Como adicionar um modo de exibição de lista (XAML)

Applies to Windows and Windows Phone

Este tutorial guia você pelas etapas para adicionar um modo de exibição de lista a um aplicativo do Tempo de Execução do Windows em C++, C# ou Visual Basic.

Você normalmente adiciona um modo de exibição de lista usando o editor de linguagem XAML ou uma ferramenta de design, como Blend para Visual Studio. Também é possível adicionar um modo de exibição de lista usando código em tempo de execução.

Mapa: Como este tópico está relacionado aos outros? Veja:

O que você precisa saber

Tecnologias

Pré-requisitos

Instruções

Etapa 1: Adicionar um modo de exibição de lista no XAML

Hh943062.wedge(pt-br,WIN.10).gifPara adicionar um modo de exibição de lista no XAML

  1. Adicione um controle ListView a um contêiner pai.
  2. Para atribuir um nome ao modo de exibição de lista, defina o atributo x:Name como um valor de cadeia de caracteres.

    Para fazer referência a um controle no código, ele deve ter um nome. Caso contrário, um nome não será necessário.

  3. Adicione itens ao modo de exibição de lista populando a coleção Items ou associando a propriedade ItemsSource a uma fonte de dados.

    Aqui está um exemplo de como popular a coleção Items no XAML.

    
    <ListView x:Name="listView1" SelectionChanged="ListView_SelectionChanged">
        <x:String>Item 1</x:String>
        <x:String>Item 2</x:String>
    </ListView>
    
    
    

    Aqui está um exemplo de como associar uma ItemsSource a uma coleção no XAML. A ItemsSource é associada ao DataContext do ListView, que é definido em código.

    
    <ListView ItemsSource="{Binding}" SelectionChanged="ListView_SelectionChanged"/>
    
    
    
  4. Para executar uma ação quando o modo de exibição de lista muda, adicione um manipulador para o evento SelectionChanged. No manipulador de eventos SelectionChanged, adicione código para executar algumas ações.
    
    Private Sub ListView_SelectionChanged()
        ' Add code to perform some action here.
    End Sub
    
    
    

    Para verificar o item selecionado do controle externo ao evento SelectionChanged, use a propriedade SelectedItem ou SelectedIndex.

Etapa 2: Adicionar um modo de exibição de lista em código

Hh943062.wedge(pt-br,WIN.10).gifPara adicionar um modo de exibição de lista em código

  1. Crie um novo ListView.
  2. Adicione itens ao modo de exibição de lista populando a coleção Items ou definindo a propriedade ItemsSource como uma coleta de dados.
  3. Para executar uma ação quando o modo de exibição de lista muda, adicione um manipulador para o evento SelectionChanged. No manipulador de eventos SelectionChanged, adicione código para executar alguma ação.
  4. Adicione a ListView a um contêiner pai na árvore visual. Isso é necessário para mostrar o modo de exibição de lista na interface do usuário.

    Aqui está um exemplo de como adicionar um ListView e popular a coleção Items em código.

    
    ' Create a new list view, add content, 
    ' and add a SelectionChanged event handler.
    Dim listView1 = New ListView()
    listView1.Items.Add("Item 1")
    listView1.Items.Add("Item 2")
    AddHandler listView1.SelectionChanged, AddressOf Me.ListView_SelectionChanged
    
    ' Add the list view to a parent container in the visual tree.
    stackPanel1.Children.Add(listView1)
    
    
    

    Aqui está um exemplo de como adicionar um ListView e definir a ItemsSource em código.

    
    ' Data source.
    Dim itemsList = New List(Of String)()
    itemsList.Add("Item 1")
    itemsList.Add("Item 2")
    
    ' Create a new list view, add content, 
    ' and add a SelectionChanged event handler.
    Dim listView1 = New ListView()
    listView1.ItemsSource = itemsList
    AddHandler listView1.SelectionChanged, AddressOf Me.ListView_SelectionChanged
    
    ' Add the list view to a parent container in the visual tree.
    stackPanel1.Children.Add(listView1)
    
    
    
  5. Para executar uma ação quando o modo de exibição de lista muda, adicione um manipulador para o evento SelectionChanged. No manipulador de eventos SelectionChanged, adicione código para executar algumas ações.
    
    Private Sub ListView_SelectionChanged()
        ' Add code to perform some action here.
    End Sub
    
    
    

    Para verificar o item selecionado do controle externo ao evento SelectionChanged, use a propriedade SelectedItem ou SelectedIndex.

Etapa 3: Adicionar um modo de exibição de lista usando uma ferramenta de design

Hh943062.wedge(pt-br,WIN.10).gifPara adicionar um modo de exibição de lista usando uma ferramenta de design

  1. Selecione o controle ListView.
    • No Microsoft Visual Studio, selecione o ListView no painel Caixa de Ferramentas.
    • No Blend para Visual Studio, escolha o ListView no painel Ativos.

      Selecione Controles no lado esquerdo do painel Ativos, se ainda não estiver selecionado.

  2. Adicione uma ListView à superfície de design. Execute uma das seguintes ações:
    • Clique duas vezes no modo de exibição de lista. O modo de exibição de lista é adicionado ao contêiner pai selecionado com as configurações padrão de posição e tamanho.
    • Arraste o modo de exibição de lista para a superfície de design e o solte. O modo de exibição de lista é adicionado na posição onde você o solta com as configurações padrão de tamanho.
    • Desenhe o modo de exibição de lista na superfície de design. O modo de exibição de lista é adicionado com as configurações de tamanho e posição que você desenha.
  3. Se precisar, atribua um nome ao ListView. Com o modo de exibição de lista selecionado, digite o nome na caixa de texto da propriedade Nome.

    A caixa de texto da propriedade Nome está na parte superior do painel Propriedades. Para fazer referência a um controle no código, ele deve ter um nome. Caso contrário, um nome não será necessário.

  4. Adicione itens ao modo de exibição de lista populando a coleção Items ou associando a propriedade ItemsSource a uma coleta de dados.
  5. Para executar uma ação quando o modo de exibição de lista muda, adicione um manipulador para o evento SelectionChanged. No manipulador de eventos SelectionChanged, adicione código para executar alguma ação.
    1. Selecione a exibição Evento no painel Propriedade.
    2. Com o modo de exibição de lista selecionado na superfície de design, execute um dos seguintes procedimentos:
      • Clique duas vezes na caixa de texto do evento SelectionChanged para adicionar um manipulador com um nome padrão.
      • Digite um nome na caixa de texto do evento SelectionChanged e pressione Enter para adicionar um manipulador com um nome personalizado.

Tópicos relacionados

ListView
Guia de início rápido: adicionando controles ListView e GridView
Mapa de aplicativos do Tempo de Execução do Windows em C# ou Visual Basic
Mapa de aplicativos do Tempo de Execução do Windows em C++

 

 

Mostrar:
© 2015 Microsoft