Clase wxTimePickerCtrl
Este control permite al usuario introducir la hora.
Jerarquía:
Es similar a wxDatePickerCtrl pero se utiliza para la selección de la hora, y no de la fecha. Los métodos GetValue() y SetValue() todavía funcionan con valores de tipo wxDateTime (porque wxWidgets no proporciona una clase sólo de tiempo), su parte de fecha es ignorada por este control.
Sólo está disponible si wxUSE_TIMEPICKCTRL tiene el valor 1.
Este control actualmente no tiene ninguna bandera de estilo específica.
Eventos emitidos por esta clase
Las siguientes macros manejadoras de eventos redirigen los eventos a manejadores de funciones miembro 'func' con prototipos como:
void handlerFuncName(wxDateEvent& event)
Macros para eventos emitidos por esta clase:
- EVT_TIME_CHANGED(id, func)
- Procesa un evento wxEVT_TIME_CHANGED, que se dispara cuando el usuario cambia la selección actual en el control.
Funciones miembro
wxTimePickerCtrl()
wxTimePickerCtrl::wxTimePickerCtrl()
Constructor por defecto.
wxTimePickerCtrl()
wxTimePickerCtrl::wxTimePickerCtrl( wxWindow * parent, wxWindowID id, const wxDateTime & dt = wxDefaultDateTime, const wxPoint & pos = wxDefaultPosition, const wxSize & size = wxDefaultSize, long style = wxTP_DEFAULT, const wxValidator & validator = wxDefaultValidator, const wxString & name = wxTimePickerCtrlNameStr )
Inicializa el objeto y llama a Create() con todos los parámetros.
Create()
bool wxTimePickerCtrl::Create( wxWindow * parent, wxWindowID id, const wxDateTime & dt = wxDefaultDateTime, const wxPoint & pos = wxDefaultPosition, const wxSize & size = wxDefaultSize, long style = wxTP_DEFAULT, const wxValidator & validator = wxDefaultValidator, const wxString & name = wxTimePickerCtrlNameStr )
Crea la ventana de control.
Este método sólo debe usarse para objetos creados usando el constructor por defecto.
Parámetros
- parent
- Ventana padre, no debe ser no nula.
- id
- El identificador del control.
- dt
- El valor inicial del control, si se utiliza una fecha inválida (como el valor por defecto), el control se establece a la hora actual.
- pos
- Posición inicial.
- size
- Tamaño inicial. Si se deja en el valor por defecto, el control elige su mejor tamaño utilizando una altura aproximadamente igual a la de un control de texto y una anchura lo suficientemente grande como para mostrar la hora completamente.
- style
- El estilo de la ventana, debe dejarse en 0 ya que no hay estilos especiales para este control en esta versión.
- validator
- Validador que puede utilizarse para comprobaciones adicionales.
- name
- Nombre del control.
Valor de retorno
true si el control fue creado con éxito o false si la creación falló.
GetTime()
bool wxTimePickerCtrl::GetTime( int * hour, int * min, int * sec ) const
Devuelve la hora introducida actualmente como horas, minutos y segundos.
Todos los argumentos deben ser no nulos, en caso contrario se devuelve false y no se modifica ninguno de ellos.
GetValue()
virtual wxDateTime wxTimePickerCtrl::GetValue() const
Devuelve la hora introducida actualmente.
La parte de fecha del objeto wxDateTime devuelto siempre se establece en la fecha actual y debe ignorarse, sólo la parte de hora es relevante.
SetTime()
bool wxTimePickerCtrl::SetTime( int hour, int min, int sec )
Cambia la hora actual del control.
La llamada a este método no produce un evento de cambio de hora.
Parámetros
- hour
- El nuevo valor de la hora en un intervalo de 0..23.
- min
- El nuevo valor de minutos en un intervalo de 0..59.
- sec
- El nuevo valor del segundo en un intervalo de 0..59.
Valor de retorno
true si se ha cambiado la hora o false en caso de fallo, por ejemplo, si los componentes de la hora no eran válidos.
SetValue()
virtual void wxTimePickerCtrl::SetValue(const wxDateTime & dt)
Cambia el valor actual del control.
La parte de fecha de dt se ignora, sólo la parte de hora se muestra en el control. Sin embargo, el objeto dt debe ser válido.
En particular, obérvese que es una mala idea utilizar el constructor por defecto wxDateTime a partir de los valores de horas, minutos y segundos, ya que utiliza la fecha de hoy para la parte de fecha, lo que significa que algunos valores pueden ser inválidos si hoy resulta ser el día del cambio de horario de verano. Por ejemplo, cuando se cambia al horario de verano, la hora 2:00 normalmente no existe ya que los relojes saltan directamente a las 3:00. Para evitar este problema, utilizar una fecha fija en la que se sepa que no va a cambiar el horario de verano (por ejemplo, 1 de enero de 2012) para la parte de la fecha del argumento o utilizar SetTime().
La llamada a este método no produce un evento de cambio de hora.
Métodos y datos heredados
Esta clase hereda los métodos y datos miembro públicos y protegidos de wxControl, wxWindow, wxEvtHandler y wxObject.