ListView: syncComponents()

対象の ListView と同期している ObservableArray との同期処理を行います。

構文

listView.syncComponents(operation) => void

引数

• operation: object

  対象の ListView と同期している ObservableArray との同期に必要な情報を持つオブジェクトです。以下のプロパティを持ちます。

  • operation.kind: ObservableArray.OperationKind.SORT | ObservableArray.OperationKind.SPLICE

    配列操作の種別です。

  • operation.from: this | ObservableArray

    対象の ListView 自身またはそれと同期している ObservableArray。ListView 自身からの呼び出しではその this が設定され、ObservableArray からの同期処理の場合は ObservableArray の参照が設定されます。

  • operation.indexMap: ({ from: number, to: number })[]?

    配列要素の入れ替えを表すオブジェクトの配列です。このプロパティは operation.kind が SORT の場合のみ与えられます。

  • operation.startIndex: number

    配列要素の削除や配列への要素の挿入の開始位置を示す整数です。このプロパティは operation.kind が SPLICE の場合のみ与えられます。

  • operation.deleteCount: number

    削除される配列要素の個数を示す整数です。このプロパティは operation.kind が SPLICE の場合のみ与えられます。

  • operation.insertedItems: ViewLogic[] | ObservableObject[]

    挿入される配列要素の配列です。operation.kind が this の場合は ViewLogic の配列が与えられ、ObservableArray の場合は ObservableObject の配列が与えられます。このプロパティは operation.kind が SPLICE の場合のみ与えられます。

解説

対象の ListView と同期している ObservableArray との同期処理を行います。

この関数を明示的に呼び出す必要はありません。ObservableArray または ListView が操作されるたび、必要ならこの関数が呼び出されます。