Skip to main content

TextSelectionChangeCause

Indicates what triggered the change in selected text.

Inherits: enum.Enum

Properties

  • DOUBLE_TAP - The user tapped twice in quick succession on the text and that caused the selection (or the location of the cursor) to change.
  • DRAG - The user used the mouse to change the selection by dragging over a piece of text.
  • FORCE_PRESS - The user force-pressed the text and that caused the selection (or the location of the cursor) to change.
  • KEYBOARD - The user used the keyboard to change the selection or the location of the cursor.
  • LONG_PRESS - The user long-pressed the text and that caused the selection (or the location of the cursor) to change.
  • SCRIBBLE - The user used iPadOS 14+ Scribble to change the selection.
  • TAP - The user tapped on the text and that caused the selection (or the location of the cursor) to change.
  • TOOLBAR - The user used the selection toolbar to change the selection or the location of the cursor.
  • UNKNOWN - The cause of the selection change is unknown or could not be determined.

Properties​

DOUBLE_TAPclass-attributeinstance-attribute​

The user tapped twice in quick succession on the text and that caused the selection (or the location of the cursor) to change.

DRAGclass-attributeinstance-attribute​

The user used the mouse to change the selection by dragging over a piece of text.

FORCE_PRESSclass-attributeinstance-attribute​

The user force-pressed the text and that caused the selection (or the location of the cursor) to change.

KEYBOARDclass-attributeinstance-attribute​

The user used the keyboard to change the selection or the location of the cursor.

Keyboard-triggered selection changes may be caused by the IME as well as by accessibility tools (e.g. TalkBack on Android).

LONG_PRESSclass-attributeinstance-attribute​

The user long-pressed the text and that caused the selection (or the location of the cursor) to change.

SCRIBBLEclass-attributeinstance-attribute​

The user used iPadOS 14+ Scribble to change the selection.

TAPclass-attributeinstance-attribute​

The user tapped on the text and that caused the selection (or the location of the cursor) to change.

TOOLBARclass-attributeinstance-attribute​

The user used the selection toolbar to change the selection or the location of the cursor.

An example is when the user taps on select all in the tool bar.

UNKNOWNclass-attributeinstance-attribute​

The cause of the selection change is unknown or could not be determined.