SetLocationUnitFormat Method

In This Topic

Sets the current map location unit format for the current project. This method must be called on the MCT. Use QueuedTask.Run.

Syntax

Visual Basic (Declaration)
C#

Public Sub SetLocationUnitFormat( _
   ByVal unitFormat As DisplayUnitFormat _
)

public void SetLocationUnitFormat( 
   DisplayUnitFormat unitFormat
)

Parameters

unitFormat: The location unit format to set

Exceptions

Exception	Description
ArcGIS.Core.CalledOnWrongThreadException	This method or property must be called within the lambda passed to QueuedTask.Run.
System.ArgumentException	unit format is of the wrong type
System.ArgumentException	unit format is not in the list of available location unit formats

Remarks

Map location unit formats are used to format the coordinate system display at the bottom of the map or scene as well as format the scale combo box.
Display units.
Unit format must be of type ArcGIS.Desktop.Core.UnitFormats.UnitFormatType.Location or a System.ArgumentException will be thrown.
The location unit format must be in the list of available location unit formats for the map or a System.ArgumentException will be thrown. Refer to: GetAvailableLocationUnitFormats. Note: If the map is using a GCS, linear unit formats are not included (in the list of available units).

Example

Set the Location Unit for the Current Map

{
    //Get the list of available location unit formats
    //for the current map
    //Note: Must be on the QueuedTask.Run()
    var loc_units = map.GetAvailableLocationUnitFormats();

    //arbitrarily use the last unit in the list
    map.SetLocationUnitFormat(loc_units.Last());
}

Requirements

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

ArcGIS Pro version: 3.0 or higher.

Reference

Map Class
Map Members

Send feedback