SelectionRectangle QML Type

TableView 내의 테이블 셀을 선택하는 데 사용됩니다. 더 보기...

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

속성

• active : bool
• bottomRightHandle : Component
• dragging : bool
• selectionMode : enumeration
• target : Item
• topLeftHandle : Component

연관 속성

• control : SelectionRectangle
• dragging : bool

상세 설명

SelectionRectangle은 TableView 에서 테이블 셀을 선택하는 데 사용됩니다. 이를 통해 사용자는 뷰포트 내에서 포인터를 드래그하거나 셀을 길게 눌러 선택을 시작할 수 있습니다.

SelectionRectangle이 셀을 선택할 수 있으려면, TableView 에 ItemSelectionModel 가 할당되어 있어야 합니다. ItemSelectionModel 는 모델에서 수행된 모든 선택 내용을 저장하며, 사용자가 어떤 셀을 선택했는지 조회하는 데 사용할 수 있습니다.

다음 예제는 SelectionRectangle이 TableView 을 대상으로 하도록 설정하는 방법을 보여줍니다:

    TableView {
        id: tableView
        anchors.fill: parent
        clip: true
        acceptedButtons: Qt.NoButton // mouse-drag changes selection

        model: TableModel {
            TableModelColumn { display: "name" }
            TableModelColumn { display: "age" }
            rows: [ { "name": "Harry", "age": "11" },
                    { "name": "Hedwig", "age": "8" } ]
        }

        selectionModel: ItemSelectionModel {
            model: tableView.model
        }

        delegate: TableViewDelegate { padding: 2 }
    }

    SelectionRectangle {
        target: tableView
    }

TableView, TableView::selectionModel 및 ItemSelectionModel도 참조하십시오 .

속성 문서

active : bool [read-only]

이 속성은 사용자가 선택을 수행하는 동안 ` true `입니다. 선택 상태는 사용자가 선택을 시작하는 시점부터, 예를 들어 뷰포트 내부를 탭하여 선택이 해제될 때까지 유지됩니다.

bottomRightHandle : Component

이 속성은 선택 사각형의 왼쪽 상단 모서리 중앙에 표시될 핸들을 포함합니다. 핸들이 제공되면 사용자는 이를 드래그하여 선택 영역을 조정할 수 있습니다.

선택 영역이 제거될 때 핸들은 기본적으로 숨겨지지 않습니다. 대신, 사용자 정의 페이드 아웃 애니메이션을 구현하기 위해 핸들을 숨기는 것은 델리게이트의 역할입니다. 핸들이 최종적으로 숨겨지도록 하는 가장 쉬운 방법은 ` visible `를 ` SelectionRectangle`의 ` active ` 상태에 바인딩하는 것입니다:

SelectionRectangle {
    bottomRightHandle: Rectangle {
        width: 20
        height: 20
        visible: SelectionRectangle.control.active
    }
}

오른쪽 하단에 선택 핸들이 표시되지 않게 하려면 이 속성을 ` null `로 설정하십시오.

topLeftHandle항목도 참조하십시오 .

dragging : bool [read-only]

사용자가 선택 사각형을 조정하기 위해 포인터를 드래그하거나 핸들을 드래그할 때마다 이 속성은 ` true `가 됩니다.

selectionMode : enumeration

이 속성은 선택이 시작되어야 할 시점에 적용됩니다.

기본값은 ` Auto`입니다.

target : Item

이 속성은 ` SelectionRectangle `가 적용되어야 하는 ` TableView `를 포함합니다.

topLeftHandle : Component

이 속성은 선택 사각형의 왼쪽 상단 모서리 중앙에 표시될 델리게이트를 보관합니다. 핸들이 제공되면 사용자는 이를 드래그하여 선택 영역을 조정할 수 있습니다.

선택 영역이 제거될 때 핸들은 기본적으로 숨겨지지 않습니다. 대신, 사용자 정의 페이드 아웃 애니메이션을 구현하기 위해 핸들을 숨기는 작업은 델리게이트의 책임입니다. 핸들이 최종적으로 숨겨지도록 하는 가장 쉬운 방법은 SelectionRectangle 의 active 상태에 visible 를 바인딩하는 것입니다:

SelectionRectangle {
    topLeftHandle: Rectangle {
        width: 20
        height: 20
        visible: SelectionRectangle.control.active
    }
}

왼쪽 상단에 선택 핸들이 표시되지 않게 하려면 이 속성을 null 로 설정하십시오.

bottomRightHandle도 참조하십시오 .

첨부된 속성 설명서

SelectionRectangle.control : SelectionRectangle [attached]

이 첨부 속성은 델리게이트 인스턴스를 관리하는 SelectionRectangle 를 포함하고 있습니다. 이 속성은 각 핸들 인스턴스에 첨부되어 있습니다.

SelectionRectangle.dragging : bool [attached]

사용자가 핸들을 드래그하고 있는 경우, 이 첨부 속성의 값은 ` true `가 됩니다. 이 속성은 각 핸들 인스턴스에 첨부되어 있습니다.