Format

Property Overview

Property Details

conversionInfo ConversionInfo

Contains information that describes how this Format should be converted. This property should only be set when creating a custom Format.

Default Value:null

coordinateSegments CoordinateSegment[]

A array of Coordinate Segments. Each segment represents a section of the Format's coordinate.

Default Value:null

currentPattern String

A string that serves as a pattern describing how this Format should be displayed. The pattern should contain all of aliases specified by the Format's coordinateSegments property.

Default Value:null

Example

// Remove the spaces from an mgrs coordinate
let format = coordinateConversionWidget.formats.find(function(format) {
  return format.name === "mgrs";
});

console.log.(format.currentPattern);
// > Z S X Y

format.currentPattern = "ZSXY"

declaredClass Stringreadonly inherited

The name of the class. The declared class name is formatted as esri.folder.className.

defaultPattern String

The default pattern describing how this Format should be displayed. See currentPattern.

Default Value:null

label String

Since: ArcGIS Maps SDK for JavaScript 4.24

A string that is used to label this Format in the UI. If not set, it will default to name

name String

The name of the coordinate. A CoordinateConversion widget should not contain multiple Formats with the same name.

Default Value:null

spatialReference SpatialReference

The SpatialReference for this format. Coordinates generated for a format will be derived from points in this spatial reference.

viewModel CoordinateConversionViewModel

The view model of the CoordinateConversion widget that is utilizing this format.

Method Overview

Method Details

addHandles(handleOrHandles, groupKey)inherited

Since: ArcGIS Maps SDK for JavaScript 4.25

Adds one or more handles which are to be tied to the lifecycle of the object. The handles will be removed when the object is destroyed.

// Manually manage handles
const handle = reactiveUtils.when(
  () => !view.updating,
  () => {
    wkidSelect.disabled = false;
  },
  { once: true }
);

this.addHandles(handle);

// Destroy the object
this.destroy();

Parameters

handleOrHandles WatchHandle|WatchHandle[] Handles marked for removal once the object is destroyed.

groupKey * optional Key identifying the group to which the handles should be added. All the handles in the group can later be removed with Accessor.removeHandles(). If no key is provided the handles are added to a default group.

hasHandles(groupKey){Boolean}inherited

Since: ArcGIS Maps SDK for JavaScript 4.25

Returns true if a named group of handles exist.

Parameter

groupKey * optional A group key.

Returns

Type	Description
Boolean	Returns true if a named group of handles exist.

Example

// Remove a named group of handles if they exist.
if (obj.hasHandles("watch-view-updates")) {
  obj.removeHandles("watch-view-updates");
}

removeHandles(groupKey)inherited

Since: ArcGIS Maps SDK for JavaScript 4.25

Removes a group of handles owned by the object.

Parameter

groupKey * optional A group key or an array or collection of group keys to remove.

Example

obj.removeHandles(); // removes handles from default group

obj.removeHandles("handle-group");
obj.removeHandles("other-handle-group");

Type Definitions

ConversionInfo Object

This object describes how a Format should be projected and formatted for display. Used to define custom Formats that require custom conversion and/or projection logic.

Properties

convert ConvertFunction optional A function that takes a point and returns a position.

reverseConvert ReverseConvertFunction optional A function that takes a string and returns a Point.

ConvertFunction(point){Position}

A user-provided function that converts a Point into a Position. This function may be necessary to provide as part of ConversionInfo when creating a custom Format.

Parameter

point Point A point to be converted.

Returns

Type	Description
Position	The returned position.

CoordinateSegment

A coordinate segment represents one piece of a coordinate string.

A MGRS coordinate, for example 30UVG898998, is described by four segments:

1. Alias Z, the gridzone: 30U
2. Alias S, the 100,000 meter square designator: VG
3. Alias X, the easting (x coordinate with respect to the 10,000 meter square): 898
4. Alias Y, the northing (y coordinate with respect to the 10,000 meter square): 998

Properties

alias String A string that provides the name for this segment of a coordinate string.

description String A string that describes the role of this segment.

searchPattern RegExp A regular expression that should extract this segment from the complete coordinate.

Position Object

Describes a point in terms of a location, a Point, and a coordinate, a string.

Properties

location Point A point geometry representing the location described by the conversion.

coordinate String A string representing the location.

ReverseConvertFunction(coordinate){Point}

A user-provided function that converts a coordinate string into a Point. This function may be necessary to provide as part of ConversionInfo when creating a custom Format.

Parameter

coordinate String The string to be reversed.

Returns

Type	Description
Point	The returned point