Class SymbolLayer
A base class to represent symbol layers, which are the fundamental components used to build multilayer symbols.
Implements
Namespace: Esri.ArcGISRuntime.Symbology
Assembly: Esri.ArcGISRuntime.dll
Syntax
public abstract class SymbolLayer : INotifyPropertyChanged
Remarks
The available symbol layer types correspond to the primitive geometry they are designed to render: marker layers for point, stroke layers for line, and fill layers for area or polygons. Layer types, however, are not applied exclusively to the corresponding geoelement geometry type. A marker symbol layer, for example, could be applied to a polyline feature to render its vertices. Each layer type has a unique set of properties to control its display. A symbol can contain one or several symbol layers of the same or different type. A symbol used to render polygons, for example, might contain a fill symbol layer to render the polygon interior, a stroke symbol layer for rendering the polygon outline, and a marker symbol layer to render polygon vertices. A symbol to render a polyline might contain several stroke layers of varying widths. If a symbol contains a layer that cannot render the type of geometry to which it is applied, that symbol layer is ignored when rendering.
The following table lists symbol types and symbol layers:
Symbol type | Typical symbol layers | Role |
---|---|---|
Point symbol |
Marker layers |
Draw relative to the point geometry |
Polyline symbol |
Marker layers |
Draw at specified locations relative to the line geometry |
Stroke layers |
Draw relative to the line geometry |
|
Polygon symbol |
Marker layers |
Draw relative to the polygon outline or in the interior, depending on placement setting |
Stroke layers |
Draw relative to the polygon outline |
|
Fill layers |
Draw relative to the polygon interior |
Symbol and layer property interaction
Most Symbol
Unknown symbol layers or properties
The multilayer symbol specification is complex and continues to evolve outside of ArcGIS Runtime. The potential exists that some symbol layers (or properties) will not expose an API or will not be known by ArcGIS Runtime. Depending on the problem encountered, ArcGIS Runtime will handle this situation in one of the following ways:
- If ArcGIS Runtime reads a symbol that it can render, but for which no public API is exposed, the base class for the appropriate symbol layer is returned in the layer collection.
- The multilayer symbology specification for an existing symbol layer type might be updated to include properties that are not recognized by ArcGIS Runtime. When reading such a symbol layer, ArcGIS Runtime attempts to create it with the properties it understands. The symbol layer renders, but properties that cannot be identified are ignored.
- In the event that a new(unrecognized) symbol layer is encountered by ArcGIS Runtime, the symbol is ignored and is not added to the symbol layer collection.
Properties
Name | Description |
---|---|
Is |
Gets or sets a value indicating whether the symbol layer is color locked. |
Is |
Gets or sets a value indicating whether the symbol layer is enabled. |
Events
Name | Description |
---|---|
Property |
Occurs when a property value changes. |
Applies to
Target | Versions |
---|---|
.NET Standard 2.0 | 100.5 - 100.15 |
.NET 6.0 | 100.13 - 100.15 |
.NET 6.0 Windows | 100.13 - 100.15 |
.NET Framework | 100.5 - 100.15 |
.NET 5 | 100.10 - 100.12 |
.NET Core 3.1 | 100.7 - 100.12 |
Xamarin.Android | 100.5 - 100.15 |
Xamarin.iOS | 100.5 - 100.15 |
UWP | 100.5 - 100.15 |