DialogButtonBox QML Type

대화 상자에서 사용되는 버튼 상자. 더 보기...

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

속성

• alignment : flags
• buttonLayout : enumeration (since QtQuick.Controls 2.5 (Qt 5.12))
• defaultButton : AbstractButton (since 6.11)
• defaultStandardButton : enumeration (since 6.11)
• delegate : Component
• position : enumeration
• standardButtons : enumeration

연관 속성

• buttonBox : DialogButtonBox
• buttonRole : enumeration

신호

• accepted()
• applied() (since QtQuick.Controls 2.3 (Qt 5.10))
• clicked(AbstractButton button)
• discarded() (since QtQuick.Controls 2.3 (Qt 5.10))
• helpRequested()
• rejected()
• reset() (since QtQuick.Controls 2.3 (Qt 5.10))

방법

• AbstractButton standardButton(StandardButton button)

상세 설명

대화 상자와 메시지 상자는 일반적으로 해당 플랫폼의 인터페이스 지침에 부합하는 순서로 버튼을 표시합니다. 플랫폼마다 대화 상자 버튼의 순서가 서로 다릅니다. DialogButtonBox를 사용하면 개발자가 버튼을 추가할 수 있으며, 사용자의 플랫폼에 적합한 순서가 자동으로 적용됩니다.

대화의 대부분의 버튼은 특정 역할을 따릅니다. 이러한 역할에는 다음이 포함됩니다:

• 대화 상자를 수락하거나 거부하는 역할.
• 도움 요청.
• 대화 상자 자체에 대한 작업 수행(예: 필드 재설정 또는 변경 사항 적용).

또한 대화 상자를 닫는 다른 방법이 있을 수 있으며, 이는 치명적인 결과를 초래할 수도 있습니다.

대부분의 대화 상자에는 거의 표준으로 간주될 수 있는 버튼들(예: OK 및 Cancel 버튼)이 있습니다. 이러한 버튼들을 표준 방식으로 생성하는 것이 때로는 편리합니다.

DialogButtonBox를 사용하는 방법에는 몇 가지가 있습니다. 한 가지 방법은 표준 버튼(예: OK, Cancel, Save)을 지정하고 버튼 상자가 버튼을 설정하도록 하는 것입니다.

DialogButtonBox {
    standardButtons: DialogButtonBox.Ok | DialogButtonBox.Cancel

    onAccepted: console.log("Ok clicked")
    onRejected: console.log("Cancel clicked")
}

또는 버튼과 그 역할을 직접 지정할 수도 있습니다:

DialogButtonBox {
    Button {
        text: qsTr("Save")
        DialogButtonBox.buttonRole: DialogButtonBox.AcceptRole
    }
    Button {
        text: qsTr("Close")
        DialogButtonBox.buttonRole: DialogButtonBox.DestructiveRole
    }
}

일반 버튼과 표준 버튼을 혼합하여 사용할 수도 있습니다.

버튼 상자에서 버튼이 클릭되면, 실제로 눌린 버튼에 대해 clicked() 신호가 발생합니다. 또한, 해당 역할(들)을 가진 버튼이 눌릴 때 다음 신호들이 자동으로 발생합니다:

Dialog도 참조하십시오 .

속성 설명서

alignment : flags

이 속성은 버튼의 정렬 방식을 지정합니다.

사용 가능한 값:

기본적으로 특정 정렬 방식이 설정되어 있지 않으며, alignment 속성을 읽으면 0과 동일한 기본 플래그 값이 반환됩니다. 이 속성에 ` undefined `를 할당하면 이 값으로 재설정할 수 있습니다. 이 경우, 버튼의 크기가 사용 가능한 공간을 채우도록 조정됩니다.

buttonLayout : enumeration [since QtQuick.Controls 2.5 (Qt 5.12)]

이 속성은 버튼 상자에 포함된 버튼들을 배열할 때 사용될 버튼 레이아웃 정책을 지정합니다. 기본값은 플랫폼에 따라 다릅니다.

사용 가능한 값:

이 속성은 QtQuick.Controls 2.5(Qt 5.12)에서 도입되었습니다.

defaultButton : AbstractButton [since 6.11]

이 속성은 기본 버튼을 지정합니다.

기본 버튼은 ' highlighted '가 되며 포커스를 받게 됩니다.

버튼 상자 내의 버튼 중 하나만 기본 버튼으로 지정할 수 있습니다. 이 속성은 defaultStandardButton 속성과 함께 사용할 수 없습니다.

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

standardButtons 및 defaultStandardButton도 참조하십시오 .

defaultStandardButton : enumeration [since 6.11]

이 속성은 기본 표준 버튼을 지정합니다.

기본 표준 버튼은 ' highlighted '가 되며, 포커스를 받게 됩니다.

버튼 박스 내에서는 단 하나의 버튼만 기본값으로 설정할 수 있습니다. 이 속성은 ` defaultButton ` 속성과 함께 사용할 수 없습니다.

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

standardButtons 및 defaultButton도 참조하십시오 .

delegate : Component

이 속성은 표준 버튼을 생성하기 위한 델리게이트를 보유합니다.

DialogButtonBox 이 속성은 델리게이트의 소유권을 인수하지 않습니다.

standardButtons도 참조하십시오 .

position : enumeration

이 속성은 버튼 상자의 위치를 지정합니다.

사용 가능한 값:

기본값은 Footer 입니다.

Dialog::header 및 Dialog::footer도 참조하십시오 .

standardButtons : enumeration

이 속성은 버튼 상자에서 사용되는 표준 버튼들의 조합을 포함합니다.

DialogButtonBox {
    standardButtons: DialogButtonBox.Ok | DialogButtonBox.Cancel

    onAccepted: console.log("Ok clicked")
    onRejected: console.log("Cancel clicked")
}

버튼은 사용자의 플랫폼에 적합한 순서대로 배치됩니다.

사용 가능한 플래그:

standardButton()도 참조하십시오 .

부속 속성 문서

DialogButtonBox.buttonBox : DialogButtonBox [read-only attached]

이 첨부 속성은 해당 버튼을 관리하는 버튼 박스를 참조하며, 버튼이 버튼 박스에 포함되어 있지 않은 경우에는 null 를 참조합니다.

DialogButtonBox.buttonRole : enumeration [attached]

이 첨부 속성은 버튼 상자 내 각 버튼의 역할을 나타냅니다.

DialogButtonBox {
    Button {
        text: qsTr("Save")
        DialogButtonBox.buttonRole: DialogButtonBox.AcceptRole
    }
    Button {
        text: qsTr("Close")
        DialogButtonBox.buttonRole: DialogButtonBox.DestructiveRole
    }
}

사용 가능한 값:

Signal 문서

accepted()

이 신호는 AcceptRole 또는 YesRole 로 정의된 버튼이 클릭될 때 발생합니다.

rejected(), clicked(), helpRequested()도 참조하십시오 .

[since QtQuick.Controls 2.3 (Qt 5.10)] applied()

이 신호는 ` ApplyRole `로 정의된 버튼이 클릭될 때 발생합니다.

이 신호는 QtQuick.Controls 2.3(Qt 5.10)에서 도입되었습니다.

discarded() 및 reset()도 참조하십시오 .

clicked(AbstractButton button)

이 신호는 버튼 상자 내부의 button 가 클릭될 때 발생합니다.

accepted(), rejected(), helpRequested()도 참조하십시오 .

[since QtQuick.Controls 2.3 (Qt 5.10)] discarded()

이 신호는 ` DiscardRole `로 정의된 버튼이 클릭될 때 발생합니다.

이 신호는 QtQuick.Controls 2.3(Qt 5.10)에서 도입되었습니다.

reset() 및 applied()도 참조하십시오 .

helpRequested()

이 신호는 ` HelpRole `로 정의된 버튼이 클릭될 때 발생합니다.

accepted(), rejected(), clicked()도 참조하십시오 .

rejected()

이 신호는 ` RejectRole ` 또는 ` NoRole `로 정의된 버튼이 클릭될 때 발생합니다.

accepted(), helpRequested(), clicked()도 참조하십시오 .

[since QtQuick.Controls 2.3 (Qt 5.10)] reset()

이 신호는 ` ResetRole `로 정의된 버튼이 클릭될 때 발생합니다.

이 신호는 QtQuick.Controls 2.3(Qt 5.10)에서 도입되었습니다.

discarded() 및 applied()도 참조하십시오 .

메서드 문서

AbstractButton standardButton(StandardButton button)

지정된 표준 button 를 반환하거나, 해당 항목이 존재하지 않을 경우 null 를 반환합니다.

standardButtons도 참조하십시오 .