Shortcut QML Type
키보드 단축키를 제공합니다. 더 보기...
| Import Statement: | import QtQuick |
속성
- autoRepeat : bool
- context : enumeration
- enabled : bool
- nativeText : string
- portableText : string
- sequence : keysequence
- sequences : list<keysequence>
신호
자세한 설명
'단축키' 유형을 사용하면 키보드 단축키를 처리할 수 있습니다. 단축키는 standard keyboard shortcuts 중 하나로 설정하거나, 단축키를 activate 하기 위해 필요한 최대 4개의 키 입력 순서가 포함된 문자열로 정의할 수 있습니다.
Item {
id: view
property int currentIndex
Shortcut {
sequences: [StandardKey.NextChild]
onActivated: view.currentIndex++
}
}또한 여러 개의 키 조합 sequences 을 설정하여, 서로 다른 키 입력 순서를 통해 단축키를 활성화 activated 할 수 있습니다.
Keys 및 shortcutOverride()도 참조하십시오 .
속성 문서
autoRepeat : bool
이 속성은 바로가기가 자동 반복될 수 있는지 여부를 결정합니다.
기본값은 ` true`입니다.
context : enumeration
이 속성은 ‘ shortcut context ’를 저장합니다.
지원되는 값은 다음과 같습니다:
| 상수 | 설명 |
|---|---|
Qt.WindowShortcut | (기본값) 이 바로 가기는 상위 항목이 활성 최상위 창에 있을 때 활성화됩니다. |
Qt.ApplicationShortcut | 애플리케이션의 창 중 하나가 활성 상태일 때 바로 가기가 활성화됩니다. |
enabled : bool
이 속성은 바로 가기가 활성화되어 있는지 여부를 나타냅니다.
기본값은 ` true`입니다.
nativeText : string [read-only]
이 속성은 단축키 조합을 플랫폼별 문자열로 제공합니다. 즉, 이 텍스트는 번역된 형태로 표시되며, macOS에서는 메뉴 바의 키 조합과 유사한 형태로 나타납니다. 이 텍스트를 사용자에게 표시하는 것이 가장 좋습니다(예: 툴팁을 통해).
참고: 여러 키 조합이 설정된경우 , 이 속성은 첫 번째 키 조합에 대한 표현만 제공합니다.
관련 항목: sequence 및 portableText.
portableText : string [read-only]
이 속성은 단축키의 키 시퀀스를 파일에 읽고 쓰기에 적합한 “이식 가능한” 형식의 문자열로 제공합니다. 대부분의 경우, 이 형식은 Windows 및 X11의 기본 텍스트와 비슷하게 보입니다.
참고: 여러 시퀀스가 설정된경우 , 이 속성은 첫 번째 시퀀스에 대한 표현만 제공합니다.
sequence 및 nativeText도 참조하십시오 .
sequence : keysequence
이 속성은 단축키의 키 시퀀스를 저장합니다. 키 시퀀스는 standard keyboard shortcuts 중 하나로 설정하거나, 단축키를 activate 실행하는 데 필요한 최대 4개의 키 입력 순서를 포함하는 문자열로 정의할 수 있습니다.
기본값은 빈 키 시퀀스입니다.
Shortcut {
sequence: "Ctrl+E,Ctrl+W"
onActivated: edit.wrapMode = TextEdit.Wrap
}참고: 표준 키는 일부 플랫폼에서는 하나의 단축키로 해석될 수 있지만, 다른 플랫폼에서는 여러 개의 단축키로 해석될수 있으므로 , 표준 키의 경우 항상 sequences 를 사용하는 것이 좋습니다.
sequences도 참조하십시오 .
sequences : list<keysequence>
이 속성은 단축키에 대한 여러 키 조합을 포함합니다. 키 조합은 standard keyboard shortcuts 중 하나로 설정하거나, 단축키를 activate 실행하는 데 필요한 최대 4개의 키를 연속해서 누르는 순서를 포함하는 문자열로 정의할 수 있습니다.
Shortcut {
sequences: [StandardKey.Cut, "Ctrl+X", "Shift+Del"]
onActivated: edit.cut()
}Signal 문서
activated()
이 신호는 바로 가기가 활성화될 때 발생합니다.
참고: 해당 핸들러는 onActivated 입니다.
activatedAmbiguously()
이 신호는 단축키가 모호하게 활성화되었을 때, 즉 하나 이상의 단축키 시작 부분과 일치할 때 발생합니다.
참고: 해당 핸들러는 onActivatedAmbiguously 입니다.
© 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.