MenuItem QML Type

기본 메뉴 항목. 더 보기...

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• 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))
• menu : Menu
• role : enumeration
• separator : bool
• shortcut : keysequence
• subMenu : Menu
• text : string
• visible : bool

신호

• hovered()
• triggered()

방법

• 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()
    }
}

Menu 및 MenuItemGroup도 참조하십시오 .

속성 문서

checkable : bool

이 속성은 해당 항목이 선택 가능한지 여부를 나타냅니다.

선택 가능한 메뉴 항목은 켜짐/꺼짐 상태를 가집니다. 예를 들어, 워드 프로세서에서 "굵게" 메뉴 항목은 켜져 있거나 꺼져 있을 수 있습니다. 선택 불가능한 메뉴 항목은 단순히 실행되는 명령 항목으로, 예를 들어 '파일 저장'과 같은 것입니다.

기본값은 false 입니다.

checked 및 MenuItemGroup항목도 참조하십시오 .

checked : bool

이 속성은 항목이 선택된(on) 상태이든 선택되지 않은(off) 상태이든 상관없이 적용됩니다. 기본값은 false 입니다.

checkable 및 MenuItemGroup도 참조하십시오 .

enabled : bool

이 속성은 항목이 활성화되어 있는지 여부를 나타냅니다. 기본값은 ‘ true ’입니다.

비활성화된 항목은 사용자가 트리거할 수 없습니다. 메뉴에서 사라지지는 않지만, 사용할 수 없음을 나타내는 방식으로 표시됩니다. 예를 들어, 회색 음영만 사용하여 표시될 수 있습니다.

항목이 비활성화된 경우, 해당 항목의 ` shortcut`을 통해 트리거할 수 없습니다.

font : font

이 속성은 메뉴 항목의 글꼴을 지정합니다.

text도 참조하십시오 .

group : MenuItemGroup

이 속성은 항목이 속한 그룹을 나타내며, 항목이 어떤 그룹에도 속하지 않은 경우에는 ‘ null ’를 반환합니다.

icon group

이 속성은 메뉴 항목의 아이콘을 저장합니다.

MenuItem {
    icon.mask: true
    icon.name: "edit-undo"
    icon.source: "qrc:/images/undo.png"
}

이 속성들은 Qt Labs Platform 1.1(Qt 5.12)에서 도입되었습니다.

QIcon::fromTheme()도 참조하십시오 .

menu : Menu [read-only]

이 속성은 해당 항목이 속한 메뉴를 나타내며, 항목이 메뉴에 속하지 않는 경우에는 ` null `를 반환합니다.

role : enumeration

이 속성은 항목의 역할을 나타냅니다. 이 역할에 따라 해당 항목이 macOS의 애플리케이션 메뉴에 표시될지 여부가 결정됩니다.

사용 가능한 값:

역할 지정은 메뉴 막대의 직접 메뉴에 있는 항목에만 영향을 미치며, 해당 메뉴의 하위 메뉴에 있는 항목에는 영향을 미치지 않습니다. 예를 들어, 메뉴 바에 “파일” 메뉴가 있고 이 “파일” 메뉴에 하위 메뉴가 있는 경우, 해당 하위 메뉴에 있는 항목에 역할을 지정해도 아무런 효과가 없습니다. 이러한 항목들은 절대 애플리케이션 메뉴로 이동되지 않습니다.

separator : bool

이 속성은 해당 항목이 구분선인지 여부를 나타냅니다. 기본값은 false 입니다.

MenuSeparator도 참조하십시오 .

shortcut : keysequence

이 속성은 메뉴 항목의 단축키를 저장합니다.

단축키 조합은 standard keyboard shortcuts 중 하나로 설정할 수 있으며, 단축키를 trigger 입력하는 데 필요한 최대 4개의 키 누름 순서가 포함된 문자열로 지정할 수도 있습니다.

기본값은 빈 키 시퀀스입니다.

MenuItem {
    shortcut: "Ctrl+E,Ctrl+W"
    onTriggered: edit.wrapMode = TextEdit.Wrap
}

subMenu : Menu [read-only]

이 속성은 해당 항목이 포함하고 있는 하위 메뉴를 나타내며, 해당 항목이 하위 메뉴 항목이 아닌 경우에는 ` null `를 반환합니다.

text : string

이 속성은 메뉴 항목의 텍스트를 저장합니다.

visible : bool

이 속성은 항목이 표시되는지 여부를 나타냅니다. 기본값은 ` true`입니다.

신호 문서

hovered()

이 신호는 사용자가 메뉴 항목 위로 마우스를 가져갔을 때 발생합니다.

triggered()

이 신호는 사용자가 메뉴 항목을 실행했을 때 발생합니다.

메서드 문서

void toggle()

checked 의 상태를 반대 상태로 전환합니다.