Editar Grade

O controle Editar grade permite a você listar, editar, paginar ou pesquisar registros tabulares.

Demonstração: editar grade

Baixe o aplicativo de demonstração Apps_Tables_Cachesheet.zip e importe-o para o UiPath Studio Web para ver um exemplo de como o controle Editar grade pode ser usado para construir uma folha de dicas de tabela para exibir e atualizar dados.

Geral

• Adicionar nova coluna — adicione novas colunas aos seus dados clicando no ícone de mais "+".
• Oculto — se verdadeiro, oculta o controle no tempo de execução.
• Editável — se falso, marca o controle como somente leitura.
• Adicionar linhas — se verdadeiro, permite que os usuários de aplicativos adicionem novas linhas no tempo de execução. Se falso, os usuários não podem adicionar novas linhas.
• Excluir linhas — se verdadeiro, permite que os usuários de aplicativos excluam linhas. Se falso, os usuários não podem excluir linhas.
• Pesquisa — se verdadeiro, expõe uma capacidade de pesquisa integrada.
  Observação:

  O Seletor de datas em Editar grade não oferece suporte à edição de tipos de coluna que contêm valores de tempo. Configure a coluna em sua entidade do Data Service usando a opção Excluir hora para evitar erros em seus dados. Se você precisar incluir uma coluna de tempo, defina a opção de Visualização em modo de edição da coluna como o tipo Caixa de texto .

Events

• Linha selecionada — configure o que deve acontecer quando uma linha é selecionada.
• Linha adicionada — configure o que deve acontecer quando uma linha é adicionada.
• Linha modificada — configure o que acontece quando uma linha é modificada.
• Linha excluída — configure o que deve acontecer quando uma linha é excluída.

Estilo

• Alinhamento de controle — Por padrão, herda o alinhamento parent. É possível definir outro alinhamento que não o pai. Para voltar ao alinhamento padrão pai, desmarque as opções substituídas.
  Observação:

  O alinhamento depende do layout selecionado para o pai (Vertical vs Horizontal).

• Cor de fundo — define a cor de fundo para o Cabeçalho da grade e o Corpo da grade.
• Borda — define a borda do controle. Espessura, cor e raio da borda podem ser configurados.
• Fonte — os atributos de fonte para o texto do Cabeçalho da coluna e Corpo da coluna , como família de fontes, tamanho, cor ou estilo (Necessário, Itálico e Sublinhado). Por padrão, o controle herda a família de fontes do contêiner pai imediato, que é indicado pela palavra-chave “herdado”.
• Margem — a margem do controle. Por padrão, uma margem de 4px é definida. As propriedades Top/Bottom e Left/Right são combinadas. Essas propriedades podem ser desanexadas usando o botão Link no lado direito da seção Margem .
• Tamanho — a largura e a altura do controle. Por padrão, o tamanho é definido como auto. Para definir valores mínimos ou máximos, clique no ícone de três pontos (*). Se o tamanho do controle for menor que as opções, será exibida uma barra de rolagem.

Propriedades VB

Expandir tabela

Propriedade do VB	Tipo de dados	Description
SelectedItem	Apps.Controls.TabularInitClass	Faz referência ao item atualmente selecionado no controle.
DataSource	Apps.Controls.ListSource(Of Apps.Controls.TabularInitClass)	Faz referência à origem de dados para os valores dentro do controle Tabela.
NewItem	Apps.Controls.TabularInitClass	Faz referência ao item que está sendo criado pela opção Adicionar linha . O evento Linha adicionada faz referência a essa propriedade.
Editable	Booleano	Determina se Editar grade é editável.
AddRows	Booleano	Determina se as linhas podem ser adicionadas a Editar grade.
DeleteRows	Booleano	Determina se as linhas podem ser excluídas de Editar grade.
RowIndex	Número inteiro	Referencia o índice da linha para atualizar e excluir operações. Deve ser usado para integração de processos em que todo o conjunto de dados está na memória.
Search	Booleano	Habilita ou desabilita a função de pesquisa. Se verdadeiro, a pesquisa é habilitada.
Value	Apps.Controls.TabularInitClass	O valor atualmente selecionado do controle.
Hidden	Booleano	Se verdadeiro, oculta o controle no tempo de execução.
Disabled	Booleano	Se verdadeiro, desabilita o controle no tempo de execução.

Conversão de dados complexos em AppsDataSource

Para converter uma tabela de dados ou um tipo de dados complexo em um AppsDataSource: salve a tabela de dados em uma variável e, em seguida, use o método .ToListSource, que converte dados da tabela de dados em AppsDataSource.

1. Salve os dados em uma variável do tipo DataTable. Por exemplo, nomeie a variável "dt".
2. No campo Origem de dados de controles de tabela, use a seguinte expressão:

   dt.ToListSource()
   

Genericamente, objetos complexos podem ser convertidos em AppsDataSource usando-se a sintaxe:

Processes.ALLDATATYPES.out_datatable.ToListSource()

Uso de entidades com controles Tabela e Editar grade

Confira Usar controles tabulares com entidades do Data Service em projetos de aplicativos para obter mais informações sobre como usar entidades com os controles Tabela e Editar grade.

Observação:

• Não há suporte para a formatação de datas com o uso dos controles Tabela e Editar grade . Ao usar colunas de data, o tipo DateTime é exibido sem formatação adicional (exibido como valores brutos). Em contraste, as colunas do tipo DateOnly são formatadas automaticamente com base nas configurações de local e idioma do navegador do usuário.
• Ao trabalhar com entidades, é recomendável usar a opção Criar fluxo de trabalho para habilitar a paginação. Usar uma variável de aplicativo de entidade como Origem de dados não é aconselhável, pois cria uma cópia local dos dados e não é compatível com a paginação do Data Fabric.