VTimeEditBrowser
Hereda de: VAbstractBrowser.
Esta clase representa al control de edición de hora/minutos/segundos con doble botón arriba/abajo y botón de menú.
Esta clase implementa la misma funcionalidad que la clase VTimeEdit más las propiedades y funciones heredadas de la clase VAbstractBrowser.
Indice de propiedades
Boolean accelerated
const Boolean acceptableInput
Number alignment
Number buttonSymbols
Number correctionMode
Number currentSection
Number currentSectionIndex
const Number displayedSections
String displayFormat
Boolean frame
Boolean keyboardTracking
Time maximumTime
Time minimumTime
Boolean readOnly
const Number sectionCount
String specialValueText
const String text
Time time
Number timeSpec
Boolean wrapping
Indice de funciones
Generales
void clear()
void selectAll()
void setTime( Time time )
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
Flags de sección
NoSection = 0x0000
AmPmSection = 0x0001
MSecSection = 0x0002
SecondSection = 0x0004
MinuteSection = 0x0008
HourSection = 0x0010
DaySection = 0x0100
MonthSection = 0x0200
YearSection = 0x0400
Time spec
LocalTime
UTC
OffsetFromUTC
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).
correctionMode
Permite leer o configurar si se aplicará corrección si existe un valor intermedio editado en el control.
currentSection
Permite leer o configurar la sección actual del microscroller setCurrentSection(). Ver enum Section.
currentSectionIndex
Permite leer o configurar el índice de la sección actual del microscroller. Si el formato es "aaaa/MM/dd ', el displayText es '2001/05/21' y la posición del cursor es de 5 currentSectionIndex devuelve 1. Si la posición del cursor es 3 currentSectionIndex es 0, etc.
displayedSections
Permite leer los campos mostrados actualmente de la edición Fecha y Hora. Devuelve un conjunto de bits de las secciones que se muestran. Ver enum de flags de secciones. Los valores con combinables mediante el uso del operador bitwise or booleano "|".
displayFormat
Permite leer o configurar el formato utilizado para mostrar la fecha y la hora. Este formato es el mismo que el utilizado se describe en DateTime.toString() y DateTime.FromString()
Ejemplo de formato de cadenas (asumiendo que la fecha es 02 de julio 1969):
Formato de resultados
dd.mm.aaaa - 02.07.1969
MMM d aa - 02 de julio 69
MMMM d yy - 02 de julio 69
Tenga en cuenta que si especifica un año de dos dígitos, se interpreta que en el siglo en el que la edición de fecha y hora se ha inicializado. El valor predeterminado es el siglo 21 (2000-2099). Si se especifica un formato no válido el formato no se establecerá.
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.
maximumTime
Permite leer o configurar la hora máxima editable. Al establecer esta propiedad, el minimumTime se ajusta si es necesario para asegurar que el rango sigue siendo válido. Si la hora no es válida, esta función no hace nada. De forma predeterminada, esta propiedad posee un tiempo de 23:59:59 y 999 milisegundos.
minimumTime
Permite leer o configurar la hora mínima editable. Al establecer esta propiedad la maximumTime se ajusta si es necesario, para asegurar que el rango sigue siendo válido. Si la hora no es válida, esta función no hace nada. De forma predeterminada, esta propiedad posee un tiempo de 00:00:00 y 0 milisegundos.
readOnly
Permite leer o configurar si el control es de sólo lectura.
sectionCount
Devuelve el número de secciones que se muestran. Si el formato es "aaaa/aa/aaaa ', sectionCount devuelve 3.
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.
text
Devuelve el texto del control, incluyendo el prefijo y el sufijo.
time
Permite leer o configurar la hora del widget. De forma predeterminada, esta propiedad posee un tiempo de 00:00:00 y 0 milisegundos.
timeSpec
Devuelva la especificación de tiempo empleada. Ver enum TimeSpec.
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.
void selectAll()
Selecciona todo el contenido del control.
void setTime( Time time )
Asigna el valor de tipo hora al control.
Parámetros:
time: valor de tipo hora.
void stepDown()
Equivale a pulsar el botón abajo del microscroller lo que produce que el valor del dato seleccionado disminuya en una unidad.
void stepUp()
Equivale a pulsar el botón arriba del microscroller lo que produce que el valor del dato seleccionado aumente en una unidad.