ListView QML Type

モデルによって提供されるアイテムのリストビューを提供します。詳細...

• 継承されたメンバを含むすべてのメンバのリスト

プロパティ

• count : int (since Qt Quick Ultralite 2.9)
• currentIndex : int (since Qt Quick Ultralite 2.9)
• delegate : Component
• highlight : Component (since Qt Quick Ultralite 2.9)
• model : model
• orientation : Qt::Orientation
• spacing : real

方法

• int indexAt(real x, real y) (since Qt Quick Ultralite 2.9)
• var itemAtIndex(int index) (since Qt Quick Ultralite 1.6)
• void positionViewAtIndex(int index, PositionMode mode) (since Qt Quick Ultralite 2.9)

詳細説明

ListViewは、ListModel のような組み込みのQML型から作成されたモデルのデータを表示します。

リストビューには、表示するデータを定義するモデルと、データをどのように表示するかを定義するデリゲートがあります。ListViewのアイテムは水平または垂直にレイアウトされます。ListViewはFlickable を継承しているため、リストビューは本質的にフリック可能です。

使用例

以下の例では、ListViewで使用される単純なリストモデルを定義しています。ここでは、ListViewはデリゲートにTextアイテムを作成します。

Item {
    ListView {
        width: 180; height: 300

        model: ListModel {
            ListElement {
                name: "Bill Smith"
                number: "555 3264"
            }
            ListElement {
                name: "John Brown"
                number: "555 8426"
            }
            ListElement {
                name: "Sam Wise"
                number: "555 0473"
            }
        }

        delegate: Text {
        width: 180
        height: 30
            text: model.name + ": " + model.number
        }
    }
}

ビューはモデルの各項目に対して新しいTextコンポーネントを作成します。デリゲートはモデルの名前と番号のデータに直接アクセスできることに注意してください。

改良された例

改良されたリストビューを以下に示します。デリゲートは視覚的に改善され、別のcontactDelegateコンポーネントに移動しています。

Item {
    Rectangle {
        width: 360; height: 200

        Component {
            id: contactDelegate
            Item {
                width: 360; height: 60
                Column {
                    Text { text: 'Name: ' + model.name }
                    Text { text: 'Number: ' + model.number }
                }
            }
        }

        ListView {
            anchors.fill: parent

            model: ListModel {
                ListElement {
                    name: "Bill Smith"
                    number: "555 3264"
                }
                ListElement {
                    name: "John Brown"
                    number: "555 8426"
                }
                ListElement {
                    name: "Sam Wise"
                    number: "555 0473"
                }
            }

            delegate: contactDelegate
        }
    }
}

デリゲートは必要に応じてインスタンス化され、いつでも破棄することができます。デリゲートはListViewのcontentItemの親になります。状態をデリゲートに保存してはいけません。

レイアウトの例

リストビューのアイテムのレイアウトは、orientation プロパティを使用して制御することができます。この値はQt.HorizontalまたはQt.Verticalのどちらかを指定します。

Item {
    Rectangle {
        width: 360; height: 200

        Component {
            id: contactDelegate
            Item {
                width: 120; height: 200
                Column {
                    Text { text: model.name }
                    Text { text: model.surname }
                    Text { text: "Age: " + model.age }
                }
            }
        }

        ListView {
            anchors.fill: parent
            orientation: Qt.Horizontal

            model: ListModel {
                ListElement {
                    name: "Bill"
                    surname: "Smith"
                    age: "30"
                }
                ListElement {
                    name: "John"
                    surname: "Brown"
                    age: "56"
                }
                ListElement {
                    name: "Sam"
                    surname: "Wise"
                    age: "42"
                }
            }

            delegate: contactDelegate
        }
    }
}

ListView QML TypeおよびModel-View-Delegate パターンも参照してください 。

プロパティの説明

count : int [since Qt Quick Ultralite 2.9]

このプロパティはモデル内のアイテムの数を保持する。

このプロパティはQt Quick Ultralite 2.9 で導入されました。

currentIndex : int [since Qt Quick Ultralite 2.9]

currentIndex プロパティは、現在のアイテムのインデックスを保持する。このプロパティを -1 に設定すると、ハイライトが削除されます。

このプロパティはQt Quick Ultralite 2.9 で導入されました。

delegate : Component

デリゲートは、リスト・ビューによってインスタンス化された各アイテムを定義するテンプレートを提供する。

highlight : Component [since Qt Quick Ultralite 2.9]

このプロパティは、ハイライトとして使用するコンポーネントを保持する。

各ListView はハイライトコンポーネントのインスタンスを取得し、ListView によって管理され、現在のアイテムをハイライトします。

このプロパティは、Qt Quick Ultralite 2.9で導入されました。

model : model

このプロパティは、リストのデータを提供するモデルを保持します。

モデルは、ビューのアイテムを作成するために使用されるデータのセットを提供します。

Qt Quick Ultraliteのモデルとビューも参照してください 。

orientation : Qt::Orientation

このプロパティは、リストの向きを保持する。

spacing : real

このプロパティは項目間の間隔を保持する。

デフォルト値は 0 です。

メソッド・ドキュメント

[since Qt Quick Ultralite 2.9] int indexAt(real x, real y)

x,y の点を含む可視アイテムのインデックスをコンテンツ座標で返す。この関数は、指定された点に項目がない場合、または項目が可視でない場合、-1 を返す。

また、アイテムがListView に存在するかどうかに関わらず、アイテムが可視領域外にある場合は-1 を返す。

このメソッドはQt Quick Ultralite 2.9 で導入された。

[since Qt Quick Ultralite 1.6] var itemAtIndex(int index)

index にあるアイテムを返します。そのインデックスに対応するアイテムがない場合、例えば、そのアイテムがまだ作成されていなかったり、可視領域からパンされてキャッシュから削除された場合は、NULL アイテムが返されます。

このメソッドはQt Quick Ultralite 1.6 で導入されました。

[since Qt Quick Ultralite 2.9] void positionViewAtIndex(int index, PositionMode mode)

ListView 内のビューポートを制御することができます。index を以下のmode のいずれかに基づいて設定します：

ビューをindex に配置すると、ビューの最初または最後に空のスペースが追加される場合、ビューは境界に配置されます。

このメソッドはQt Quick Ultralite 2.9 で導入されました。

特定の Qt ライセンスの下で利用可能です。
詳細はこちら。