C

PathView QML Type

モデル内のアイテムをパス上にレイアウトします。詳細...

Import Statement:	`import QtQuick`
Since:	Qt Quick Ultralite 2.12
Inherits:	Item

継承されたメンバーを含む全メンバーのリスト

プロパティ

count : int
currentIndex : int
delegate : Component
model : model
path : Path
pathItemCount : int
preferredHighlightBegin : real
preferredHighlightEnd : real

付属物件

isCurrentItem : bool

方法

void decrementCurrentIndex()
void incrementCurrentIndex()

詳細説明

PathViewは、ListModel のような組み込みのQML型、またはQul::ListModel を継承したC++で定義されたカスタムモデルクラスから作成されたモデルのデータを表示します。

ビューは、表示されるデータを定義するmodel プロパティと、データの表示方法を定義するdelegate プロパティを持ちます。delegate は PathView の各項目に対してインスタンス化されます。

注: Qt のメインストリームとは異なり、Qt Quick Ultralite は、フリックやスワイプジェスチャを使用したパスに沿ったアイテムの移動をサポートしていません。PathView のcurrentIndex プロパティを変更するには、ボタンを使用します。

例えば、ファイルContactModel.qml にこのような単純なリストモデルが定義されているとします：

ListModel {
    ListElement {
        name: "Bill Jones"
        icon: "qtlogo.png"
    }
    ListElement {
        name: "Jane Doe"
        icon: "qtlogo.png"
    }
    ListElement {
        name: "John Smith"
        icon: "qtlogo.png"
    }
}

このデータは、このようにPathViewとして表現することができます：

Rectangle {
    PathView {
        model: model1
        // Note, pathItemCount should be set to a value larger than 0
        pathItemCount: 3
        path: Path {
            startX: 120; startY: 100
            PathQuad { x: 120; y: 25; controlX: 260; controlY: 75 }
            PathQuad { x: 120; y: 100; controlX: -20; controlY: 75 }
        }
        delegate: Item {
            id: wrapper
            height: 100
            width: 100
            required property string icon
            required property string name
            required property int index
            readonly property bool isCurrent: PathView.isCurrentItem

            opacity: isCurrent ? 1 : 0.5
            // Note: to keep the current item on top of the others change the z value
            z: isCurrent ? 1 : 0

            Image {
                anchors.horizontalCenter: nameText.horizontalCenter
                width: 64; height: 64
                source: wrapper.icon
            }

            Text {
                id: nameText
                text: wrapper.name
                font.pointSize: 16
                anchors.bottom: parent.bottom
            }
        }
    }
}

PathViewは、ナビゲーションキーがパスの形状に依存するため、自動的にキーボードナビゲーションを処理しません。代わりに、decrementCurrentIndex またはincrementCurrentIndex のいずれかで現在のインデックスを変更することによって、PathView 内の項目をナビゲートするためにボタンを使用します。

PathView {
    // ...
    Button {
        text: "Previous"
        onClicked: pathView.decrementCurrentIndex()
    }
    Button {
        text: "Next"
        onClicked: pathView.incrementCurrentIndex()
    }
    // the Keys.* with the focus property is not supported in \QUL
    // focus: true
    // Keys.onLeftPressed: decrementCurrentIndex()
    // Keys.onRightPressed: incrementCurrentIndex()
}

Qt Quick Ultraliteはいつでもデリゲートをインスタンス化し、破棄します。

Qt Quick Ultraliteはデリゲートに固定サイズを静的に割り当てますが、pathItemCount プロパティを使用してサイズを定義できます。サイズは0より大きい値でなければなりません。これは、パス上にいつでも表示できるアイテムの最大数を表します。モデルのアイテム数がpathItemCount より少ない場合、PathView はそれに応じてデリゲート数を調整します。

PathView は、デリゲートのルートアイテムにPathView.isCurrentItem プロパティをアタッチします。次の例では、ルートのデリゲート項目はPathView.isCurrentItem として添付されたプロパティに直接アクセスできますが、子のnameText オブジェクトはプロパティにアクセスするために追加の修飾子が必要です。

Component {
    id: delegate
    Column {
        id: wrapper

        required property url icon
        required property string name

        opacity: PathView.isCurrentItem ? 1 : 0.5

        Image {
            anchors.horizontalCenter: nameText.horizontalCenter
            width: 64; height: 64
            source: wrapper.icon
        }
        Text {
            id: nameText
            text: wrapper.name + (wrapper.PathView.isCurrentItem ? " (current)" : "")
            font.pointSize: 16
        }
    }
}

重要な考慮事項

PathView.isCurrentItem Qt Quick Ultralite はまだをサポートしていません。highlightItem
PathView は自動的にクリップを有効にしません。ビューが他のアイテムやスクリーンによってクリップされていない場合、ビューポートの外にあるアイテムをクリップするには、clip: trueを設定します。

Path,ListModel,ListView, Qt Quick Ultraliteのモデルとビュー、およびC++データモデルも参照してください 。

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

count : int

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

currentIndex : int

このプロパティは、現在のアイテムのインデックスを保持する。

delegate : Component

デリゲートは、ビューによってインスタンス化された各項目を定義するテンプレートを提供する。インデックスは、アクセス可能なindex プロパティとして公開されます。ListModel のタイプに応じて、モデルのプロパティも利用可能です。

注: PathView は、ルートのサイズに基づいて項目をレイアウトします。

以下はデリゲートの例です：

        delegate: Item {
            id: wrapper
            height: 100
            width: 100
            required property string icon
            required property string name
            required property int index
            readonly property bool isCurrent: PathView.isCurrentItem

            opacity: isCurrent ? 1 : 0.5
            // Note: to keep the current item on top of the others change the z value
            z: isCurrent ? 1 : 0

            Image {
                anchors.horizontalCenter: nameText.horizontalCenter
                width: 64; height: 64
                source: wrapper.icon
            }

            Text {
                id: nameText
                text: wrapper.name
                font.pointSize: 16
                anchors.bottom: parent.bottom
            }
        }
    }

model : model

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

モデルはビューの項目を作成するために使用されるデータのセットを提供します。大規模なデータセットや動的なデータセットにはC++モデルを使用し、単純なデータセットにはListModel 型に基づいたQMLモデルを使用します。

注意： model を変更すると、オフセットがリセットされ、currentIndex が0 になります。

ListModelも参照してください。

path : Path

このプロパティは、アイテムのレイアウトに使用されるパスを保持します。

Pathも参照してください。

pathItemCount : int

このプロパティは、常にパス上に表示されるアイテムの数を保持します。

Qt Quick Ultraliteは、デリゲートを静的に割り当てるためにもこれを使用します。モデルのアイテム数がpathItemCount より少ない場合にのみ、必要な数のデリゲートインスタンスを使用します。

preferredHighlightBegin : real

preferredHighlightEnd : real

これらのプロパティは、ビュー内のハイライト（現在のアイテム）の優先範囲を設定します。優先値は0 から1 の範囲でなければなりません。

注: アニメーションとタッチジェスチャーはまだサポートされていないため、デフォルトのPathView.StrictlyEnforceRange が常に使用されます。つまり、currentItem が範囲の最初になります。

ハイライト範囲を定義して、ビューが移動したときに現在のアイテムが終了する場所を制御します。例えば、現在選択されているアイテムをパスの中央に配置したい場合、ハイライト範囲を0.5,0.5 に設定します。

注意： 有効な範囲には、preferredHighlightEnd がpreferredHighlightBegin 以上であることが必要です。

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

PathView.isCurrentItem : bool `[read-only attached]`

このアタッチされたプロパティは、デリゲートがカレントアイテムの場合はtrue となり、そうでない場合はfalse となります。デリゲートの各インスタンスにアタッチされる。

カレントアイテムとは、PathView のcurrentIndex プロパティと同じインデックスを持つデリゲートアイテムのことである。

このプロパティを使用して、カレント項目の外観を調整することができます。

        delegate: Item {
            id: wrapper
            height: 100
            width: 100
            required property string icon
            required property string name
            required property int index
            readonly property bool isCurrent: PathView.isCurrentItem

            opacity: isCurrent ? 1 : 0.5
            // Note: to keep the current item on top of the others change the z value
            z: isCurrent ? 1 : 0

            Image {
                anchors.horizontalCenter: nameText.horizontalCenter
                width: 64; height: 64
                source: wrapper.icon
            }

            Text {
                id: nameText
                text: wrapper.name
                font.pointSize: 16
                anchors.bottom: parent.bottom
            }
        }
    }

メソッド・ドキュメント

void decrementCurrentIndex()

現在のインデックスを減らします。

注意: このメソッドは、コンポーネントが完了した後にのみ呼び出します。

void incrementCurrentIndex()

現在のインデックスをインクリメントします。

注意: このメソッドは、Component が完了した後にのみ呼び出します。

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

C

PathView QML Type

プロパティ

付属物件

方法

詳細説明

重要な考慮事項

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

count : int

currentIndex : int

delegate : Component

model : model

path : Path

pathItemCount : int

preferredHighlightBegin : real

preferredHighlightEnd : real

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

PathView.isCurrentItem : bool [read-only attached]

メソッド・ドキュメント

void decrementCurrentIndex()

void incrementCurrentIndex()

PathView.isCurrentItem : bool `[read-only attached]`