Clase wxKeyboardState
Proporciona métodos para comprobar el estado de las teclas modificadoras del teclado.
Jerarquía:
Esta clase se utiliza como clase base de wxKeyEvent y wxMouseState y, por tanto, indirectamente, de wxMouseEvent, por lo que sus métodos pueden utilizarse para obtener información sobre las teclas modificadoras que se pulsaron cuando se produjo el evento.
Esta clase se implementa completamente en línea en <wx/kbdstate.h> y por lo tanto no tiene requisitos de enlace.
Funciones miembro
wxKeyboardState()
wxKeyboardState::wxKeyboardState( bool controlDown = false, bool shiftDown = false, bool altDown = false, bool metaDown = false )
El constructor inicializa la configuración de las teclas modificadoras.
Por defecto, no hay modificadores activos.
AltDown()
bool wxKeyboardState::AltDown() const
Devuelve true si la tecla Alt está pulsada.
Hay que tener en cuenta que normalmente debería usarse GetModifiers() en lugar de ésta.
CmdDown()
bool wxKeyboardState::CmdDown() const
Devuelve true si se pulsa la tecla utilizada para los aceleradores de comandos.
Igual que ControlDown(). Obsoleto.
Hay que tener en cuenta que normalmente debería usarse GetModifiers() en lugar de ésta.
ControlDown()
bool wxKeyboardState::ControlDown() const
Devuelve verdadero si se pulsa la tecla Control o la tecla Apple/Comando en macOS.
Esta función no distingue entre teclas de control derecha e izquierda.
Hay que tener en cuenta que normalmente debería usarse GetModifiers() en lugar de ésta.
GetModifiers()
int wxKeyboardState::GetModifiers() const
Devuelve la máscara de bits de todas las teclas modificadoras pulsadas.
El valor devuelto es una combinación de las máscaras de bits wxMOD_ALT, wxMOD_CONTROL, wxMOD_SHIFT y wxMOD_META. Además, wxMOD_NONE se define como 0, es decir, corresponde a ningún modificador (ver HasAnyModifiers()) y wxMOD_CMD es wxMOD_CONTROL (MSW y Unix) o wxMOD_META (Mac), ver CmdDown(). Ver wxKeyModifier para la lista completa de modificadores.
Hay que tener en cuenta que esta función es más fácil de usar correctamente que, por ejemplo, ControlDown() porque al usar esta última también tiene que acordarse de comprobar que no se pulsa ninguno de los otros modificadores:
if ( ControlDown() && !AltDown() && !ShiftDown() && !MetaDown() )
... manejar Ctrl-XXX ...
y olvidarse de hacerlo puede dar lugar a graves errores en el programa (por ejemplo, que el programa no funcione con la distribución de teclado europea en la que se utiliza la tecla AltGr, que el programa ve como una combinación de CTRL y ALT). Por otro lado, se puede simplemente escribir:
if ( GetModifiers() == wxMOD_CONTROL )
... manejar Ctrl-XXX ...
con esta función.
HasAnyModifiers()
bool wxKeyboardState::HasAnyModifiers() const
Devuelve true si hay algún modificador pulsado.
Esto es equivalente a GetModifiers() != wxMOD_NONE.
Hay que tener en cuenta que esto es diferente del método HasModifiers() que no tiene en cuenta, por ejemplo, el modificador Shift. Este método es más adecuado para eventos de ratón cuando cualquier modificador, incluyendo Shift, puede cambiar la interpretación del evento.
HasModifiers()
bool wxKeyboardState::HasModifiers() const
Devuelve true si Control o Alt están pulsados.
Comprueba si están pulsadas las teclas Control, Alt o, sólo en macOS, Comando (hay que tener en cuenta que la tecla Control real también se tiene en cuenta en OS X).
Este método devuelve false si sólo se pulsa Shift por razones de compatibilidad y también porque pulsar Shift normalmente no cambia la interpretación de los eventos de tecla, ver HasAnyModifiers() si se quiere tener en cuenta Shift también.
MetaDown()
bool wxKeyboardState::MetaDown() const
Devuelve true si la tecla Meta/Windows/Apple está pulsada.
Esta función comprueba el estado de la tecla tradicionalmente llamada Meta en sistemas Unix, teclas de Windows en MSW. Hay que tener en cuenta que GetModifiers() debe usarse normalmente en lugar de ésta.
RawControlDown()
bool wxKeyboardState::RawControlDown() const
Devuelve true si la tecla Control (también en macOS).
Esta función no distingue entre teclas de control derecha e izquierda.
Hay que tener en cuenta que GetModifiers()debería usarse normalmente en lugar de esta.
SetAltDown()
void wxKeyboardState::SetAltDown(bool down)
SetControlDown()
void wxKeyboardState::SetControlDown(bool down)
SetMetaDown()
void wxKeyboardState::SetMetaDown(bool down)
SetRawControlDown()
void wxKeyboardState::SetRawControlDown(bool down)
SetShiftDown()
void wxKeyboardState::SetShiftDown(bool down)
ShiftDown()
bool wxKeyboardState::ShiftDown() const
Devuelve verdadero si se pulsa la tecla Mayús.
Esta función no distingue entre las teclas shift derecha e izquierda.
Hay que tener en cuenta que GetModifiers() debería usarse normalmente en lugar de esta.
Métodos y datos heredados
Esta clase hereda los métodos y datos miembro públicos y protegidos de wxKeyEvent, wxMouseEvent y wxMouseState