ListViewBase.SelectionMode プロパティ

  • リファレンス

定義

名前空間:
Microsoft.UI.Xaml.Controls
編集

ListViewBase インスタンスの選択動作を取得または設定します。

public:
 property ListViewSelectionMode SelectionMode { ListViewSelectionMode get(); void set(ListViewSelectionMode value); };
ListViewSelectionMode SelectionMode();

void SelectionMode(ListViewSelectionMode value);
public ListViewSelectionMode SelectionMode { get; set; }
var listViewSelectionMode = listViewBase.selectionMode;
listViewBase.selectionMode = listViewSelectionMode;
Public Property SelectionMode As ListViewSelectionMode
<listViewBase SelectionMode="listViewSelectionModeMemberName" />

プロパティ値

ListViewSelectionMode

ListViewSelectionMode 列挙値のいずれか。 既定値は [単一選択] です。

注釈

既定では、ユーザーはビュー内の 1 つの項目を選択できます。 SelectionMode プロパティを ListViewSelectionMode 列挙値に設定すると、複数選択を有効にしたり、選択を無効にしたりできます。 選択モードの値を次に示します。

  • ユーザーはスペース バー、マウスのクリック、タッチ操作のタップを使って 1 つの項目を選択できます。
  • ユーザーは、下向きのスワイプ ジェスチャを使用して項目の選択を解除できます。
Ctrl キーを押しながら:
  • ユーザーは、スペース バー、マウス クリック、またはタッチ タップを使用して項目の選択を解除できます。
  • 方向キーを使うと、選択した項目とは関係なくフォーカスを移動できます。
  • ユーザーは、スペース バー、マウスのクリック、タッチ操作のタップを使って、フォーカスのある項目の選択状態を切り替えることで、複数の項目を選択できます。
  • 方向キーを使うと、選択した項目とは関係なくフォーカスを移動できます。
  • 動作は と同じです
    • ユーザーは、スペース バー、マウスのクリック、タッチ操作のタップを使って、フォーカスのある項目の選択状態を切り替えることで、複数の項目を選択できます。
    • 方向キーを使うと、選択した項目とは関係なくフォーカスを移動できます。
    Shift キーを押しながら:
    • ユーザーは、選択する最初の項目をクリックまたはタップした後、選択する最後の項目をクリックまたはタップすることで、複数の項目を連続的に選択できます。
    • 方向キーを使用すると、Shift キーが押されたときに選択された項目を起点として連続的に選択することができます。

注意

タッチ操作は、 IsSwipeEnabled が true の場合にのみ有効になります。

SelectionMode が None で、 CanDragItems と CanReorderItems が false の場合、アプリのパフォーマンスを向上させるには 、IsSwipeEnabled を false に設定する必要があります。 詳細については、 IsSwipeEnabled プロパティを参照してください。

SelectionMode が Single の場合は、 Selector.SelectedItem プロパティを使用して、選択されている項目を取得します。 SelectionMode が Multiple または Extended の場合は、 SelectedItems プロパティを使用して、選択されている項目を取得します。

アイテムの選択を無効にすると、ユーザーが選択されているのではなく、ボタンのようにクリックしたときにアイテムを応答させることができます。 これを行うには、SelectionMode を None に設定し、 IsItemClickEnabled プロパティを true に設定し、 ItemClick イベントを処理します。

詳細と例については、「 操作モードを変更する方法」を参照してください。

適用対象

こちらもご覧ください