LabelDefinition Class

Member Function Documentation

[since Esri::ArcGISRuntime 100.11] LabelDefinition::LabelDefinition(Esri::ArcGISRuntime::LabelExpression *labelExpression, Esri::ArcGISRuntime::TextSymbol *textSymbol, QObject *parent = nullptr)

Creates a LabelDefinition with the specified LabelExpression and TextSymbol.

• labelExpression - The expression script used to calculate the label text.
• textSymbol - The text symbol which describes the overall appearance of label text (e.g., font and size). If no textSymbol has been set, then no labels can be created.
• parent - The optional parent QObject.

The label expression may be a combination of literal text and attribute values from the feature being labeled. The syntax of the expression is determined by which label expression object is used: ArcadeLabelExpression, SimpleLabelExpression or WebmapLabelExpression. Warning: If the expression attempts to use attributes which don't exist then no label will be produced. This is distinct from the attribute existing but having a empty or empty value, which can form part of the produced text label.

If no textSymbol has been set, then no labels can be created.

This function was introduced in Esri::ArcGISRuntime 100.11.

[override virtual] LabelDefinition::~LabelDefinition()

Destructor.

[since Esri::ArcGISRuntime 100.11] Esri::ArcGISRuntime::LabelAngle *LabelDefinition::angle() const

Returns the angular positions and layout directions for labels on or around point feature symbols.

This optional object specifies how to position a label following the direction of an angle. The angular position may be different for each feature (driven by one or more feature attributes) or constant for all features (specified by a fixed number).

The placement will still be used to indicate whether offset or centered positioning is required, but the exact position will be overridden by the angle calculated for the feature. After the position has been determined, textLayout and textOrientation are used to specify the layout of the text at that position.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also setAngle().

[since Esri::ArcGISRuntime 100.11] Esri::ArcGISRuntime::LabelDeconflictionStrategy LabelDefinition::deconflictionStrategy() const

Returns the strategy for moving labels to avoid overlapping feature, annotation, dimension, or graphic symbols or higher priority labels.

The default is LabelDeconflictionStrategy::Automatic (which will be interpreted as LabelDeconflictionStrategy::Static, meaning, use preferred location unless it overlaps an obstacle).

In 3D LabelDeconflictionStrategy::Static is also selected by default.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also setDeconflictionStrategy().

[since Esri::ArcGISRuntime 100.11] Esri::ArcGISRuntime::LabelExpression *LabelDefinition::expression() const

Returns the expression script used to calculate the label text.

The expression may be a combination of literal text and attribute values from the feature being labeled. The syntax of the expression is determined by which label expression object is used: ArcadeLabelExpression, SimpleLabelExpression, or WebmapLabelExpression.

A label expression using one scripting language can be replaced by an expression using a different scripting language just by creating an object of the new LabelExpression subclass and assigning it to expression.

The default value is an empty ArcadeLabelExpression, which will evaluate to an empty text label.

The expression needs to create a text string that will be used as the label text. The text string can be any legal UTF16 characters and can also include HTML-style formatting tags, for example:

"Hello <BOL>World</BOL>"

where the angle-bracketed tags will not appear in the label, but may change the presentation of the text. In the example, the "World" will appear in bold.

The available tags are:

• <BOL></BOL> for bold text
• <UND></UND> for underlined text
• <ITA></ITA> for italic text
• <CLR red='256'></CLR> for colored text
• <FNT name='Arial' size='18'></FNT> for text using a different size or font (if available on client).

Tags can be upper or lower case, but not a mixture. Tags can be nested e.g. "<ITA>Hello <BOL>World</BOL></ITA>".

Full documentation of the tag parameters is available at Text formatting tags.

Note that not all ArcGIS Pro tags are currently supported in this API. The "<CLR>" tag is currently only supported for text in 2D views. Any unsupported tags will be ignored and not written as part of the label text.

Warning: If the expression attempts to use attributes which don't exist then no label will be produced. This is distinct from the attribute existing but having a nullptr or empty value, which can form part of the produced text label.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also setExpression().

[since Esri::ArcGISRuntime 100.11] Esri::ArcGISRuntime::LabelOverlapStrategy LabelDefinition::featureBoundaryOverlapStrategy() const

Returns the strategy for whether other labels are allowed to overlap the boundary of polygon features being labeled by this LabelDefinition.

In 3D scenes, labels will be allowed to overlap the boundaries of polygon features.

The default is LabelOverlapStrategy::Automatic, which will give the same behavior as LabelOverlapStrategy::Allow.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also setFeatureBoundaryOverlapStrategy().

[since Esri::ArcGISRuntime 100.11] Esri::ArcGISRuntime::LabelOverlapStrategy LabelDefinition::featureInteriorOverlapStrategy() const

Returns the strategy for whether other labels are allowed to overlap the interior of polygon features being labeled by this LabelDefinition.

In 3D scenes, labels will be allowed to overlap the boundaries of polygon features.

The default is LabelOverlapStrategy::Automatic which will give the same behavior as LabelOverlapStrategy::Allow.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also setFeatureInteriorOverlapStrategy().

[static] Esri::ArcGISRuntime::LabelDefinition *LabelDefinition::fromJson(const QString &json, QObject *parent = nullptr)

Creates this LabelDefinition from its JSON representation.

Returns a LabelDefinition created using the data in the json parameter and an optional parent.

See also JsonSerializable.

[since Esri::ArcGISRuntime 200.3] Esri::ArcGISRuntime::LabelGeometryStrategy LabelDefinition::geometryStrategy() const

Returns the strategy for how to use the geometry of the feature when calculating the label position.

Only applicable to labels for lines or polygons.

This function was introduced in Esri::ArcGISRuntime 200.3.

See also setGeometryStrategy().

[since Esri::ArcGISRuntime 100.11] bool LabelDefinition::isUseCodedValues() const

Returns true if the data source should translate domain identifiers into meanings using a CodedValueDomain, false otherwise.

For any translation to occur, the data source must have one or more CodedValueDomain set up for the attribute fields. The default value is true.

This property only affects Simple label expressions. Arcade expressions can use functions to specify when code translations should be carried out. Coded value translation for web map expressions is not currently supported.

This function was introduced in Esri::ArcGISRuntime 100.11.

[since Esri::ArcGISRuntime 100.11] Esri::ArcGISRuntime::LabelOverlapStrategy LabelDefinition::labelOverlapStrategy() const

Returns the strategy for whether other labels are allowed to overlap labels created by this LabelDefinition.

In 3D, labels will not be allowed to overlap other labels. Overlapping labels will not be displayed until the user zooms in further so that the labels don't overlap.

The default is LabelOverlapStrategy::Automatic, which will give the same behavior as LabelOverlapStrategy::Exclude.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also setLabelOverlapStrategy().

[since Esri::ArcGISRuntime 100.11] Esri::ArcGISRuntime::LabelLineConnection LabelDefinition::lineConnection() const

Returns the strategy for whether line features with the same label, and matching end vertices, should be joined before sharing a label. 3D line features will be treated as independent features with their own label.

The default is LabelLineConnection::Automatic, which will be interpreted as LabelLineConnection::MinimizeLabels.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also setLineConnection().

[since Esri::ArcGISRuntime 200.1] Esri::ArcGISRuntime::LabelLineOrientation LabelDefinition::lineOrientation() const

Returns the strategy for whether placement above or below a line geometry will be interpreted as above or below on the `screen`, or with respect to the `direction` of line's geometry (that is, the digitization order in which the vertices are listed).

• of the screen.
• from its line segment. If the lineOrientation is set to LabelLineOrientation::Unconstrained then the label will be offset perpendicularly to whichever side of the line geometry has space (defaulting to above in the `screen` sense). placement below would have the corresponding interpretations. The default is LabelLineOrientation::Screen.

This function was introduced in Esri::ArcGISRuntime 200.1.

See also setLineOrientation().

[since Esri::ArcGISRuntime 100.11] double LabelDefinition::maxScale() const

Returns the maximum scale at which labels will be visible.

Labels will only be visible when the viewing scale is smaller than (or equal to) the maxScale. In 3D scenes,the scale range is between individual label and view plane instead of map and view plane.

For example, if the viewing scale is 1:12000 and the maxScale is 1:10000, then the labels will be visible (because 1/12000 <= 1/10000).

A maxScale of 0, which is the default, indicates no upper limit on the viewing scale.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also setMaxScale().

[since Esri::ArcGISRuntime 100.11] double LabelDefinition::minScale() const

Returns the minimum scale at which labels will be visible.

In 3D scenes, the scale range is between individual label and view plane instead of map and view plane. Labels will only be visible when the viewing scale is larger than (or equal to) the minScale.

For example, if the viewing scale is 1:12000 and the minScale is 1:20000, then the labels will be visible (because 1/12000 >= 1/20000). A minScale of 0, which is the default, indicates no lower limit on the viewing scale.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also setMinScale().

[since Esri::ArcGISRuntime 100.11] Esri::ArcGISRuntime::LabelMultipartStrategy LabelDefinition::multipartStrategy() const

Returns the strategy for how many labels should be placed on each polyline or polygon (multi-ring) feature.

The default is LabelMultipartStrategy::Automatic.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also setMultipartStrategy().

[since Esri::ArcGISRuntime 100.11] QString LabelDefinition::name() const

Returns text name for the class of labels.

This name is assigned by the map author to clarify the purpose of this label definition. It is used for display or debugging purposes. If no name is explicitly assigned, then an empty text string is stored.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also setName().

[since Esri::ArcGISRuntime 100.11] double LabelDefinition::offsetDistance() const

Returns the distance in points (1/72 inches) that text should be moved away from its features.

The distance is measured from the point symbol radius or line feature symbology edge. The distance is measured on the screen (i.e., not in the map) in points, comparable to the text font size.

This can be a negative value, to pull the label closer to the feature if, for example, the average size for a point symbol is overly conservative for the actual graphic shown.

If no value is set, then 1 point is assumed.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also setOffsetDistance().

[since Esri::ArcGISRuntime 100.11] Esri::ArcGISRuntime::LabelOverrunStrategy LabelDefinition::overrunStrategy() const

Returns the strategy for whether a label will be visible at scales where the feature is too small for the label to fit.

The default is LabelOverrunStrategy::Automatic, which will give different behavior depending on the type of feature that the label might overrun.

Not supported by 3D scenes.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also setOverrunStrategy().

[since Esri::ArcGISRuntime 100.11] Esri::ArcGISRuntime::LabelingPlacement LabelDefinition::placement() const

Returns the preferred position of the text label, with respect to its feature geometry.

The default is LabelingPlacement::Automatic. The effect of this is the same as one of the following, depending on the type of feature geometry:

• LabelingPlacement::PointAboveRight for point features
• LabelingPlacement::PolygonAlwaysHorizontal for polygon features
• LabelingPlacement::LineAboveAlong for line features

Note that if a polygon contains holes (defined as counter-clockwise rings), labels will not be placed within those holes.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also setPlacement().

[since Esri::ArcGISRuntime 100.11] double LabelDefinition::priority() const

Returns which labels are placed first, and can also supplant existing lower-priority labels (e.g., during panning).

Lower values indicate more important labels; higher values indicate lower priority, i.e.:

• 0 is the most important
• 5 is high priority
• 15 is medium priority

If set to -1 or not set at all, then default values are used, depending on the geometry types of the features:

• 12 for point features
• 15 for line features
• 18 for polygon features

This value does not have to be an integer because it is just a continuum of values for comparison. Users can use this to specify that a class of labels should have priority between two other classes with close priorities.

For example, PreferredRoutes might be given priority 13 to appear ahead of general line feature labels, but after general point feature labels. And HistoricSites might be given priority 12.5 to appear ahead of PreferredRoute labels, but still after general point feature labels.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also setPriority().

[since Esri::ArcGISRuntime 100.11] double LabelDefinition::removeDuplicatesDistance() const

Returns a value that controls the duplicate thinning radius in points (1/72 inches).

The distance is measured on the screen (i.e., not in the map) in points, comparable to the text font size. This value is only used if removeDuplicatesStrategy is enabled. The default value is 0. This indicates that duplicates should be removed from the entire extent.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also setRemoveDuplicatesDistance().

[since Esri::ArcGISRuntime 100.11] Esri::ArcGISRuntime::LabelRemoveDuplicatesStrategy LabelDefinition::removeDuplicatesStrategy() const

Returns the strategy for whether labels are removed if other features have the same text label. This can reduce clutter and free up space.

The default is LabelRemoveDuplicatesStrategy::Automatic, which will be interpreted as LabelRemoveDuplicatesStrategy::None indicating that all labels should be shown if possible.

The distance within which to look for duplicates is controlled by removeDuplicatesDistance.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also setRemoveDuplicatesStrategy().

[since Esri::ArcGISRuntime 100.11] double LabelDefinition::repeatDistance() const

Returns the distance apart in points (1/72 inches) that the repetitions should be.

This value is only used if repeatStrategy is enabled. The distance is measured on the screen along the line feature. As the user zooms in closer, two repetitions move further apart on the screen, until there is room for a new repetition between them. The default is 216 points, i.e., line labels should be repeated approximately every 3 inches along long features.

The distance is considered a guide for the approximate label separation and should not be used for precise distance markings.

A distance of 0 disables label repetition.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also setRepeatDistance().

[since Esri::ArcGISRuntime 100.11] Esri::ArcGISRuntime::LabelRepeatStrategy LabelDefinition::repeatStrategy() const

Returns the strategy for whether a label should have multiple copies created and placed along or across the same feature.

The default is LabelRepeatStrategy::Automatic.

The frequency of repetition is controlled by the repeatDistance property. In 3D scenes, only one label will be placed per line feature.

This property is currently only supported for line features, but will be extended to polygons in the future.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also setRepeatStrategy().

[since Esri::ArcGISRuntime 100.11] void LabelDefinition::setAngle(Esri::ArcGISRuntime::LabelAngle *angle)

Sets the angle to angle.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also angle.

[since Esri::ArcGISRuntime 100.11] void LabelDefinition::setDeconflictionStrategy(Esri::ArcGISRuntime::LabelDeconflictionStrategy deconflictionStrategy)

Sets the deconflictionStrategy to deconflictionStrategy.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also deconflictionStrategy.

[since Esri::ArcGISRuntime 100.11] void LabelDefinition::setExpression(Esri::ArcGISRuntime::LabelExpression *expression)

Sets the expression to expression.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also expression.

[since Esri::ArcGISRuntime 100.11] void LabelDefinition::setFeatureBoundaryOverlapStrategy(Esri::ArcGISRuntime::LabelOverlapStrategy featureBoundaryOverlapStrategy)

Sets the featureBoundaryOverlapStrategy to featureBoundaryOverlapStrategy.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also featureBoundaryOverlapStrategy.

[since Esri::ArcGISRuntime 100.11] void LabelDefinition::setFeatureInteriorOverlapStrategy(Esri::ArcGISRuntime::LabelOverlapStrategy featureInteriorOverlapStrategy)

Sets the featureInteriorOverlapStrategy to featureInteriorOverlapStrategy.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also featureInteriorOverlapStrategy.

[since Esri::ArcGISRuntime 200.3] void LabelDefinition::setGeometryStrategy(Esri::ArcGISRuntime::LabelGeometryStrategy geometryStrategy)

Sets the geometryStrategy to geometryStrategy.

This function was introduced in Esri::ArcGISRuntime 200.3.

See also geometryStrategy.

[since Esri::ArcGISRuntime 100.11] void LabelDefinition::setLabelOverlapStrategy(Esri::ArcGISRuntime::LabelOverlapStrategy labelOverlapStrategy)

Sets the labelOverlapStrategy to labelOverlapStrategy.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also labelOverlapStrategy.

[since Esri::ArcGISRuntime 100.11] void LabelDefinition::setLineConnection(Esri::ArcGISRuntime::LabelLineConnection lineConnection)

Sets the lineConnection to lineConnection.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also lineConnection.

[since Esri::ArcGISRuntime 200.1] void LabelDefinition::setLineOrientation(Esri::ArcGISRuntime::LabelLineOrientation lineOrientation)

Sets the lineOrientation to lineOrientation.

This function was introduced in Esri::ArcGISRuntime 200.1.

See also lineOrientation.

[since Esri::ArcGISRuntime 100.11] void LabelDefinition::setMaxScale(double maxScale)

Sets the maxScale to maxScale.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also maxScale.

[since Esri::ArcGISRuntime 100.11] void LabelDefinition::setMinScale(double minScale)

Sets the minScale to minScale.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also minScale.

[since Esri::ArcGISRuntime 100.11] void LabelDefinition::setMultipartStrategy(Esri::ArcGISRuntime::LabelMultipartStrategy multipartStrategy)

Sets the multipartStrategy to multipartStrategy.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also multipartStrategy.

[since Esri::ArcGISRuntime 100.11] void LabelDefinition::setName(const QString &name)

Sets the name to name.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also name.

[since Esri::ArcGISRuntime 100.11] void LabelDefinition::setOffsetDistance(double offsetDistance)

Sets the offsetDistance to offsetDistance.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also offsetDistance.

[since Esri::ArcGISRuntime 100.11] void LabelDefinition::setOverrunStrategy(Esri::ArcGISRuntime::LabelOverrunStrategy overrunStrategy)

Sets the overrunStrategy to overrunStrategy.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also overrunStrategy.

[since Esri::ArcGISRuntime 100.11] void LabelDefinition::setPlacement(Esri::ArcGISRuntime::LabelingPlacement placement)

Sets the placement to placement.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also placement.

[since Esri::ArcGISRuntime 100.11] void LabelDefinition::setPriority(double priority)

Sets the priority to priority.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also priority.

[since Esri::ArcGISRuntime 100.11] void LabelDefinition::setRemoveDuplicatesDistance(double removeDuplicatesDistance)

Sets the removeDuplicatesDistance to removeDuplicatesDistance.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also removeDuplicatesDistance.

[since Esri::ArcGISRuntime 100.11] void LabelDefinition::setRemoveDuplicatesStrategy(Esri::ArcGISRuntime::LabelRemoveDuplicatesStrategy removeDuplicatesStrategy)

Sets the removeDuplicatesStrategy to removeDuplicatesStrategy.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also removeDuplicatesStrategy.

[since Esri::ArcGISRuntime 100.11] void LabelDefinition::setRepeatDistance(double repeatDistance)

Sets the repeatDistance to repeatDistance.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also repeatDistance.

[since Esri::ArcGISRuntime 100.11] void LabelDefinition::setRepeatStrategy(Esri::ArcGISRuntime::LabelRepeatStrategy repeatStrategy)

Sets the repeatStrategy to repeatStrategy.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also repeatStrategy.

[since Esri::ArcGISRuntime 100.11] void LabelDefinition::setStackAlignment(Esri::ArcGISRuntime::LabelStackAlignment stackAlignment)

Sets the stackAlignment to stackAlignment.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also stackAlignment.

[since Esri::ArcGISRuntime 100.11] void LabelDefinition::setStackBreakPosition(Esri::ArcGISRuntime::LabelStackBreakPosition stackBreakPosition)

Sets the stackBreakPosition to stackBreakPosition.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also stackBreakPosition.

[since Esri::ArcGISRuntime 100.11] void LabelDefinition::setStackRowLength(double stackRowLength)

Sets the stackRowLength to stackRowLength.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also stackRowLength.

[since Esri::ArcGISRuntime 100.11] void LabelDefinition::setStackStrategy(Esri::ArcGISRuntime::LabelStackStrategy stackStrategy)

Sets the stackStrategy to stackStrategy.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also stackStrategy.

[since Esri::ArcGISRuntime 100.11] void LabelDefinition::setTextLayout(Esri::ArcGISRuntime::LabelTextLayout textLayout)

Sets the textLayout to textLayout.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also textLayout.

[since Esri::ArcGISRuntime 100.11] void LabelDefinition::setTextOrientation(Esri::ArcGISRuntime::LabelTextOrientation textOrientation)

Sets the textOrientation to textOrientation.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also textOrientation.

[since Esri::ArcGISRuntime 100.11] void LabelDefinition::setTextSymbol(Esri::ArcGISRuntime::TextSymbol *textSymbol)

Sets the textSymbol to textSymbol.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also textSymbol.

[since Esri::ArcGISRuntime 100.11] void LabelDefinition::setUseCodedValues(bool useCodedValues)

Sets the useCodedValues to useCodedValues.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also isUseCodedValues.

[since Esri::ArcGISRuntime 100.11] void LabelDefinition::setWhereClause(const QString &whereClause)

Sets the whereClause to whereClause.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also whereClause.

[since Esri::ArcGISRuntime 100.11] Esri::ArcGISRuntime::LabelStackAlignment LabelDefinition::stackAlignment() const

Returns the strategy for how multi-row (stacked) text should be aligned.

A multi-row text label can be horizontally aligned on the left, right or at its center. This preference can be specified by the TextSymbol assigned to the LabelDefinition. By using the stackAlignment property, the user can choose to use the TextSymbol::horizontalAlignment property for all labels, or can choose to have the most aesthetic alignment calculated case-by-case for each label depending on its placement position around its feature. This is particularly useful for labels of dense point features, where labels may move above, below, left or right of their point symbol, in order to fit on the display.

The default value is LabelStackAlignment::Automatic (which will have the same effect on labels as LabelStackAlignment::TextSymbol).

This property has no effect if stackStrategy is LabelStackStrategy::None.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also setStackAlignment().

[since Esri::ArcGISRuntime 100.11] Esri::ArcGISRuntime::LabelStackBreakPosition LabelDefinition::stackBreakPosition() const

Returns the strategy for whether a row of text should be broken before or after it exceeds the ideal length.

If stacking is turned on, label placement can insert a line break before or after the word that overruns the maximum number of characters per row. Using the LabelStackBreakPosition::Before option means rows will generally be shorter than the stackRowLength (although will overrun for individual words larger than this count).

The default is LabelStackBreakPosition::Automatic (which will have the same effect on labels as LabelStackBreakPosition::After).

This property has no effect if stackStrategy is LabelStackStrategy::None.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also setStackBreakPosition().

[since Esri::ArcGISRuntime 100.11] double LabelDefinition::stackRowLength() const

Returns a value that limits the number of characters in a row of stacked text.

This length guides the decision on when to break long text strings into separate rows. The line break will be inserted between words, not in the middle of a word, so rows may be longer or shorter than the ideal. Depending on stackBreakPosition, the break may be inserted before the breaking word, or after.

The default value is -1. This means that a default length of 13 characters is currently used.

This property has no effect if stackStrategy is LabelStackStrategy::None.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also setStackRowLength().

[since Esri::ArcGISRuntime 100.11] Esri::ArcGISRuntime::LabelStackSeparatorListModel *LabelDefinition::stackSeparators() const

Returns the stack separators that should be used for automatic line breaking of label text.

Each LabelStackSeparator specifies a code point to be looked for in the text. A code point is often thought of as a single character in the text, but may need several chars in a QString to describe it. So each LabelStackSeparator::separator is a QString intended to describe one code point.

For example:

• To use a comma as a separator, the {Esri::ArcGISRuntime::LabelStackSeparator::separator} {LabelStackSeparator::separator} string would be just ",".
• To use a Hebrew punctuation Paseq as a separator, the LabelStackSeparator::separator would need to encode the code point with utf16 value "\u05c0" or with the utf8 string "\x30\x35\x63\x30".
• To use higher range unicode code points such as Aegean Word Separator Dot( which has utf32 hex value 10101), the l {Esri::ArcGISRuntime::LabelStackSeparator::separator} {LabelStackSeparator::separator} would need to encode the code point with utf16 value "\ud800\udd01".

If it is found, then the LabelStackSeparator also specifies whether:

• the text should always be broken here
• the separator code point should remain visible
• the separator code point should appear at the end of one row, or the beginning of the next.

Three default separators are provided: a comma, a space, and a hyphen. Custom separators can be added, and default separators can be removed if not required.

Note that a carriage-return (\n) in the label will always be considered a forced separator.

This property has no effect if stackStrategy is LabelStackStrategy::None.

This function was introduced in Esri::ArcGISRuntime 100.11.

[since Esri::ArcGISRuntime 100.11] Esri::ArcGISRuntime::LabelStackStrategy LabelDefinition::stackStrategy() const

Returns the strategy for whether the text should be stacked or wrapped, rather than placed as long trailing labels across the map.

This property controls whether stacking is allowed, not allowed, or should be calculated automatically based on feature type. The default is LabelStackStrategy::Automatic, meaning that stacking will be enabled for point and polygon features and disabled for line features.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also setStackStrategy().

[since Esri::ArcGISRuntime 100.11] Esri::ArcGISRuntime::LabelTextLayout LabelDefinition::textLayout() const

Returns the layout of the text, which can be horizontal, straight, or perpendicular, or follow the line feature.

Optional specification of whether, once the text is positioned, it should be written:

• horizontally
• straight (parallel) to the tangent to the line feature
• straight in line with the point feature positioning angle
• perpendicular to the tangent or positioning angle
• following the geometry of the line feature.

The default is LabelTextLayout::Automatic, which will be interpreted as:

• LabelTextLayout::Horizontal for labels attached to point features
• LabelTextLayout::FollowFeature for labels attached to line features
• LabelTextLayout::Horizontal for labels attached to polygon features.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also setTextLayout().

[since Esri::ArcGISRuntime 100.11] Esri::ArcGISRuntime::LabelTextOrientation LabelDefinition::textOrientation() const

Returns the orientation of the text, which can be either angle direction or screen-oriented.

Optional specification of whether text should follow the placement angle direction even if it means being rendered upside-down, or whether text should be flipped through 180 degrees to keep it screen-oriented. This setting will take effect whenever the feature geometry determines that the text is angled upside-down, or if the map is rotated within the screen to make the text upside-down (with respect to the screen).

The default is LabelTextOrientation::Automatic, which is interpreted as LabelTextOrientation::Screen.

Not supported by 3D scenes.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also setTextOrientation().

[since Esri::ArcGISRuntime 100.11] Esri::ArcGISRuntime::TextSymbol *LabelDefinition::textSymbol() const

Returns the text symbol, which describes the overall appearance of label text (for example, font and size).

If no textSymbol has been set, then no labels can be created. If no textSymbol has been set, then no labels can be created.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also setTextSymbol().

[override virtual] QString LabelDefinition::toJson() const

Reimplements: JsonSerializable::toJson() const.

Returns this LabelDefinition instance represented as a JSON String.

See also JsonSerializable.

[override virtual] QJsonObject LabelDefinition::unknownJson() const

Reimplements: JsonSerializable::unknownJson() const.

Returns the unknown data from the source JSON.

Unknown JSON is a dictionary of values not defined in the ArcGIS specification used to create this object but found in the source JSON. If the object is written back to JSON, any unknown JSON data is not persisted. The ArcGIS specification may be for a web map, web scene, REST API, and so on.

See also JsonSerializable.

[override virtual] QJsonObject LabelDefinition::unsupportedJson() const

Reimplements: JsonSerializable::unsupportedJson() const.

Returns the unsupported data from the source JSON.

Unsupported JSON is a dictionary of values defined in the ArcGIS specification used to create this object but not currently used in this API. If the object is written back to JSON, any unsupported JSON data is persisted. The ArcGIS specification may be from a web map, web scene, REST API, and so on.

See also JsonSerializable.

[since Esri::ArcGISRuntime 100.11] QString LabelDefinition::whereClause() const

Returns an SQL where clause expression that limits the set of features for which labels will be generated and placed.

This is an SQL where clause that can refer to the attributes of the feature e.g.:

• "" (no limitations)
• "NAME LIKE 'A%'" (Only label features with NAME attribute values starting with 'A')
• "(LENGTH > CAPACITY) and (TYPE = 1)" (Only label features whose attributes satisfy the SQL condition).

The default value is "" - which will allow all features in the data source and extent to be labeled.

This function was introduced in Esri::ArcGISRuntime 100.11.

See also setWhereClause().