SpinBox

public SpinBox();

Creates a numeric field with an internal LineEdit and button timer. Step = 1, Editable = true, UpdateOnTextChanged = false; Format is empty.

public HorizontalAlignment Alignment { get; set; }

Horizontal text alignment of the internal LineEdit, default Left. Does not move SpinBox within its parent layout.

public bool CustomArrowRound { get; set; }

Aligns button transitions to the CustomArrowStep grid rather than simply adding/subtracting, default false. Arrow increment must be compatible with Step or a transition can leave Value unchanged.

public double CustomArrowStep { get; set; }

Button increment: 0 uses Step; nonzero uses a custom increment. Does not replace Range snapping, so choose a compatible increment. Does not recalculate current Value.

public bool Editable { get; set; }

Allows user editing through the internal LineEdit and buttons, default true. Does not block programmatic Value or Apply.

public string Format { get; set; }

Single-value sprintf template for display outside editing. %s uses standard Step-aware text; %.2f displays two decimal places. Does not change Value; takes precedence over Prefix/Suffix. Invalid templates can display <Invalid>.

public Entity.AutoTranslateModeEnum FormatAutoTranslateMode { get; set; }

Automatic Format/PluralFormat translation: default Disabled, Always forces translation, Inherit respects entity translation. Does not itself add catalog translations.

public string PluralFormat { get; set; }

Plural-form template for Format translation. Requires nonempty Format and translation enabled through FormatAutoTranslateMode; selection uses Value and the translation catalog.

public string Prefix { get; set; }

Deprecated display prefix separated from the number by a space. Applies only with empty Format outside editing. Use Format for new code.

public bool SelectAllOnFocus { get; set; }

Select all text on focus, default false. Delegated to the internal LineEdit; toggling the setting does not request focus.

public string Suffix { get; set; }

Deprecated display suffix separated from the number by a space. Applies only with empty Format outside editing. Not part of numeric Value.

public bool UpdateOnTextChanged { get; set; }

Apply expressions through a deferred connection to the internal field’s TextChanged, default false. Programmatic LineEdit.Text writes do not emit that signal; use Apply.

public void Apply();

Parses current internal LineEdit text as a numeric expression and assigns the result to Value. Empty or syntactically invalid text preserves the previous number. Call after programmatic Text assignment; there is no Error/bool result.

public double GetCustomArrowStep();

Button increment: 0 uses Step; nonzero uses a custom increment. Does not replace Range snapping, so choose a compatible increment. Does not recalculate current Value.

public string GetFormat();

Single-value sprintf template for display outside editing. %s uses standard Step-aware text; %.2f displays two decimal places. Does not change Value; takes precedence over Prefix/Suffix. Invalid templates can display <Invalid>.

public Entity.AutoTranslateModeEnum GetFormatAutoTranslateMode();

Automatic Format/PluralFormat translation: default Disabled, Always forces translation, Inherit respects entity translation. Does not itself add catalog translations.

public HorizontalAlignment GetHorizontalAlignment();

Horizontal text alignment of the internal LineEdit, default Left. Does not move SpinBox within its parent layout.

public LineEdit GetLineEdit();

Returns the shared internal LineEdit owned by SpinBox. Do not free or reparent it. Text is editing text rather than guaranteed Value; use Apply for programmatic commitment.

public string GetPluralFormat();

Plural-form template for Format translation. Requires nonempty Format and translation enabled through FormatAutoTranslateMode; selection uses Value and the translation catalog.

public string GetPrefix();

Deprecated display prefix separated from the number by a space. Applies only with empty Format outside editing. Use Format for new code.

public string GetSuffix();

Deprecated display suffix separated from the number by a space. Applies only with empty Format outside editing. Not part of numeric Value.

public bool GetUpdateOnTextChanged();

Apply expressions through a deferred connection to the internal field’s TextChanged, default false. Programmatic LineEdit.Text writes do not emit that signal; use Apply.

public bool IsCustomArrowRounding();

Aligns button transitions to the CustomArrowStep grid rather than simply adding/subtracting, default false. Arrow increment must be compatible with Step or a transition can leave Value unchanged.

public bool IsEditable();

Allows user editing through the internal LineEdit and buttons, default true. Does not block programmatic Value or Apply.

public bool IsSelectAllOnFocus();

Select all text on focus, default false. Delegated to the internal LineEdit; toggling the setting does not request focus.

public void SetCustomArrowRound(bool round);

Aligns button transitions to the CustomArrowStep grid rather than simply adding/subtracting, default false. Arrow increment must be compatible with Step or a transition can leave Value unchanged.

public void SetCustomArrowStep(double arrowStep);

Button increment: 0 uses Step; nonzero uses a custom increment. Does not replace Range snapping, so choose a compatible increment. Does not recalculate current Value.

public void SetEditable(bool enabled);

Allows user editing through the internal LineEdit and buttons, default true. Does not block programmatic Value or Apply.

public void SetFormat(string format);

Single-value sprintf template for display outside editing. %s uses standard Step-aware text; %.2f displays two decimal places. Does not change Value; takes precedence over Prefix/Suffix. Invalid templates can display <Invalid>.

public void SetFormatAutoTranslateMode(Entity.AutoTranslateModeEnum mode);

Automatic Format/PluralFormat translation: default Disabled, Always forces translation, Inherit respects entity translation. Does not itself add catalog translations.

public void SetHorizontalAlignment(HorizontalAlignment alignment);

Horizontal text alignment of the internal LineEdit, default Left. Does not move SpinBox within its parent layout.

public void SetPluralFormat(string format);

Plural-form template for Format translation. Requires nonempty Format and translation enabled through FormatAutoTranslateMode; selection uses Value and the translation catalog.

public void SetPrefix(string prefix);

Deprecated display prefix separated from the number by a space. Applies only with empty Format outside editing. Use Format for new code.

public void SetSelectAllOnFocus(bool enabled);

Select all text on focus, default false. Delegated to the internal LineEdit; toggling the setting does not request focus.

public void SetSuffix(string suffix);

Deprecated display suffix separated from the number by a space. Applies only with empty Format outside editing. Not part of numeric Value.

public void SetUpdateOnTextChanged(bool enabled);

Apply expressions through a deferred connection to the internal field’s TextChanged, default false. Programmatic LineEdit.Text writes do not emit that signal; use Apply.