Clase wxSpinCtrlDouble
wxSpinCtrlDouble combina wxTextCtrl y wxSpinButton en un control y muestra un número real.
(wxSpinCtrl muestra un número entero).
Jerarquía:
Estilos
Esta clase soporta los siguientes estilos:
- wxSP_ARROW_KEYS
- El usuario puede utilizar las teclas de flecha para cambiar el valor.
- wxSP_WRAP
- El valor se ajusta al mínimo y al máximo.
- wxTE_PROCESS_ENTER
- Indica que el control debe generar eventos wxEVT_TEXT_ENTER. El uso de este estilo evitará que el usuario utilice la tecla Intro para navegar por el diálogo (por ejemplo, activando el botón por defecto del diálogo) en MSW.
- wxALIGN_LEFT
- Igual que wxTE_LEFT para wxTextCtrl: el texto se alinea a la izquierda (por defecto).
- wxALIGN_CENTRE_HORIZONTAL
- Igual que wxTE_CENTRE para wxTextCtrl: el texto se centra.
- wxALIGN_RIGHT
- Igual que wxTE_RIGHT
- para wxTextCtrl: el texto se alinea a la derecha.
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(wxSpinDoubleEvent& event)
Macros de evento para eventos emitidos por esta clase:
- EVT_SPINCTRLDOUBLE(id, func)
- Se genera siempre que se cambia el valor numérico del control de giro, es decir, cuando se pulsa el botón de giro arriba/abajo, cuando se pulsa ENTER, o el control pierde el foco y el nuevo valor es diferente del último. Ver wxSpinDoubleEvent.
Funciones miembro
wxSpinCtrlDouble()
wxSpinCtrlDouble::wxSpinCtrlDouble()
Constructor por defecto.
wxSpinCtrlDouble()
wxSpinCtrlDouble::wxSpinCtrlDouble( wxWindow * parent, wxWindowID id = -1, const wxString & value = wxEmptyString, const wxPoint & pos = wxDefaultPosition, const wxSize & size = wxDefaultSize, long style = wxSP_ARROW_KEYS, double min = 0, double max = 100, double initial = 0, double inc = 1, const wxString & name = "wxSpinCtrlDouble" )
Constructor, crea y muestra un control de giro.
Si value no está vacío, se mostrará en la parte de entrada de texto del control y si tiene valor numérico, el valor numérico inicial del control, devuelto por GetValue() también será determinado por éste en lugar de por initial. Por lo tanto, solo tiene sentido especificar initial si value es una cadena vacía o no es convertible a un número, de lo contrario, initial simplemente se ignora y se utiliza el número especificado por value.
Parámetros
- parent
- Ventana padre. No debe ser nullptr.
- value
- Valor por defecto (como texto).
- id
- Identificador de la ventana. El valor wxID_ANY indica un valor por defecto.
- pos
- Posición de la ventana. Si se especifica wxDefaultPosition se elige una posición por defecto.
- size
- Tamaño de la ventana. Si se especifica wxDefaultSize se elige un tamaño por defecto.
- style
- Estilo de la ventana.
- min
- Valor mínimo.
- max
- Valor máximo.
- initial
- Valor inicial.
- inc
- Incrementa el valor.
- name
- Nombre de la ventana.
La precisión (número de dígitos después del punto decimal) del valor del control de giro se deriva de la precisión de inc. Si es necesario, la precisión por defecto puede ajustarse llamando a SetDigits().
Create()
bool wxSpinCtrlDouble::Create( wxWindow * parent, wxWindowID id = -1, const wxString & value = wxEmptyString, const wxPoint & pos = wxDefaultPosition, const wxSize & size = wxDefaultSize, long style = wxSP_ARROW_KEYS, double min = 0, double max = 100, double initial = 0, double inc = 1, const wxString & name = "wxSpinCtrlDouble" )
Función de creación llamada por el constructor del control de giro.
Ver wxSpinCtrlDouble() para más detalles.
GetDigits()
unsigned int wxSpinCtrlDouble::GetDigits() const
Obtiene la precisión del valor del control de giro.
GetIncrement()
double wxSpinCtrlDouble::GetIncrement() const
Obtiene el valor de incremento.
GetMax()
double wxSpinCtrlDouble::GetMax() const
Obtiene el valor máximo permitido.
GetMin()
double wxSpinCtrlDouble::GetMin() const
Obtiene el valor mínimo permitido.
GetTextValue()
wxString wxSpinCtrlDouble::GetTextValue() const
GetValue()
double wxSpinCtrlDouble::GetValue() const
Obtiene el valor del control de giro.
SetDigits()
void wxSpinCtrlDouble::SetDigits(unsigned int digits)
Establece la precisión del valor del control de giro.
Se permiten hasta 20 dígitos después del punto decimal.
SetIncrement()
void wxSpinCtrlDouble::SetIncrement(double inc)
Establece el valor del incremento.
El uso de este método cambia el número de dígitos utilizados por el control para que al menos coincida con el valor de inc, por ejemplo, utilizando el incremento de 0,01 establece el número de dígitos a 2 si antes había sido inferior a 2. Sin embargo, no cambia el número de dígitos si ya había sido lo suficientemente alto.
En cualquier caso, se puede llamar explícitamente a SetDigits() para anular la determinación automática del número de dígitos.
SetRange()
void wxSpinCtrlDouble::SetRange( double minVal, double maxVal )
Establece el rango de valores permitidos.
Nota. En wxQt minVal debe ser menor que maxVal.
SetValue()
virtual void wxSpinCtrlDouble::SetValue(const wxString & text)
Establece el valor del control de giro.
Se recomienda utilizar la sobrecarga que toma un valor double en su lugar. Si el texto no representa un número válido, puede que no se muestre en absoluto en la parte de texto del control (solo se garantiza el soporte de la cadena vacía en todas las plataformas) y el valor numérico se cambiará a GetMin().
Observar que, a diferencia de wxTextEntry::SetValue(), pero como la mayoría de los otros métodos de asignación en wxWidgets, llamar a este método no genera ningún evento ya que los eventos solo se generan para las acciones del usuario.
SetValue()
void wxSpinCtrlDouble::SetValue(double value)
Establece el valor del control de giro.
La llamada a este método no genera ningún evento wxEVT_SPINCTRLDOUBLE.
Métodos y datos heredados
Esta clase hereda los métodos y datos miembro públicos y protegidos de wxControl, wxWindow, wxEvtHandler y wxObject.