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)

자세한 설명

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

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는 네이티브 메뉴 바로 구현됩니다. 그 결과, MenuBar 내의 모든 Menu, MenuItem 및 MenuBarItem도 네이티브로 처리됩니다. 이 방식은 모든 요소가 네이티브처럼 보인다는 장점이 있지만, 언급된 컨트롤에 설정된 델리게이트가 렌더링에 사용되지 않는다는 단점도 있습니다. 네이티브 MenuBar를 사용하지 않으려면 QGuiApplication::setAttribute(Qt::AA_DontUseNativeMenuBar) 를 설정하여 비활성화할 수 있습니다.

Qt Quick Controls 의‘메뉴 바 사용자 정의(Customizing MenuBar)’, ‘메뉴 바 구성 요소( Menu)’, ‘메뉴 바 항목( MenuBarItem)’, ‘메뉴 컨트롤(Menu Controls)’, ‘포커스 관리(Focus Management)’항목도 참조하십시오 .

속성 설명서

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 참조를 더 이상 보유하지 않게 되면, 메뉴는 결국 가비지 컬렉터에 의해 삭제됩니다.