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 列舉值。 預設值為 [單一 選取專案]。

備註

根據預設，用戶可以在檢視中選取單一專案。 您可以將 SelectionMode 屬性設定為 ListViewSelectionMode 列舉值，以啟用多重選取或停用選取。 以下是選取模式值。

  • 使用者可以使用空格鍵、按一下滑鼠或觸控點選來選取單一項目。
  • 用戶可以使用向下撥動手勢取消選取專案。
按下 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 事件。

如需詳細資訊和範例，請參閱 如何變更互動模式。

適用於

另請參閱