Skip to main content

Class: FrequencyInput

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/FrequencyInput/FrequencyInput.tsx:44

An input with a scrolling cursor which allows users to select a radio frequency.

Extends

Implements

Constructors

Constructor

new FrequencyInput(props): FrequencyInput

Defined in: src/sdk/components/FSComponent.ts:73

Creates an instance of a DisplayComponent.

Parameters

ParameterTypeDescription
propsFrequencyInputPropsThe propertis of the component.

Returns

FrequencyInput

Inherited from

DisplayComponent<FrequencyInputProps>.constructor

Properties

context?

optional context: [] = undefined

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

The context on this component, if any.

Inherited from

DisplayComponent.context


contextType?

readonly optional contextType: readonly [] = undefined

Defined in: src/sdk/components/FSComponent.ts:67

The type of context for this component, if any.

Inherited from

DisplayComponent.contextType


props

props: FrequencyInputProps & ComponentProps

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

The properties of the component.

Inherited from

DisplayComponent.props

Accessors

cursorPosition

Get Signature

get cursorPosition(): Subscribable<number>

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/FrequencyInput/FrequencyInput.tsx:124

The index of the character position currently selected by this input's cursor.

Returns

Subscribable<number>


isEditingActive

Get Signature

get isEditingActive(): Subscribable<boolean>

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/FrequencyInput/FrequencyInput.tsx:130

Whether editing is active for this input.

Returns

Subscribable<boolean>


isSelectionPerSlot

Get Signature

get isSelectionPerSlot(): Subscribable<boolean>

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/FrequencyInput/FrequencyInput.tsx:136

Whether this input's cursor selection mode is per-slot.

Returns

Subscribable<boolean>

Methods

activateEditing()

activateEditing(isSelectionPerSlot): void

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/FrequencyInput/FrequencyInput.tsx:281

Activates editing for this input.

Parameters

ParameterTypeDescription
isSelectionPerSlotbooleanWhether cursor selection should be initialized to per-slot mode. If false, cursor selection will be initialized to per-character mode instead.

Returns

void

Throws

Error if this input is not initialized.


backspace()

backspace(): void

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/FrequencyInput/FrequencyInput.tsx:408

Removes the character at the cursor's current position. If backfill is allowed, this will also shift all non-empty characters to the left of the cursor's current position one position to the right. If backfill is not allowed, this will shift the cursor one position to the left after the character is removed.

Returns

void

Throws

Error if this input is not initialized.


changeSlotValue()

changeSlotValue(direction): void

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/FrequencyInput/FrequencyInput.tsx:328

Increments or decrements the value of the slot currently selected by the cursor. If editing is not active, it will be activated instead of changing any slot value. If cursor selection is in per-character mode, it will be forced to per-slot mode. If the cursor is past the last slot, this method does nothing.

Parameters

ParameterTypeDescription
direction-1 | 1The direction in which to change the slot value (1 = increment, -1 = decrement).

Returns

void

Throws

Error if this input is not initialized.


deactivateEditing()

deactivateEditing(): void

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/FrequencyInput/FrequencyInput.tsx:295

Deactivates editing for this input.

Returns

void

Throws

Error if this input is not initialized.


destroy()

destroy(): void

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/FrequencyInput/FrequencyInput.tsx:724

Returns

void

Inherit Doc

Overrides

DisplayComponent.destroy


getContext()

protected getContext(context): never

Defined in: src/sdk/components/FSComponent.ts:106

Gets a context data subscription from the context collection.

Parameters

ParameterTypeDescription
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

DisplayComponent.getContext


isInitialized()

isInitialized(): boolean

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/FrequencyInput/FrequencyInput.tsx:241

Checks whether this input is initialized.

Returns

boolean

Whether this input is initialized.


moveCursor()

moveCursor(direction, forceSelectionPerSlot): void

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/FrequencyInput/FrequencyInput.tsx:311

Moves the cursor.

Parameters

ParameterTypeDescription
direction-1 | 1The direction in which to move (1 = to the right, -1 = to the left).
forceSelectionPerSlotbooleanWhether to force cursor selection to per slot mode.

Returns

void

Throws

Error if this input is not initialized.


onAfterRender()

onAfterRender(thisNode): void

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/FrequencyInput/FrequencyInput.tsx:145

Parameters

ParameterType
thisNodeVNode

Returns

void

Inherit Doc

Overrides

DisplayComponent.onAfterRender


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

DisplayComponent.onBeforeRender


onUiInteractionEvent()

onUiInteractionEvent(event): boolean

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/FrequencyInput/FrequencyInput.tsx:453

Handles a UiInteractionEvent.

Parameters

ParameterTypeDescription
eventUiInteractionEventThe event to handle.

Returns

boolean

Whether the event was handled.

Implementation of

UiInteractionHandler.onUiInteractionEvent


populateCharsFromValue()

populateCharsFromValue(): void

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/FrequencyInput/FrequencyInput.tsx:422

Populates all of this input's character positions with non-empty values, if possible, using this input's value digitizer function and the current composite value as a template.

Returns

void


refresh()

refresh(): void

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/FrequencyInput/FrequencyInput.tsx:430

Refreshes this input, updating the size and position of the cursor.

Returns

void


render()

render(): VNode

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/FrequencyInput/FrequencyInput.tsx:548

Returns

VNode

Inherit Doc

Overrides

DisplayComponent.render


setFrequency()

setFrequency(freq): number

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/FrequencyInput/FrequencyInput.tsx:254

Sets the frequency value of this slot. As part of the operation, all of this slot's characters will be set to non-null representations of the new slot value, if possible. The frequency value of this slot after the operation is complete may differ from the requested value depending on whether the requested value can be accurately represented by this slot.

Parameters

ParameterTypeDescription
freqnumberThe new frequency value, in hertz.

Returns

number

The frequency value of this input after the operation is complete.

Throws

Error if this input is not initialized.


setSlotCharacterValue()

setSlotCharacterValue(value): void

Defined in: src/workingtitle-instruments-g3x-touch/html_ui/Shared/Components/FrequencyInput/FrequencyInput.tsx:346

Sets the value of the slot character currently selected by the cursor. If editing is not active, it will be activated before setting the value. If cursor selection is in per-slot mode, it will be forced to per-character mode, and the first character of the slot will be selected before setting the value. If the cursor is past the last slot, this method does nothing.

Parameters

ParameterTypeDescription
valuestringThe value to set.

Returns

void

Throws

Error if this input is not initialized.