Skip to content

TextSelectionChangeCause

Inherits: Enum

Indicates what triggered the change in selected text.

Properties

  • DOUBLE_TAP –

    The user tapped twice in quick succession on the text and that caused the

  • 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

  • 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

  • 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

  • TOOLBAR –

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

  • UNKNOWN –

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

Properties#

DOUBLE_TAP = 'doubleTap' class-attribute instance-attribute #

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

DRAG = 'drag' class-attribute instance-attribute #

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

FORCE_PRESS = 'forcePress' class-attribute instance-attribute #

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

KEYBOARD = 'keyboard' class-attribute instance-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_PRESS = 'longPress' class-attribute instance-attribute #

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

SCRIBBLE = 'scribble' class-attribute instance-attribute #

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

TAP = 'tap' class-attribute instance-attribute #

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

TOOLBAR = 'toolbar' class-attribute instance-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.

UNKNOWN = 'unknown' class-attribute instance-attribute #

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