Back to Qt.io
Contact Us Blog Download Qt

MenuItemGroup QML Type

기본 메뉴 항목을 관리하기 위한 그룹입니다. 더 보기...

Import Statement: import Qt.labs.platform
Inherits:

QtObject

속성

신호

방법

상세 설명

MenuItemGroup은 기본 메뉴 항목을 함께 그룹화합니다.

MenuItemGroup은 기본적으로 독점적입니다. 독점 메뉴 항목 그룹에서는 한 번에 하나의 항목만 선택할 수 있으며, 다른 항목을 선택하면 이전에 선택된 항목의 선택이 자동으로 해제됩니다. 메뉴 항목 그룹은 비독점으로 구성할 수 있으므로 그룹으로 항목을 함께 표시, 숨기기, 활성화 및 비활성화할 때 특히 유용합니다.

MenuItemGroup을 사용하는 가장 간단한 방법은 항목 목록을 할당하는 것입니다.

Menu {
    id: verticalMenu
    title: qsTr("Vertical")

    MenuItemGroup {
        id: verticalGroup
        items: verticalMenu.items
    }

    MenuItem { text: qsTr("Top"); checkable: true }
    MenuItem { text: qsTr("Center"); checked: true }
    MenuItem { text: qsTr("Bottom"); checkable: true }
}

동일한 메뉴에 동일한 전용 그룹에 포함되지 않아야 하는 항목이 포함될 수 있습니다. 이러한 경우는 group 속성을 사용하여 처리하는 것이 가장 좋습니다.

Menu {
    id: horizontalMenu
    title: qsTr("Horizontal")

    MenuItemGroup {
        id: horizontalGroup
    }

    MenuItem {
        checked: true
        text: qsTr("Left")
        group: horizontalGroup
    }
    MenuItem {
        checkable: true
        text: qsTr("Center")
        group: horizontalGroup
    }
    MenuItem {
        text: qsTr("Right")
        checkable: true
        group: horizontalGroup
    }

    MenuItem { separator: true }
    MenuItem { text: qsTr("Justify"); checkable: true }
    MenuItem { text: qsTr("Absolute"); checkable: true }
}

보다 고급 사용 사례는 addItem() 및 removeItem() 메서드를 사용하여 처리할 수 있습니다.

참고: Qt.labs 모듈의 유형은 향후 버전에서 호환성을 보장하지 않습니다.

MenuItem 를참조하세요 .

속성 문서

checkedItem : MenuItem

이 속성은 그룹에서 현재 체크된 항목을 보유하며, 체크된 항목이 없는 경우 null 을 보유합니다.


enabled : bool

이 속성은 그룹이 활성화되었는지 여부를 보유합니다. 기본값은 true 입니다.

그룹의 활성화 상태는 그룹에 있는 각 항목의 활성화 상태에 영향을 주지만, 명시적으로 비활성화된 항목은 그룹이 활성화되어 있어도 활성화되지 않습니다.


exclusive : bool

이 속성은 그룹이 독점적인지 여부를 보유합니다. 기본값은 true 입니다.

독점 메뉴 항목 그룹에서는 한 번에 하나의 항목만 선택할 수 있으며, 다른 항목을 선택하면 이전에 선택한 항목의 선택이 자동으로 해제됩니다.


items : list<MenuItem>

이 속성은 그룹의 항목 목록을 보유합니다.


visible : bool

이 속성은 그룹이 표시되는지 여부를 저장합니다. 기본값은 true 입니다.

그룹의 표시 여부는 그룹 내 각 항목의 표시 여부에 영향을 주지만, 명시적으로 숨겨진 항목은 그룹이 표시되더라도 표시되지 않습니다.


신호 문서

hovered(MenuItem item)

이 신호는 사용자가 그룹에 있는 item 에 마우스를 갖다 대면 발생합니다.

참고: 해당 핸들러는 onHovered 입니다.

MenuItem::hovered()도 참조하세요 .


triggered(MenuItem item)

이 신호는 사용자가 그룹 내 item 을 트리거할 때 발생합니다.

참고: 해당 핸들러는 onTriggered 입니다.

MenuItem::triggered()도 참조하세요 .


메서드 문서

void addItem(MenuItem item)

그룹에 item 을 추가합니다.


void clear()

그룹에서 모든 항목을 제거합니다.


void removeItem(MenuItem item)

그룹에서 item 를 제거합니다.


© 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.