ListView QML Type

currentIndex プロパティは現在の項目のインデックスを保持し、currentItem は現在の項目を保持する。currentIndex を -1 に設定すると、ハイライトが消去され、currentItem が null に設定される。

highlightFollowsCurrentItem がtrue の場合、これらのプロパティのいずれかを設定すると、ListView が滑らかにスクロールし、現在のアイテムが表示されるようになる。

現在のアイテムの位置は、ビューに表示されるまでは、おおよその位置にしかならない可能性があることに注意してください。

これらのプロパティは、ビュー内での（現在のアイテムの）ハイライトの優先範囲を定義する。preferredHighlightBegin の値はpreferredHighlightEnd の値より小さくなければならない。

これらのプロパティは、リストがスクロールされたときの現在のアイテムの位置に影響します。例えば、ビューがスクロールされたときに、現在選択されているアイテムがリストの真ん中に留まる必要がある場合、preferredHighlightBegin とpreferredHighlightEnd の値を、真ん中のアイテムがある位置の上端と下端の座標に設定します。currentItem をプログラムで変更すると、現在のアイテムがビューの中央に来るようにリストが自動的にスクロールします。さらに、現在のアイテムのインデックスの動作は、ハイライトの有無にかかわらず発生します。

highlightRangeMode の有効な値は以下の通りです：

このプロパティは、ビュージオメトリの外側にデリゲートを表示することを許可します。

この値が0以外の場合、ビューはビューの開始前または終了後に余分なデリゲートを作成する。ビューは、指定されたピクセルサイズに収まるだけのデリゲートを作成します。

例えば、縦長のビューでデリゲートの高さが20ピクセルで、displayMarginBeginning とdisplayMarginEnd の両方が40に設定されている場合、上に2つのデリゲート、下に2つのデリゲートが作成され、表示されます。

デフォルト値は0です。

このプロパティは、特定のUI構成を許可するためのものであり、パフォーマンスの最適化ではありません。パフォーマンス上の理由からビュージオメトリの外側にデリゲートを作成したい場合は、代わりにcacheBuffer プロパティを使用することをお勧めします。

この QML プロパティは QtQuick 2.3 で導入されました。

これらのプロパティは、ハイライトデリゲートの移動アニメーションとサイズ変更アニメーションの速度を制御します。

highlightFollowsCurrentItem これらのプロパティを有効にするには、true にする必要があります。

velocity プロパティのデフォルト値は 400 ピクセル/秒です。つまり、ハイライトは設定された速度で移動するのに必要なだけの時間がかかります。

これらのプロパティはSmoothedAnimation と同じ特性を持っています : velocity と duration の両方が設定されている場合、アニメーションは短い方の duration を使用します。

移動速度と持続時間のプロパティは、インデックスの変化による動きを制御するために使用されます。例えば、incrementCurrentIndex （）が呼び出されたときなどです。ユーザーがListView をフリックすると、フリックによる速度が代わりに動きの制御に使用されます。

一方のプロパティのみを設定するには、もう一方のプロパティを-1 に設定します。たとえば、持続時間だけをアニメートし、ベロシティをアニメートしたくない場合は、次のコードを使用します：

highlightMoveDuration: 1000
highlightMoveVelocity: -1

highlightFollowsCurrentItemも参照してください 。

このプロパティは、ビューに追加されたアイテムに適用するトランジションを保持します。

例えば、このようなトランジションを指定するビューを以下に示します：

ListView {
    ...
    add: Transition {
        NumberAnimation { properties: "x,y"; from: 100; duration: 1000 }
    }
}

上記のビューにアイテムが追加されるたびに、アイテムはビュー内の位置 (100,100) から最終的な x,y 位置まで、1 秒かけてアニメーションします。このトランジションは、ビューに追加された新しいアイテムにのみ適用され、新しいアイテムの追加によって置き換えられた下のアイテムには適用されません。置き換えられたアイテムをアニメーション化するには、displaced またはaddDisplaced プロパティを設定します。

ビュー遷移の使用方法の詳細と例については、ViewTransition ドキュメントを参照してください。

addDisplaced 、populate 、ViewTransitionも参照してください 。

このプロパティは、ビューに他のアイテムが追加されることによって、ビュー内のアイテムの位置がずれる場合に適用する遷移を保持します。

例えば、このような遷移を指定するビューを示します：

ListView {
    ...
    addDisplaced: Transition {
        NumberAnimation { properties: "x,y"; duration: 1000 }
    }
}

上記のビューにアイテムが追加される度に、新しいアイテムの下にある全てのアイテムは変位し、ビュー内で下に（水平方向の場合は横に）移動する。この変位が発生すると、ビュー内の新しい x,y 位置へのアイテムの移動は、指定された 1 秒間にわたってNumberAnimation によってアニメーション化されます。この遷移は、ビューに追加された新しいアイテムには適用されません。追加されたアイテムをアニメーション化するには、add プロパティを設定します。

アイテムが複数の種類の操作によって同時に配置される場合、addDisplaced、moveDisplaced 、removeDisplaced のいずれのトランジションが適用されるかは定義されていません。また、アイテムが追加、移動、削除のいずれの操作によって配置されるかに応じて異なるトランジションを指定する必要がない場合は、代わりにdisplaced プロパティを設定することを検討する。

ビュー遷移の使用方法の詳細と例については、ViewTransition ドキュメントを参照してください。

displaced 、add 、populate 、およびViewTransitionも参照してください 。

このプロパティは、デリゲートがビューの可視領域外に保持されるかどうかを決定します。

この値が0より大きい場合、ビューは指定されたバッファ内に収まるだけのインスタンス化されたデリゲートを保持することができる。例えば、縦長のビューで、デリゲートが20ピクセルの高さで、cacheBuffer が40に設定されている場合、可視領域の上と下に最大2つのデリゲートが作成/保持される可能性があります。バッファリングされたデリゲートは非同期に作成されるため、複数のフレームにまたがって作成することができ、フレームをスキップする可能性が低くなります。描画のパフォーマンスを向上させるために、可視領域外のデリゲートは描画されません。

このプロパティのデフォルト値はプラットフォームに依存しますが、通常は0より大きい値になります。負の値は無視されます。

cacheBufferはピクセルバッファではなく、インスタンス化された追加のデリゲートを保持するだけであることに注意してください。

cacheBuffer は、displayMarginBeginning またはdisplayMarginEnd で指定された表示マージンの外側で動作します。

このプロパティは、デリゲート・コンポーネントのItem として可視化されているかインスタンス化されているかに関係なく、ListView'のモデル内のアイテムの数を反映します。

このプロパティは、現在ビューの先頭にあるセクションを保持します。

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

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

ListView は、デリゲート内のルートアイテムのサイズに基づいてアイテムをレイアウトします。

デリゲートのサイズは、アイテムのサブピクセル整列を避けるために整数であることが推奨されます。

stacking order デリゲート・インスタンスのデフォルトは1 です。

Stacking Order in ListViewも参照してください 。

このプロパティは、ビューに影響を与えるモデル操作によって置き換えられたアイテムに適用される一般的な遷移を保持します。

これは、追加、移動、または削除の操作によって置き換えられたアイテムに適用される一般的な遷移を指定するための便宜的なもので、addDisplaced 、moveDisplaced 、removeDisplaced プロパティを個別に指定する必要はありません。例えば、以下は、置き換えられたトランジションを指定するビューです：

ListView {
    ...
    displaced: Transition {
        NumberAnimation { properties: "x,y"; duration: 1000 }
    }
}

上記のビュー内でアイテムが追加、移動、または削除されると、その下にあるアイテムは変位し、ビュー内で下に（水平方向の場合は横に）移動します。この変位が発生すると、ビュー内の新しいx,y位置へのアイテムの移動は、指定されたように、1秒かけてNumberAnimation 、アニメーション化されます。

enabled ビューがこの一般的な変位トランジションと特定のaddDisplaced 、moveDisplaced またはremoveDisplaced トランジションを指定した場合、関連する操作が発生したときに、一般的な変位トランジションの代わりに、より特定のトランジションが使用されます。もし無効化されていれば、一般的な変位トランジションが代わりに適用されます。

ビュー遷移の使用方法の詳細と例については、ViewTransition ドキュメントを参照してください。

addDisplaced,moveDisplaced,removeDisplaced,ViewTransitionも参照して ください。

このプロパティは、水平方向のリストの有効なレイアウト方向を保持します。

付属のプロパティLayoutMirroring::enabled をロケールレイアウトに使う場合、横向きリストの視覚的なレイアウト方向はミラーされます。しかし、layoutDirection プロパティは変更されません。

ListView::layoutDirection とLayoutMirroringも参照して ください。

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

フッターコンポーネントのインスタンスは、各ビューに対して作成されます。フッターはビューの最後、アイテムの後に配置されます。stacking order フッターのデフォルトは1 です。

header 、footerItem 、Stacking Order in ListViewも参照して ください。

これは、footer コンポーネントから作成されたフッター項目を保持します。

フッターコンポーネントのインスタンスはビューごとに作成されます。フッターはビューの最後、アイテムの後に配置されます。フッターのデフォルトstacking order は1 です。

footer 、headerItem 、Stacking Order in ListViewも参照してください 。

このプロパティは、footer item の位置を決定します。

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

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

ヘッダー・コンポーネントのインスタンスは、各ビューに対して作成されます。ヘッダは、ビューの先頭、アイテムの前に配置されます。stacking order ヘッダーのデフォルトは1 です。

footer 、headerItem 、Stacking Order in ListViewも参照して ください。

これは、header コンポーネントから作成されたヘッダーアイテムを保持します。

ヘッダーコンポーネントのインスタンスは各ビューに作成されます。ヘッダーはビューの先頭、アイテムの前に配置されます。ヘッダーのデフォルトstacking order は1 です。

header,footerItem,Stacking Order in ListViewも参照してください 。

このプロパティは、header item の位置を決定します。

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

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

ハイライト・コンポーネントのインスタンスは、リストごとに作成されます。生成されたコンポーネント・インスタンスのジオメトリは、highlightFollowsCurrentItem プロパティが false でない限り、現在のアイテムに留まるようにリストによって管理されます。ハイライト項目のデフォルトstacking order は0 です。

highlightItem 、highlightFollowsCurrentItem 、リストビューのハイライトの例、Stacking Order in ListViewも参照してください 。

このプロパティは、ハイライトがビューによって管理されるかどうかを保持する。

このプロパティがtrue（デフォルト値）の場合、ハイライトは現在のアイテムに追従してスムーズに移動する。そうでない場合、ハイライトはビューによって移動されず、移動はハイライトによって実装されなければなりません。

以下は、SpringAnimation アイテムによって動きが定義されたハイライトです：

Component {
    id: highlight
    Rectangle {
        width: 180; height: 40
        color: "lightsteelblue"; radius: 5
        y: list.currentItem.y
        Behavior on y {
            SpringAnimation {
                spring: 3
                damping: 0.2
            }
        }
    }
}

ListView {
    id: list
    width: 180; height: 200
    model: ContactModel {}
    delegate: Text { text: name }

    highlight: highlight
    highlightFollowsCurrentItem: false
    focus: true
}

ハイライトのアニメーションは、ビューのスクロールにも影響することに注意してください。ハイライトのアニメーションは、ビューのスクロールにも影響することに注意してください。

highlight およびhighlightMoveVelocityも参照して ください。

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

highlightFollowsCurrentItem が false に設定されない限り、highlightItem はビューによって管理されます。ハイライトアイテムのデフォルトstacking order は0 です。

highlight 、highlightFollowsCurrentItem 、Stacking Order in ListViewも参照してください 。

このプロパティは、リストのキーナビゲーションを有効にするかどうかを保持する。

これがtrue の場合、ユーザーはキーボードでビューをナビゲートできます。これは、マウスとキーボードの相互作用を選択的に有効または無効にする必要があるアプリケーションに便利です。

デフォルトでは、このプロパティの値は、既存のアプリケーションの動作互換性を確保するために、interactive にバインドされています。明示的に設定されると、インタラクティブ・プロパティにバインドされなくなります。

interactiveも参照のこと 。

このプロパティは、リストがキーナビゲーションをラップするかどうかを保持する。

このプロパティが真である場合、現在のアイテムの選択をリストの末尾に移動させるキーナビゲーションは、代わりに折り返され、リストの先頭に選択アイテムを移動させます。

デフォルトでは、キーナビゲーションは折り返されません。

このプロパティは、水平方向のリストのレイアウト方向を保持します。

取り得る値

orientation が Qt.Vertical の場合、このプロパティを設定しても効果はありません。

ListView::effectiveLayoutDirection およびListView::verticalLayoutDirectionも参照してください 。

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

このモデルは、ビューの項目を作成するために使用されるデータのセットを提供します。モデルは、ListModel 、ObjectModel を用いてQMLで直接作成することもできますし、C++のモデルクラスによって提供されることもできます。C++モデルクラスを使用する場合は、QAbstractItemModel のサブクラスか、単純なリストでなければなりません。

関連項目： データモデル。

このプロパティは、ビューの移動操作によって移動されるビュー内のアイテムに適用される遷移を保持するmodel 。

例えば、このような遷移を指定するビューを示します：

ListView {
    ...
    move: Transition {
        NumberAnimation { properties: "x,y"; duration: 1000 }
    }
}

model が特定のインデックスのセットを移動するために移動操作を実行するたびに、ビュー内の各アイテムは1秒かけてビュー内の新しい位置にアニメーション表示されます。このトランジションは、モデル内の移動操作の対象であるアイテムにのみ適用され、移動操作によって置き換えられたその下のアイテムには適用されません。移動したアイテムをアニメーション化するには、displaced またはmoveDisplaced プロパティを設定します。

ビュー遷移の使用方法の詳細と例については、ViewTransition のドキュメントを参照してください。

moveDisplaced およびViewTransitionも参照して ください。

このプロパティは、ビューのmodel の移動操作によって置き換えられたアイテムに適用するトランジションを保持します。

例えば、このような遷移を指定するビューを以下に示します：

ListView {
    ...
    moveDisplaced: Transition {
        NumberAnimation { properties: "x,y"; duration: 1000 }
    }
}

model が特定のインデックスのセットを移動させる移動操作を実行するたびに、移動操作のソースインデックスとデスティネーションインデックスの間のアイテムが変位し、ビュー内で上方または下方（水平方向の場合は横方向）に移動します。この変位が発生すると、ビュー内の新しい x,y 位置へのアイテムの移動は、指定された 1 秒間にわたってNumberAnimation によってアニメーション化されます。この遷移は、実際の移動操作の対象であるアイテムには適用されません。移動したアイテムをアニメーション化するには、move プロパティを設定します。

アイテムが複数の種類の操作によって同時に移動される場合、addDisplaced 、moveDisplaced、removeDisplaced のいずれのトランジションが適用されるかは定義されていない。また、アイテムが追加、移動、削除のいずれの操作によって配置されるかに応じて異なるトランジションを指定する必要がない場合は、代わりにdisplaced プロパティを設定することを検討する。

ビュー遷移の使用方法の詳細と例については、ViewTransition ドキュメントを参照してください。

displaced 、move 、ViewTransitionも参照して ください。

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

取り得る値：

定数	説明
ListView.Horizontal	項目は水平にレイアウトされる
ListView.Vertical	(デフォルト) アイテムは縦に並べられます。

Flickable Directionも参照してください 。

このプロパティは、ビューに最初に作成されるアイテムに適用される遷移を保持します。

このプロパティは、以下の場合に作成されるすべてのアイテムに適用されます：

• ビューが最初に作成されたとき
• ビューのmodel が、表示されているデリゲートが完全に置き換えられるように変更される。
• モデルがQAbstractItemModel のサブクラスである場合、ビューのmodel はreset になります。

例えば、このような遷移を指定するビューを以下に示します：

ListView {
    ...
    populate: Transition {
        NumberAnimation { properties: "x,y"; duration: 1000 }
    }
}

ビューが初期化されると、ビューはビューに必要なすべてのアイテムを作成し、1秒かけてビュー内の正しい位置にアニメーションさせます。

しかし、後でビューをスクロールすると、デリゲートが見えるようになるにつれてインスタンス化されているにもかかわらず、populateトランジションは実行されません。新しいデリゲートが表示されるようにモデルが変更されると、add のトランジションが実行されます。したがって、デリゲートのプロパティを初期化するために、populate トランジションに依存すべきではありません。なぜなら、 トランジションはすべてのデリゲートに適用されるわけではないからです。アニメーションがプロパティのto 値を設定する場合、プロパティは最初はto 値を持つべきであり、アニメーションが実行される場合はfrom 値を設定すべきです：

ListView {
    ...
    delegate: Rectangle {
        opacity: 1 // not necessary because it's the default
    }
    populate: Transition {
        NumberAnimation { property: "opacity"; from: 0; to: 1; duration: 1000 }
    }
}

ビュー遷移の使用方法の詳細と例については、ViewTransition ドキュメントを参照してください。

add とViewTransitionも参照して ください。

このプロパティは、ビューから削除されるアイテムに適用するトランジションを保持します。

例えば、このような遷移を指定するビューを以下に示します：

ListView {
    ...
    remove: Transition {
        ParallelAnimation {
            NumberAnimation { property: "opacity"; to: 0; duration: 1000 }
            NumberAnimation { properties: "x,y"; to: 100; duration: 1000 }
        }
    }
}

このトランジションは、ビューから削除されたアイテムにのみ適用され、アイテムの削除によって置き換えられたアイテムの下のアイテムには適用されません。置き換えられたアイテムをアニメーションするには、displaced またはremoveDisplaced プロパティを設定します。

トランジションが適用される時点で、アイテムはすでにモデルから削除されていることに注意してください。

さらに、delayRemove attached プロパティがデリゲート項目に設定されている場合、delayRemove が再び false になるまで、削除トランジションは適用されません。

ビュー遷移の使用方法の詳細と例については、ViewTransition ドキュメントを参照してください。

removeDisplaced およびViewTransitionも参照して ください。

このプロパティは、ビュー内の他のアイテムの削除によって置き換えられたビュー内のアイテムに適用する遷移を保持します。

例えば、このような遷移を指定するビューを以下に示します：

ListView {
    ...
    removeDisplaced: Transition {
        NumberAnimation { properties: "x,y"; duration: 1000 }
    }
}

上のビューからアイテムが取り除かれるたびに、その下にある全てのアイテムが変位し、ビュー内で上方（水平方向の場合は横方向）に移動する。この変位が発生すると、ビュー内の新しい x,y 位置へのアイテムの移動は、指定された 1 秒間にわたってNumberAnimation によってアニメーションされます。この遷移は、実際にビューから削除されたアイテムには適用されません。削除されたアイテムをアニメーション化するには、remove プロパティを設定します。

アイテムが同時に複数の種類の操作によって置き換えられた場合、addDisplaced 、moveDisplaced または removeDisplaced のいずれのトランジションが適用されるかは定義されていません。また、アイテムが追加、移動、削除のいずれの操作によって配置されるかに応じて異なるトランジションを指定する必要がない場合は、代わりにdisplaced プロパティを設定することを検討する。

ビュー遷移の使用方法の詳細と例については、ViewTransition ドキュメントを参照してください。

displaced 、remove 、ViewTransitionも参照してください 。

falseこのプロパティをdelegate に設定すると、現在プールされているアイテムは破棄されます。

このプロパティの既定値はfalse です。

Reusing items 、pooled()、およびreused()も参照してください 。

これらのプロパティは、評価される式とセクション・ラベルの外観を決定します。

section.property は、各セクションの基準となるプロパティの名前を保持します。

section.criteria は、 に基づく各セクションの形成基準を保持します。この値は、以下のいずれかです：section.property

セクションの境界を決定する際には、大文字小文字を区別しない比較が行われます。

section.delegate は、各セクションのデリゲート・コンポーネントを保持します。その中に "section" という名前の プロパティを宣言すると、その プロパティにセクションのタイトルが格納されます。stacking order 2 required

section.labelPositioning この値は、現在のセクション・ラベルと次のセクション・ラベルがビューの開始/終 了に張り付くかどうか、ラベルがインラインで表示されるかどうかを決定します。この値は、以下の組み合わせになります：

リストの各項目には、ListView.section 、ListView.previousSection 、ListView.nextSection というプロパティがあります。

例えば、動物のリストをセクションごとに分けて表示するListView 。ListView の各項目は、モデル項目の「size」プロパティに応じて、異なるセクションに配置されます。sectionHeading デリゲートコンポーネントは、各セクションの始まりを示す水色のバーを提供します。

    // The delegate for each section header
    Component {
        id: sectionHeading
        Rectangle {
            width: ListView.view.width
            height: childrenRect.height
            color: "lightsteelblue"

            required property string section

            Text {
                text: parent.section
                font.bold: true
                font.pixelSize: 20
            }
        }
    }

    ListView {
        id: view
        anchors.top: parent.top
        anchors.bottom: buttonBar.top
        width: parent.width
        model: animalsModel
        delegate: Text {
            required property string name

            text: name
            font.pixelSize: 18
        }

        section.property: "size"
        section.criteria: ViewSection.FullString
        section.delegate: sectionHeading
    }

ListView の例と Stacking Order in ListViewも参照してください 。

このプロパティは、ビューのスクロールがドラッグやフリックの後にどのように落ち着くかを決定します。設定可能な値は以下の通りです：

snapMode currentIndexリストの移動に伴って を更新するには、 を に設定します。currentIndex highlightRangeMode ListView.StrictlyEnforceRange

highlightRangeModeも参照してください 。

このプロパティは、アイテム間の間隔を保持します。

デフォルト値は0である。

このプロパティは、垂直方向のリストのレイアウト方向を保持します。

取り得る値：

このプロパティを設定しても、orientation が Qt.Horizontal の場合は効果がありません。

ListView::layoutDirectionも参照してください 。

この Attached プロパティは、デリゲートが破棄されるかどうかを保持します。このプロパティは、デリゲートの各インスタンスにアタッチされます。デフォルト値は false です。

アニメーションが完了するまで、アイテムの破棄を遅らせる必要がある場合があります。以下のデリゲートの例では、アイテムがリストから削除される前にアニメーションが完了するようにしています。

Component {
    id: delegate
    Item {
        SequentialAnimation {
            id: removeAnimation
            PropertyAction { target: wrapper; property: "ListView.delayRemove"; value: true }
            NumberAnimation { target: wrapper; property: "scale"; to: 0; duration: 250; easing.type: Easing.InOutQuad }
            PropertyAction { target: wrapper; property: "ListView.delayRemove"; value: false }
        }
        ListView.onRemove: removeAnimation.start()
    }
}

remove トランジションが指定されている場合、delayRemove がfalse に返されるまで、そのトランジションは適用されない。

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

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

このプロパティは、現在のアイテムの外観を調整する場合などに使用できます：

ListView {
    width: 180; height: 200

    Component {
        id: contactsDelegate
        Rectangle {
            id: wrapper
            width: 180
            height: contactInfo.height
            color: ListView.isCurrentItem ? "black" : "red"
            Text {
                id: contactInfo
                text: name + ": " + number
                color: wrapper.ListView.isCurrentItem ? "red" : "black"
            }
        }
    }

    model: ContactModel {}
    delegate: contactsDelegate
    focus: true
}

このアタッチされたプロパティは、次の要素のセクションを保持します。

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

セクションは、section プロパティを使用して評価されます。

このアタッチされたプロパティは、前の要素のセクションを保持します。

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

このセクションは、section プロパティを使用して評価されます。

このアタッチされたプロパティは、この要素のセクションを保持する。

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

セクションはsection プロパティを使用して評価されます。

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

これは、デリゲートの各インスタンスにアタッチされ、ヘッダー、フッター、セクション、およびハイライトのデリゲートにもアタッチされます。

このアタッチドシグナルは、ビューにアイテムが追加された直後に発行されます。

追加トランジションが指定されている場合は、このシグナルが処理された直後に適用されます。

このシグナルは、アイテムが再利用プールに追加された後に発行されます。アイテム内部で進行中のタイマーやアニメーションを一時停止したり、再利用できないリソースを解放したりするために使用できます。

このシグナルは、reuseItems プロパティがtrue の場合のみ発行されます。

Reusing items,reuseItems,reused()も参照してください 。

この付属シグナルは、アイテムがビューから削除される直前に発行されます。

removeトランジションが指定されている場合、delayRemove がfalseであれば、このシグナルが処理された後に適用されます。

このシグナルはアイテムが再使用された後に発行される。この時点で、アイテムはプールから取り出され、コンテンツビュー内に配置され、index やrow などのモデルプロパティが更新されています。

モデルによって提供されない他のプロパティは、アイテムが再利用されても変更されません。デリゲートの内部に状態を保存することは避けるべきですが、保存する場合は、このシグナルを受信したときに手動でその状態をリセットしてください。

このシグナルは、アイテムが最初に作成されたときではなく、アイテムが再利用されたときに発行されます。

このシグナルは、reuseItems プロパティがtrue の場合のみ発行されます。

Reusing items 、reuseItems 、pooled()も参照 。

ヘッダーやフッターを考慮して、ビューを先頭または末尾に配置する。

contentX やcontentY を使用して特定のインデックスにビューを配置することは推奨されません。なぜなら、リストの先頭から項目を削除しても、他のすべての項目が再配置されるわけではないからです。また、ビューの実際の開始位置は、デリゲートのサイズによって異なる可能性があるからです。

また、ビューの実際の開始位置は、デリゲートのサイズによって異なる可能性があります。起動時にビューを配置するには、Component.onCompletedでこのメソッドを呼び出します。例えば、起動時にビューを最後に配置する場合：

Component.onCompleted: positionViewAtEnd()

現在のインデックスをデクリメントします。現在のインデックスは、keyNavigationWraps が真で、現在先頭にある場合にラップされます。このメソッドは、count がゼロの場合、何の効果もありません。

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

モデルの変更に対応する処理は、通常1フレームに1回だけ行われるようにバッチ処理されます。つまり、スクリプトブロックの中では、基礎となるモデルが変更されていても、ListView がまだ追いついていない可能性があります。

このメソッドは、ListView 、モデルの未解決の変更に即座に対応するよう強制します。

注意: メソッドは、コンポーネントが完了した後にのみ呼び出すようにしてください。

現在のインデックスをインクリメントします。現在のインデックスがラップされるのは、keyNavigationWraps が真で、現在末尾にある場合です。このメソッドは、count がゼロの場合は何の効果もありません。

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

コンテンツ座標で点x,y を含む可視アイテムのインデックスを返す。指定されたポイントにアイテムがないか、アイテムが表示されていない場合は -1 が返されます。

項目が可視領域の外にある場合は、スクロールして表示されたときにその点に項目が存在するかどうかにかかわらず、-1 が返される。

注意: メソッドは、コンポーネントが完了した後にのみ呼び出すようにしてください。

コンテンツ座標で点x,y を含む可視アイテムを返します。指定されたポイントにアイテムがない場合、またはアイテムが表示されていない場合は null が返されます。

アイテムが可視領域の外にある場合は、スクロールして表示されたときにそのポイントにアイテムが存在するかどうかにかかわらず、null が返されます。

注意: メソッドは、コンポーネントが完了した後にのみ呼び出すようにしてください。

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

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

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

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

contentX やcontentY を使用して特定のインデックスにビューを配置することは推奨されません。なぜなら、リストの先頭から項目を削除しても、他のすべての項目が再配置されるわけではないからです。また、ビューの実際の開始位置は、デリゲートのサイズによって異なる可能性があるからです。アイテムをビューに入れる正しい方法は、positionViewAtIndex を使うことです。

注意: メソッドは、コンポーネントが完了してから呼び出すようにしてください。起動時にビューを配置するには、このメソッドを Component.onCompleted で呼び出します。例えば、最後にビューを配置する場合：

Component.onCompleted: positionViewAtIndex(count - 1, ListView.Beginning)