Class MarkerSymbolLayer

A base class for marker symbol layers, representing a symbol layer used to display a marker.

Inheritance

System.Object

SymbolLayer

MarkerSymbolLayer

PictureMarkerSymbolLayer

VectorMarkerSymbolLayer

Implements

System.ComponentModel.INotifyPropertyChanged

SymbolLayer.IsColorLocked

SymbolLayer.IsEnabled

SymbolLayer.PropertyChanged

System.Object.Equals(System.Object)

System.Object.Equals(System.Object, System.Object)

System.Object.GetHashCode()

System.Object.GetType()

System.Object.MemberwiseClone()

System.Object.ReferenceEquals(System.Object, System.Object)

System.Object.ToString()

Namespace: Esri.ArcGISRuntime.Symbology

Assembly: Esri.ArcGISRuntime.dll

Syntax

public abstract class MarkerSymbolLayer : SymbolLayer, INotifyPropertyChanged

Remarks

MarkerSymbolLayer draws a shape or picture at a specific location relative to point geometry. A marker symbol layer is most often used in point symbols, but they can also be included in polyline and polygon symbols to draw a symbol at locations along lines and outlines, or within areas (the center of a polygon, for example).

The following types of marker symbol layers are supported:

VectorMarkerSymbolLayer - Vector geometry defines the shape and appearance of the marker.
PictureMarkerSymbolLayer - Uses an image file (specified using a URI or image data) to define the marker.

This symbol layer controls many common operations vital for working with markers. Anchors, angles, offsets, and size properties are controlled on MarkerSymbolLayer.

The MarkerSymbolLayer has methods affecting both 2D and 3D markers. Some properties apply only to 3D markers others only affect 2D markers. Properties that affect the marker's position in screen space, not world space. This means that the x-axis for a 2D marker runs from negative-x on the West edge of the screen to positive-x on the East edge of the screen. Negative-y to positive-y runs from the South edge of the screen to the North edge of the screen.

Properties that apply only to 3D markers affect the marker's position in geographic space, rather than screen space. This means that the x, y, and z-axes to which the class methods are the axes of the world, with the following layout: from negative to positive, the x-axis spans from West to East, the y-axis from South to North, and the z-axis from directly into the surface to the sky.

While a simple text symbol (TextSymbol) can be used to display a character as a marker, proper display is dependent on the referenced font being available on the machine or device running the app. If the exact font is not found, which is likely to occur on many mobile devices, a fallback mechanism is used to find the best available font to use. A character marker symbol authored from ArcGIS Pro, however, is represented by a vector marker symbol. This symbol stores the geometry that represents the character, is not dependent on the font to render the shape of the marker, and displays as expected on all devices.

Properties

Name	Description
Anchor	Gets or sets the anchor object of a marker symbol layer.
Heading	Gets or sets the marker symbol layer's heading: the angle of rotation about the anchor point.
OffsetX	Gets or sets the marker symbol layer's x-offset.
OffsetY	Gets or sets the marker symbol layer's y-offset.
Size	Gets or sets the size of marker symbol layer.

Applies to

Target	Versions
.NET Standard 2.0	100.5 - 200.5
.NET	100.13 - 200.5
.NET Windows	100.13 - 200.5
.NET Android	200.0 - 200.5
.NET iOS	200.0 - 200.5
.NET Framework	100.5 - 200.5
Xamarin.Android	100.5 - 100.15
Xamarin.iOS	100.5 - 100.15
UWP	100.5 - 200.5