ListViewBase.SelectionMode Propriedade

Definição

Namespace:

Windows.UI.Xaml.Controls

Obtém ou define o comportamento de seleção de uma instância 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" />

Valor da propriedade

ListViewSelectionMode

Um dos valores de enumeração ListViewSelectionMode . O padrão é Seleção única .

Comentários

Por padrão, um usuário pode selecionar um único item em um modo de exibição. Você pode definir a propriedade SelectionMode como um valor de enumeração ListViewSelectionMode para habilitar a seleção múltipla ou desabilitar a seleção. Aqui estão os valores do modo de seleção.

Nenhum	A seleção de itens está desabilitada.
Single	Sem chaves modificadoras: Um usuário pode selecionar um único item usando a barra de espaço, um clique do mouse ou um toque. Um usuário pode desmarcar um item usando um gesto de passar o dedo para baixo. Ao pressionar Ctrl: Um usuário pode desmarcar o item usando a barra de espaço, o clique do mouse ou o toque. Com as teclas de seta, um usuário pode mover o foco independentemente da seleção.
Vários	Sem chaves modificadoras: Um usuário pode selecionar vários itens usando a barra de espaço, um clique do mouse ou um toque para alternar a seleção do item focalizado. Com as teclas de seta, um usuário pode mover o foco independentemente da seleção.
Estendido	Sem chaves modificadoras: O comportamento é o mesmo que da seleção Único. Ao pressionar Ctrl: Um usuário pode selecionar vários itens usando a barra de espaço, um clique do mouse ou um toque para alternar a seleção do item focalizado. Com as teclas de seta, um usuário pode mover o foco independentemente da seleção. Ao pressionar Shift: Um usuário pode selecionar vários itens adjacentes clicando ou tocando no primeiro item da seleção e, em seguida, no último item da seleção. Com as teclas de seta, um usuário pode criar uma seleção contígua começando com o item selecionado quando Shift é pressionada.

Observação

As interações por toque são habilitadas somente quando IsSwipeEnabled é true.

Se SelectionMode for None e CanDragItems e CanReorderItems forem false, você deverá definir IsSwipeEnabled como false para melhorar o desempenho do aplicativo. Consulte a propriedade IsSwipeEnabled para obter mais informações.

Quando SelectionMode for Single, use a propriedade Selector.SelectedItem para obter o item selecionado. Quando SelectionMode for Múltiplo ou Estendido, use a propriedade SelectedItems para obter os itens selecionados.

Quando a seleção de itens está desabilitada, você pode fazer com que os itens respondam a um clique do usuário como um botão em vez de serem selecionados. Para fazer isso, defina SelectionMode como None, a propriedade IsItemClickEnabled como true e manipule o evento ItemClick .

Para obter mais informações e exemplos, consulte Como alterar o modo de interação.

Confira também

• SelectedItems
• SelectedItem
• SelectedIndex
• SelectionChanged
• Como alterar o modo de interação