Vixen
feb85697

ControlStrings

ui control Core/Vixen.Ui.Controls/ControlStrings.cs:39
csharp
public static class ControlStrings

Every word the standard control set says, declared once.

Read the guide page for this →

Remarks

The control library's own strings, in the same shape an application declares its own. Thirteen labels — fifteen, with the two dialog-button defaults that doc 46 § A3 recorded as owed to itself — were English literals baked into control constructors, which meant "Clear" in every search box, "Dismiss" on every toast and "Previous tab" on every docked group, inside every localised window, with no way for the application to reach them — and the only party who could close that seam was this repository.

⚠ One class for both control assemblies. Six of these are used from Vixen.Ui.Controls.Advanced, which references this assembly. A second declaration class over there would hand a translator two files to find and would put the boundary between "a control" and "an advanced control" — an assembly split about compile cost — into a translator's workflow, where it means nothing.

⚠ Two ids for the two "Close"s, deliberately. A dialog's dismiss button and a dock tab's are the same English word and are not the same string: a language that distinguishes closing a question from closing a document needs to say so, and an id that says where the string is used is what makes that possible. Merging them saves one line and cannot be undone without a translator's file changing shape.

⚠ A control reads these in its constructor, so it shows the language it was built in. That is not a live binding: Strings.Catalog is a signal and an expression that reads it re-runs, but an assignment in OnCreated is not an expression. A control set that re-labelled itself would need an effect per label and a place to dispose it; what this buys today is that the words are *translatable at all*, and that a control built after the language changed is built in the new one.

Fields and properties (61)

  • public static StringId TextInputClear

    The button that empties a text field.

  • public static StringId FieldRequired

    Why an empty field with Required set is not acceptable.

  • public static StringId FieldOutOfRange

    Why a number outside Minimum and Maximum is not acceptable.

  • public static StringId StepperIncrease

    A stepper's upward arrow.

  • public static StringId StepperDecrease

    A stepper's downward arrow.

  • public static StringId DialogClose

    The button that dismisses a dialog.

  • public static StringId DialogConfirm

    What a confirming button says when the caller does not name it.

  • public static StringId DialogCancel

    And what the button that backs out of it says.

  • public static StringId ToastDismiss

    The button that dismisses a toast.

  • public static StringId SelectSuggestions

    The toggle that opens a combo box's suggestion list.

  • public static StringId DockClose

    The button that closes a docked panel.

  • public static StringId DockPreviousTab

    The button that scrolls a tab strip back.

  • public static StringId DockNextTab

    The button that scrolls a tab strip on.

  • public static StringId PropertyGridReset

    The button that puts a property back to its default.

  • public static StringId PropertyGridSearch

    The prompt in a property grid's filter box.

  • public static StringId ColorPickerIntensity

    The caption over a colour picker's HDR intensity slider.

  • public static StringId ColorPickerEyedropper

    The eyedropper button.

  • public static StringId PaginationPrevious

    The arrow that steps a pager back.

  • public static StringId PaginationNext

    The arrow that steps a pager on.

  • public static StringId PaginationGap

    The mark a pager draws where it leaves pages out.

  • public static StringId TimelineMute

    What a screen reader calls a timeline track's mute toggle.

  • public static StringId TimelineMuteMark

    The one character a timeline track's mute toggle shows.

  • public static StringId CalendarPreviousMonth

    The arrow that shows a calendar's previous month.

  • public static StringId CalendarNextMonth

    The arrow that shows a calendar's next month.

  • public static StringId DatePickerDialog

    What a screen reader calls the calendar a date picker opens.

  • public static StringId ScrollBarVertical

    What a screen reader calls the bar down the side of a scrolling area.

  • public static StringId ScrollBarHorizontal
  • public static StringId ColorPickerHex

    The colour picker's hexadecimal field, which has no caption beside it.

  • public static StringId ColorPickerHue

    The hue band, which is a rainbow and has no words on it.

  • public static StringId ColorPickerAlpha

    The alpha band beneath it.

  • public static StringId ColorPickerField

    The two-dimensional square the marker moves in.

  • public static StringId ColorPickerPalette

    The row of saved colours under it.

  • public static StringId GradientEditorSpace

    The gradient editor's choice of how two stops are mixed.

  • public static StringId GradientEditorOpacity

    The gradient editor's opacity slider, shown when an alpha stop is chosen.

  • public static StringId GradientEditorColorStops

    The rail of colour stops under the bar.

  • public static StringId GradientEditorAlphaStops

    The rail of alpha stops over it.

  • public static StringId NodeCanvasNodes

    The set of nodes on a graph canvas.

  • public static StringId SplitViewDivider

    The bar between a split view's two panes.

  • public static StringId DocumentSavePrompt

    What the prompt on closing a dirty document asks.

  • public static StringId DocumentSave

    The prompt's confirming button.

  • public static StringId DocumentDiscard

    The button that throws the changes away.

  • public static StringId KeysFilter

    What the keybinding panel's filter box says when it is empty.

  • public static StringId KeysRecord

    Puts the keybinding panel into capture mode.

  • public static StringId KeysRecording

    What that button says while it is waiting.

  • public static StringId KeysClear

    Unbinds the selected command.

  • public static StringId KeysResetRow

    Puts one row back to the layer underneath.

  • public static StringId KeysResetAll

    Puts every row back.

  • public static StringId KeysImport

    Asks for a keymap file to be read in.

  • public static StringId KeysExport

    Asks for one to be written out.

  • public static StringId KeysColumnCommand

    The command column.

  • public static StringId KeysColumnCategory

    The category column.

  • public static StringId KeysColumnBinding

    The shortcut column.

  • public static StringId KeysColumnSource

    The column saying which layer a binding came from.

  • public static StringId KeysSourceDefault

    What that column says for a binding the application shipped.

  • public static StringId KeysSourceUser

    And for one the user made.

  • public static StringId KeysPickRow

    What the status line says with no row chosen.

  • public static StringId KeysReady

    And with one chosen.

  • public static StringId KeysWaiting

    And while it is waiting for one.

  • public static StringId KeysConflict

    What it says when the chord is taken.

  • public static StringId KeysUnknownPreset

    What it says when a keymap names a preset the application has not got.

  • public static IReadOnlyList<StringId> All

    Every string above, for a translator to start from.

Used by (43, showing 40)

  • ShellCloseTestsHelloUi.Tests
  • AccessibilityTreeTestsVixen.Ui.Controls.Tests
  • AccessibilityTreeTestsVixen.Ui.Controls.Advanced.Tests
  • AccessibleNameDomainTestsVixen.Ui.Controls.Advanced.Tests
  • AccessibleNameLocalisationTestsVixen.Ui.Controls.Tests
  • AccessibleNameLocalisationTestsVixen.Ui.Controls.Advanced.Tests
  • CalendarVixen.Ui.Controls
  • ColorFieldVixen.Ui.Controls.Advanced
  • ColorPickerVixen.Ui.Controls.Advanced
  • ColorPickerKeyboardTestsVixen.Ui.Controls.Advanced.Tests
  • ColorStripVixen.Ui.Controls.Advanced
  • ComboBoxVixen.Ui.Controls
  • DatePickerVixen.Ui.Controls
  • DatePickerTestsVixen.Ui.Controls.Tests
  • DialogVixen.Ui.Controls
  • DialogServiceVixen.Ui.Controls
  • DockGroupViewVixen.Ui.Controls.Advanced
  • DockTabVixen.Ui.Controls.Advanced
  • DocumentClosePromptVixen.Ui.Controls
  • DocumentClosePromptTestsVixen.Ui.Controls.Tests
  • FieldValidationTestsVixen.Ui.Controls.Tests
  • GradientEditorVixen.Ui.Controls.Advanced
  • GradientRailVixen.Ui.Controls.Advanced
  • GradientRailKeyboardTestsVixen.Ui.Controls.Advanced.Tests
  • KeyBindingsViewVixen.Ui.Controls.Advanced
  • KeyBindingsViewTestsVixen.Ui.Controls.Advanced.Tests
  • LocalisationTestsVixen.Ui.Controls.Tests
  • NodeCanvasVixen.Ui.Controls.Advanced
  • NumericInputVixen.Ui.Controls
  • PaginationVixen.Ui.Controls
  • PropertyGridVixen.Ui.Controls.Advanced
  • PropertyGridTestsVixen.Ui.Controls.Advanced.Tests
  • PropertyRowVixen.Ui.Controls.Advanced
  • ScrollBarVixen.Ui.Controls
  • SearchBoxVixen.Ui.Controls
  • SelectionTestsVixen.Ui.Controls.Tests
  • SplitViewVixen.Ui.Controls
  • StepperVixen.Ui.Controls
  • TextFieldVixen.Ui.Controls
  • TextFieldTestsVixen.Ui.Controls.Tests