KeyEvent QML Type

Proporciona información sobre un evento clave. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

• accepted : bool
• count : int
• isAutoRepeat : bool
• key : int
• modifiers : int
• nativeScanCode : quint32
• text : string

Métodos

• bool matches(StandardKey matchKey)

Descripción detallada

Por ejemplo, lo siguiente cambia la propiedad de estado del elemento cuando se pulsa la tecla Intro:

Item {
    focus: true
    Keys.onPressed: (event)=> { if (event.key == Qt.Key_Enter) state = 'ShowDetails'; }
}

Propiedad Documentación

accepted : bool

Establecer accepted a true evita que el evento clave se propague al elemento padre.

Generalmente, si el ítem actúa sobre el evento clave, entonces debe ser aceptado para que los ítems ancestros no respondan también al mismo evento.

count : int [read-only]

Esta propiedad contiene el número de claves involucradas en este evento. Si KeyEvent::text no está vacío, es simplemente la longitud de la cadena.

isAutoRepeat : bool [read-only]

Esta propiedad indica si este evento proviene de una tecla de repetición automática.

key : int [read-only]

Esta propiedad contiene el código de la tecla que se ha pulsado o soltado.

Consulte Qt.Key para ver la lista de códigos de teclado. Estos códigos son independientes del sistema de ventanas subyacente. Tenga en cuenta que esta función no distingue entre mayúsculas y minúsculas; utilice la propiedad text para este propósito.

Un valor de 0 o Qt.Key_Unknown significa que el evento no es el resultado de una tecla conocida; por ejemplo, puede ser el resultado de una secuencia de composición, una macro de teclado o deberse a la compresión de eventos de teclado.

modifiers : int [read-only]

Esta propiedad contiene los indicadores de modificador de teclado que existían inmediatamente antes de que se produjera el evento.

Contiene una combinación bit a bit de valores numéricos (igual que en Qt::KeyboardModifier):

Por ejemplo, para reaccionar a una combinación de teclas Mayús + Intro:

Item {
    focus: true
    Keys.onPressed: (event)=> {
        if ((event.key == Qt.Key_Enter) && (event.modifiers & Qt.ShiftModifier))
            doSomething();
    }
}

nativeScanCode : quint32 [read-only]

Esta propiedad contiene el código de escaneo nativo de la tecla pulsada. Se transmite desde QKeyEvent sin cambios.

Véase también QKeyEvent::nativeScanCode().

text : string [read-only]

Esta propiedad contiene el texto Unicode que generó la tecla. El texto devuelto puede ser una cadena vacía en los casos en que se estén pulsando o soltando teclas modificadoras, como Shift, Control, Alt y Meta. En tales casos, key contendrá un valor válido.

Documentación del método

bool matches(StandardKey matchKey)

Devuelve true si el evento clave coincide con la norma dada matchKey; en caso contrario devuelve false.

Item {
    focus: true
    Keys.onPressed: (event)=> {
        if (event.matches(StandardKey.Undo))
            myModel.undo();
        else if (event.matches(StandardKey.Redo))
            myModel.redo();
    }
}

Véase también QKeySequence::StandardKey.