Lista Personalizada

Enquanto o controle Tabela representa os dados como linhas e colunas, a Lista Personalizada (anteriormente chamada de Lista Avançada) oferece flexibilidade para representar os dados no formato em que o usuário necessita. No controle Lista Personalizada, o usuário pode usar vários controles e posicioná-los como preferir, usando o Modelo. Um modelo não é nada além de um Contêiner que mantém controles e outros contêineres.

A Lista Personalizada tem 2 conjuntos de propriedades, um para a Lista Personalizada e o outro para o Modelo dentro dele.

Observação: você pode navegar entre as propriedades da Lista Personalizada e as propriedades do Modelo, clicando no controle na tela ou na visualização em árvore, à esquerda. Cada clique alterna a seleção entre Lista Avançada e seu Modelo na tela.

Propriedades da lista personalizada

Geral

• Dica de ferramenta — Dica de ferramenta a ser exibida na lista personalizada. Use a dica para fornecer informações adicionais sobre o controle.
• Origem de dados — Origem do controle da tabela. Os tipos de dados válidos são Tabela de Dados e Array de Objetos.
• Associação de valor selecionado — Associe o valor da tabela selecionado no tempo de execução a um argumento de Processo de RPA ou a um campo do aplicativo.
• Oculto — Quando selecionado, oculta o controle no tempo de execução.
• Desabilitado — Quando selecionado, desabilita o controle no tempo de execução.

Events

• Valor alterado — Configure o que deve acontecer quando o valor for alterado.

Estilo

• Alinhamento de controle — Por padrão, herda o alinhamento parent. É possível definir outro alinhamento que não o pai. Para usar o alinhamento Parent como padrão, alterne entre os ícones de alinhamento selecionados para desativar um alinhamento específico.

  Observação: o alinhamento depende do layout do pai (Vertical vs. Horizontal).
• Layout — Determine como os modelos serão exibidos na Lista Avançada. Ele pode ser apresentado horizontalmente (lado a lado) ou verticalmente (um abaixo do outro).
• Espaço intermediário — Determine o espaço entre os modelos.
• Margem — Define a margem do controle. Por padrão, a margem de 4px é definida. As propriedades Top/Bottom (Superior/Inferior) e Left/Right (Esquerda/Direita) são combinadas. Essas propriedades podem ser desvinculadas, usando-se o botão de desvinculação, do lado direito do cabeçalho da seção da Margem.
• Tamanho — A largura e a altura do controle podem ser definidas na seção de tamanho. Por padrão, o tamanho é definido como Automático. As opções de largura mínima/altura mínima e largura máxima/altura máxima estão disponíveis em mais (…), na seção de Tamanho.

Propriedades do modelo

Geral

Sem Propriedades

Events

• Clicando em — Configure o que acontece ao se clicar no modelo.

Estilo

• Layout — Determine como os controles dentro do modelo são posicionados.

  • Direção (Horizontal/vertical) - Os controles são organizados um abaixo do outro (vertical) ou um ao lado do outro (horizontal).
  • Alinhamento — Alinhamento de controles dentro do modelo (Esquerdo, Centro, Direito e Estender na vertical e Superior, Meio, Inferior e Estender na horizontal).
  • Justificar — Superior, Centro, Inferior e Distribuir na direção vertical e Esquerda, Centro, Direita e Distribuir na direção horizontal.

  • Permitir encapsulamento — se habilitada, encapsula o controle no contêiner se não houver espaço suficiente.

    Observação: A propriedade Allow Wrapping é aplicada quando o tamanho (largura ou altura) estiver configurada para um valor definido e não no Auto.
• Cor de fundo — Define a cor de fundo do modelo.
• Borda — Define a borda do controle. Com relação à borda, é possível configurar a espessura, a cor e o raio da borda.
• Preenchimento — Define o preenchimento do modelo. Por padrão, o preenchimento é definido para 8px. As propriedades de margem interna Superior/Inferior e Direita/Esquerda são combinadas. Caso outros valores de preenchimento precisarem ser definidos para os lados Superior, Inferior, Esquerdo e Direito, essas propriedades podem ser desvinculadas com o ícone de desvinculação, que fica do lado direito do cabeçalho, na seção de preenchimento.

• Tamanho - A largura e a altura do controle podem ser definidas na seção de tamanho. A largura é herdada do pai para o layout Vertical e não pode ser editada. Da mesma forma, a altura é herdada do pai para o layout horizontal e não pode ser editada. Min Width/ Min Height e Max Width/ Max Height estão disponíveis em mais (...) na seção de tamanho.

Observação:

As listas personalizadas são mais bem otimizadas quando têm uma altura de pixel fixa, que é quando a Rolagem Virtual está habilitada.

Para um grande número de linhas em uma lista personalizada, há uma opção de usar a rolagem virtual para que os elementos do visor sejam carregados instantaneamente e os próximos elementos sejam carregados de forma progressiva à medida que você rola. A rolagem virtual só funciona quando a altura da lista personalizada estiver definida como uma altura em pixels.

Se a rolagem virtual não for usada, uma lista personalizada com um grande número de linhas pode ser lenta.

A rolagem virtual melhora o desempenho carregando apenas os itens relevantes no visor quando no tempo de execução. Isso só funciona quando uma altura é configurada e não é definida como automática.

Se a propriedade Altura estiver definida como automática, o tamanho do controle no tempo de execução e o tempo de design podem não corresponder. Isso acontece porque a altura do controle depende do número de linhas retornadas no tempo de execução, enquanto no tempo de design, o controle está vazio.

Para qualquer controle com dados dinâmicos, como tabelas, listas ou listas personalizadas, recomendamos configurar uma altura fixa para melhorar o desempenho.