Description
Converts zoomed coordinates into image coordinates.
-
Return Type
-
None
-
Syntax
-
object.MapZoomedToImage pvarLongZoomedCoords, pvarFloatImageCoords, [bClientRelative]
The MapZoomedToImage Method syntax has these parts: |
| object | An expression evaluating to an object of type McDisplay. | | pvarLongZoomedCoords | Required. A Variant value. VARIANT* : A SafeArray of integer zoomed coordinates.
| | pvarFloatImageCoords | Required. A Variant value. VARIANT* : A SafeArray of resulting floating point image coordinates.
| | bClientRelative | Optional. A Boolean value. BOOL : Optional, indicates whether the conversion should account for Pan and Scroll (the default). When TRUE, the zoomed coordinate (0,0) is the upper left corner pixel of the client window managed by the viewer. When FALSE, the zoomed coordinate (0,0) represents the actual upper left pixel of the image.
|
Remarks
Image coordinates are real numbers and provide sub-pixel accuracy. Zoomed coordinates are integers and represent the actual pixel within the display, or client window, of the image. Zoomed coordinate 0:0 represents the upper left corner of the display window.
When the Magnification is 1.0, MapZoomedToImage() simply converts the integer into a real number.
Refer to MapImageToZoomed for complete details.
Exceptions
E_INVALIDARG -- bad lPointCount, or a pointer is invalid.
| Note: |
When this method is called from within the AboutToPaint or the PostPaint methods of the _IMcViewEvents or _IMcBasicViewEvents event interfaces, then “zoomed coordinates” are interpreted as logical coordinates for the device context being drawn into (the lHDC argument in the notification calls). At all other times, “zoomed coordinates” are client coordinates (i.e., logical coordinates when the mapping mode is set to MM_TEXT). |
|
MapZoomedToImage Method (McDisplay)
