Show / Hide Table of Contents

Enum LabelTextLayout

The layout to use for label text, which can be either horizontal, straight, perpendicular, or follow the line feature.

Namespace: Esri.ArcGISRuntime.Mapping.Labeling
Assembly: Esri.ArcGISRuntime.dll
Syntax
public enum LabelTextLayout

Fields

Name Description
Automatic

The text layout will be determined by the individual feature type.

For each label, the layout will be determined by the feature Geometry type:

  • Line feature labels will use FollowFeature.
  • Point and polygon feature labels will use Horizontal.

FollowFeature

Text will bend to follow a curved or multi-segment line feature.

Individual characters will be angled to follow the changes in angle of the line geometry.

If the text overruns the beginning or end of the line geometry, then the remaining characters will be laid out in a straight line extrapolated from the last geometry segment.

Horizontal

Text will be written horizontally (with respect to the screen).

If the map is rotated within the screen, then the text will be redrawn (and possibly repositioned) to remain horizontal with respect to the screen.

Perpendicular

Text will be written perpendicular to the Straight text layout.

Straight

Text will be written along a straight line, following the point positioning angle or at a tangent to the line feature.

An angle for placement and orientation will be calculated for each label if the labelAngleInfo JSON property for the LabelDefinition has been specified.

Centered point labels will stay centered on the point feature, but will be rotated to the angle (or horizontal, if none has been defined).

Offset point labels will be positioned around the point feature, at the position specified by the angle. The text will lie along this angle, so that it stretches radially from the edge of the point feature.

Note that if a label has an angle of zero then its text will be drawn horizontally with respect to the map. If the map is rotated within the screen, the text will rotate with the map.

Line labels will be positioned as usual, but then rotated (around their midpoint) to lie on a straight line at a tangent to the line geometry at that point.

Applies to

TargetVersions
.NET Standard 2.0100.11 - 200.2
.NET 6.0100.13 - 200.2
.NET 6.0 Windows100.13 - 200.2
.NET 6.0 Android200.0 - 200.2
.NET 6.0 iOS200.0 - 200.2
.NET Framework100.11 - 200.2
.NET 5100.11 - 100.12
.NET Core 3.1100.11 - 100.12
Android100.11 - 100.15
iOS100.11 - 100.15
UWP100.11 - 200.2
In This Article
Back to top Copyright © 2022 Esri.