Show / Hide Table of Contents

Property StackSeparators

StackSeparators

Gets a collection of stack separators that should be used for automatic line breaking of label text.

Declaration
public IList<LabelStackSeparator> StackSeparators { get; }
Property Value
Type Description
System.Collections.Generic.IList<LabelStackSeparator>

A collection of stack separators that should be used for automatic line breaking of label text.

Remarks

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 System.String to describe it. So each Separator is a System.String intended to describe one code point.

For example:

  • To use a comma as a separator, the Separator string would be just ",".
  • To use a Hebrew punctuation Paseq as a separator, the Separator would need to encode the code point with utf16 value \u05c0.
  • To use higher range unicode code points such as Aegean Word Separator Dot which has utf32 hex value 10101, the 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.
  • Whether the separator code point should remain visible.
  • Whether 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 = None.

Applies to

Platforms and versions
TargetVersions
.NET Standard 2.0100.11 - 200.7
.NET100.13 - 200.7
.NET Windows100.13 - 200.7
.NET Android200.0 - 200.7
.NET iOS200.0 - 200.7
.NET Framework100.11 - 200.7
Xamarin.Android100.11 - 100.15
Xamarin.iOS100.11 - 100.15
UWP100.11 - 200.7
In This Article
Back to top Copyright © 2022 Esri.