Partilhar via


ListViewBase.SelectionMode Propriedade

Definição

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

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.

NenhumA seleção de itens está desabilitada.
SingleSem 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áriosSem 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.
EstendidoSem 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.

Aplica-se a

Confira também