Abstract Class: WT21UiControlList<T, P>

Defined in: workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:226

A list of WT21 UI controls.

Extends

• HardwareUiControlList<T, GuiUiControlEvents, P>

Type Parameters

Type Parameter	Default type
T	-
P extends WT21UiControlListProps<T>	WT21UiControlListProps<T>

Implements

• UiControlEventHandlers<GuiUiControlEvents>

Constructors

Constructor

new WT21UiControlList<T, P>(props): WT21UiControlList<T, P>

Defined in: sdk/components/controls/HardwareUiControlList.tsx:64

Creates an instance of a ControlList.

Parameters

Parameter	Type	Description
props	P	The props on the ControlList component.

Returns

WT21UiControlList<T, P>

Inherited from

HardwareUiControlList.constructor

Properties

context?

optional context: [] = undefined

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

The context on this component, if any.

Inherited from

HardwareUiControlList.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

HardwareUiControlList.contextType

---

focusedIndex

protected focusedIndex: number = -1

Defined in: sdk/components/controls/HardwareUiControl.tsx:139

Inherited from

HardwareUiControlList.focusedIndex

---

props

props: P & ComponentProps

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

The properties of the component.

Inherited from

HardwareUiControlList.props

---

registeredControls

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

Defined in: sdk/components/controls/HardwareUiControl.tsx:137

Inherited from

HardwareUiControlList.registeredControls

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

HardwareUiControlList.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

HardwareUiControlList.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

HardwareUiControlList.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

HardwareUiControlList.length

Methods

blur()

blur(): void

Defined in: sdk/components/controls/HardwareUiControl.tsx:593

Blurs, or removes focus, from the component.

Returns

void

Inherited from

HardwareUiControlList.blur

---

clearRegistered()

clearRegistered(): void

Defined in: sdk/components/controls/HardwareUiControl.tsx:793

Clears the list of registered components.

Returns

void

Inherited from

HardwareUiControlList.clearRegistered

---

destroy()

destroy(): void

Defined in: sdk/components/controls/HardwareUiControl.tsx:923

Destroys this component.

Returns

void

Inherited from

HardwareUiControlList.destroy

---

ensureIndexInView()

ensureIndexInView(index, pinDirection): void

Defined in: sdk/components/controls/HardwareUiControlList.tsx:385

Ensures an indexed list item is in view.

Parameters

Parameter	Type	Default value	Description
index	number	undefined	The index of the list item.
pinDirection	"top" | "none" | "bottom"	'none'	The end of the container which the element should be pinned to.

Returns

void

Inherited from

HardwareUiControlList.ensureIndexInView

---

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

HardwareUiControlList.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

HardwareUiControlList.getChild

---

getChildInstance()

getChildInstance<TControl>(index): null | TControl

Defined in: sdk/components/controls/HardwareUiControlList.tsx:446

Gets the instance of the node at the specified index.

Type Parameters

Type Parameter
TControl extends HardwareUiControl<GuiUiControlEvents, HardwareUiControlProps>

Parameters

Parameter	Type	Description
index	number	The index to get the instance for.

Returns

null | TControl

The node instance of specified type.

Inherited from

HardwareUiControlList.getChildInstance

---

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

HardwareUiControlList.getContext

---

getData()

getData(index): null | T

Defined in: sdk/components/controls/HardwareUiControlList.tsx:407

Gets the data object related to the selected DOM element.

Parameters

Parameter	Type	Description
index	number	The index of the data to get.

Returns

null | T

The selected item, if found.

Inherited from

HardwareUiControlList.getData

---

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

HardwareUiControlList.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

HardwareUiControlList.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

HardwareUiControlList.getMostRecentFocusedIndex

---

getSelectedElement()

getSelectedElement(): null | HTMLElement

Defined in: sdk/components/controls/HardwareUiControlList.tsx:425

Get the selected HTMLElement.

Returns

null | HTMLElement

The selected element, if found.

Inherited from

HardwareUiControlList.getSelectedElement

---

getSelectedIndex()

getSelectedIndex(): number

Defined in: sdk/components/controls/HardwareUiControlList.tsx:433

Gets the index of the currently selected element.

Returns

number

Selected element index. Returns -1 if nothing found.

Inherited from

HardwareUiControlList.getSelectedIndex

---

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

HardwareUiControlList.indexOf

---

onAfterRender()

onAfterRender(node): void

Defined in: sdk/components/controls/HardwareUiControlList.tsx:76

A callback that is called after the component is rendered.

Parameters

Parameter	Type	Description
node	VNode	The component's VNode.

Returns

void

Inherited from

HardwareUiControlList.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

HardwareUiControlList.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

HardwareUiControlList.onBeforeRender

---

onBlurred()

protected onBlurred(source): void

Defined in: sdk/components/controls/HardwareUiControlList.tsx:456

An event called when the control is blurred.

Parameters

Parameter	Type	Description
source	HardwareUiControl<GuiUiControlEvents, P>	The control that emitted this event.

Returns

void

Inherited from

HardwareUiControlList.onBlurred

---

onDataAdded()

protected onDataAdded(index, data): void

Defined in: sdk/components/controls/HardwareUiControlList.tsx:114

An event called when data is added to the subscription.

Parameters

Parameter	Type	Description
index	number	The index that the data was added at.
data	undefined | T | readonly T[]	The data that was added.

Returns

void

Inherited from

HardwareUiControlList.onDataAdded

---

onDataCleared()

protected onDataCleared(): void

Defined in: sdk/components/controls/HardwareUiControlList.tsx:210

An event called when the data is cleared in the subscription.

Returns

void

Inherited from

HardwareUiControlList.onDataCleared

---

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

HardwareUiControlList.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

HardwareUiControlList.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

HardwareUiControlList.onFocused

---

onInteractionEvent()

onInteractionEvent(evt): boolean

Defined in: workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:231

A method which is called when this control receives an interaction event.

Parameters

Parameter	Type	Description
evt	GuiHEvent	The event.

Returns

boolean

True if the event was handled, false otherwise.

Overrides

HardwareUiControlList.onInteractionEvent

---

onLowerKnobDec()

onLowerKnobDec(source): boolean

Defined in: workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:289

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:280

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:348

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:358

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:328

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:308

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:318

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

HardwareUiControlList.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

HardwareUiControlList.onScroll

---

onSoftkey1L()

onSoftkey1L(source): boolean

Defined in: workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:365

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:389

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:371

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:395

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:377

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:401

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:383

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:407

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

HardwareUiControlList.onUnregistered

---

onUpperKnobDec()

onUpperKnobDec(source): boolean

Defined in: workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:271

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:262

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:298

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:338

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

HardwareUiControlList.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

HardwareUiControlList.register

---

render()

render(): VNode

Defined in: sdk/components/controls/HardwareUiControlList.tsx:499

Renders the control.

Returns

VNode

The component VNode.

Inherited from

HardwareUiControlList.render

---

renderScrollbar()

protected renderScrollbar(): VNode

Defined in: workingtitle-instruments-wt21/shared/UI/WT21UiControl.tsx:253

Renders the control list scroll bar.

Returns

VNode

Overrides

HardwareUiControlList.renderScrollbar

---

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

HardwareUiControlList.scroll

---

scrollToIndex()

scrollToIndex(index, focusPosition): void

Defined in: sdk/components/controls/HardwareUiControlList.tsx:373

Scrolls to an item.

Parameters

Parameter	Type	Default value	Description
index	number	undefined	is the index of the list item to scroll to.
focusPosition	FocusPosition	FocusPosition.First	The focus position to apply to children of the item being scrolled to.

Returns

void

Inherited from

HardwareUiControlList.scrollToIndex

---

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

HardwareUiControlList.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

HardwareUiControlList.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

HardwareUiControlList.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

HardwareUiControlList.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

HardwareUiControlList.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

HardwareUiControlList.unregister

---

updateOrder()

updateOrder(): void

Defined in: sdk/components/controls/HardwareUiControlList.tsx:276

Updates the order of data items in the list by the props supplied comparison function, if one exists.

Returns

void

Inherited from

HardwareUiControlList.updateOrder