MouseEvent QML Type (Uncreatable)
Proporciona información sobre un evento del ratón. Más...
| Import Statement: | import QtQuick |
Nota: Se trata de un tipo no creable. No se puede instanciar en QML.
Propiedades
- accepted : bool
- button : enumeration
- buttons : int
- flags : int
- modifiers : int
- wasHeld : bool
- x : real
- y : real
Descripción detallada
La posición del ratón se puede obtener mediante las propiedades « x » y « y ». El botón que ha provocado el evento se puede obtener mediante la propiedad « button ».
Véase también MouseArea.
Documentación de la propiedad
accepted : bool
Al establecer « accepted » en «true», se evita que el evento del ratón se propague a los elementos situados por debajo de este elemento.
Por lo general, si un elemento reacciona ante el evento del ratón, este debe aceptarse para que los elementos situados más abajo en el orden de superposición no respondan también al mismo evento.
button : enumeration [read-only]
Esta propiedad contiene el botón que provocó el evento. Puede ser uno de los siguientes:
buttons : int [read-only]
Esta propiedad contiene los botones del ratón que estaban pulsados en el momento en que se generó el evento. En el caso de los eventos de movimiento del ratón, se trata de todos los botones que están pulsados. En el caso de los eventos de pulsación y doble clic del ratón, incluye el botón que provocó el evento. En el caso de los eventos de suelta del ratón, excluye el botón que provocó el evento.
Contiene una combinación bit a bit de:
flags : int [read-only]
Esta propiedad contiene los indicadores que proporcionan información adicional sobre el evento del ratón.
- Qt.MouseEventCreatedDoubleClick - Indica que Qt ha creado un evento de doble clic a partir de este evento. Este indicador se establece en el evento originado por la pulsación de un botón, y no en el evento de doble clic resultante.
modifiers : int [read-only]
Esta propiedad contiene los indicadores de modificadores del teclado que estaban activos justo antes de que se produjera el evento.
Contiene una combinación bit a bit de:
- Qt.NoModifier - No hay ninguna tecla modificadora pulsada.
- Qt.ShiftModifier - Se ha pulsado una tecla Mayús del teclado.
- Qt.ControlModifier - Se pulsa una tecla Ctrl del teclado.
- Qt.AltModifier - Se ha pulsado una tecla Alt del teclado.
- Qt.MetaModifier - Se pulsa la tecla Meta del teclado.
- Qt.KeypadModifier - Se pulsa una tecla del teclado numérico.
Por ejemplo, para reaccionar ante una pulsación de la tecla Mayús + clic con el botón izquierdo del ratón:
MouseArea {
onClicked: (mouse)=> {
if ((mouse.button == Qt.LeftButton) && (mouse.modifiers & Qt.ShiftModifier))
doSomething();
}
}wasHeld : bool [read-only]
Esta propiedad es verdadera si el botón del ratón se ha mantenido pulsado durante más tiempo que el umbral (800 ms).
Estas propiedades contienen las coordenadas de la posición proporcionadas por el evento del ratón.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.