MenuItem QML Type

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

• 상속된 멤버를 포함한 모든 멤버 목록

속성

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

신호

• void triggered()

상세 설명

MenuItem은 AbstractButton API를 구현하는 편의형(convenience type)으로, 예를 들어 메뉴 항목이 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 : real [since 6.8]

이 속성은 contentItem 의 왼쪽 가장자리에서 텍스트까지 필요한 최소 간격을 지정합니다. 이 속성은 Menu 내의 모든 MenuItem에 대해 공통된 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 : real [read-only, since 6.8]

이 속성은 동일한 menu 내의 모든 메뉴 항목 중에서 발견된 최대 implicitTextPadding 값을 저장합니다.

이 속성은 스타일을 통해 동일한 Menu 내의 모든 MenuItem이 text 을 기준으로 정렬되도록 보장하는 데 사용할 수 있습니다.

Menu 은 여러 개의 서로 다른 MenuItem으로 구성될 수 있으며, 일부는 선택 가능하고, 일부는 아이콘이 있으며, 일부는 단순히 텍스트만 포함할 수 있습니다. 그리고 대개 스타일에서는 이들 모두의 내부 텍스트가 왼쪽 정렬(또는 mirrored 항목의 경우 오른쪽 정렬)되도록 하고자 합니다. 각 MenuItem 이 (아이콘과 체크 표시를 고려하여) implicitTextPadding 에 자체적인 최소 텍스트 패딩을 할당하도록 하면서, textPadding을 사용하여 text 의 실제 위치를 조정함으로써 모든 MenuItems가 정렬되도록 할 수 있습니다

이 기능이 제대로 작동하려면, 모든 MenuItem이 implicitTextPadding 을 contentItem 의 왼쪽 가장자리에서 텍스트까지 필요한 최소 간격으로 설정해야 합니다.

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

implicitTextPadding도 참조하십시오 .

신호 문서

void triggered()

이 신호는 사용자가 메뉴 항목을 실행했을 때 발생합니다.