MenuItem QML Type
기본 메뉴 항목입니다. 더 보기...
Import Statement: | import Qt.labs.platform |
Inherits: | |
Inherited By: |
속성
- checkable : bool
- checked : bool
- enabled : bool
- font : font
- group : MenuItemGroup
- icon
(since Qt.labs.platform 1.1 (Qt 5.12))
- icon.mask : bool
(since Qt.labs.platform 1.1 (Qt 5.12))
- icon.name : string
(since Qt.labs.platform 1.1 (Qt 5.12))
- icon.source : url
(since Qt.labs.platform 1.1 (Qt 5.12))
- icon.mask : bool
- menu : Menu
- role : enumeration
- separator : bool
- shortcut : keysequence
- subMenu : Menu
- text : string
- visible : bool
신호
방법
- void toggle()
상세 설명
MenuItem 유형은 네이티브 플랫폼 메뉴 항목에 대한 QML API를 제공합니다.
메뉴 항목은 icon, text, shortcut 로 구성됩니다.
Menu { id: zoomMenu MenuItem { text: qsTr("Zoom In") shortcut: StandardKey.ZoomIn onTriggered: zoomIn() } MenuItem { text: qsTr("Zoom Out") shortcut: StandardKey.ZoomOut onTriggered: zoomOut() } }
참고: Qt.labs 모듈의 유형은 향후 버전에서 호환성을 보장하지 않습니다.
Menu 및 MenuItemGroup 을참조하세요 .
속성 문서
checkable : bool |
이 속성은 항목이 체크 가능한지 여부를 저장합니다.
체크 가능한 메뉴 항목은 켜짐/꺼짐 상태를 갖습니다. 예를 들어 워드 프로세서에서 '굵게' 메뉴 항목은 켜져 있거나 꺼져 있을 수 있습니다. 체크할 수 없는 메뉴 항목은 단순히 실행되는 명령 항목입니다(예: 파일 저장).
기본값은 false
입니다.
checked 및 MenuItemGroup 을참조하세요 .
checked : bool |
이 속성은 항목이 선택되어 있는지(켜짐) 또는 선택되지 않았는지(꺼짐)를 유지합니다. 기본값은 false
입니다.
checkable 및 MenuItemGroup도 참조 하세요.
enabled : bool |
이 속성은 항목의 활성화 여부를 저장합니다. 기본값은 true
입니다.
비활성화된 항목은 사용자가 트리거할 수 없습니다. 메뉴에서 사라지지는 않지만 사용할 수 없음을 나타내는 방식으로 표시됩니다. 예를 들어 회색 음영으로만 표시될 수 있습니다.
항목이 비활성화되면 해당 shortcut 을 통해 트리거할 수 없습니다.
group : MenuItemGroup |
이 속성은 항목이 속한 그룹을, 항목이 그룹에 속하지 않은 경우 null
을 보유합니다.
이 속성은 메뉴 항목의 아이콘을 보유합니다.
MenuItem { icon.mask: true icon.name: "edit-undo" icon.source: "qrc:/images/undo.png" }
이 QML 속성은 Qt.labs.platform 1.1(Qt 5.12)에서 도입되었습니다.
QIcon::fromTheme()도 참조하십시오 .
menu : Menu |
이 속성은 항목이 속한 메뉴, 또는 항목이 메뉴에 없는 경우 null
를 보유합니다.
role : enumeration |
이 속성은 항목의 역할을 보유합니다. 역할에 따라 항목이 macOS의 애플리케이션 메뉴에 배치될지 여부가 결정됩니다.
사용 가능한 값
상수 | 설명 |
---|---|
MenuItem.NoRole | 항목을 애플리케이션 메뉴에 배치해서는 안 됩니다. |
MenuItem.TextHeuristicRole | 작업의 텍스트에 따라 항목을 애플리케이션 메뉴에 배치해야 합니다(기본값). |
MenuItem.ApplicationSpecificRole | 항목은 응용 프로그램별 역할과 함께 응용 프로그램 메뉴에 배치되어야 합니다. |
MenuItem.AboutQtRole | 항목이 "Qt 정보" 메뉴 항목을 처리합니다. |
MenuItem.AboutRole | 이 항목은 애플리케이션 메뉴에서 "정보" 메뉴 항목이 있는 위치에 배치되어야 합니다. 메뉴 항목의 텍스트는 "<응용 프로그램 이름 정보>"로 설정됩니다. 애플리케이션 이름은 애플리케이션의 번들에 있는 Info.plist 파일에서 가져옵니다( macOS용 Qt - 배포 참조). |
MenuItem.PreferencesRole | 이 항목은 애플리케이션 메뉴에서 "환경설정..." 메뉴 항목이 있는 곳에 배치해야 합니다. |
MenuItem.QuitRole | 이 항목은 애플리케이션 메뉴에서 종료 메뉴 항목이 있는 곳에 배치해야 합니다. |
역할을 지정하면 메뉴 표시줄의 바로 메뉴에 있는 항목에만 영향을 미치며 해당 메뉴의 하위 메뉴에는 영향을 미치지 않습니다. 예를 들어 메뉴 모음에 '파일' 메뉴가 있고 '파일' 메뉴에 하위 메뉴가 있는 경우 해당 하위 메뉴의 항목에 대한 역할을 지정해도 아무 효과가 없습니다. 해당 항목은 애플리케이션 메뉴로 이동되지 않습니다.
separator : bool |
이 속성은 항목이 구분선인지 여부를 보유합니다. 기본값은 false
입니다.
MenuSeparator 를참조하세요 .
shortcut : keysequence |
이 속성은 메뉴 항목의 바로 가기를 보유합니다.
바로 가기 키 시퀀스는 standard keyboard shortcuts 중 하나로 설정하거나 바로 가기 trigger 에 필요한 최대 4개의 키 누름 시퀀스를 포함하는 문자열로 지정할 수 있습니다.
기본값은 빈 키 시퀀스입니다.
MenuItem { shortcut: "Ctrl+E,Ctrl+W" onTriggered: edit.wrapMode = TextEdit.Wrap }
subMenu : Menu |
이 속성은 항목에 포함된 하위 메뉴 또는 항목이 하위 메뉴 항목이 아닌 경우 null
를 보유합니다.
text : string |
이 속성은 메뉴 항목의 텍스트를 보유합니다.
visible : bool |
이 속성은 항목이 표시되는지 여부를 저장합니다. 기본값은 true
입니다.
문서 신호
hovered() |
이 신호는 사용자가 메뉴 항목을 가리키면 발생합니다.
참고: 해당 핸들러는 onHovered
입니다.
triggered() |
이 신호는 메뉴 항목이 사용자에 의해 트리거될 때 발생합니다.
참고: 해당 핸들러는 onTriggered
입니다.
메서드 문서
void toggle() |
checked 상태를 반대 상태로 전환합니다.
© 2025 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.