FormatValue Method—ArcGIS Pro

FormatValue Method

In This Topic

Format the input value using the unit format. This method must be called on the MCT. Use QueuedTask.Run.

Syntax

Visual Basic (Declaration)
C#

Public Function FormatValue( _
   ByVal value As Double _
) As String

public string FormatValue( 
   double value
)

Parameters

value: The value to be formatted

Return Value

The formatted value

Exceptions

Exception	Description
ArcGIS.Core.CalledOnWrongThreadException	This method or property must be called within the lambda passed to QueuedTask.Run

Remarks

For the unit format of type UnitFormatType.Location use FormatLocation(Double,Double,SpatialReference) or FormatLocation(MapPoint) with the location to be formatted.

Example

Format an Elevation Using the Current Map Elevation Unit

{
    //Get the current elevation unit. If the map is not
    //a scene the default Project distance unit is returned
    //Note: Must be on the QueuedTask.Run()
    var elev_unit = map.GetElevationUnitFormat();

    //Format the view camera elevation
    var str = elev_unit.FormatValue(mapView.Camera.Z);

    System.Diagnostics.Debug.WriteLine($"Formatted elevation: {str}");
}

Requirements

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

ArcGIS Pro version: 3.0 or higher.

Reference

DisplayUnitFormat Class
DisplayUnitFormat Members

Send feedback