RadListViewアイテムの選択

"RadListView" は、 アイテムを選択または選択解除するメカニズムを実装します。選択メカニズムを使用する場合、2つの選択モードを使用できます。

• 単一選択
• 複数選択

"RadListView" はまた、プログラムで項目を選択または選択解除し、 現在選択されている項目を取得するための便利なAPIも公開しています。次のメソッドは、選択を管理するために "RadListView" によって公開されています。

• "selectAll()" - データソース内のすべての使用可能なアイテムを選択します
• "deselectAll()" - データソースから現在選択されているすべてのアイテムの選択を解除します
• "selectItemAt(index)" - 指定されたインデックスのアイテムを選択します
• "deselectItemAt(index)" - 選択されている場合、指定されたインデックスにある項目の選択を解除します
• "isItemSelected(item)" - 提供されたアイテムが選択されているかどうかを返します
• "getSelectedItems()" - 現在選択されている項目の配列を返します

RadListViewでの選択の有効化

"selectionBehavior" プロパティの値によって、 アイテム選択の動作が決まります。 "ListViewSelectionBehavior" 列挙からの値を受け入れます。

• "None" - アイテムは選択できません
• "Press" - タップすることによって選択されます
• "LongPress" - 長押しすることによって選択されます

さらに、"multipleSelection" プロパティの値によって、 使用される選択モードが決まります。使用可能なオプションは次のとおりです。

• 複数選択モード - 複数のアイテムを選択できます。 RadListViewは選択された項目を追跡し、getSelectedItems()メソッドを通じてそれらを公開します。 multipleSelectionプロパティをtrueに設定すると、複数選択が有効になります。
• 単一選択モード - 一度に選択できる項目は1つだけです。 このモードを有効にするには、multipleSelectionプロパティをfalseに設定します。

例1：XMLのRadListViewで複数選択を有効にする：

<lv:RadListView id="listView" items="{{ dataItems }}" row="1" selectionBehavior="Press" multipleSelection="true">

選択イベントの処理

アイテムの選択状態が変更されたときに通知するために、"RadListView" は次のイベントを公開します。

• "itemSelecting" - アイテムが選択される前に発生します。操作をキャンセルするために使用できます
• "itemSelected" - アイテムが正常に選択された後に発生します。この時点で、項目はすでに "getSelectedItems()" メソッドによって返された選択された項目配列にあります
• "itemDeselecting" - アイテムが選択解除される前に発生します。操作をキャンセルするために使用できます
• "itemDeselected" - アイテムが正常に選択解除された後に発生します。この時点では、項目は "getSelectedItems()" メソッドによって返される選択された項目配列の一部ではありません。

参考文献

このシナリオを実際に見てみたいですか？ GitHubのSDKサンプルリポジトリを確認してください。これとNativeScript UIを使用した他の多くの実用的な例があります。

• アイテムの選択の例