MenuBar QML Type

창 메뉴 표시줄을 제공합니다. 더 보기...

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

속성

• delegate : Component
• menus : list<Menu>

방법

• void addMenu(Menu menu)
• void insertMenu(int index, Menu menu)
• Menu menuAt(int index)
• void removeMenu(Menu menu)
• Menu takeMenu(int index)

상세 설명

메뉴바는 드롭다운 메뉴로 구성되며, 일반적으로 창의 상단 가장자리에 위치합니다.

ApplicationWindow {
    id: window
    width: 320
    height: 260
    visible: true

    menuBar: MenuBar {
        Menu {
            title: qsTr("&File")
            Action { text: qsTr("&New...") }
            Action { text: qsTr("&Open...") }
            Action { text: qsTr("&Save") }
            Action { text: qsTr("Save &As...") }
            MenuSeparator { }
            Action { text: qsTr("&Quit") }
        }
        Menu {
            title: qsTr("&Edit")
            Action { text: qsTr("Cu&t") }
            Action { text: qsTr("&Copy") }
            Action { text: qsTr("&Paste") }
        }
        Menu {
            title: qsTr("&Help")
            Action { text: qsTr("&About") }
        }
    }
}

일반적으로 메뉴는 메뉴 표시줄의 하위 항목으로 정적으로 선언되지만 MenuBar는 add, insert, remove, take 메뉴에 대한 API도 동적으로 제공합니다. 메뉴 표시줄의 메뉴는 menuAt()를 사용하여 액세스할 수 있습니다.

네이티브 메뉴 바

Qt 6.8부터 메뉴바는 macOS에서 네이티브 메뉴바로 구현됩니다. 따라서 메뉴바 내의 모든 메뉴, 메뉴 항목 및 메뉴바 항목도 네이티브 메뉴바가 됩니다. 이렇게 하면 모든 것이 네이티브처럼 보인다는 장점이 있지만, 앞서 언급한 컨트롤에 설정된 델리게이트가 렌더링에 사용되지 않는다는 단점도 있습니다. 네이티브 MenuBar를 원하지 않는 경우 QGuiApplication::setAttribute(Qt::AA_DontUseNativeMenuBar) 을 설정하여 비활성화할 수 있습니다.

MenuBar 사용자 지정하기, Menu, MenuBarItem, 메뉴 컨트롤 및 Qt Quick Controls 의 포커스 관리도참조하세요 .

속성 문서

delegate : Component

이 속성은 메뉴 모음에 메뉴를 표시하기 위해 메뉴 모음 항목을 만드는 데 사용되는 컴포넌트를 보유합니다.

MenuBar 는 델리게이트의 소유권을 갖지 않습니다.

MenuBarItem 를참조하세요 .

menus : list<Menu>

이 속성은 메뉴 목록을 보유합니다.

이 목록에는 QML에서 메뉴 표시줄의 자식으로 선언된 모든 메뉴와 addMenu() 및 insertMenu() 메서드를 사용하여 각각 동적으로 추가되거나 삽입된 메뉴가 포함됩니다.

메서드 문서

void addMenu(Menu menu)

메뉴 목록 끝에 menu 을 추가합니다.

void insertMenu(int index, Menu menu)

index 에 menu 을 삽입합니다.

Menu menuAt(int index)

메뉴가 없는 경우 index, 또는 null 에서 메뉴를 반환합니다.

void removeMenu(Menu menu)

지정된 menu 을 제거합니다. 메뉴가 open 인 경우 먼저 dismissed 이 됩니다. menu 은 애플리케이션에 더 이상 QML 참조가 없을 때 가비지 컬렉터에 의해 삭제됩니다.

Menu takeMenu(int index)

index 에서 메뉴를 제거하고 반환합니다. 메뉴가 open 인 경우 먼저 dismissed 이 됩니다. 메뉴는 애플리케이션이 더 이상 QML 참조를 보유하지 않을 때 가비지 컬렉터에 의해 삭제됩니다.