MenuItem QML Type

메뉴 내에 항목을 표시합니다. 더 보기...

Import Statement:	`import QtQuick.Controls`
Inherits:	AbstractButton

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

속성

arrow : Item (since QtQuick.Controls 2.3 (Qt 5.10))
highlighted : bool
implicitTextPadding : bool (since 6.8)
menu : Menu (since QtQuick.Controls 2.3 (Qt 5.10))
subMenu : Menu (since QtQuick.Controls 2.3 (Qt 5.10))
textPadding : bool (since 6.8)

신호

void triggered()

상세 설명

MenuItem은 AbstractButton API를 구현하는 편의 유형으로, 예를 들어 triggered 과 같은 메뉴 항목에 응답하는 친숙한 방법을 제공합니다.

MenuItem은 AbstractButton 에서 API를 상속받습니다. 예를 들어 AbstractButton API를 사용하여 text 및 아이콘을 설정할 수 있습니다.

Button {
    id: fileButton
    text: "File"
    onClicked: menu.open()

    Menu {
        id: menu

        MenuItem {
            text: "New..."
            onTriggered: document.reset()
        }
        MenuItem {
            text: "Open..."
            onTriggered: openDialog.open()
        }
        MenuItem {
            text: "Save"
            onTriggered: saveDialog.open()
        }
    }
}

메뉴 사용자 정의, Menu 및 메뉴 컨트롤도참조하세요 .

속성 문서

arrow : Item [since QtQuick.Controls 2.3 (Qt 5.10)]

이 속성은 하위 메뉴 화살표 항목을 보유합니다.

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

메뉴 사용자 정의도 참조하십시오 .

highlighted : bool

이 속성은 메뉴 항목이 사용자에 의해 강조 표시되는지 여부를 저장합니다.

메뉴 항목은 마우스 호버 또는 키보드 탐색으로 강조 표시할 수 있습니다.

기본값은 false 입니다.

Menu::currentIndex도 참조하십시오 .

implicitTextPadding : bool [since 6.8]

이 속성은 contentItem 의 왼쪽 가장자리에서 텍스트까지 필요한 최소 공간을 보유합니다. Menu 안에 있는 모든 메뉴 항목의 공통 textPadding 을 계산하는 데 사용됩니다.

이 프로퍼티는 Qt 6.8에 도입되었습니다.

textPadding도 참조하십시오 .

menu : Menu [read-only, since QtQuick.Controls 2.3 (Qt 5.10)]

이 프로퍼티는 이 메뉴 항목이 포함된 메뉴, 또는 메뉴에 없는 경우 null 를 보유합니다.

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

subMenu : Menu [read-only, since QtQuick.Controls 2.3 (Qt 5.10)]

이 속성은 이 항목이 상위 메뉴에 표시되는 하위 메뉴, 또는 이 항목이 하위 메뉴 항목이 아닌 경우 null 를 보유합니다.

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

textPadding : bool [read-only, since 6.8]

이 속성은 동일한 menu 안에 있는 모든 메뉴 항목에서 발견되는 최대 implicitTextPadding 를 보유합니다.

이 프로퍼티는 스타일에서 동일한 메뉴 내의 모든 MenuItems가 text 을 기준으로 정렬되도록 하는 데 사용할 수 있습니다.

Menu 는 다양한 MenuItems로 구성될 수 있으며, 일부는 체크할 수 있고 일부는 아이콘이 있고 일부는 텍스트만 포함할 수 있습니다. 그리고 대부분의 경우 스타일은 모든 항목의 텍스트가 왼쪽 정렬( mirrored 항목의 경우 오른쪽 정렬)되도록 하고 싶어합니다. MenuItem 각각이 implicitTextPadding 에 최소 텍스트 패딩을 할당하도록 하고(아이콘과 체크 표시를 고려), textPadding을 사용하여 실제로 text 의 위치를 지정하면 모든 MenuItems가 정렬되도록 할 수 있습니다.

이렇게 하려면 모든 MenuItems는 contentItem 의 왼쪽 가장자리에서 텍스트까지 필요한 최소 공간을 implicitTextPadding 로 설정해야 합니다.

이 속성은 Qt 6.8에서 도입되었습니다.

implicitTextPadding 를참조하십시오 .

신호 문서

void triggered()

이 신호는 메뉴 항목이 사용자에 의해 트리거될 때 발생합니다.

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

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