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

このプロパティは、選択矩形の左上隅の中央に表示されるデリゲートを保持します。ハンドルを指定すると、ユーザーはそれをドラッグして選択範囲を調整することができます。

デフォルトでは、選択範囲が削除されたときにハンドルが非表示になることはありません。その代わり、これはデリゲートの責任であり、カスタムフェードアウトアニメーションのために開きます。ハンドルを確実に非表示にする最も簡単な方法は、visible をSelectionRectangle のactive ステートにバインドすることです：

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

左上に選択ハンドルを表示したくない場合は、このプロパティをnull に設定してください。

bottomRightHandleも参照してください 。

付属プロパティのドキュメント

SelectionRectangle.control : SelectionRectangle

このアタッチド・プロパティは、デリゲート・インスタンスを管理するSelectionRectangle を保持する。各ハンドルインスタンスにアタッチされます。

SelectionRectangle.dragging : bool

この付属プロパティは、ユーザーがハンドル上でドラッグしている場合、true 。これは、各ハンドルのインスタンスにアタッチされます。