maxLibQt
maxLibQt::controls::MLHexSpinBox Class Reference

MLHexSpinBox allows editing integers using hexadecimal notation. More...

Inherits maxLibQt::controls::MLDoubleSpinBox.

Properties

int digits
 Number of digits expected, used in validator, input mask, and for zero-padding. More...
 
bool showPrefix
 Whether to show the "0x" prefix. More...
 
bool upperCase
 Whether to force upper-case formatting for letters. More...
 
bool zeroPad
 Whether to pad numbers with leading zeros up to digits length. More...
 
- Properties inherited from maxLibQt::controls::MLDoubleSpinBox
bool acceptableInput
 Indicates if input is valid (it would be nicer if the validator would expose an "isValid" prop/method!). More...
 
real botValue
 The effective minimum value. More...
 
int buttonRepeatDelay
 Milliseconds to delay before held +/- button repeat is activated. More...
 
int buttonRepeatInterval
 +/- button repeat interval while held (in milliseconds). More...
 
string cleanText
 Holds the text of the spin box excluding any prefix, suffix, or leading or trailing whitespace. More...
 
int decimals
 Desired precision. More...
 
string displayText
 
QtObject doubleValidator
 Default numeric validator, strictly enforces notation type, does not allow for custom inputMask with non-numeric components. More...
 
bool editable
 
double from
 
string inputMask
 Input mask for the text edit control (. More...
 
bool inputMethodComposing
 
int inputMethodHints
 
int notation
 For validator and text formatting. More...
 
int pageSteps
 How many steps in a "page" step (PAGE UP/DOWN keys or CTRL-Wheel). More...
 
string prefix
 Optional string to display before the value. More...
 
QtObject regExpValidator
 This is an experimental validator using a RegExp instead of numerical validation (which we do anyway). More...
 
bool selectByMouse
 Whether to allow selection of text (bound to the text editor of the spinbox control). More...
 
bool showGroupSeparator
 Whether to format numbers with the thousands separator visible (using current locale if useLocaleFormat is true). More...
 
SpinBox spinBoxItem
 The SpinBox item. More...
 
double stepSize
 
string suffix
 Optional string to display after the value. More...
 
Item textInputItem
 Use the "native" text editor of the SpinBox to preserve look/feel. If you use a custom SpinBox, you may need to set this property also. If defined, it must have a text property. More...
 
double to
 
real topValue
 The effective maximum value. More...
 
bool trimExtraZeros
 Whether to remove trailing zeros from decimals. More...
 
bool useLocaleFormat
 Whether to format numbers according to the current locale. More...
 
QtObject validator
 There are 2 validators available, see notes for each below. More...
 
double value
 
bool wrap
 

Public Member Functions

void textFromValue (value, locale)
 
void valueFromText (text, locale)
 
- Public Member Functions inherited from maxLibQt::controls::MLDoubleSpinBox
void decrease ()
 Decrement value by one stepSize. More...
 
void doubleValidationRegEx ()
 Return a RegExp object to validate numeric entry according to the current formatting & locale specs and accounting for any prefix/suffix. More...
 
void escapeInputMaskChars (string)
 Make string safe for use in Qt input mask as a literal. More...
 
void escapeRegExpChars (string)
 Make string safe for use in RegExp as a literal. More...
 
void getCleanText (text, locale)
 Return text stripped of any prefix or suffix and trimmed. More...
 
void increase ()
 Increment value by one stepSize. More...
 
bool setValue (real newValue, bool noWrap, bool notModified)
 Set the spin box value to newValue. More...
 
void stepBy (int steps, bool noWrap)
 Adjust value by number of steps. More...
 
void textFromValue (value, locale)
 Reimplimented from SpinBox. More...
 
void valueFromText (text, locale)
 Reimplimented from SpinBox. More...
 

Additional Inherited Members

- Signals inherited from maxLibQt::controls::MLDoubleSpinBox
void valueModified ()
 Mimic SpinBox API (interactive change only, NOT emitted if value property is set directly). More...
 

Detailed Description

MLHexSpinBox allows editing integers using hexadecimal notation.

Since
1.0

It uses MLDoubleSpinBox as the base class because this allows a wider range of values, including signed integers. The basic Controls 2 SpinBox is limited to signed int range only.

Individual property documentation can be found inline.

See also
MLDoubleSpinBox

Definition at line 41 of file MLHexSpinBox.qml.

Property Documentation

◆ digits

int maxLibQt::controls::MLHexSpinBox::digits

Number of digits expected, used in validator, input mask, and for zero-padding.

Default is based on maximum value.

Definition at line 46 of file MLHexSpinBox.qml.

◆ showPrefix

bool maxLibQt::controls::MLHexSpinBox::showPrefix

Whether to show the "0x" prefix.

Definition at line 45 of file MLHexSpinBox.qml.

◆ upperCase

bool maxLibQt::controls::MLHexSpinBox::upperCase

Whether to force upper-case formatting for letters.

Definition at line 43 of file MLHexSpinBox.qml.

◆ zeroPad

bool maxLibQt::controls::MLHexSpinBox::zeroPad

Whether to pad numbers with leading zeros up to digits length.

Definition at line 44 of file MLHexSpinBox.qml.

Member Function Documentation

◆ textFromValue()

void maxLibQt::controls::MLHexSpinBox::textFromValue ( value  ,
locale   
)

◆ valueFromText()

void maxLibQt::controls::MLHexSpinBox::valueFromText ( text  ,
locale   
)