Back to Qt.io
Contact Us Blog Download Qt

SelectionRectangle QML Type

TableView 内部のテーブル・セルを選択するために使用される。

Import Statement: import QtQuick.Controls
Since: Qt 6.2
Inherits:

Control

プロパティ

付属プロパティ

詳細説明

SelectionRectangle は、TableView 内の表のセルを選択するために使用されます。ビューポート内でポインタをドラッグするか、セルの上で長押しすることで選択を開始できます。

SelectionRectangle がセルを選択できるようにするには、TableView にItemSelectionModel が割り当てられている必要があります。ItemSelectionModel はモデル上で行われた選択を保存し、ユーザーがどのセルを選択したかをクエリするために使用することができます。

次の例は、SelectionRectangle がTableView をターゲットにする方法を示しています：

    TableView {
        id: tableView
        anchors.fill: parent
        clip: true

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

        selectionModel: ItemSelectionModel {
            model: tableView.model
        }

        delegate: Rectangle {
            implicitWidth: 100
            implicitHeight: 30
            color: selected ? "blue" : "lightgray"

            required property bool selected

            Text { text: display }
        }
    }

    SelectionRectangle {
        target: tableView
    }

注： SelectionRectangle自体は、選択の一部として表示されません。デリゲート（topLeftHandle やbottomRightHandle ）のみが使用されます。rendering the TableView delegate as selected も参照してください。

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

このプロパティは、選択を開始するタイミングを保持します。

定数説明
SelectionRectangle.Dragビューポート内でポインタドラッグを行うと、選択が開始されます。
SelectionRectangle.PressAndHoldセルを長押しすると選択が開始されます。
SelectionRectangle.AutoSelectionRectangle は、ターゲットとプラットフォームに応じて使用するモードを選択します。これは通常、タッチベースのプラットフォームでは 、デスクトップでは 。ただし、 はフリックと競合しない場合にのみ使用される。つまり、 が選択されるためには、 が を に設定して構成されているか、 （デフォルトではマウス・イベントに対してフリックがオフになっている）の中に配置されている必要があります。PressAndHold Drag Drag Drag TableView interactive false ScrollView

デフォルト値はAuto です。


target : Item

このプロパティは、SelectionRectangle が作用すべきTableView を保持する。


topLeftHandle : Component

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

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

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

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

bottomRightHandleも参照してください 。


Attached Property ドキュメント

SelectionRectangle.control : SelectionRectangle

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


SelectionRectangle.dragging : bool

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


本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。