PathView QML Type

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

highlightRangeMode ：

デフォルト値はPathView.StrictlyEnforceRangeです。

ハイライト範囲を定義することは、ビューが移動したときに現在のアイテムがどこに終わるかに影響を与える正しい方法です。例えば、現在選択されているアイテムがパスの中央に来るようにしたい場合、ハイライト範囲を0.5,0.5に設定し、highlightRangeMode PathView.StrictlyEnforceRangeに設定します。そうすると、パスがスクロールするとき、現在選択されているアイテムはその位置のアイテムになります。これは、現在選択されているアイテムが変更されるときにも適用されます - それは優先ハイライト範囲内にスクロールされます。さらに、現在のアイテムのインデックスの動作は、ハイライトの有無にかかわらず発生します。

このプロパティは、パスからキャッシュするアイテムの最大数を保持します。

例えば、20 個のアイテムを含むモデルを持つPathView で、pathItemCount が 10、cacheItemCount が 4 の場合、最大 14 個のアイテムが作成され、パス上に 10 個の可視アイテムと 4 個の不可視アイテムがキャッシュされます。

キャッシュされたデリゲートは非同期に作成されるため、複数のフレームにまたがって作成することができ、フレームをスキップする可能性を減らすことができます。

pathItemCountも参照してください 。

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

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

このプロパティは、ビュー内の現在の項目を保持します。

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

デリゲート内のオブジェクトとバインディングの数は、pathItemCount が指定された場合のビューのフリックパフォーマンスに直接影響します。可能な限り、デリゲートの通常の表示に必要のない機能は、必要なときに追加のコンポーネントをロードできるLoader に配置してください。

PathView は、デリゲート内のルートアイテムのサイズに基づいてアイテムをレイアウトすることに注意してください。

デリゲートの例を示します：

    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
                font.pointSize: 16
            }
        }
    }

このプロパティは、マウスドラッグを開始するパスからの最大距離を保持します。

デフォルトでは、パスはアイテムをクリックすることによってのみドラッグすることができます。dragMargin が 0 より大きい場合、ドラッグはパスの dragMargin ピクセル以内でクリックすることで開始できます。

このプロパティは、ユーザがビューをドラッグすることによってビューが現在移動しているかどうかを保持します。

このプロパティは、フリックが減速する速度を保持します。

デフォルトは 100 です。

このプロパティは、ユーザがビューをフリックすることによってビューが現在移動しているかどうかを保持します。

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

ハイライトコンポーネントのインスタンスは、ビューごとに作成されます。生成されたコンポーネントのインスタンスのジオメトリは、現在のアイテムに合わせてビューによって管理されます。

以下の例は、簡単なハイライトの作り方を示しています。PathView.onPath attached プロパティを使用して、パスからフリックするとハイライトが非表示になるようにしています。

Component {
    Rectangle {
        visible: PathView.onPath
        // ...
    }
}

highlightItem とhighlightRangeModeも参照して ください。

highlightItem は、 コンポーネントから作成されたハイライト アイテムを保持しています。highlight

highlightも参照して ください。

このプロパティは、ハイライトデリゲートの移動アニメーション時間を保持します。

highlightRangeMode が StrictlyEnforceRange の場合、このプロパティはアイテムがパスに沿って移動する速度を決定します。

持続時間のデフォルト値は300msです。

インタラクティブでないPathView をユーザーがドラッグまたはフリックすることはできません。

このプロパティは、一時的にフリックを無効にするのに便利です。これにより、PathView'の子との特別なインタラクションが可能になります。

このプロパティは、ユーザーがビューをフリックできるおおよその最大速度をピクセル/秒で保持します。

デフォルト値はプラットフォーム依存です。

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

モデルは、ビューのアイテムを作成するために使用されるデータのセットを提供します。大規模または動的なデータセットの場合、モデルは通常C++モデルオブジェクトによって提供されます。また、ListModel 型を用いて、QMLで直接モデルを作成することもできます。

データモデル」も参照してください 。

このプロパティは、現在のインデックスを設定する際のアイテムの移動方向を決定します。指定できる値は以下の通りです：

たとえば、モデル内に 5 つのアイテムがあり、currentIndex が0 であるとします。currentIndex が2 に設定されている場合、 の移動方向に移動します、

• に設定された場合、Positive の移動方向は以下の順番になる：0, 1, 2
• Negative の移動方向は以下の順番になります：0, 5, 4, 3, 2
• Shortest の移動方向は、Positive と同じ順番になります。

このプロパティは、ユーザがビューをドラッグまたはフリックすることによって、ビューが現在移動しているかどうかを保持します。

オフセットは、アイテムが初期位置からパスに沿ってどのくらい離れているかを指定します。これは、0 からモデル内のアイテムの数までの実数である。

このプロパティは、アイテムのレイアウトに使用されるパスを保持します。詳細については、Path のドキュメントを参照してください。

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

pathItemCount を undefined に設定すると、パス上のすべてのアイテムが表示されます。

このプロパティは、ドラッグまたはフリックの後にアイテムがどのように落ち着くかを決定します。設定可能な値は次のとおりです：

snapMode currentIndexビューの移動に合わせて を更新するには、 を に設定します（デフォルトは ）。currentIndex highlightRangeMode PathView.StrictlyEnforceRange PathView

highlightRangeModeも参照してください 。

この Attached プロパティは、このデリゲートが現在のアイテムの場合は true、そうでない場合は false になります。

このプロパティは、デリゲートの各インスタンスにアタッチされます。

このプロパティを使用して、現在のアイテムの外観を調整することができます。

    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
                font.pointSize: 16
            }
        }
    }

このアタッチされたプロパティは、アイテムが現在パス上にあるかどうかを保持する。

pathItemCount が設定されている場合、いくつかのアイテムがインスタンス化されていても、現在パス上にあるとはみなされない可能性がある。通常、これらのアイテムは不可視に設定されるなどする：

Component {
    Rectangle {
        visible: PathView.onPath
        // ...
    }
}

これは、デリゲートの各インスタンスにアタッチされます。

このアタッチされたプロパティは、このデリゲートのインスタンスを管理するビューを保持します。

デリゲートの各インスタンスにアタッチされます。

このシグナルは、ユーザがビューのドラッグを止めた時に発行されます。

タッチ/マウスボタンが離された時点でドラッグの速度が十分であれば、フリックが開始されます。

このシグナルは、ユーザーインタラクションによってビューがドラッグされ始めると発行されます。

このシグナルは、フリックによってビューの移動が停止したときに発行されます。

このシグナルは、ビューがフリックされたときに発行されます。フリックは、マウスまたはタッチが離された時点から開始されます。

このシグナルは、ユーザーインタラクションによってビューの移動が停止したときに発行されます。フリックが生成された場合、フリックが停止するとこのシグナルが発行されます。フリックが生成されなかった場合、このシグナルはユーザーがドラッグを止めた時、つまりマウスやタッチを離した時に発行されます。

このシグナルは、ユーザーインタラクションによってビューが動き始めたときに発行されます。

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

注意: メソッドはコンポーネントが完了した後にのみ呼び出されるべきです。

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

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

x,y の点を含む項目のインデックスを内容座標で返す。指定されたポイントにアイテムがない場合は、-1 が返される。

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

コンテンツ座標で点x,y を含むアイテムを返す。指定された点に項目がない場合は null が返される。

注意：メソッドは、Component が完了した後にのみ呼び出す必要があります。

index のアイテムを返します。そのインデックスのアイテムがまだ作成されていない、または可視領域からパンされてキャッシュから削除されているなどの理由で存在しない場合は、null が返されます。

注意：このメソッドは、Componentが完了した後にのみ呼び出す必要があります。ビューがそのアイテムを解放した場合、制御が呼び出し元のスコープから外れるとすぐに null になる可能性があるため、返される値も保存しないでください。

mode で指定された位置にindex が来るように、ビューを配置します：

注意：メソッドは、コンポーネントが完了した後にのみ呼び出す必要があります。起動時にビューを配置するには、このメソッドを Component.onCompleted で呼び出す必要があります。例えば、最後にビューを配置する場合：

Component.onCompleted: positionViewAtIndex(count - 1, PathView.End)