CheckDelegate QML Type

켜거나 끌 수 있는 체크 표시기가 있는 항목 델리게이트. 더 보기...

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

속성

• checkState : enumeration
• nextCheckState : function (since QtQuick.Controls 2.4 (Qt 5.11))
• tristate : bool

상세 설명

CheckDelegate는 켜기(선택) 또는 끄기(선택 해제)로 전환할 수 있는 항목 델리게이트를 제공합니다. CheckDelegate는 일반적으로 목록에 있는 일련의 옵션 중에서 하나 이상의 옵션을 선택하는 데 사용됩니다. 옵션의 수가 적거나, 옵션을 고유하게 식별해야 하는 경우에는 대신 CheckBox 를 사용하는 것을 고려해 보십시오.

CheckDelegate는 ItemDelegate 에서 API를 상속받으며, 은 AbstractButton 에서 상속받습니다. 예를 들어, text 을 설정하고, AbstractButton API를 사용하여 clicks 에 반응할 수 있습니다. 체크 델리게이트의 상태는 checked 속성을 사용하여 설정할 수 있습니다.

선택됨(checked) 및 선택 해제됨(unchecked) 상태 외에도 세 번째 상태인 부분 선택됨(partially checked) 상태가 있습니다. 부분 선택됨 상태는 tristate 속성을 사용하여 활성화할 수 있습니다. 이 상태는 일반적인 선택됨/선택 해제됨 상태를 판단할 수 없음을 나타내며, 일반적으로 체크 델리게이트에 영향을 미치는 다른 상태들 때문입니다. 이 상태는 예를 들어 트리 뷰에서 여러 자식 노드가 선택된 경우 등에 유용합니다.

ListView {
    model: ["Option 1", "Option 2", "Option 3"]
    delegate: CheckDelegate {
        text: modelData
    }
}

‘CheckDelegate 사용자 지정’, ‘Delegate 컨트롤’ 및 ‘ CheckBox ’항목도 참조하십시오 .

속성 설명서

checkState : enumeration

이 속성은 체크 델리게이트의 확인 상태를 결정합니다.

사용 가능한 상태:

‘ tristate ’ 및 ‘ checked ’항목도 참조하십시오 .

nextCheckState : function [since QtQuick.Controls 2.4 (Qt 5.11)]

이 속성은 사용자가 터치, 마우스 또는 키보드를 통해 체크 델리게이트를 직접 전환할 때마다 다음 체크 상태를 결정하기 위해 호출되는 콜백 함수를 포함합니다.

기본적으로 일반 체크 델리게이트는 ' Qt.Unchecked ' 상태와 ' Qt.Checked ' 상태 사이를 순환하며, 3상태 체크 델리게이트는 ' Qt.Unchecked', ' Qt.PartiallyChecked', ' Qt.Checked ' 상태 사이를 순환합니다.

nextCheckState 콜백 함수는 기본 동작을 재정의할 수 있습니다. 다음 예제는 외부 조건에 따라 부분적으로 체크된 상태를 표시할 수 있지만, 사용자가 직접 토글할 때는 절대 부분적으로 체크된 상태로 전환되지 않는 트라이스테이트 체크 델리게이트를 구현합니다.

CheckDelegate {
    tristate: true
    checkState: allChildrenChecked ? Qt.Checked :
                   anyChildChecked ? Qt.PartiallyChecked : Qt.Unchecked

    nextCheckState: function() {
        if (checkState === Qt.Checked)
            return Qt.Unchecked
        else
            return Qt.Checked
    }
}

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

tristate : bool

이 속성은 check 델리게이트가 세 가지 상태를 가지는지 여부를 결정합니다.

아래 애니메이션에서 첫 번째 checkdelegate는 3상태입니다:

기본값은 ` false`이며, 즉 델리게이트는 두 가지 상태만 가집니다.