SelectionOptions SelectionOptions SelectionOptions SelectionOptions SelectionOptions Enum


Describes the options that apply to a selection.

This enumeration has a System.FlagsAttribute attribute that allows a bitwise combination of its member values.

public : enum class SelectionOptions
enum class winrt::Windows::UI::Text::SelectionOptions : uint32_t
public enum SelectionOptions
Public Enum SelectionOptions
var value =;
System.FlagsAttribute ContractVersionAttribute
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)


Active Active Active Active Active

The selection is active; that is, the text control has the input focus.

AtEndOfLine AtEndOfLine AtEndOfLine AtEndOfLine AtEndOfLine

For a degenerate selection (insertion point), the character position at the beginning of a line is the same as the character position at the end of the preceding line. As such, the character position is ambiguous. If this flag is 1, display the caret at the end of the preceding line; otherwise, display it at the beginning of the line.

Overtype Overtype Overtype Overtype Overtype

Insert/overtype mode is set to overtype.

Replace Replace Replace Replace Replace

Typing and pasting replaces the selection.

StartActive StartActive StartActive StartActive StartActive

The start position of the selection is the active end; that is, the end that is changed by pressing Shift+Right Arrow and Shift+Left Arrow.


Each option is binary, so if a particular option is not set, the text selection has the opposite option. For example, if the Overtype option is not set, the text selection is set to insert mode.

See Also