QML类型说明-Keys

Keys

ImportStatement:   import QtQuick 2.2

 

Properties

enabled :bool

forwardTo :list<Object>

priority :enumeration

 

Signals

asteriskPressed(KeyEventevent)

backPressed(KeyEventevent)

backtabPressed(KeyEventevent)

callPressed(KeyEventevent)

cancelPressed(KeyEventevent)

context1Pressed(KeyEventevent)

context2Pressed(KeyEventevent)

context3Pressed(KeyEventevent)

context4Pressed(KeyEventevent)

deletePressed(KeyEventevent)

digit0Pressed(KeyEventevent)

digit1Pressed(KeyEventevent)

digit2Pressed(KeyEventevent)

digit3Pressed(KeyEventevent)

digit4Pressed(KeyEventevent)

digit5Pressed(KeyEventevent)

digit6Pressed(KeyEventevent)

digit7Pressed(KeyEventevent)

digit8Pressed(KeyEventevent)

digit9Pressed(KeyEventevent)

downPressed(KeyEventevent)

enterPressed(KeyEventevent)

escapePressed(KeyEventevent)

flipPressed(KeyEventevent)

hangupPressed(KeyEventevent)

leftPressed(KeyEventevent)

menuPressed(KeyEventevent)

noPressed(KeyEventevent)

pressed(KeyEventevent)

released(KeyEventevent)

returnPressed(KeyEventevent)

rightPressed(KeyEventevent)

selectPressed(KeyEventevent)

spacePressed(KeyEventevent)

tabPressed(KeyEventevent)

upPressed(KeyEventevent)

volumeDownPressed(KeyEventevent)

volumeUpPressed(KeyEventevent)

yesPressed(KeyEventevent)

 

DetailedDescription

所有的视觉元素都支持经按键关联属性处理按键。按键能经onPressed和onReleased信号被处理。

信号属性有KeyEvent参数，命名包含详细信息的事件。如果一个按键事件被处理，event.accepted应该被设置成真以阻止事件向组件的层次结构扩散。

下面的例子展示了怎样生成onPressed处理来测试一些按键。在例子中，是左光标键：

Item {

    anchors.fill: parent

    focus: true

    Keys.onPressed: {

        if (event.key == Qt.Key_Left) {

            console.log("move left");

            event.accepted = true;

        }

    }

}

一些按键可以选择经由指定的信号属性处理。例如onSelectPressed。这些处理自动设置event.accepted为真。

Item {

    anchors.fill: parent

    focus: true

    Keys.onLeftPressed: console.log("moveleft")

}

键盘编码的列表参阅Qt.Key。

 

Key HandlingPriorities

Keys的关联属性能设置在它关联的组件之前还是之后处理按键事件。这使它能拦截事件，从而覆盖组件对事件的默认行为，也能作为组件不处理的事件的补充。

如果优先级是Keys.BeforeItem（默认），按键事件处理的顺序是：

1、在forwardTo中指定的组件。

2、指定的按键处理。例如：onReturnPressed

3、onPressed、onReleased处理

4、组件指定按键处理，例如TextInput按键处理。

5、父组件

如果优先级是Keys.AfterItem，按键处理的顺序是：

1、组件指定按键处理，例如TextInput按键处理。

2、在forwardTo中指定的组件

3、指定按键处理，例如onReturnPressed

4、onPressed、onReleased处理

5、父组件

如果事件在上面的任何一步被接收，按键散播停止。

 

PropertyDocumentation

enabled :bool

如果为真，则使能按键处理（默认）；否则没有按键处理被调用。

 

forwardTo :list<Object>

按键按下，按键释放和从其他组件传入的输入方法将在这个列表中传递。当我们希望一个组件处理一些按键（例如上和下键），而另一个组件处理其他的按键（例如左和右键），这个列表就很有用。一旦事件在列表的某个组件中被接收，它就不再向下传递。

例如：

Item {

    ListView {

        id: list1

        // ...

    }

    ListView {

        id: list2

        // ...

    }

    Keys.forwardTo: [list1, list2]

    focus: true

}

 

priority :enumeration

关联的组件自己的按键之前还是之后处理按键。

Keys.BeforeItem(default) - 在一般组件按键处理之前，处理按键。如果按键事件被接收，它将不会传递到组件。

Keys.AfterItem- 在组件处理按键之后处理按键。如果组件接收了按键事件，它将不会被Keys关联属性处理。

 

SignalDocumentation

asteriskPressed(KeyEventevent)

当星号'*'被按下时，发射这个信号。event参数是事件的详细信息。

 

backPressed(KeyEventevent)

当Back键被按下时，发射这个信号。event参数是事件的详细信息。

 

backtabPressed(KeyEventevent)

当Shift+Tab组合键被按下时，发射这个信号。event参数是事件的详细信息。

 

callPressed(KeyEventevent)

当Call键被按下时，发射这个信号。event参数是事件的详细信息。

 

cancelPressed(KeyEventevent)

当Cancel被按下时，发射这个信号。event参数是事件的详细信息。

 

context1Pressed(KeyEventevent)

当Context1被按下时，发射这个信号。event参数是事件的详细信息。

 

context2Pressed(KeyEventevent)

当Context2被按下时，发射这个信号。event参数是事件的详细信息。

 

context3Pressed(KeyEventevent)

当Context3被按下时，发射这个信号。event参数是事件的详细信息。

 

context4Pressed(KeyEventevent)

当Context4被按下时，发射这个信号。event参数是事件的详细信息。

 

deletePressed(KeyEventevent)

当Delete被按下时，发射这个信号。event参数是事件的详细信息。

 

digit0Pressed(KeyEventevent)

当数字'0'被按下时，发射这个信号。event参数是事件的详细信息。

 

digit1Pressed(KeyEventevent)

当数字'1'被按下时，发射这个信号。event参数是事件的详细信息。

 

digit2Pressed(KeyEventevent)

当数字'2'被按下时，发射这个信号。event参数是事件的详细信息。

 

digit3Pressed(KeyEventevent)

当数字'3'被按下时，发射这个信号。event参数是事件的详细信息。

 

digit4Pressed(KeyEventevent)

当数字'4'被按下时，发射这个信号。event参数是事件的详细信息。

 

digit5Pressed(KeyEventevent)

当数字'5'被按下时，发射这个信号。event参数是事件的详细信息。

 

digit6Pressed(KeyEventevent)

当数字'6'被按下时，发射这个信号。event参数是事件的详细信息。

 

digit7Pressed(KeyEventevent)

当数字'7'被按下时，发射这个信号。event参数是事件的详细信息。

 

digit8Pressed(KeyEventevent)

当数字'8'被按下时，发射这个信号。event参数是事件的详细信息。

 

digit9Pressed(KeyEventevent)

当数字'9'被按下时，发射这个信号。event参数是事件的详细信息。

 

downPressed(KeyEventevent)

当Down被按下时，发射这个信号。event参数是事件的详细信息。

 

enterPressed(KeyEventevent)

当Enter被按下时，发射这个信号。event参数是事件的详细信息。

 

escapePressed(KeyEventevent)

当Escape被按下时，发射这个信号。event参数是事件的详细信息。

 

flipPressed(KeyEventevent)

当Flip被按下时，发射这个信号。event参数是事件的详细信息。

 

hangupPressed(KeyEventevent)

当Hangup被按下时，发射这个信号。event参数是事件的详细信息。

 

leftPressed(KeyEventevent)

当Left被按下时，发射这个信号。event参数是事件的详细信息。

 

menuPressed(KeyEventevent)

当Menu被按下时，发射这个信号。event参数是事件的详细信息。

 

noPressed(KeyEventevent)

当No被按下时，发射这个信号。event参数是事件的详细信息。

 

pressed(KeyEventevent)

当任意键被按下时，发射这个信号。event参数是事件的详细信息。

 

released(KeyEventevent)

当任意键被释放时，发射这个信号。event参数是事件的详细信息。

 

returnPressed(KeyEventevent)

当Return被按下时，发射这个信号。event参数是事件的详细信息。

 

rightPressed(KeyEventevent)

当Right被按下时，发射这个信号。event参数是事件的详细信息。

 

selectPressed(KeyEventevent)

当Select被按下时，发射这个信号。event参数是事件的详细信息。

 

spacePressed(KeyEventevent)

当Space被按下时，发射这个信号。event参数是事件的详细信息。

 

tabPressed(KeyEventevent)

当Tab被按下时，发射这个信号。event参数是事件的详细信息。

 

upPressed(KeyEventevent)

当Up被按下时，发射这个信号。event参数是事件的详细信息。

 

volumeDownPressed(KeyEventevent)

当VolumeDown被按下时，发射这个信号。event参数是事件的详细信息。

 

volumeUpPressed(KeyEventevent)

当VolumeUp被按下时，发射这个信号。event参数是事件的详细信息。

 

yesPressed(KeyEventevent)

当Yes被按下时，发射这个信号。event参数是事件的详细信息。