PageToMap(MapPoint) Method

In This Topic

Translates a point in page coordinates to a point in map coordinates. This method must be called on the MCT. Use QueuedTask.Run.

Syntax

Visual Basic (Declaration)
C#

Public Overloads Function PageToMap( _
   ByVal pagePoint As MapPoint _
) As MapPoint

public MapPoint PageToMap( 
   MapPoint pagePoint
)

Parameters

pagePoint: The point in page coordinates

Return Value

A point in map coordinates

Exceptions

Exception	Description
System.InvalidOperationException	Mapframe must contain a 2D map
System.ArgumentNullException	pagePoint
ArcGIS.Core.CalledOnWrongThreadException	This method or property must be called within the lambda passed to QueuedTask.Run.

Remarks

The map coordinates will be in the spatial reference of the map associated with the map frame. Page coordinates can only be translated for 2D maps. If the map frame does not contain a 2D map, an System.InvalidOperationException is thrown. If either page coordinate value is double.NaN then a point with X, Y both set to System.Double.NaN is returned.

Example

Translates a point in page coordinates to a point in map coordinates.

{
  var pointSymbol = SymbolFactory.Instance.ConstructPointSymbol(ColorFactory.Instance.BlackRGB, 8);
  var graphicsLayer = MapView.Active.Map.GetLayersAsFlattenedList().OfType<GraphicsLayer>().FirstOrDefault();
  //Note: Must be on QueuedTask.Run

  //Get a point in the center of the Map frame
  var mapFrameCenterPoint = mapFrame.GetBounds().CenterCoordinate;
  //Convert to MapPoint
  var pointInMapFrame = MapPointBuilderEx.CreateMapPoint(mapFrameCenterPoint);

  //Find the corresponding point in the MapView
  var pointOnMap = mapFrame.PageToMap(pointInMapFrame);

  //Create a point graphic on the MapView.
  var cimGraphicElement = new CIMPointGraphic
  {
    Location = pointOnMap,
    Symbol = pointSymbol.MakeSymbolReference()
  };
  graphicsLayer.AddElement(cimGraphicElement);
}

Requirements

Target Platforms: Windows 11 Home, Pro, Enterprise (64 bit)

ArcGIS Pro version: 3.0 or higher.

Reference

MapFrame Class
MapFrame Members
Overload List

Send feedback