Skip to main content

Interface: GtcSetValueTouchButtonProps<S>

Defined in: workingtitle-instruments-g3000/html_ui/GTC/Components/TouchButton/GtcSetValueTouchButton.tsx:11

Component props for GtcSetValueTouchButton.

Extends

  • SetValueTouchButtonProps<S>

Type Parameters

Type Parameter
S extends MutableSubscribable<any>

Properties

children?

optional children: DisplayChildren[]

Defined in: sdk/components/FSComponent.ts:122

The children of the display component.

Inherited from

SetValueTouchButtonProps.children


class?

optional class: string | SubscribableSet<string>

Defined in: garminsdk/components/touchbutton/TouchButton.tsx:168

CSS class(es) to apply to the button's root element.

Inherited from

SetValueTouchButtonProps.class


dragThresholdPx?

optional dragThresholdPx: number

Defined in: garminsdk/components/touchbutton/TouchButton.tsx:156

The distance, in pixels, the mouse can click and drag before the pad begins to ignore mouse events. Ignored if inhibitOnDrag is false. Defaults to 40 pixels.

Inherited from

SetValueTouchButtonProps.dragThresholdPx


focusOnDrag?

optional focusOnDrag: boolean

Defined in: workingtitle-instruments-g3000/html_ui/GTC/Components/TouchButton/GtcSetValueTouchButton.tsx:16

Whether the pad should focus all mouse events when dragging, preventing them from bubbling up to any ancestors in the DOM tree. Defaults to true.

Overrides

SetValueTouchButtonProps.focusOnDrag


gtcOrientation?

optional gtcOrientation: GtcOrientation

Defined in: workingtitle-instruments-g3000/html_ui/GTC/Components/TouchButton/GtcSetValueTouchButton.tsx:34

The orientation of the button's parent GTC. Used to set the button's inhibit on drag threshold unless otherwise specified by the dragThresholdPx prop. Defaults to 'horizontal'.


inhibitOnDrag?

optional inhibitOnDrag: boolean

Defined in: garminsdk/components/touchbutton/TouchButton.tsx:150

Whether the button should stop responding to mouse events and instead forward them to its parent after clicking and dragging for a certain distance defined by dragThresholdPx along the axis defined by inhibitOnDragAxis. When mouse events are inhibited, the button cannot be primed or held. Defaults to false.

Inherited from

SetValueTouchButtonProps.inhibitOnDrag


inhibitOnDragAxis?

optional inhibitOnDragAxis: "both" | "x" | "y"

Defined in: garminsdk/components/touchbutton/TouchButton.tsx:162

The axis along which dragging will trigger the inhibit function. Ignored if inhibitOnDrag is false. Defaults to 'both'.

Inherited from

SetValueTouchButtonProps.inhibitOnDragAxis


isEnabled?

optional isEnabled: boolean | Subscribable<boolean>

Defined in: garminsdk/components/touchbutton/TouchButton.tsx:79

Whether the button is enabled, or a subscribable which provides it. Disabled buttons cannot be touched, primed, pressed, or held. Defaults to true.

Inherited from

SetValueTouchButtonProps.isEnabled


isHighlighted?

optional isHighlighted: boolean | Subscribable<boolean>

Defined in: garminsdk/components/touchbutton/TouchButton.tsx:82

Whether the button is highlighted, or a subscribable which provides it. Defaults to false.

Inherited from

SetValueTouchButtonProps.isHighlighted


isInList?

optional isInList: boolean

Defined in: workingtitle-instruments-g3000/html_ui/GTC/Components/TouchButton/GtcSetValueTouchButton.tsx:22

Whether the button is in a scrollable list. If true, will enable the inhibit on drag function unless otherwise specified by the inhibitOnDrag prop. Defaults to false.


isVisible?

optional isVisible: boolean | Subscribable<boolean>

Defined in: garminsdk/components/touchbutton/TouchButton.tsx:85

Whether the button is visible. Defaults to true.

Inherited from

SetValueTouchButtonProps.isVisible


label?

optional label: string | VNode | Subscribable<string>

Defined in: garminsdk/components/touchbutton/TouchButton.tsx:94

The label for the button. Can be defined as either a static string, a subscribable which provides the label string, or a VNode. If not defined, the button will not have a label.

If the label is defined as a VNode, all first-level DisplayComponents in the VNode tree will be destroyed when the button is destroyed.

Inherited from

SetValueTouchButtonProps.label


listScrollAxis?

optional listScrollAxis: "x" | "y"

Defined in: workingtitle-instruments-g3000/html_ui/GTC/Components/TouchButton/GtcSetValueTouchButton.tsx:28

The scroll axis of the button's parent list. Ignored if isInList is false. Sets the button's inhibit on drag axis unless otherwise specified by the inhibitOnDragAxis prop. Defaults to y.


onDestroy()?

optional onDestroy: () => void

Defined in: garminsdk/components/touchbutton/TouchButton.tsx:165

A callback function which will be called when the button is destroyed.

Returns

void

Inherited from

SetValueTouchButtonProps.onDestroy


onHoldEnded()?

optional onHoldEnded: <B>(button, state, setValue, totalHoldDuration, endReason) => void

Defined in: garminsdk/components/touchbutton/SetValueTouchButton.tsx:80

A function which is called when the button exits the held state.

Type Parameters

Type ParameterDefault type
B extends SetValueTouchButton<S>SetValueTouchButton<S>

Parameters

ParameterTypeDescription
buttonBThe button that was held.
stateSThe state that is bound to the button.
setValueSubscribableType<S>The value that the button sets.
totalHoldDurationnumberThe total amount of time, in milliseconds, that the button was held.
endReasonTouchButtonHoldEndReasonThe reason that the button exited the held state.

Returns

void

Inherited from

SetValueTouchButtonProps.onHoldEnded


onHoldStarted()?

optional onHoldStarted: <B>(button, state, setValue) => TouchButtonHoldAction

Defined in: garminsdk/components/touchbutton/SetValueTouchButton.tsx:49

A function which is called when the button enters the held state. If not defined, then the button will default to taking no specific action when it enters the held state.

Type Parameters

Type ParameterDefault type
B extends SetValueTouchButton<S>SetValueTouchButton<S>

Parameters

ParameterTypeDescription
buttonBThe button that is held.
stateSThe state that is bound to the button.
setValueSubscribableType<S>The value that the button sets.

Returns

TouchButtonHoldAction

The action to take. Ignored if the value is equal to TouchButtonHoldAction.EndHold.

Inherited from

SetValueTouchButtonProps.onHoldStarted


onHoldTick()?

optional onHoldTick: <B>(button, state, setValue, dt, totalTime, timeSinceLastPress) => TouchButtonHoldAction

Defined in: garminsdk/components/touchbutton/SetValueTouchButton.tsx:63

A function which is called every frame when the button is held. If not defined, then the button will default to taking no specific action with each frame tick.

Type Parameters

Type ParameterDefault type
B extends SetValueTouchButton<S>SetValueTouchButton<S>

Parameters

ParameterTypeDescription
buttonBThe button that is held.
stateSThe state that is bound to the button.
setValueSubscribableType<S>The value that the button sets.
dtnumberThe elapsed time, in milliseconds, since the previous frame.
totalTimenumberThe total amount of time, in milliseconds, that the button has been held.
timeSinceLastPressnumberThe amount of time, in milliseconds, that the button has been held since the last time the button was pressed as a tick action.

Returns

TouchButtonHoldAction

The action to take.

Inherited from

SetValueTouchButtonProps.onHoldTick


onPressed()?

optional onPressed: <B>(button, state, setValue, isHeld) => void

Defined in: garminsdk/components/touchbutton/SetValueTouchButton.tsx:39

A callback function which will be called when the button is pressed. If not defined, pressing the button will apply the button's set value to its bound state.

Type Parameters

Type ParameterDefault type
B extends SetValueTouchButton<S>SetValueTouchButton<S>

Parameters

ParameterTypeDescription
buttonBThe button that was pressed.
stateSThe state that is bound to the button.
setValueSubscribableType<S>The value that the button sets.
isHeldbooleanWhether the button was held when it was pressed.

Returns

void

Inherited from

SetValueTouchButtonProps.onPressed


onTouched()?

optional onTouched: <B>(button, state, setValue) => TouchButtonOnTouchedAction

Defined in: garminsdk/components/touchbutton/SetValueTouchButton.tsx:29

A callback function which will be called every time the button is touched (i.e. a mouse down event on the button is detected). If not defined, then the button will default to entering the primed state when touched.

Type Parameters

Type ParameterDefault type
B extends SetValueTouchButton<S>SetValueTouchButton<S>

Parameters

ParameterTypeDescription
buttonBThe button that was touched.
stateSThe state that is bound to the button.
setValueSubscribableType<S>The value that the button sets.

Returns

TouchButtonOnTouchedAction

The action to take as a result of the button being touched.

Inherited from

SetValueTouchButtonProps.onTouched


ref?

optional ref: NodeReference<any>

Defined in: sdk/components/FSComponent.ts:125

A reference to the display component.

Inherited from

SetValueTouchButtonProps.ref


setValue

setValue: SubscribableType<S> | Subscribable<SubscribableType<S>>

Defined in: garminsdk/components/touchbutton/SetValueTouchButton.tsx:19

A subscribable which provides the value that the button sets.

Inherited from

SetValueTouchButtonProps.setValue


state

state: S

Defined in: garminsdk/components/touchbutton/SetValueTouchButton.tsx:16

A mutable subscribable whose state will be bound to the button.

Inherited from

SetValueTouchButtonProps.state