CheckDelegate QML Type

켜거나 끌 수 있는 확인 표시기가 있는 항목 델리게이트입니다. 자세히...

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

속성

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

상세 설명

체크 델리게이트는 켜거나(체크) 끌 수 있는(체크 해제) 항목 델리게이트를 표시합니다. 체크 델리게이트는 일반적으로 목록의 옵션 집합에서 하나 이상의 옵션을 선택하는 데 사용됩니다. 옵션 세트가 더 작거나 고유하게 식별할 수 있어야 하는 옵션의 경우 CheckBox 대신 사용하는 것이 좋습니다.

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

체크된 상태와 체크되지 않은 상태 외에도 세 번째 상태인 부분적으로 체크된 상태가 있습니다. 부분적으로 확인됨 상태는 tristate 속성을 사용하여 활성화할 수 있습니다. 이 상태는 일반적으로 체크 델리게이트에 영향을 미치는 다른 상태 때문에 일반적인 체크/체크되지 않은 상태를 확인할 수 없음을 나타냅니다. 이 상태는 예를 들어 트리 보기에서 여러 개의 자식 노드를 선택한 경우에 유용합니다.

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

체크 델리게이트 사용자 지정하기, 델리게이트 컨트롤 및 CheckBox 를참조하세요 .

속성 문서

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
    }
}

tristate : bool

이 프로퍼티는 체크 델리게이트에 세 가지 상태가 있는지 여부를 결정합니다.

아래 애니메이션에서 첫 번째 체크 델리게이트는 3 상태입니다:

기본값은 false 즉, 델리게이트에 두 개의 상태만 있습니다.