Class DimensionLayer
A layer that can visualize dimension features data.
Namespace: Esri.ArcGISRuntime.Mapping
Assembly: Esri.ArcGISRuntime.dll
Syntax
public sealed class DimensionLayer : Layer, INotifyPropertyChanged, ILoadable, ILayerContentRemarks
Dimension features are a special kind of annotation feature for showing specific lengths or distances on a map. A dimension may indicate the length of a side of a building or land parcel, or the distance between two features, such as a fire hydrant and the corner of a building. They are described in detail in "Dimension". Each Dimension feature has specific text and specific locations for its schematic lines and arrows. Dimension features are not linked to other point, line or polygon features, even if the dimension measurement was created to refer to one or more features.
You can construct a dimension layer using a feature table containing dimension features:
- An online ServiceFeatureTable that has a feature layer service type of DimensionLayer.
- An offline GeodatabaseFeatureTable returned by the GeodatabaseDimensionTables collection when a GenerateGeodatabaseJob has completed.
Dimension layers can be taken offline from a feature service hosted on ArcGIS Enterprise 10.9 or later, using the GeodatabaseSyncTask. Dimension layers are also supported in mobile map packages or mobile geodatabases created in ArcGIS Pro 2.9 or later.
Dimension respects the reference scale defined by the map, so dimension will always be presented to the user at the correct size and position, as defined by the dimension author.
You cannot add, change, or delete a dimension feature. Any attempt produces a "Geodatabase table not editable" (3016) error.
The FeatureTable associated with this DimensionLayer contains a set of attributes (fields, in other words) that define dimensions. These attributes, automatically added by ArcGIS Pro, are described in "Dimension fields". The author of the dimension layer may have also added additional fields. You can query and use any of these attributes in a definition expression but you cannot change their value.
You do not have access to, and cannot change, the renderer or the styles used for rendering dimensions.
Constructors
| Name | Description |
|---|---|
| DimensionLayer(ArcGISFeatureTable) | Initializes a new instance of the DimensionLayer class from a feature table containing dimension features. |
| DimensionLayer(Item, Int64) | Initializes a new instance of the DimensionLayer class from a feature service portal item. |
| DimensionLayer(Uri) | Initializes a new instance of the DimensionLayer class from a feature service URI. |
Properties
| Name | Description |
|---|---|
| BarrierWeight | Gets or sets the weight of dimension features when considered as barriers to labeling. |
| DefinitionExpression | Gets or sets an expression which is a SQL statement WHERE clause to specify the subset of features to be displayed. |
| FeatureTable | Gets the feature table associated with this layer. |
| LayerId | Gets the layer ID that defines the layer within the feature service portal item. |
| ReferenceScale | Gets the reference scale for the layer. |
| Source | Gets the URI of a feature service to define the layer. |
Methods
| Name | Description |
|---|---|
| ClearSelection() | Updates any selected features in the layer back to the un-selected state. |
| GetSelectedFeaturesAsync() | Returns a list of the currently selected features. |
| ResetFeaturesVisible() | Resets the visibility of the layer's features back to the original visibility when loaded from the data source. |
| SelectFeature(Feature) | Selects the given feature and adds it to the current list of selected features. |
| SelectFeatures(IEnumerable<Feature>) | Selects the features in the list and adds them to the current list of selected features. |
| SelectFeaturesAsync(QueryParameters, SelectionMode, CancellationToken) | Selects the features that match the criteria in the QueryParameters object and adds them to the current list of selected features. |
| SetFeaturesVisible(IEnumerable<Feature>, Boolean) | Sets the visibility of the given features. |
| SetFeatureVisible(Feature, Boolean) | Sets the visibility of the given feature. |
| UnselectFeature(Feature) | Unselects the given feature and removes it from the current list of selected features. |
| UnselectFeatures(IEnumerable<Feature>) | Unselects the features in the given list and removes them from the current list of selected features. |
Applies to
| Target | Versions |
|---|---|
| .NET Standard 2.0 | 100.13 - 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.13 - 200.5 |
| Xamarin.Android | 100.13 - 100.15 |
| Xamarin.iOS | 100.13 - 100.15 |
| UWP | 100.13 - 200.5 |