マルチセレクトリスト
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
MultiSelectListコンポーネントは動作です。つまり、そのコンポーネント自体は何もしません。代わりに、別のコンポーネントに能力を追加します。
MultiSelectListコンポーネントはListControlコントロールに関連する動作のみです。MultiSelectListの動作は、ページにMultiSelectListコンポーネントを追加し、ListControlコントロールのBehaviorsプロパティでMultiSelectListを挙動リストに追加することで使います。
MultiSelectListの動作により、ユーザーはListControlコントロール内で複数の項目を選択できます。
MultiSelectListの動作は**、ListControl**コントロールに2つのプロパティを拡張します。
- checkedItems - ユーザーが確認した生のオブジェクトの配列を含みます。
- checkedItemIds - ユーザーがチェックしたアイテムのIDの配列を含みます。
!注MultiSelectListコンポーネントはアプリケーションのメインページに必ず追加しなければなりません。たとえその動作を追加したいListControlコントロールがサブページ上であってもです。
MultiSelectListコントロールのIDは関係なく、動作名として必ずMultiSelectListと入力します。
たとえ複数のListControlコントロールを持っていても、ページごとにMultiSelectListコンポーネントは1つだけで十分です。
方法
MultiSelectListの動作は、ListControlコントロールを8つのメソッドで拡張します。これらのメソッドを使って、デフォルトの機能が要件に合わない場合にアイテムのチェック方法やチェック解除をいつ、どのように制御します。
その方法とその論点は以下の通りです:
- checkItem(item)
- checkItem(itemId)
- checkItems(アイテムの配列)
- checkItems(itemIds の配列)
- uncheckItem(item)
- uncheckItem(itemId)
- uncheckItems(アイテムの配列)
- uncheckItems(itemIds 配列)
使用例
MultiSelectListの動作は以下の通りに使います:
ListControl.viewModel.checkItem("{EB443C0B-F923-409E-85F3-E7893C8C30C2}")
このようにcheckItem()メソッドを呼び出すと、MultiSelectListの動作が起こります:
- 指定されたアイテムのIDをcheckedItemIds配列に追加し、
- ListControlに指定された項目の行が含まれている場合、その項目をcheckedItems配列に追加し、その行をチェック済みとしてマークします。
MultiSelectListの動作は、ListControlコントロールに新しい行が追加された際にcheckedItemIds配列をスキャンし、適切な行をチェック済みとしてマークします。また、checkedItems配列も更新します。
つまり、checkedItemIds配列にはチェック依頼されたアイテムのIDが含まれ、checkedItems配列はListControlコントロール内で実際にチェック・表示されるアイテムを指します。