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