Skip to main content

Class: CheckBox

The CheckBox component.

Hierarchy

Constructors

constructor

new CheckBox(props): CheckBox

Creates an instance of a HardwareUiControl.

Parameters

NameTypeDescription
propsCheckBoxPropsThe props for this component.

Returns

CheckBox

Inherited from

WT21UiControl.constructor

Defined in

sdk/components/controls/HardwareUiControl.tsx:155

Properties

checkTextRef

Protected Readonly checkTextRef: NodeReference<HTMLDivElement>

Defined in

workingtitle-instruments-wt21/shared/Menus/Components/Checkbox.tsx:25


context

Optional context: [] = undefined

The context on this component, if any.

Inherited from

WT21UiControl.context

Defined in

sdk/components/FSComponent.ts:64


contextType

Optional Readonly contextType: readonly [] = undefined

The type of context for this component, if any.

Inherited from

WT21UiControl.contextType

Defined in

sdk/components/FSComponent.ts:67


el

Protected Readonly el: NodeReference<HTMLDivElement>

Defined in

workingtitle-instruments-wt21/shared/Menus/Components/Checkbox.tsx:23


focusedIndex

Protected focusedIndex: number = -1

Inherited from

WT21UiControl.focusedIndex

Defined in

sdk/components/controls/HardwareUiControl.tsx:139


inputRef

Protected Readonly inputRef: NodeReference<HTMLInputElement>

Defined in

workingtitle-instruments-wt21/shared/Menus/Components/Checkbox.tsx:24


props

props: CheckBoxProps & ComponentProps

The properties of the component.

Inherited from

WT21UiControl.props

Defined in

sdk/components/FSComponent.ts:61


registeredControls

Protected registeredControls: undefined | HardwareUiControl<GuiUiControlEvents, HardwareUiControlProps>[]

Inherited from

WT21UiControl.registeredControls

Defined in

sdk/components/controls/HardwareUiControl.tsx:137


FOCUS_CLASS

Static Readonly FOCUS_CLASS: "highlight"

Inherited from

WT21UiControl.FOCUS_CLASS

Defined in

workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:28

Accessors

isDisabled

get isDisabled(): boolean

Gets whether or not the control is currently disabled.

Returns

boolean

True if disabled, false otherwise.

Inherited from

WT21UiControl.isDisabled

Defined in

sdk/components/controls/HardwareUiControl.tsx:177


isFocused

get isFocused(): boolean

Gets whether or not the control is currently focused.

Returns

boolean

True if disabled, false otherwise.

Inherited from

WT21UiControl.isFocused

Defined in

sdk/components/controls/HardwareUiControl.tsx:185


isIsolated

get isIsolated(): boolean

Gets whether or not the control is currently in scroll isolation.

Returns

boolean

True if currently in scroll isolation, false otherwise.

Inherited from

WT21UiControl.isIsolated

Defined in

sdk/components/controls/HardwareUiControl.tsx:193


length

get length(): number

Gets the current number of registered child controls.

Returns

number

The current number of registered child controls.

Inherited from

WT21UiControl.length

Defined in

sdk/components/controls/HardwareUiControl.tsx:165

Methods

blur

blur(): void

Blurs, or removes focus, from the component.

Returns

void

Inherited from

WT21UiControl.blur

Defined in

sdk/components/controls/HardwareUiControl.tsx:593


clearRegistered

clearRegistered(): void

Clears the list of registered components.

Returns

void

Inherited from

WT21UiControl.clearRegistered

Defined in

sdk/components/controls/HardwareUiControl.tsx:793


destroy

destroy(): void

Returns

void

Inherit Doc

Inherited from

WT21UiControl.destroy

Defined in

sdk/components/controls/HardwareUiControl.tsx:923


focus

focus(focusPosition): boolean

Brings focus to the control. Focusing the control will also blur the currently focused control, if any.

Parameters

NameTypeDescription
focusPositionFocusPositionThe focus position to activate for descendents of this control.

Returns

boolean

Whether this control was successfully focused.

Inherited from

WT21UiControl.focus

Defined in

sdk/components/controls/HardwareUiControl.tsx:410


getChild

getChild(index): undefined | HardwareUiControl<GuiUiControlEvents, HardwareUiControlProps>

Gets a child control at the specified index.

Parameters

NameTypeDescription
indexnumberThe index of the child control to get.

Returns

undefined | HardwareUiControl<GuiUiControlEvents, HardwareUiControlProps>

The specified child control.

Inherited from

WT21UiControl.getChild

Defined in

sdk/components/controls/HardwareUiControl.tsx:859


getContext

getContext(context): never

Gets a context data subscription from the context collection.

Parameters

NameTypeDescription
contextneverThe 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

WT21UiControl.getContext

Defined in

sdk/components/FSComponent.ts:106


getFocusPositionOnScroll

getFocusPositionOnScroll(direction): FocusPosition

Gets the focus position to apply when this control is focused from a scroll.

Parameters

NameTypeDescription
directionScrollDirectionThe direction of the scroll.

Returns

FocusPosition

The focus position to apply when this control is focused from a scroll.

Inherited from

WT21UiControl.getFocusPositionOnScroll

Defined in

sdk/components/controls/HardwareUiControl.tsx:250


getFocusedIndex

getFocusedIndex(): number

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

WT21UiControl.getFocusedIndex

Defined in

sdk/components/controls/HardwareUiControl.tsx:824


getMostRecentFocusedIndex

getMostRecentFocusedIndex(): number

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

WT21UiControl.getMostRecentFocusedIndex

Defined in

sdk/components/controls/HardwareUiControl.tsx:833


indexOf

indexOf(child): number

Gets the index of a specified child control within the registered child controls collection.

Parameters

NameTypeDescription
childHardwareUiControl<GuiUiControlEvents, HardwareUiControlProps>The child to get the index of.

Returns

number

The index of the child, or -1 if not found.

Inherited from

WT21UiControl.indexOf

Defined in

sdk/components/controls/HardwareUiControl.tsx:873


onAfterRender

onAfterRender(thisNode): void

Parameters

NameType
thisNodeVNode

Returns

void

Inherit Doc

Overrides

WT21UiControl.onAfterRender

Defined in

workingtitle-instruments-wt21/shared/Menus/Components/Checkbox.tsx:59


onAfterScroll

onAfterScroll(control, index): void

An event called when a scroll operation has completed.

Parameters

NameTypeDescription
controlHardwareUiControl<GuiUiControlEvents, HardwareUiControlProps>The control that was scrolled to.
indexnumberThe index of the control in the collection of registered controls.

Returns

void

Inherited from

WT21UiControl.onAfterScroll

Defined in

sdk/components/controls/HardwareUiControl.tsx:284


onBeforeRender

onBeforeRender(): void

A callback that is called before the component is rendered.

Returns

void

Inherited from

WT21UiControl.onBeforeRender

Defined in

sdk/components/FSComponent.ts:80


onBlurred

onBlurred(): void

An event called when the control is blurred.

Returns

void

Overrides

WT21UiControl.onBlurred

Defined in

workingtitle-instruments-wt21/shared/Menus/Components/Checkbox.tsx:41


onDisabled

onDisabled(): void

An event called when the control is disabled.

Returns

void

Overrides

WT21UiControl.onDisabled

Defined in

workingtitle-instruments-wt21/shared/Menus/Components/Checkbox.tsx:46


onEnabled

onEnabled(): void

An event called when the control is enabled.

Returns

void

Overrides

WT21UiControl.onEnabled

Defined in

workingtitle-instruments-wt21/shared/Menus/Components/Checkbox.tsx:53


onFocused

onFocused(): void

An event called when the control receives focus.

Returns

void

Overrides

WT21UiControl.onFocused

Defined in

workingtitle-instruments-wt21/shared/Menus/Components/Checkbox.tsx:36


onInteractionEvent

onInteractionEvent(evt): boolean

Parameters

NameType
evtGuiHEvent

Returns

boolean

Inherit Doc

Inherited from

WT21UiControl.onInteractionEvent

Defined in

workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:40


onLowerKnobDec

onLowerKnobDec(source): boolean

Handles GUI lower knob decrease events.

Parameters

NameTypeDescription
sourceWT21UiControl<WT21UiControlProps>The source of the event.

Returns

boolean

Whether the event was handled.

Inherited from

WT21UiControl.onLowerKnobDec

Defined in

workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:93


onLowerKnobInc

onLowerKnobInc(source): boolean

Handles GUI lower knob increase events.

Parameters

NameTypeDescription
sourceWT21UiControl<WT21UiControlProps>The source of the event.

Returns

boolean

Whether the event was handled.

Inherited from

WT21UiControl.onLowerKnobInc

Defined in

workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:84


onLowerMenuPush

onLowerMenuPush(source): boolean

Handles MFD LWR menu push events. (not implemented)

Parameters

NameTypeDescription
sourceWT21UiControl<WT21UiControlProps>The source of the event.

Returns

boolean

Whether the event was handled.

Inherited from

WT21UiControl.onLowerMenuPush

Defined in

workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:152


onMfdEsc

onMfdEsc(source): boolean

Handles MFD esc events. (not implemented)

Parameters

NameTypeDescription
sourceWT21UiControl<WT21UiControlProps>The source of the event.

Returns

boolean

Whether the event was handled.

Inherited from

WT21UiControl.onMfdEsc

Defined in

workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:162


onPfdEsc

onPfdEsc(source): boolean

Handles PFD esc events. (not implemented)

Parameters

NameTypeDescription
sourceWT21UiControl<WT21UiControlProps>The source of the event.

Returns

boolean

Whether the event was handled.

Inherited from

WT21UiControl.onPfdEsc

Defined in

workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:132


onPfdMenuPush

onPfdMenuPush(source): boolean

Handles PFD menu push events. (not implemented)

Parameters

NameTypeDescription
sourceWT21UiControl<WT21UiControlProps>The source of the event.

Returns

boolean

Whether the event was handled.

Inherited from

WT21UiControl.onPfdMenuPush

Defined in

workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:112


onRefsMenuPush

onRefsMenuPush(source): boolean

Handles REFS menu push events. (not implemented)

Parameters

NameTypeDescription
sourceWT21UiControl<WT21UiControlProps>The source of the event.

Returns

boolean

Whether the event was handled.

Inherited from

WT21UiControl.onRefsMenuPush

Defined in

workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:122


onRegistered

onRegistered(source): void

An event called when a control is registered with this control.

Parameters

NameTypeDescription
sourceHardwareUiControl<GuiUiControlEvents, HardwareUiControlProps>The control that emitted this event.

Returns

void

Inherited from

WT21UiControl.onRegistered

Defined in

sdk/components/controls/HardwareUiControl.tsx:233


onScroll

onScroll(direction): boolean

An event called when the control is scrolled.

Parameters

NameTypeDescription
directionScrollDirectionThe direction that is being requested to scroll.

Returns

boolean

True if this control handled this event, false otherwise.

Inherited from

WT21UiControl.onScroll

Defined in

sdk/components/controls/HardwareUiControl.tsx:263


onSoftkey1L

onSoftkey1L(source): boolean

Parameters

NameType
sourceWT21UiControl<WT21UiControlProps>

Returns

boolean

Inherit Doc

Inherited from

WT21UiControl.onSoftkey1L

Defined in

workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:169


onSoftkey1R

onSoftkey1R(source): boolean

Parameters

NameType
sourceWT21UiControl<WT21UiControlProps>

Returns

boolean

Inherit Doc

Inherited from

WT21UiControl.onSoftkey1R

Defined in

workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:193


onSoftkey2L

onSoftkey2L(source): boolean

Parameters

NameType
sourceWT21UiControl<WT21UiControlProps>

Returns

boolean

Inherit Doc

Inherited from

WT21UiControl.onSoftkey2L

Defined in

workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:175


onSoftkey2R

onSoftkey2R(source): boolean

Parameters

NameType
sourceWT21UiControl<WT21UiControlProps>

Returns

boolean

Inherit Doc

Inherited from

WT21UiControl.onSoftkey2R

Defined in

workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:199


onSoftkey3L

onSoftkey3L(source): boolean

Parameters

NameType
sourceWT21UiControl<WT21UiControlProps>

Returns

boolean

Inherit Doc

Inherited from

WT21UiControl.onSoftkey3L

Defined in

workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:181


onSoftkey3R

onSoftkey3R(source): boolean

Parameters

NameType
sourceWT21UiControl<WT21UiControlProps>

Returns

boolean

Inherit Doc

Inherited from

WT21UiControl.onSoftkey3R

Defined in

workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:205


onSoftkey4L

onSoftkey4L(source): boolean

Parameters

NameType
sourceWT21UiControl<WT21UiControlProps>

Returns

boolean

Inherit Doc

Inherited from

WT21UiControl.onSoftkey4L

Defined in

workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:187


onSoftkey4R

onSoftkey4R(source): boolean

Parameters

NameType
sourceWT21UiControl<WT21UiControlProps>

Returns

boolean

Inherit Doc

Inherited from

WT21UiControl.onSoftkey4R

Defined in

workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:211


onUnregistered

onUnregistered(source): void

An event called when a control is unregistered from this control.

Parameters

NameTypeDescription
sourceHardwareUiControl<GuiUiControlEvents, HardwareUiControlProps>The control that emitted this event.

Returns

void

Inherited from

WT21UiControl.onUnregistered

Defined in

sdk/components/controls/HardwareUiControl.tsx:241


onUpperKnobDec

onUpperKnobDec(source): boolean

Handles GUI upper knob decrease events.

Parameters

NameTypeDescription
sourceWT21UiControl<WT21UiControlProps>The source of the event.

Returns

boolean

Whether the event was handled.

Inherited from

WT21UiControl.onUpperKnobDec

Defined in

workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:75


onUpperKnobInc

onUpperKnobInc(source): boolean

Handles GUI upper knob increase events.

Parameters

NameTypeDescription
sourceWT21UiControl<WT21UiControlProps>The source of the event.

Returns

boolean

Whether the event was handled.

Inherited from

WT21UiControl.onUpperKnobInc

Defined in

workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:66


onUpperKnobPush

onUpperKnobPush(): boolean

Handles upper knob push events.

Returns

boolean

Whether the event was handled.

Overrides

WT21UiControl.onUpperKnobPush

Defined in

workingtitle-instruments-wt21/shared/Menus/Components/Checkbox.tsx:28


onUpperMenuPush

onUpperMenuPush(source): boolean

Handles MFD UPR menu push events. (not implemented)

Parameters

NameTypeDescription
sourceWT21UiControl<WT21UiControlProps>The source of the event.

Returns

boolean

Whether the event was handled.

Inherited from

WT21UiControl.onUpperMenuPush

Defined in

workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:142


reconcileChildBlur

reconcileChildBlur(index, child): number | BlurReconciliation

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

NameTypeDescription
indexnumberThe 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.
childHardwareUiControl<GuiUiControlEvents, HardwareUiControlProps>The child control that was blurred.

Returns

number | BlurReconciliation

The index of the child control to focus.

Inherited from

WT21UiControl.reconcileChildBlur

Defined in

sdk/components/controls/HardwareUiControl.tsx:688


register

register(control, index?): void

Registers a child control with this control.

Parameters

NameTypeDescription
controlHardwareUiControl<GuiUiControlEvents, HardwareUiControlProps>The control to register.
index?numberThe 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

WT21UiControl.register

Defined in

sdk/components/controls/HardwareUiControl.tsx:722


render

render(): VNode

Renders the control.

Returns

VNode

The component VNode.

Overrides

WT21UiControl.render

Defined in

workingtitle-instruments-wt21/shared/Menus/Components/Checkbox.tsx:69


scroll

scroll(direction): boolean

Scrolls the currently focused control in the supplied direction.

Parameters

NameTypeDescription
directionScrollDirectionThe direction that is being requested to scroll.

Returns

boolean

True if propagation should be stopped, false otherwise.

Inherited from

WT21UiControl.scroll

Defined in

sdk/components/controls/HardwareUiControl.tsx:293


setDisabled

setDisabled(isDisabled): void

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

NameTypeDescription
isDisabledbooleanWhether or not the component is disabled.

Returns

void

Inherited from

WT21UiControl.setDisabled

Defined in

sdk/components/controls/HardwareUiControl.tsx:705


setFocusedIndex

setFocusedIndex(index, focusPosition?): void

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

NameTypeDefault valueDescription
indexnumberundefinedThe index of the child control to set most recent focus for.
focusPositionFocusPositionFocusPosition.MostRecentThe focus position to focus the child for, if required.

Returns

void

Inherited from

WT21UiControl.setFocusedIndex

Defined in

sdk/components/controls/HardwareUiControl.tsx:843


setIsolated

setIsolated(isolated): void

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

NameTypeDescription
isolatedbooleanWhether or not the control is isolated.

Returns

void

Inherited from

WT21UiControl.setIsolated

Defined in

sdk/components/controls/HardwareUiControl.tsx:895


setParent

setParent(parent): void

Sets the parent of this control.

Parameters

NameTypeDescription
parentHardwareUiControl<GuiUiControlEvents, HardwareUiControlProps>The parent to set.

Returns

void

Inherited from

WT21UiControl.setParent

Defined in

sdk/components/controls/HardwareUiControl.tsx:885


triggerEvent

triggerEvent(event, source, ...args): boolean

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

NameTypeDescription
eventGuiHEventThe event to trigger.
sourceHardwareUiControl<Record<string, any>, HardwareUiControlProps>The source of the event. Defaults to this if not supplied.
...argsany[]Additional arguments to pass to the event handler.

Returns

boolean

True if the event was handled, false otherwise.

Inherited from

WT21UiControl.triggerEvent

Defined in

sdk/components/controls/HardwareUiControl.tsx:348


unregister

unregister(item): void

Unregisters a child control with this control.

Parameters

NameTypeDescription
itemnumber | 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

WT21UiControl.unregister

Defined in

sdk/components/controls/HardwareUiControl.tsx:748