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 Parameter | Default type |
---|---|
B extends SetValueTouchButton <S > | SetValueTouchButton <S > |
Parameters
Parameter | Type | Description |
---|---|---|
button | B | The button that was held. |
state | S | The state that is bound to the button. |
setValue | SubscribableType <S > | The value that the button sets. |
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
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 Parameter | Default type |
---|---|
B extends SetValueTouchButton <S > | SetValueTouchButton <S > |
Parameters
Parameter | Type | Description |
---|---|---|
button | B | The button that is held. |
state | S | The state that is bound to the button. |
setValue | SubscribableType <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 Parameter | Default type |
---|---|
B extends SetValueTouchButton <S > | SetValueTouchButton <S > |
Parameters
Parameter | Type | Description |
---|---|---|
button | B | The button that is held. |
state | S | The state that is bound to the button. |
setValue | SubscribableType <S > | The value that the button sets. |
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
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 Parameter | Default type |
---|---|
B extends SetValueTouchButton <S > | SetValueTouchButton <S > |
Parameters
Parameter | Type | Description |
---|---|---|
button | B | The button that was pressed. |
state | S | The state that is bound to the button. |
setValue | SubscribableType <S > | The value that the button sets. |
isHeld | boolean | Whether 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 Parameter | Default type |
---|---|
B extends SetValueTouchButton <S > | SetValueTouchButton <S > |
Parameters
Parameter | Type | Description |
---|---|---|
button | B | The button that was touched. |
state | S | The state that is bound to the button. |
setValue | SubscribableType <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