MenuBar QML Type

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

Import Statement: import QtQuick.Controls
Inherits:

Container

속성

방법

상세 설명

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

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 의 포커스 관리도참조하세요 .

속성 문서

contentHeight : real [since QtQuick.Controls 2.3 (Qt 5.10)]

이 속성은 콘텐츠 높이를 보유합니다. 메뉴 표시줄의 총 암시적 높이를 계산하는 데 사용됩니다.

참고: 이 프로퍼티는 QtQuick.Controls 2.3(Qt 5.10)부터 MenuBar 에서 사용할 수 있었지만, QtQuick.Controls 2.5(Qt 5.12)에서 컨테이너 기본 유형으로 승격되었습니다.

이 프로퍼티는 QtQuick.Controls 2.3 (Qt 5.10)에서 도입되었습니다.

Container::contentHeight참조하십시오 .


contentWidth : real [since QtQuick.Controls 2.3 (Qt 5.10)]

이 속성은 콘텐츠 너비를 보유합니다. 메뉴 표시줄의 총 암시적 너비를 계산하는 데 사용됩니다.

참고: 이 프로퍼티는 QtQuick.Controls 2.3(Qt 5.10)부터 MenuBar 에서 사용할 수 있지만, QtQuick.Controls 2.5(Qt 5.12)에서 컨테이너 기본 유형으로 승격되었습니다.

이 프로퍼티는 QtQuick.Controls 2.3 (Qt 5.10)에서 도입되었습니다.

Container::contentWidth참조하십시오 .


delegate : Component

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

MenuBarItem도 참조하십시오 .


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

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


메서드 문서

void addMenu(Menu menu)

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


void insertMenu(int index, Menu menu)

indexmenu 을 삽입합니다.


메뉴가 없는 경우 index 또는 null 을 반환합니다.


void removeMenu(Menu menu)

지정된 menu 을 제거합니다. 메뉴가 open 인 경우 먼저 dismissed 이 됩니다. menu 은 애플리케이션이 더 이상 QML 참조를 보유하지 않으면 가비지 수집기에 의해 삭제됩니다.


Menu takeMenu(int index)

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


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