Como alterar o modo de seleção (HTML)

[ Este artigo destina-se aos desenvolvedores do Windows 8.x e do Windows Phone 8.x que escrevem aplicativos do Windows Runtime. Se você estiver desenvolvendo para o Windows 10, consulte documentação mais recente ]

A propriedade selectionMode do controle ListView especifica como o usuário pode selecionar itens na lista.

O que você precisa saber

Tecnologias

• Crie seu primeiro aplicativo do Tempo de Execução do Windows em JavaScript
• ListView

Pré-requisitos

• Presumimos que você possa criar um controle ListView. Para saber mais, veja o guia de início rápido para adicionar ListView.

Instruções

Alterar o modo de seleção

A propriedade selectionMode oferece suporte aos seguintes valores, conforme definido pela enumeração SelectionMode:

Termo	Descrição
nenhum	Os itens não podem ser selecionados.
único	Somente um item pode ser selecionado. Clicar em um item altera a seleção desse item.
vários	Vários itens podem ser selecionados. Clicar em itens adicionais os coloca na seleção.

 

Para especificar o modo de seleção em HTML, use o atributo data-win-options para definir a selectionMode como uma representação de cadeia de caracteres de um dos valores de enumeração permitidos, como "none" ou "single".

Para especificar o modo de seleção em HTML

• Este exemplo define o modo de seleção para que somente um único item possa ser selecionado.

  <div id="basicListView" 
      data-win-control="WinJS.UI.ListView"
      data-win-options="{ itemDataSource : DataExample.itemList.dataSource, itemTemplate: select('#mediumListIconTextTemplate'), selectionMode: 'single'}">
  </div> 
  

Para especificar o modo de seleção em JavaScript, recupere o controle e defina sua propriedade selectionMode.

Para especificar o modo de seleção em JavaScript

• O próximo exemplo define o modo de seleção para que somente um único item possa ser selecionado.

  var myListView = document.getElementById("basicListView1").winControl;
  myListView.selectionMode = WinJS.UI.SelectionMode.single;
  

Tópicos relacionados

Guia de início rápido: adicionando um ListView