Compartilhar via


Criar e atualizar uma coleção em um aplicativo de tela

Use uma coleção para armazenar dados que os usuários podem gerenciar em seu aplicativo. Uma coleção é um grupo de itens semelhantes, como produtos em uma lista de produtos. Para mais informações sobre diferentes tipos de variáveis, como coleções: Noções básicas sobre variáveis de aplicativo de tela.

Pré-requisitos

  • Inscreva-se no Power Apps e depois entre fornecendo as mesmas credenciais que usou para se inscrever.
  • Crie um aplicativo ou abra um aplicativo existente no Power Apps.
  • Saiba como configurar um controle no Power Apps.

Assista a este vídeo para aprender como criar e atualizar uma coleção:

Criar uma coleção de várias colunas

  1. No Power Apps Studio, adicione um controle Entrada de texto.

  2. Renomeie o controle selecionando suas reticências no painel de navegação esquerdo, selecionando Renomear e, em seguida, digitando ProductName.

    Captura de tela que mostra como renomear um controle.

  3. Adicione um controle Lista suspensa.

    Captura de tela que mostra como adicionar uma lista suspensa.

  4. Renomeie o controle Lista suspensa para Colors e verifique se a propriedade Items está selecionada na lista de propriedades.

    Captura de tela que mostra a propriedade Items ao lado da barra de fórmulas.

  5. Na barra de fórmulas, substitua DropDownSample por esta expressão:

    ["Red","Green","Blue"]

  6. Adicione um controle Botão, defina sua propriedade Text como "Add" e defina sua propriedade OnSelect como esta fórmula:

    Collect(
        ProductList,
        {
            Product: "ProductName.Text",
            Color: "Colors.Selected.Value"
        }
    )
    
  7. Para visualizar o aplicativo, pressione F5 ou selecione o botão de reprodução. Digite o texto em ProductName, selecione uma opção em Cores e selecione Adicionar.

  8. Repita a etapa anterior pelo menos mais duas vezes e pressione Esc.

  9. Selecione o painel Variáveis e, em seguida, selecione Coleções para ver as coleções que você criou.

    Captura de tela que mostra a seção Coleções da lista Variáveis.

Mostrar uma coleção

  1. Selecione o controle Inserir>Galeria vertical.

  2. Defina a propriedade Items da galeria como ProductList.

  3. Selecione a galeria na exibição de árvore e escolha Campos.

  4. Defina o campo de subtítulo como Cor e defina o campo de título como Produto.

  5. Selecione Layout>Título e subtítulo.

    Captura de tela que mostra a guia Layout com o título Título e subtítulo selecionado.

Remover um ou todos os itens

  1. Selecione a galeria e adicione um ícone de Lixo ao modelo de galeria.

  2. Defina a propriedade OnSelect do ícone como esta fórmula:

    Remove(ProductList, ThisItem)

  3. Fora da galeria, adicione um botão, defina sua propriedade Text como "Clear" e defina sua propriedade OnSelect como esta fórmula:

    Clear(ProductList)

  4. Enquanto pressiona a tecla Alt, selecione o ícone da Lixeira de um item para remover esse item da coleção ou selecione o botão Limpar para remover todos os itens da coleção.

Colocar uma lista em uma coleção

  1. Cria uma conexão a uma lista criada usando Listas da Microsoft.

  2. Adicione um botão e defina sua propriedade OnSelect para essa função, substituindo ListName pelo nome da lista:

    Collect(MySPCollection, ListName)

    Essa função cria uma coleção denominada MySPCollection que contém os mesmos dados da lista.

  3. Mantendo a tecla Alt pressionada, selecione o botão.

Para obter informações de como mostrar dados em um formulário (com listas suspensas, seletores de data e seletores de pessoas): Controles Editar formulário e Exibir formulário.

Próximas etapas