Abstract Class: AbstractUiNumberDialog<Input, Output, InputDef, P>
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:57
An abstract implementation of a UI dialog view which allows the user to select an arbitrary numeric value. The
dialog includes a 0-9 number pad and backspace button by default. Subclasses can register an arbitrary number of
NumberInput components. The different inputs may be used to allow the user to input numbers with different
formatting, number of digits, etc. However, only one input is active and visible at a time. Subclasses may also
choose to render additional dialog content by overriding the renderOtherNumberPadContents() and
renderOtherContents() methods.
Extends
Extended by
Type Parameters
| Type Parameter | Default type |
|---|---|
Input extends UiNumberDialogInput | UiNumberDialogInput |
Output | number |
InputDef extends UiNumberDialogInputDefinition | UiNumberDialogInputDefinition |
P extends UiViewProps | UiViewProps |
Implements
UiDialogView<Input,Output>
Constructors
Constructor
new AbstractUiNumberDialog<
Input,Output,InputDef,P>(props):AbstractUiNumberDialog<Input,Output,InputDef,P>
Defined in: src/sdk/components/FSComponent.ts:73
Creates an instance of a DisplayComponent.
Parameters
| Parameter | Type | Description |
|---|---|---|
props | P | The propertis of the component. |
Returns
AbstractUiNumberDialog<Input, Output, InputDef, P>
Inherited from
Properties
_knobLabelState
protectedreadonly_knobLabelState:FilteredMapSubject<UiKnobId,string>
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/UiSystem/AbstractUiView.ts:13
Inherited from
AbstractUiView._knobLabelState
activeInputDef?
protectedoptionalactiveInputDef:InputDef
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:80
backButtonImgSrc
protectedreadonlybackButtonImgSrc:Subject<string>
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:76
backButtonLabel
protectedreadonlybackButtonLabel:Subject<string>
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:75
backRef
protectedreadonlybackRef:NodeReference<ImgTouchButton>
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:69
backspaceRef
protectedreadonlybackspaceRef:NodeReference<ImgTouchButton>
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:68
context?
optionalcontext: [] =undefined
Defined in: src/sdk/components/FSComponent.ts:64
The context on this component, if any.
Inherited from
contextType?
readonlyoptionalcontextType: readonly [] =undefined
Defined in: src/sdk/components/FSComponent.ts:67
The type of context for this component, if any.
Inherited from
enterRef
protectedreadonlyenterRef:NodeReference<ImgTouchButton>
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:70
focusController
protectedreadonlyfocusController:UiFocusController
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/UiSystem/AbstractUiView.ts:17
Inherited from
AbstractUiView.focusController
inputContainerRef
protectedreadonlyinputContainerRef:NodeReference<HTMLDivElement>
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:66
inputDefinitions
protectedreadonlyinputDefinitions:Map<string,InputDef>
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:78
isAlive
protectedisAlive:boolean=true
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:87
isEnterButtonEnabled
protectedreadonlyisEnterButtonEnabled:Subject<boolean>
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:96
Whether the enter button is enabled.
knobLabelState
readonlyknobLabelState:SubscribableMap<UiKnobId,string> &Subscribable<UiKnobRequestedLabelState>
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/UiSystem/AbstractUiView.ts:15
The bezel rotary knob label state requested by this view.
Inherited from
numpadRef
protectedreadonlynumpadRef:NodeReference<NumberPad>
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:67
props
props:
P&ComponentProps
Defined in: src/sdk/components/FSComponent.ts:61
The properties of the component.
Inherited from
resolveFunction()?
protectedoptionalresolveFunction: (value) =>void
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:82
Parameters
| Parameter | Type |
|---|---|
value | any |
Returns
void
resultObject
protectedresultObject:UiDialogResult<Output>
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:83
rootCssClass
protectedreadonlyrootCssClass:SetSubject<string>
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:71
showDecimalButton
protectedreadonlyshowDecimalButton:Subject<boolean>
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:93
Whether the decimal button is shown. Defaults to false.
showSignButton
protectedreadonlyshowSignButton:Subject<boolean>
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:90
Whether the sign button is shown. Defaults to false.
title
protectedreadonlytitle:Subject<string>
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:73
Methods
cleanupRequest()
protectedcleanupRequest():void
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:326
Clears this dialog's pending request and fulfills the pending request Promise if one exists.
Returns
void
createFocusController()
protectedcreateFocusController():UiFocusController
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/UiSystem/AbstractUiView.ts:23
Creates a new focus controller for this view.
Returns
A new focus controller.
Inherited from
AbstractUiView.createFocusController
destroy()
destroy():
void
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:522
Destroys this component.
Returns
void
Overrides
getContext()
protectedgetContext(context):never
Defined in: src/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
getInvalidValueMessage()
abstractprotectedgetInvalidValueMessage(value,activeInputDef):string|VNode
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:304
Gets the message to display when attempting to return an invalid value.
Parameters
| Parameter | Type | Description |
|---|---|---|
value | number | The invalid value. |
activeInputDef | InputDef | The input definition used to generate the invalid value. |
Returns
string | VNode
The message to display when attempting to return an invalid value.
getInvalidValueMessageDialogLayerAndKey()
protectedgetInvalidValueMessageDialogLayerAndKey(): [UiViewStackLayer,string]
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:319
Gets the view stack layer and key of the message dialog to open to display the invalid value message.
Returns
[UiViewStackLayer, string]
The view stack layer and key of the message dialog to open to display the invalid value message, as
[layer, key].
getPayload()
abstractprotectedgetPayload(value,activeInputDef):Output
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:312
Gets the payload for a completed request.
Parameters
| Parameter | Type | Description |
|---|---|---|
value | number | The numeric value to return with the request. |
activeInputDef | InputDef | The active input definition at the time the request was completed. |
Returns
Output
The payload for a completed request.
getRootCssClassName()
abstractprotectedgetRootCssClassName():undefined|string
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:420
Gets the CSS class name (singular) for this dialog's root element.
Returns
undefined | string
The CSS class name (singular) for this dialog's root element.
isValueValid()
abstractprotectedisValueValid(value,activeInputDef):boolean
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:296
Checks if a value is valid to be returned for a request.
Parameters
| Parameter | Type | Description |
|---|---|---|
value | number | The value to check. |
activeInputDef | InputDef | The input definition used to generate the value to check. |
Returns
boolean
Whether the specified value is valid to be returned for a request.
onAfterRender()
onAfterRender():
void
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:116
A callback that is called after the component is rendered.
Returns
void
Overrides
onBackPressed()
protectedonBackPressed():void
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:376
Responds to when this dialog's back/cancel button is pressed.
Returns
void
onBackspacePressed()
protectedonBackspacePressed():void
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:369
Responds to when this dialog's backspace button is pressed.
Returns
void
onBeforeRender()
onBeforeRender():
void
Defined in: src/sdk/components/FSComponent.ts:80
A callback that is called before the component is rendered.
Returns
void
Inherited from
onCleanupRequest()
protectedonCleanupRequest():void
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:340
A callback method which is called when this dialog cleans up a request. This method is called before the pending request Promise is fulfilled, if one exists.
Returns
void
onClose()
onClose():
void
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:220
Responds to when this view is closed.
Returns
void
Overrides
onDecimalPressed()
protectedonDecimalPressed():void
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:362
Called when this dialog's decimal button is pressed.
Returns
void
onEditingActiveChanged()
protectedonEditingActiveChanged(isEditingActive,activeInputDef):void
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:140
Responds to when the editing state of this dialog's active number input changes.
Parameters
| Parameter | Type | Description |
|---|---|---|
isEditingActive | boolean | Whether editing is active. |
activeInputDef | InputDef | The active input definition. |
Returns
void
onEnterPressed()
protectedonEnterPressed():void
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:383
Responds to when this dialog's enter button is pressed.
Returns
void
onNumberPressed()
protectedonNumberPressed(value):void
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:348
Responds to when one of this dialog's number pad buttons is pressed.
Parameters
| Parameter | Type | Description |
|---|---|---|
value | number | The value of the button that was pressed. |
Returns
void
onOcclusionChange()
onOcclusionChange(
occlusionType):void
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/UiSystem/AbstractUiView.ts:56
Responds to when the occlusion type applied to this view changes while this view is open.
Parameters
| Parameter | Type | Description |
|---|---|---|
occlusionType | UiViewOcclusionType | The new occlusion type applied to this view. |
Returns
void
Inherited from
AbstractUiView.onOcclusionChange
onOpen()
onOpen(
sizeMode,dimensions):void
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/UiSystem/AbstractUiView.ts:29
Responds to when this view is opened.
Parameters
| Parameter | Type | Description |
|---|---|---|
sizeMode | UiViewSizeMode | The new size mode of this view's container. |
dimensions | ReadonlyFloat64Array | The new dimensions of this view's container, as [width, height] in pixels. |
Returns
void
Inherited from
onPause()
onPause():
void
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/UiSystem/AbstractUiView.ts:44
Responds to when this view is paused.
Returns
void
Inherited from
onRequest()
abstractprotectedonRequest(input):void
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:168
A callback method which is called when this dialog receives a request.
Parameters
| Parameter | Type | Description |
|---|---|---|
input | Input | The input for the request. |
Returns
void
onResize()
onResize(
sizeMode,dimensions):void
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/UiSystem/AbstractUiView.ts:50
Responds when this view's container is resized while it is open.
Parameters
| Parameter | Type | Description |
|---|---|---|
sizeMode | UiViewSizeMode | The new size mode of this view's container. |
dimensions | ReadonlyFloat64Array | The new dimensions of this view's container, as [width, height] in pixels. |
Returns
void
Inherited from
onResume()
onResume():
void
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:225
Responds to when this view is resumed.
Returns
void
Overrides
onSignPressed()
protectedonSignPressed():void
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:355
Called when this dialog's sign button is pressed.
Returns
void
onUiInteractionEvent()
onUiInteractionEvent(
event):boolean
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:230
Handles a UiInteractionEvent.
Parameters
| Parameter | Type | Description |
|---|---|---|
event | UiInteractionEvent | The event to handle. |
Returns
boolean
Whether the event was handled.
Overrides
AbstractUiView.onUiInteractionEvent
onUpdate()
onUpdate(
time):void
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/UiSystem/AbstractUiView.ts:62
Called every update cycle.
Parameters
| Parameter | Type | Description |
|---|---|---|
time | number | The current real (operating system) time, as a Javascript timestamp. |
Returns
void
Inherited from
registerInputDefinition()
protectedregisterInputDefinition(key,def):void
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:105
Registers an input definition with this dialog. Definitions must be registered before they are requested as the active input in order to function properly.
Parameters
| Parameter | Type | Description |
|---|---|---|
key | string | The key to register the definition under. If an existing definition is already registered under the same key, it will be replaced. |
def | InputDef | The definition to register. |
Returns
void
render()
render():
VNode
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:388
Renders the component.
Returns
A JSX element to be rendered.
Overrides
renderBackButton()
protectedrenderBackButton(ref,rootCssClassName):null|VNode
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:477
Renders this dialog's back/cancel button.
Parameters
| Parameter | Type | Description |
|---|---|---|
ref | NodeReference<DisplayComponent<any, []>> | The reference to which to assign the rendered button. |
rootCssClassName | undefined | string | The CSS class name for this dialog's root element. |
Returns
null | VNode
This dialog's back/cancel button, as a VNode, or null if this dialog does not have a backspace button.
renderBackspaceButton()
protectedrenderBackspaceButton(ref,rootCssClassName):null|VNode
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:459
Renders this dialog's backspace button.
Parameters
| Parameter | Type | Description |
|---|---|---|
ref | NodeReference<DisplayComponent<any, []>> | The reference to which to assign the rendered button. |
rootCssClassName | undefined | string | The CSS class name for this dialog's root element. |
Returns
null | VNode
This dialog's backspace button, as a VNode, or null if this dialog does not have a backspace button.
renderEnterButton()
protectedrenderEnterButton(ref,rootCssClassName):null|VNode
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:496
Renders this dialog's enter button.
Parameters
| Parameter | Type | Description |
|---|---|---|
ref | NodeReference<DisplayComponent<any, []>> | The reference to which to assign the rendered button. |
rootCssClassName | undefined | string | The CSS class name for this dialog's root element. |
Returns
null | VNode
This dialog's enter button, as a VNode, or null if this dialog does not have a backspace button.
renderInputToContainer()
protectedrenderInputToContainer(def):void
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:209
Renders one of this dialog's registered inputs to the input container.
Parameters
| Parameter | Type | Description |
|---|---|---|
def | InputDef | The definition for the input to render. |
Returns
void
renderNumberPad()
protectedrenderNumberPad(ref,rootCssClassName):VNode
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:428
Renders this dialog's number pad.
Parameters
| Parameter | Type | Description |
|---|---|---|
ref | NodeReference<NumberPad> | The reference to which to assign the rendered number pad. |
rootCssClassName | undefined | string | The CSS class name for this dialog's root element. |
Returns
This dialog's number pad, as a VNode.
renderOtherContents()
protectedrenderOtherContents(rootCssClassName):null|VNode
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:517
Renders additional contents in this dialog's root container.
Parameters
| Parameter | Type | Description |
|---|---|---|
rootCssClassName | undefined | string | The CSS class name for this dialog's root element. |
Returns
null | VNode
Additional contents in this dialog's root container, as a VNode, or null if there are no additional
contents.
renderOtherNumberPadContents()
protectedrenderOtherNumberPadContents(rootCssClassName):null|VNode
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:449
Renders additional contents in this dialog's number pad container.
Parameters
| Parameter | Type | Description |
|---|---|---|
rootCssClassName | undefined | string | The CSS class name for this dialog's root element. |
Returns
null | VNode
Additional contents in this dialog's number pad container, as a VNode, or null if there are no
additional contents.
request()
request(
input):Promise<UiDialogResult<Output>>
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:147
Requests a value from this dialog.
Parameters
| Parameter | Type | Description |
|---|---|---|
input | Input | Input parameters defining the request. |
Returns
Promise<UiDialogResult<Output>>
A Promise which is fulfilled with the result of the request. The result will indicate whether the request was cancelled, and if the request was not cancelled, it will also contain the requested value.
Implementation of
resetActiveInput()
protectedresetActiveInput(key?,initialValue?,resetEditing?):void
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:178
Resets the active input.
Parameters
| Parameter | Type | Default value | Description |
|---|---|---|---|
key? | string | undefined | The key of the input to set as the active input. Defaults to the key of the current active input. |
initialValue? | number | undefined | The initial value to set on the new active input. If not defined, the new active input will retain its current value. |
resetEditing? | boolean | false | Whether to reset the editing state of this dialog, in effect resetting the Back/Cancel button on the button bar to Back. Defaults to false. |
Returns
void
setBackButtonStyle()
protectedsetBackButtonStyle(style):void
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:124
Sets the style of this dialog's back/cancel button.
Parameters
| Parameter | Type | Description |
|---|---|---|
style | "cancel" | "back" | The style to set. |
Returns
void
validateValueAndClose()
protectedvalidateValueAndClose():Promise<void>
Defined in: src/workingtitle-instruments-g3x-touch/html_ui/MFD/Dialogs/AbstractUiNumberDialog.tsx:261
Validates the currently selected value, and if valid sets the value to be returned for the currently pending request and closes this dialog.
Returns
Promise<void>