Abstract Class: WT21UiControl<P>
Defined in: workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:24
A component that forms the base of the WT21 UI control system.
Extends
HardwareUiControl
<GuiUiControlEvents
,P
>
Extended by
CheckBox
CheckBoxNumeric
CheckBoxSelect
FloatingRadioList
NumericInput
RadioBoxNumeric
RadioList
SelectInput
SubmenuLink
GuiDialog
Type Parameters
Type Parameter | Default type |
---|---|
P extends WT21UiControlProps | WT21UiControlProps |
Implements
UiControlEventHandlers
<GuiUiControlEvents
>
Constructors
Constructor
new WT21UiControl<
P
>(props
):WT21UiControl
<P
>
Defined in: sdk/components/controls/HardwareUiControl.tsx:155
Creates an instance of a HardwareUiControl.
Parameters
Parameter | Type | Description |
---|---|---|
props | P | The props for this component. |
Returns
WT21UiControl
<P
>
Inherited from
HardwareUiControl<GuiUiControlEvents, P>.constructor
Properties
context?
optional
context: [] =undefined
Defined in: sdk/components/FSComponent.ts:64
The context on this component, if any.
Inherited from
HardwareUiControl.context
contextType?
readonly
optional
contextType: readonly [] =undefined
Defined in: sdk/components/FSComponent.ts:67
The type of context for this component, if any.
Inherited from
HardwareUiControl.contextType
focusedIndex
protected
focusedIndex:number
=-1
Defined in: sdk/components/controls/HardwareUiControl.tsx:139
Inherited from
HardwareUiControl.focusedIndex
props
props:
P
&ComponentProps
Defined in: sdk/components/FSComponent.ts:61
The properties of the component.
Inherited from
HardwareUiControl.props
registeredControls
protected
registeredControls:undefined
|HardwareUiControl
<GuiUiControlEvents
,HardwareUiControlProps
>[]
Defined in: sdk/components/controls/HardwareUiControl.tsx:137
Inherited from
HardwareUiControl.registeredControls
FOCUS_CLASS
readonly
static
FOCUS_CLASS:"highlight"
='highlight'
Defined in: workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:28
Accessors
isDisabled
Get Signature
get isDisabled():
boolean
Defined in: sdk/components/controls/HardwareUiControl.tsx:177
Gets whether or not the control is currently disabled.
Returns
boolean
True if disabled, false otherwise.
Inherited from
HardwareUiControl.isDisabled
isFocused
Get Signature
get isFocused():
boolean
Defined in: sdk/components/controls/HardwareUiControl.tsx:185
Gets whether or not the control is currently focused.
Returns
boolean
True if disabled, false otherwise.
Inherited from
HardwareUiControl.isFocused
isIsolated
Get Signature
get isIsolated():
boolean
Defined in: sdk/components/controls/HardwareUiControl.tsx:193
Gets whether or not the control is currently in scroll isolation.
Returns
boolean
True if currently in scroll isolation, false otherwise.
Inherited from
HardwareUiControl.isIsolated
length
Get Signature
get length():
number
Defined in: sdk/components/controls/HardwareUiControl.tsx:165
Gets the current number of registered child controls.
Returns
number
The current number of registered child controls.
Inherited from
HardwareUiControl.length
Methods
blur()
blur():
void
Defined in: sdk/components/controls/HardwareUiControl.tsx:593
Blurs, or removes focus, from the component.
Returns
void
Inherited from
HardwareUiControl.blur
clearRegistered()
clearRegistered():
void
Defined in: sdk/components/controls/HardwareUiControl.tsx:793
Clears the list of registered components.
Returns
void
Inherited from
HardwareUiControl.clearRegistered
destroy()
destroy():
void
Defined in: sdk/components/controls/HardwareUiControl.tsx:923
Returns
void
Inherit Doc
Inherited from
HardwareUiControl.destroy
focus()
focus(
focusPosition
):boolean
Defined in: sdk/components/controls/HardwareUiControl.tsx:410
Brings focus to the control. Focusing the control will also blur the currently focused control, if any.
Parameters
Parameter | Type | Description |
---|---|---|
focusPosition | FocusPosition | The focus position to activate for descendents of this control. |
Returns
boolean
Whether this control was successfully focused.
Inherited from
HardwareUiControl.focus
getChild()
getChild(
index
):undefined
|HardwareUiControl
<GuiUiControlEvents
,HardwareUiControlProps
>
Defined in: sdk/components/controls/HardwareUiControl.tsx:859
Gets a child control at the specified index.
Parameters
Parameter | Type | Description |
---|---|---|
index | number | The index of the child control to get. |
Returns
undefined
| HardwareUiControl
<GuiUiControlEvents
, HardwareUiControlProps
>
The specified child control.
Inherited from
HardwareUiControl.getChild
getContext()
protected
getContext(context
):never
Defined in: sdk/components/FSComponent.ts:106
Gets a context data subscription from the context collection.
Parameters
Parameter | Type | Description |
---|---|---|
context | never | The context to get the subscription for. |
Returns
never
The requested context.
Throws
An error if no data for the specified context type could be found.
Inherited from
HardwareUiControl.getContext
getFocusedIndex()
getFocusedIndex():
number
Defined in: sdk/components/controls/HardwareUiControl.tsx:824
Gets the current focused index in the registered controls collection.
Returns
number
The index of the focused control in the collection of registered controls.
Inherited from
HardwareUiControl.getFocusedIndex
getFocusPositionOnScroll()
protected
getFocusPositionOnScroll(direction
):FocusPosition
Defined in: sdk/components/controls/HardwareUiControl.tsx:250
Gets the focus position to apply when this control is focused from a scroll.
Parameters
Parameter | Type | Description |
---|---|---|
direction | ScrollDirection | The direction of the scroll. |
Returns
FocusPosition
The focus position to apply when this control is focused from a scroll.
Inherited from
HardwareUiControl.getFocusPositionOnScroll
getMostRecentFocusedIndex()
getMostRecentFocusedIndex():
number
Defined in: sdk/components/controls/HardwareUiControl.tsx:833
Gets the most recent focused index (including the current focused index, if one exists) in the registered controls collection.
Returns
number
The index of the most recently focused control in the collection of registered controls.
Inherited from
HardwareUiControl.getMostRecentFocusedIndex
indexOf()
indexOf(
child
):number
Defined in: sdk/components/controls/HardwareUiControl.tsx:873
Gets the index of a specified child control within the registered child controls collection.
Parameters
Parameter | Type | Description |
---|---|---|
child | HardwareUiControl <GuiUiControlEvents > | The child to get the index of. |
Returns
number
The index of the child, or -1 if not found.
Inherited from
HardwareUiControl.indexOf
onAfterRender()
onAfterRender(
thisNode
):void
Defined in: workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:31
Parameters
Parameter | Type |
---|---|
thisNode | VNode |
Returns
void
Inherit Doc
Overrides
HardwareUiControl.onAfterRender
onAfterScroll()
protected
onAfterScroll(control
,index
):void
Defined in: sdk/components/controls/HardwareUiControl.tsx:284
An event called when a scroll operation has completed.
Parameters
Parameter | Type | Description |
---|---|---|
control | HardwareUiControl <GuiUiControlEvents > | The control that was scrolled to. |
index | number | The index of the control in the collection of registered controls. |
Returns
void
Inherited from
HardwareUiControl.onAfterScroll
onBeforeRender()
onBeforeRender():
void
Defined in: sdk/components/FSComponent.ts:80
A callback that is called before the component is rendered.
Returns
void
Inherited from
HardwareUiControl.onBeforeRender
onBlurred()
protected
onBlurred(source
):void
Defined in: sdk/components/controls/HardwareUiControl.tsx:209
An event called when the control is blurred.
Parameters
Parameter | Type | Description |
---|---|---|
source | HardwareUiControl <GuiUiControlEvents > | The control that emitted this event. |
Returns
void
Inherited from
HardwareUiControl.onBlurred
onDisabled()
protected
onDisabled(source
):void
Defined in: sdk/components/controls/HardwareUiControl.tsx:225
An event called when the control is disabled.
Parameters
Parameter | Type | Description |
---|---|---|
source | HardwareUiControl <GuiUiControlEvents > | The control that emitted this event. |
Returns
void
Inherited from
HardwareUiControl.onDisabled
onEnabled()
protected
onEnabled(source
):void
Defined in: sdk/components/controls/HardwareUiControl.tsx:217
An event called when the control is enabled.
Parameters
Parameter | Type | Description |
---|---|---|
source | HardwareUiControl <GuiUiControlEvents > | The control that emitted this event. |
Returns
void
Inherited from
HardwareUiControl.onEnabled
onFocused()
protected
onFocused(source
):void
Defined in: sdk/components/controls/HardwareUiControl.tsx:201
An event called when the control receives focus.
Parameters
Parameter | Type | Description |
---|---|---|
source | HardwareUiControl <GuiUiControlEvents > | The control that emitted this event. |
Returns
void
Inherited from
HardwareUiControl.onFocused
onInteractionEvent()
onInteractionEvent(
evt
):boolean
Defined in: workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:40
Parameters
Parameter | Type |
---|---|
evt | GuiHEvent |
Returns
boolean
Inherit Doc
Overrides
HardwareUiControl.onInteractionEvent
onLowerKnobDec()
onLowerKnobDec(
source
):boolean
Defined in: workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:93
Handles GUI lower knob decrease events.
Parameters
Parameter | Type | Description |
---|---|---|
source | WT21UiControl | The source of the event. |
Returns
boolean
Whether the event was handled.
Implementation of
UiControlEventHandlers.onLowerKnobDec
onLowerKnobInc()
onLowerKnobInc(
source
):boolean
Defined in: workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:84
Handles GUI lower knob increase events.
Parameters
Parameter | Type | Description |
---|---|---|
source | WT21UiControl | The source of the event. |
Returns
boolean
Whether the event was handled.
Implementation of
UiControlEventHandlers.onLowerKnobInc
onLowerMenuPush()
onLowerMenuPush(
source
):boolean
Defined in: workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:152
Handles MFD LWR menu push events. (not implemented)
Parameters
Parameter | Type | Description |
---|---|---|
source | WT21UiControl | The source of the event. |
Returns
boolean
Whether the event was handled.
Implementation of
UiControlEventHandlers.onLowerMenuPush
onMfdEsc()
onMfdEsc(
source
):boolean
Defined in: workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:162
Handles MFD esc events. (not implemented)
Parameters
Parameter | Type | Description |
---|---|---|
source | WT21UiControl | The source of the event. |
Returns
boolean
Whether the event was handled.
Implementation of
UiControlEventHandlers.onMfdEsc
onPfdEsc()
onPfdEsc(
source
):boolean
Defined in: workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:132
Handles PFD esc events. (not implemented)
Parameters
Parameter | Type | Description |
---|---|---|
source | WT21UiControl | The source of the event. |
Returns
boolean
Whether the event was handled.
Implementation of
UiControlEventHandlers.onPfdEsc
onPfdMenuPush()
onPfdMenuPush(
source
):boolean
Defined in: workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:112
Handles PFD menu push events. (not implemented)
Parameters
Parameter | Type | Description |
---|---|---|
source | WT21UiControl | The source of the event. |
Returns
boolean
Whether the event was handled.
Implementation of
UiControlEventHandlers.onPfdMenuPush
onRefsMenuPush()
onRefsMenuPush(
source
):boolean
Defined in: workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:122
Handles REFS menu push events. (not implemented)
Parameters
Parameter | Type | Description |
---|---|---|
source | WT21UiControl | The source of the event. |
Returns
boolean
Whether the event was handled.
Implementation of
UiControlEventHandlers.onRefsMenuPush
onRegistered()
protected
onRegistered(source
):void
Defined in: sdk/components/controls/HardwareUiControl.tsx:233
An event called when a control is registered with this control.
Parameters
Parameter | Type | Description |
---|---|---|
source | HardwareUiControl <GuiUiControlEvents > | The control that emitted this event. |
Returns
void
Inherited from
HardwareUiControl.onRegistered
onScroll()
protected
onScroll(direction
):boolean
Defined in: sdk/components/controls/HardwareUiControl.tsx:263
An event called when the control is scrolled.
Parameters
Parameter | Type | Description |
---|---|---|
direction | ScrollDirection | The direction that is being requested to scroll. |
Returns
boolean
True if this control handled this event, false otherwise.
Inherited from
HardwareUiControl.onScroll
onSoftkey1L()
onSoftkey1L(
source
):boolean
Defined in: workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:169
Parameters
Parameter | Type |
---|---|
source | WT21UiControl |
Returns
boolean
Inherit Doc
Implementation of
UiControlEventHandlers.onSoftkey1L
onSoftkey1R()
onSoftkey1R(
source
):boolean
Defined in: workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:193
Parameters
Parameter | Type |
---|---|
source | WT21UiControl |
Returns
boolean
Inherit Doc
Implementation of
UiControlEventHandlers.onSoftkey1R
onSoftkey2L()
onSoftkey2L(
source
):boolean
Defined in: workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:175
Parameters
Parameter | Type |
---|---|
source | WT21UiControl |
Returns
boolean
Inherit Doc
Implementation of
UiControlEventHandlers.onSoftkey2L
onSoftkey2R()
onSoftkey2R(
source
):boolean
Defined in: workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:199
Parameters
Parameter | Type |
---|---|
source | WT21UiControl |
Returns
boolean
Inherit Doc
Implementation of
UiControlEventHandlers.onSoftkey2R
onSoftkey3L()
onSoftkey3L(
source
):boolean
Defined in: workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:181
Parameters
Parameter | Type |
---|---|
source | WT21UiControl |
Returns
boolean
Inherit Doc
Implementation of
UiControlEventHandlers.onSoftkey3L
onSoftkey3R()
onSoftkey3R(
source
):boolean
Defined in: workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:205
Parameters
Parameter | Type |
---|---|
source | WT21UiControl |
Returns
boolean
Inherit Doc
Implementation of
UiControlEventHandlers.onSoftkey3R
onSoftkey4L()
onSoftkey4L(
source
):boolean
Defined in: workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:187
Parameters
Parameter | Type |
---|---|
source | WT21UiControl |
Returns
boolean
Inherit Doc
Implementation of
UiControlEventHandlers.onSoftkey4L
onSoftkey4R()
onSoftkey4R(
source
):boolean
Defined in: workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:211
Parameters
Parameter | Type |
---|---|
source | WT21UiControl |
Returns
boolean
Inherit Doc
Implementation of
UiControlEventHandlers.onSoftkey4R
onUnregistered()
protected
onUnregistered(source
):void
Defined in: sdk/components/controls/HardwareUiControl.tsx:241
An event called when a control is unregistered from this control.
Parameters
Parameter | Type | Description |
---|---|---|
source | HardwareUiControl <GuiUiControlEvents > | The control that emitted this event. |
Returns
void
Inherited from
HardwareUiControl.onUnregistered
onUpperKnobDec()
onUpperKnobDec(
source
):boolean
Defined in: workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:75
Handles GUI upper knob decrease events.
Parameters
Parameter | Type | Description |
---|---|---|
source | WT21UiControl | The source of the event. |
Returns
boolean
Whether the event was handled.
Implementation of
UiControlEventHandlers.onUpperKnobDec
onUpperKnobInc()
onUpperKnobInc(
source
):boolean
Defined in: workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:66
Handles GUI upper knob increase events.
Parameters
Parameter | Type | Description |
---|---|---|
source | WT21UiControl | The source of the event. |
Returns
boolean
Whether the event was handled.
Implementation of
UiControlEventHandlers.onUpperKnobInc
onUpperKnobPush()
onUpperKnobPush(
source
):boolean
Defined in: workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:102
Handles upper knob push events.
Parameters
Parameter | Type | Description |
---|---|---|
source | WT21UiControl | The source of the event. |
Returns
boolean
Whether the event was handled.
Implementation of
UiControlEventHandlers.onUpperKnobPush
onUpperMenuPush()
onUpperMenuPush(
source
):boolean
Defined in: workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:142
Handles MFD UPR menu push events. (not implemented)
Parameters
Parameter | Type | Description |
---|---|---|
source | WT21UiControl | The source of the event. |
Returns
boolean
Whether the event was handled.
Implementation of
UiControlEventHandlers.onUpperMenuPush
reconcileChildBlur()
protected
reconcileChildBlur(index
,child
):number
|BlurReconciliation
Defined in: sdk/components/controls/HardwareUiControl.tsx:688
Reconciles the focus state of this control's children when this control is focused with no focused children after a child has been blurred.
Parameters
Parameter | Type | Description |
---|---|---|
index | number | The index of the child control that was blurred. If the child is no longer registered, then this is the index of the child prior to being unregistered. |
child | HardwareUiControl <GuiUiControlEvents > | The child control that was blurred. |
Returns
number
| BlurReconciliation
The index of the child control to focus.
Inherited from
HardwareUiControl.reconcileChildBlur
register()
register(
control
,index?
):void
Defined in: sdk/components/controls/HardwareUiControl.tsx:722
Registers a child control with this control.
Parameters
Parameter | Type | Description |
---|---|---|
control | HardwareUiControl <GuiUiControlEvents > | The control to register. |
index? | number | The index at which to register the control. If none is provided, the control will be registered at the end of the collection of child controls. |
Returns
void
Inherited from
HardwareUiControl.register
render()
render():
VNode
Defined in: sdk/components/controls/HardwareUiControl.tsx:916
Renders the control.
Returns
VNode
The component VNode.
Inherited from
HardwareUiControl.render
scroll()
scroll(
direction
):boolean
Defined in: sdk/components/controls/HardwareUiControl.tsx:293
Scrolls the currently focused control in the supplied direction.
Parameters
Parameter | Type | Description |
---|---|---|
direction | ScrollDirection | The direction that is being requested to scroll. |
Returns
boolean
True if propagation should be stopped, false otherwise.
Inherited from
HardwareUiControl.scroll
setDisabled()
setDisabled(
isDisabled
):void
Defined in: sdk/components/controls/HardwareUiControl.tsx:705
Sets the component to be disabled, removing the ability for the component to scroll. Setting a component to disabled will also blur the component and its children, if necessary.
Parameters
Parameter | Type | Description |
---|---|---|
isDisabled | boolean | Whether or not the component is disabled. |
Returns
void
Inherited from
HardwareUiControl.setDisabled
setFocusedIndex()
setFocusedIndex(
index
,focusPosition
):void
Defined in: sdk/components/controls/HardwareUiControl.tsx:843
Sets the current most recently focused child control index. If this control is focused and has children that have focus, this will also switch child focus to the new index.
Parameters
Parameter | Type | Default value | Description |
---|---|---|---|
index | number | undefined | The index of the child control to set most recent focus for. |
focusPosition | FocusPosition | FocusPosition.MostRecent | The focus position to focus the child for, if required. |
Returns
void
Inherited from
HardwareUiControl.setFocusedIndex
setIsolated()
setIsolated(
isolated
):void
Defined in: sdk/components/controls/HardwareUiControl.tsx:895
Sets whether or not this control is in scroll isolation. While scroll isolation is enabled, scroll events will not propagate to the control's parent when the control has focus.
Parameters
Parameter | Type | Description |
---|---|---|
isolated | boolean | Whether or not the control is isolated. |
Returns
void
Inherited from
HardwareUiControl.setIsolated
setParent()
setParent(
parent
):void
Defined in: sdk/components/controls/HardwareUiControl.tsx:885
Sets the parent of this control.
Parameters
Parameter | Type | Description |
---|---|---|
parent | HardwareUiControl <GuiUiControlEvents > | The parent to set. |
Returns
void
Inherited from
HardwareUiControl.setParent
triggerEvent()
triggerEvent(
event
,source
, ...args
):boolean
Defined in: sdk/components/controls/HardwareUiControl.tsx:348
Triggers an event on this control. The event will first be routed to the deepest focused descendent of this control and will propagate up the control tree until it is handled or there are no more controls to which to propagate.
Parameters
Parameter | Type | Description |
---|---|---|
event | GuiHEvent | The event to trigger. |
source | HardwareUiControl | The source of the event. Defaults to this if not supplied. |
...args | any [] | Additional arguments to pass to the event handler. |
Returns
boolean
True if the event was handled, false otherwise.
Inherited from
HardwareUiControl.triggerEvent
unregister()
unregister(
item
):void
Defined in: sdk/components/controls/HardwareUiControl.tsx:748
Unregisters a child control with this control.
Parameters
Parameter | Type | Description |
---|---|---|
item | number | HardwareUiControl <GuiUiControlEvents , HardwareUiControlProps > | The child control or index of a child control to unregister. If a child control is provided, it will attempt to be located in the control's child registry and then removed. If an index is provided, the child control at that registered index will be removed. |
Returns
void
Inherited from
HardwareUiControl.unregister