Interface: GtcToggleTouchButtonProps<S>
Component props for GtcToggleTouchButton.
Type parameters
| Name | Type |
|---|---|
S | extends Subscribable<boolean> | MutableSubscribable<boolean> |
Hierarchy
ToggleTouchButtonProps<S>↳
GtcToggleTouchButtonProps
Properties
children
• Optional children: DisplayChildren[]
The children of the display component.
Inherited from
ToggleTouchButtonProps.children
Defined in
sdk/components/FSComponent.ts:122
class
• Optional class: string | SubscribableSet<string>
CSS class(es) to apply to the button's root element.
Inherited from
ToggleTouchButtonProps.class
Defined in
garminsdk/components/touchbutton/TouchButton.tsx:168
dragThresholdPx
• Optional dragThresholdPx: number
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
ToggleTouchButtonProps.dragThresholdPx
Defined in
garminsdk/components/touchbutton/TouchButton.tsx:156
focusOnDrag
• Optional focusOnDrag: boolean
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
ToggleTouchButtonProps.focusOnDrag
Defined in
workingtitle-instruments-g3000/html_ui/Pages/VCockpit/Instruments/NavSystems/WTG3000/GTC/Components/TouchButton/GtcToggleTouchButton.tsx:16
gtcOrientation
• Optional gtcOrientation: GtcOrientation
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'.
Defined in
workingtitle-instruments-g3000/html_ui/Pages/VCockpit/Instruments/NavSystems/WTG3000/GTC/Components/TouchButton/GtcToggleTouchButton.tsx:34
inhibitOnDrag
• Optional inhibitOnDrag: boolean
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
ToggleTouchButtonProps.inhibitOnDrag
Defined in
garminsdk/components/touchbutton/TouchButton.tsx:150
inhibitOnDragAxis
• Optional inhibitOnDragAxis: "both" | "x" | "y"
The axis along which dragging will trigger the inhibit function. Ignored if inhibitOnDrag is false.
Defaults to 'both'.
Inherited from
ToggleTouchButtonProps.inhibitOnDragAxis
Defined in
garminsdk/components/touchbutton/TouchButton.tsx:162
isEnabled
• Optional isEnabled: boolean | Subscribable<boolean>
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
ToggleTouchButtonProps.isEnabled
Defined in
garminsdk/components/touchbutton/TouchButton.tsx:79
isHighlighted
• Optional isHighlighted: boolean | Subscribable<boolean>
Whether the button is highlighted, or a subscribable which provides it. Defaults to false.
Inherited from
ToggleTouchButtonProps.isHighlighted
Defined in
garminsdk/components/touchbutton/TouchButton.tsx:82
isInList
• Optional isInList: boolean
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.
Defined in
workingtitle-instruments-g3000/html_ui/Pages/VCockpit/Instruments/NavSystems/WTG3000/GTC/Components/TouchButton/GtcToggleTouchButton.tsx:22
isVisible
• Optional isVisible: boolean | Subscribable<boolean>
Whether the button is visible. Defaults to true.
Inherited from
ToggleTouchButtonProps.isVisible
Defined in
garminsdk/components/touchbutton/TouchButton.tsx:85
label
• Optional label: string | VNode | Subscribable<string>
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
ToggleTouchButtonProps.label
Defined in
garminsdk/components/touchbutton/TouchButton.tsx:94
listScrollAxis
• Optional listScrollAxis: "x" | "y"
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.
Defined in
workingtitle-instruments-g3000/html_ui/Pages/VCockpit/Instruments/NavSystems/WTG3000/GTC/Components/TouchButton/GtcToggleTouchButton.tsx:28
onDestroy
• Optional onDestroy: () => void
A callback function which will be called when the button is destroyed.
Type declaration
▸ (): void
A callback function which will be called when the button is destroyed.
Returns
void
Inherited from
ToggleTouchButtonProps.onDestroy
Defined in
garminsdk/components/touchbutton/TouchButton.tsx:165
onHoldEnded
• Optional onHoldEnded: <B>(button: B, state: S, totalHoldDuration: number, endReason: TouchButtonHoldEndReason) => void
A function which is called when the button exits the held state.
Param
The button that was held.
Param
The state that is bound to the button.
Param
The total amount of time, in milliseconds, that the button was held.
Param
The reason that the button exited the held state.
Type declaration
▸ <B>(button, state, totalHoldDuration, endReason): void
A function which is called when the button exits the held state.
Type parameters
| Name | Type |
|---|---|
B | extends ToggleTouchButton<S> = ToggleTouchButton<S> |
Parameters
| Name | Type | Description |
|---|---|---|
button | B | The button that was held. |
state | S | The state that is bound to the button. |
totalHoldDuration | number | The total amount of time, in milliseconds, that the button was held. |
endReason | TouchButtonHoldEndReason | The reason that the button exited the held state. |
Returns
void
Inherited from
ToggleTouchButtonProps.onHoldEnded
Defined in
garminsdk/components/touchbutton/ToggleTouchButton.tsx:68
onHoldStarted
• Optional onHoldStarted: <B>(button: B, state: S) => TouchButtonHoldAction
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.
Param
The button that is held.
Param
The state that is bound to the button.
Type declaration
▸ <B>(button, state): TouchButtonHoldAction
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
| Name | Type |
|---|---|
B | extends ToggleTouchButton<S> = ToggleTouchButton<S> |
Parameters
| Name | Type | Description |
|---|---|---|
button | B | The button that is held. |
state | S | The state that is bound to the button. |
Returns
TouchButtonHoldAction
The action to take. Ignored if the value is equal to TouchButtonHoldAction.EndHold.
Inherited from
ToggleTouchButtonProps.onHoldStarted
Defined in
garminsdk/components/touchbutton/ToggleTouchButton.tsx:40
onHoldTick
• Optional onHoldTick: <B>(button: B, state: S, dt: number, totalTime: number, timeSinceLastPress: number) => TouchButtonHoldAction
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.
Param
The button that is held.
Param
The state that is bound to the button.
Param
The elapsed time, in milliseconds, since the previous frame.
Param
The total amount of time, in milliseconds, that the button has been held.
Param
The amount of time, in milliseconds, that the button has been held since the last time the button was pressed as a tick action.
Type declaration
▸ <B>(button, state, dt, totalTime, timeSinceLastPress): TouchButtonHoldAction
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
| Name | Type |
|---|---|
B | extends ToggleTouchButton<S> = ToggleTouchButton<S> |
Parameters
| Name | Type | Description |
|---|---|---|
button | B | The button that is held. |
state | S | The state that is bound to the button. |
dt | number | The elapsed time, in milliseconds, since the previous frame. |
totalTime | number | The total amount of time, in milliseconds, that the button has been held. |
timeSinceLastPress | number | The 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
ToggleTouchButtonProps.onHoldTick
Defined in
garminsdk/components/touchbutton/ToggleTouchButton.tsx:53
onPressed
• Optional onPressed: <B>(button: B, state: S, isHeld: boolean) => void
A callback function which will be called when the button is pressed. If not defined, pressing the button will toggle its bound state if the state is mutable.
Param
The button that was pressed.
Param
The state that is bound to the button.
Param
Whether the button was held when it was pressed.
Type declaration
▸ <B>(button, state, isHeld): void
A callback function which will be called when the button is pressed. If not defined, pressing the button will toggle its bound state if the state is mutable.
Type parameters
| Name | Type |
|---|---|
B | extends ToggleTouchButton<S> = ToggleTouchButton<S> |
Parameters
| Name | Type | Description |
|---|---|---|
button | B | The button that was pressed. |
state | S | The state that is bound to the button. |
isHeld | boolean | Whether the button was held when it was pressed. |
Returns
void
Inherited from
ToggleTouchButtonProps.onPressed
Defined in
garminsdk/components/touchbutton/ToggleTouchButton.tsx:31
onTouched
• Optional onTouched: <B>(button: B, state: S) => TouchButtonOnTouchedAction
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.
Param
The button that was touched.
Param
The state that is bound to the button.
Type declaration
▸ <B>(button, state): TouchButtonOnTouchedAction
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
| Name | Type |
|---|---|
B | extends ToggleTouchButton<S> = ToggleTouchButton<S> |
Parameters
| Name | Type | Description |
|---|---|---|
button | B | The button that was touched. |
state | S | The state that is bound to the button. |
Returns
TouchButtonOnTouchedAction
The action to take as a result of the button being touched.
Inherited from
ToggleTouchButtonProps.onTouched
Defined in
garminsdk/components/touchbutton/ToggleTouchButton.tsx:22
ref
• Optional ref: NodeReference<any>
A reference to the display component.
Inherited from
ToggleTouchButtonProps.ref
Defined in
sdk/components/FSComponent.ts:125
state
• state: S
A subscribable whose state will be bound to the button.
Inherited from
ToggleTouchButtonProps.state
Defined in
garminsdk/components/touchbutton/ToggleTouchButton.tsx:13