Converts map coordinates to screen coordinates.
FromMapPoints(MapDescription MapDescription, ImageDisplay MapImageDisplay, Multipoint MapPoints, out int[] ScreenYValues)
|
Parameter |
Description |
|
MapDescription
|
Used to define map extent in map units.
|
|
ImageDisplay |
Used to define the map image extent in pixels. |
|
MapPoints |
A Multipoint object containing one or more coordinates in map units. Each coordinate is stored as a PointN object.
|
|
ScreenYValues |
An integer array containing the Y values for coordinates converted from map to pixel units. The array is populated when the method is called.
|
Return Value
An integer array containing the X values for coordinates converted from map to pixel units.
Remarks
To convert between map and pixel units, the
origin for both must be determined. The origin
for coordinates in map units is located in the lower left corner of the
map image. The map origin is the minimum x and
y value of the current map extent. The origin for
coordinates in pixel units is located in the upper left corner of the
map image. The pixel origin is always 0,0.
Note that the map service will maintain aspect ratio, so the map extent
provided as part of the MapDescription may be different than the map extent
used to generate the pixel coordinates. To get
the map extent used in the calculation, call ExportMapImage with the same
MapDescription and ImageDisplay (as part of ImageDescription). A
MapImage is returned where the Extent property references the map extent
used by the FromMapPoints method.
Examples