VNumberSpinBox

Hereda de: Widget.

Esta clase representa al control de edición de números con doble botón arriba/abajo.

Indice de propiedades

Boolean accelerated

const Boolean acceptableInput

Number alignment

Number buttonSymbols

const String cleanText

Number correctionMode

Number decimals

Boolean frame

Boolean keyboardTracking

Number maximum

Number minimum

String prefix

Boolean readOnly

Number singleStep

String specialValueText

String suffix

const String text

Number value

Boolean wrapping

Indice de funciones

Generales

void clear()

Boolean isLocalFormat()

void selectAll()

void setLocalFormat( Boolean set )

void setValue( Number val )

void stepDown()

void stepUp()

Señales

Value changed

Enumeraciones

Button symbols

  • UpDownArrows

  • PlusMinus

  • NoButtons

Correction mode

  • CorrectToPreviousValue

  • CorrectToNearestValue

Flags de alineamiento

  • AlignLeft = 0×0001

  • AlignRight = 0×0002

  • AlignHCenter = 0×0004

  • AlignJustify = 0×0008

  • AlignAbsolute = 0×0010

  • AlignTop = 0×0020

  • AlignBottom = 0×0040

  • AlignVCenter = 0×0080

  • AlignCenter = AlignVCenter | AlignHCenter

Documentación de propiedades

accelerated

Permite leer o configurar si está activada la aceleración en caso de mantener pulsados los botones arriba/abajo del microscroller.

acceptableInput

Devuelve true si la entrada cumple la validación actual del control.

alignment

Permite leer o configurar la alineación del contenido. Ver enum de flags de alineamiento. Los valores con combinables mediante el uso del operador bitwise or booleano "|".

buttonSymbols

Permite leer o configurar los símbolos a utilizar en los botones arriba/abajo del microscroller, por ejemplo (+/- ó flecha arriba/flecha abajo).

cleanText

Devuelve el texto del cuadro de número sin incluir el prefijo, sufijo o espacios en blanco iniciales o finales.

correctionMode

Permite leer o configurar si se aplicará corrección si existe un valor intermedio editado en el control.

decimals

Permite leer o configurar el número de decimales que se mostrarán en el control.

frame

Permite leer o configurar si el control será pintado con o sin frame.

keyboardTracking

Permite leer o configurar si el seguimiento de teclado está habilitado para el control. Si el seguimiento de teclado está activado (por defecto), el cuadro de número valueChanged emite la señal (), mientras que el nuevo valor se introduce desde el teclado. Por ejemplo cuando el usuario introduce el valor 600, escribiendo 6, 0, y 0, el cuadro de número 3 emite señales con los valores de 6, 60, y 600, respectivamente. Si el seguimiento de teclado está desactivado, el cuadro de número no emite la señal valueChanged () mientras se escribe. Emite la señal después, cuando la tecla es presionada, cuando el foco del teclado se pierde, o cuando la funcionalidad spinbox otro se utiliza por ejemplo, presionando una tecla de flecha.

maximum

Permite leer o configurar el valor máximo del control. Al establecer esta propiedad el mínimo se ajusta si es necesario, para asegurar que el rango sigue siendo válido. El valor máximo predeterminado es de 99.

minimum

Permite leer o configurar el valor mínimo del control. Al establecer esta propiedad la máxima se ajusta si es necesario para asegurar que el rango sigue siendo válido. El valor mínimo predeterminado es 0.

prefix

Permite leer o configurar el prefijo a visualizar en el control. El prefijo se antepone al inicio del valor mostrado. El uso típico es para mostrar una unidad de medida o un símbolo de moneda. Para desactivar la visualización de prefijo, establezca esta propiedad en una cadena vacía. El valor predeterminado es sin prefijo.

readOnly

Permite leer o configurar si el control es de sólo lectura.

singleStep

Permite leer o configurar el valor de paso. Cuando el usuario utiliza las flechas para cambiar el valor del control, éste será incrementado/decrementado en la cantidad especificada en esta propiedad. El valor predeterminado es 1. Establecer un valor menor de 0 no hace nada.

specialValueText

Permite leer o configurar si contiene el texto especial valor. Si se establece, el cuadro de selección mostrará este texto en lugar de un valor numérico siempre que el valor actual es igual al mínimo (). El uso típico es para indicar que esta elección tiene una especial (por defecto) que significa.

Por ejemplo, si su cuadro de selección permite al usuario elegir un factor de escala (o nivel de zoom) para la visualización de una imagen, y su aplicación es capaz de seleccionar automáticamente uno que permitirá a la imagen para que quepa completamente dentro de la ventana de visualización, puede configurar hasta la vuelta cuadro como este:

QSpinBox * zoomSpinBox = new QSpinBox;

zoomSpinBox- >> SetRange (0, 1000);

zoomSpinBox >> setSingleStep (10);

zoomSpinBox >> setSuffix ("%");

zoomSpinBox >> setSpecialValueText (tr ("Automático"));

zoomSpinBox >> setValue (100);

Después, el usuario podrá elegir una escala de 1% a 1000% o seleccione "Auto" para dejar a la solicitud de elegir. Su código se debe interpretar el valor de cuadro de número 0 como una petición por parte del usuario para escalar la imagen para que quepa en la ventana. Todos los valores se muestran con el prefijo y sufijo (si se define), excepto para el valor especial, que sólo muestra el texto de un valor especial. Este texto especial se pasa en la señal QSpinBox :: valueChanged () que pasa a un QString. Para desactivar la visualización de texto especial valor y llamar a esta función con una cadena vacía. El valor predeterminado es ningún texto especial valor, es decir, el valor numérico se muestra la forma habitual. Si no hay texto especial valor está establecido, specialValueText () devuelve una cadena vacía.

suffix

Permite leer o configurar el sufijo a visualizar en el control. El sufijo se añade al final del valor mostrado. El uso típico es para mostrar una unidad de medida o un símbolo de moneda. Para desactivar la visualización de sufijo, establezca esta propiedad en una cadena vacía. El valor predeterminado es sin sufijo.

text

Devuelve el texto del control, incluyendo el prefijo y el sufijo.

value

Permite leer o configurar el valor a mostrar en el control. setValue () emitirá una señal valueChanged si el nuevo valor es diferente de la anterior.

wrapping

Permite leer o configurar si el valor del control se comportará de modo circular. Esto sólo tiene sentido si se han especificado el valor mínimo y máximo para que el aumento de valor por encima del máximo lleve al valor mínimo y el decremento de valor por debajo del mínimo lleve al máximo.

Documentación de funciones

Funciones generales

void clear()

Limpia el contenido del control.

Boolean isLocalFormat()

Devuelve true si el contenido del control está siendo mostrado con el formato local configurado en el sistema.

void selectAll()

Selecciona todo el contenido del control.

void setLocalFormat( Boolean set )

Fija si el control aplicará el formato local configurado en el sistema o no.

Parámetros:

  • set: valor booleano. True=Se aplica formato local. False=No se aplica formato local.

void setValue( Number val )

Asigna el valor a mostrar en el control.

Parámetros:

  • val: valor numérico a asignar al control.

void stepDown()

Equivale a pulsar el botón flecha abajo del control que resta el valor configurado en la propiedad valor incremento, por defecto 1, al valor numérico del control.

void stepUp()

Equivale a pulsar el botón flecha arriba del control que suma el valor configurado en la propiedad valor incremento, por defecto 1, al valor numérico del control.

Ejemplo

Forzar el número de decimales de un control de edición numérica a 3

var formulario = theRoot.dataView();
var control = formulario.control("EDT_NUM");
control.decimals(3);