Função

Lista com swipe são componentes Item com swipe vinculado a uma Fonte de dados, Dessa forma, é possível associar o conteúdo da lista com registros da fonte de dados.. Além disso, a lista com swipe permite que o usuário realize ações através dos botões que aparecem após arrastar um dos itens da lista para esquerda o componente.

Figura 1.1 - Exemplo da Lista com swipe rodando no Aplicativo

Principais propriedades

Na tabela abaixo estão descritos as principais propriedades para o funcionamento básico do componente.

Lista com swipe

Vincular fonte de dados

O funcionamento básico do componente é através do vínculo de uma fonte de dados com o componente. Assim, insera e configure a fonte de dados na área de design, e após, adicione a lista com swipe, em propriedades, selecione para fazer o vínculo (Figura 2.1) dessa fonte com o componente.

Figura 2.1 - Víncular fonte de dados existente no formulário ao componente

Itens

Após selecionar uma fonte de dados (propriedade Fonte de dados) é necessário apenas 1 item configurado com um dos campos da fonte de dados para exibir uma lista de registros. Para fazer essa configuração, vá na propriedade Itens e clique no subcomponente Item para fazer sua seleção e, assim, pode abrir a janela de conteúdo e fazer o vínculo do conteúdo com um campo da fonte de dados.

Figura 2.2.1 - Víncular dados ao componente

A propriedade Itens permite adicionar subcomponente Item na Lista, excluir (1 da Figura 2.2.2), alterar a ordem de exibição desses subcomponentes (2 da Figura 2.2.2) e ao clicar sobre o item, é possível acessar suas configurações. A configuração de cada Item é independente, permitindo botões com ações distintas para cada Item. A adição de novos itens na Lista com swipe é usada para mesclar conteúdos na lista, exibindo outro campo da fonte de dados ou um conteúdo estático.

Figura 2.2.2 - Propriedade Itens da Lista

No exemplo da Figura 2.1, o primeiro Item possui o campo "name" da fonte de dados associada e o segundo possui o texto estático "Item intermediário". Ao executar, é possível notar que a Lista com swipe intercala entre um nome da fonte de dados e um item com o texto estático (Figura 2.2). Dessa forma, para cada registro da fonte de dados, será exibido um item com o texto estático "Item intermediário".

Figura 2.2 - Execução da Lista com swipe configurada da figura 2.1

Subcomponente Item

Para mais detalhes, acesse a documentação do componente Botão.

Propriedade itens do Item

A propriedade itens do subcomponente Item é responsável por organizar os botões que são exibidos ao deslizar o registro da lista para esquerda. Para configurar esta propriedade, é necessário selecionar um dos subcomponentes Item na propriedade itens da Lista com swipe.

Figura 2.2 - Adicionar ou remover um botão do item

Subcomponente Botão

Para mais detalhes, acesse a documentação do componente Item.

Vincular fonte de dados ao componente

O funcionamento básico do componente é através do vínculo de uma fonte de dados com o componente. Assim, insera e configure a fonte de dados na área de design, e após, adicione a lista com swipe e, em propriedades, selecione para fazer o vínculo (Figura 2.3) dessa fonte com o componente.

Figura 2.3 - Víncular fonte de dados existente no formulário ao componente

Vincular dados da fonte ao componente

Para vincular os dados da fonte ao componente, clique sobre o item e clique em … ao lado do campo conteúdo para abrir a janela de configuração do conteúdo. Assim, selecione a aba campo de tela e escolha qual das colunas dessa fonte mostrará os dados no componente (Figura 2.4).

Figura 2.4 - Víncular dados ao componente