KeyNavigation QML Type

화살표 키로 키 탐색을 지원합니다. 더 보기...

• 상속된 구성원을 포함한 모든 구성원 목록

첨부된 속성

• backtab : Item
• down : Item
• left : Item
• priority : enumeration
• right : Item
• tab : Item
• up : Item

상세 설명

키 기반 사용자 인터페이스에서는 일반적으로 화살표 키를 사용하여 포커스 가능한 항목 사이를 탐색할 수 있습니다. KeyNavigation 첨부 속성은 화살표 또는 탭 키를 누를 때 초점을 가져올 항목을 지정하는 편리한 방법을 제공함으로써 이 동작을 활성화합니다.

다음 예제에서는 2x2 그리드 항목에 대한 키 탐색을 제공합니다:

import QtQuick

Grid {
    width: 100; height: 100
    columns: 2

    Rectangle {
        id: topLeft
        width: 50; height: 50
        color: focus ? "red" : "lightgray"
        focus: true

        KeyNavigation.right: topRight
        KeyNavigation.down: bottomLeft
    }

    Rectangle {
        id: topRight
        width: 50; height: 50
        color: focus ? "red" : "lightgray"

        KeyNavigation.left: topLeft
        KeyNavigation.down: bottomRight
    }

    Rectangle {
        id: bottomLeft
        width: 50; height: 50
        color: focus ? "red" : "lightgray"

        KeyNavigation.right: bottomRight
        KeyNavigation.up: topLeft
    }

    Rectangle {
        id: bottomRight
        width: 50; height: 50
        color: focus ? "red" : "lightgray"

        KeyNavigation.left: bottomLeft
        KeyNavigation.up: topRight
    }
}

왼쪽 상단 항목은 focus 을 true 으로 설정하여 처음에 초점을 받습니다. 화살표 키를 누르면 KeyNavigation left, right, up 또는 down 속성에 설정된 값에 따라 초점이 해당 항목으로 이동합니다.

KeyNavigation이 연결된 속성이 요청된 화살표 또는 탭 키에 대한 키 누르기 및 놓기 이벤트를 수신하면 이벤트가 수락되고 더 이상 전파되지 않습니다.

기본적으로 KeyNavigation은 연결된 항목 다음에 키 이벤트를 수신합니다. 항목이 키 이벤트를 수락하면 KeyNavigation 첨부 속성은 해당 키에 대한 이벤트를 수신하지 않습니다. priority 속성을 KeyNavigation.BeforeItem 으로 설정하면 이벤트가 항목 뒤가 아닌 항목 앞의 키 탐색에 사용될 수 있습니다.

포커스가 전환되는 항목이 활성화되어 있지 않거나 표시되지 않으면 이 항목을 건너뛰고 다음 항목에 초점을 맞추려고 시도합니다. 이는 동일한 키 탐색 핸들러를 가진 항목이 연이어 있는 경우에 가능합니다. 연속된 여러 항목이 활성화되지 않거나 표시되지 않으면 해당 항목도 건너뜁니다.

키 탐색은 암시적으로 다른 방향을 설정하여 이 항목으로 포커스를 되돌립니다. 따라서 left 을 다른 항목으로 설정하면 해당 항목의 KeyNavigation에 right 이 설정되어 이 항목으로 포커스가 다시 설정됩니다. 그러나 해당 항목의 KeyNavigation이 명시적으로 오른쪽으로 설정되어 있으면 아무 변화가 일어나지 않습니다. 즉, 위의 예에서는 항목에 KeyNavigation.right 또는 KeyNavigation.down을 지정하지 않고도 동일한 동작을 수행할 수 있습니다.

Keys attached property 를참조하세요 .

첨부 속성 문서