CheckBox QML Type

켜거나 끌 수 있는 확인 버튼. 더 보기...

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

속성

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

상세 설명

CheckBox는 켜기(선택) 또는 끄기(선택 해제)로 전환할 수 있는 옵션 버튼을 제공합니다. 체크박스는 일반적으로 일련의 옵션 중에서 하나 이상의 옵션을 선택하는 데 사용됩니다. 목록과 같이 옵션의 수가 많은 경우에는 대신 CheckDelegate 을 사용하는 것을 고려해 보십시오.

CheckBox는 AbstractButton 에서 API를 상속받습니다. 예를 들어, checked 속성을 사용하여 체크박스의 상태를 설정할 수 있습니다.

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

ColumnLayout {
    CheckBox {
        checked: true
        text: qsTr("First")
    }
    CheckBox {
        text: qsTr("Second")
    }
    CheckBox {
        checked: true
        text: qsTr("Third")
    }
}

계층적 체크박스 그룹은 비배타적인 ` ButtonGroup`을 사용하여 관리할 수 있습니다.

다음 예제는 자식 노드들의 결합된 선택 상태를 부모 체크박스의 선택 상태에 어떻게 바인딩할 수 있는지 보여줍니다:

Column {
    ButtonGroup {
        id: childGroup
        exclusive: false
        checkState: parentBox.checkState
    }

    CheckBox {
        id: parentBox
        text: qsTr("Parent")
        checkState: childGroup.checkState
    }

    CheckBox {
        checked: true
        text: qsTr("Child 1")
        leftPadding: indicator.width
        ButtonGroup.group: childGroup
    }

    CheckBox {
        text: qsTr("Child 2")
        leftPadding: indicator.width
        ButtonGroup.group: childGroup
    }
}

‘CheckBox’, ‘ ButtonGroup ’, ‘Button’ 컨트롤사용자 정의항목도 참조하십시오 .

속성 설명서

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 콜백 함수를 사용하면 기본 동작을 재정의할 수 있습니다. 다음 예제는 외부 조건에 따라 부분적으로 선택된 상태를 표시할 수 있지만, 사용자가 직접 토글할 때는 절대 부분적으로 선택된 상태로 전환되지 않는 3상태 체크박스를 구현합니다.

CheckBox {
    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

이 속성은 체크박스가 트라이스테이트 체크박스인지 여부를 나타냅니다.

아래 애니메이션에서 첫 번째 체크박스는 3상태 체크박스입니다:

기본값은 ` false`이며, 즉 체크박스는 두 가지 상태만 가집니다.