Função

A grade é um componente de tabela poderoso e muito customizável. Em suas configurações é possível... (deixar isso pro final)

 FAZENDO NO NOVO AMBIENTE... 

Uso

Principais propriedades

Configurações

A propriedade Configurações abre a janela de Opções da Grade, nela podemos realizar diversas personalizações, como: indicar a(s) fonte(s) de dados, configurar modelo de grade, definir e configurar cada coluna, alterar o modo de edição e adição de itens, adicionar botões com funcionalidades personalizadas, alterar template e mais outras tantas funcionalidades.

No item (1) da Figura 1.1, temos a área de detalhes com o Master (principal e que não pode ser excluído) e o Novo, criado posteriormente. Cada detalhe pode ser responsável por personalizar uma grade, sendo possível definir Modelos (2) e as configurações das abas (3) para cada uma delas ou vincular duas fontes de dados a uma mesma grade. Com os detalhes é possível adicionar uma subgrade a uma grade, permitindo por exemplo que em uma grade de funcionário, cada linha tenha uma subgrade com os seus dependentes ou, ao invés de exibir uma subgrade com a lista de dependentes, criar uma nova coluna com o número total de dependentes de cada funcionário, dado que seria obtido em um detalhe distinto e vinculado a Master.

Na Figura 1.1 mostrando as áreas de configuração da janela Opções da Grade.

Figura 1.1 - Janela de Opções da Grade

1. Detalhes: permite selecionar cada detalhe e configurá-los separadamente, além de adicionar e remover detalhes. O Master não pode ser removido.
2. Modelos: é possível selecionar modelos pré configurados de grade ou de customização. Temos cinco opções:
   • Editável simples: (Ver a diferença).....
   • Editável completa: (Ver a diferença).....
   • Listagem simples: exibe os itens como em uma tabela, permitido apenas ordenação por coluna;
   • Listagem completa: exibe os itens como em uma tabela, mas possui funcionalidades como: paginar, ordenar, agrupar, atualizar grade e outros;
   • Customizado: permite a personalização de todos os componentes da grade;
3. Abas de customização: toda a personalização da grade é feita nessa área. Abaixo detalharemos o conteúdo de cada uma das abas.

Aba Geral

A aba Geral (item (3) da Figura 1.1) define as configurações mais amplas da grade, como fonte de dados, tamanho e modo de edição.

• Fonte de dados: seleciona uma fonte existente na view, cria uma nova fonte de dados ou edita a fonte selecionada;
• Altura: define a altura da grade na página em número de pixel e aceita somente valores numéricos;
• Editável: informa se os itens poderão ser editáveis e como ocorrerá essa edição. As possibilidades são:
  1. Não: não é possível editar ou excluir itens da grade e os botões são ocultos da grade;
  2. Em linha: a adição ou edição ocorre na própria linha da grade;
  3. Pop up: um pop é aberto com os campos para inserção ou edição do item selecionado;
  4. Pop up customizado: habilita os campos Pop up inserção e Pop up edição;
  5. Pelo Datasource: a grade é oculta da tela e os campos de entrada de texto são exibidos na tela para edição ou adição, assim como ocorre nas páginas de CRUD no Cronapp;
• Pop up inserção: são exibidos os modais criados pelo usuário na view, dessa forma o usuário pode personalizar a inserção de item.
• Pop up edição: são exibidos os modais criados pelo usuário na view, dessa forma o usuário pode personalizar a edição de item.
• Permite selecionar linha: quando habilitado, ao clica em uma linha a mesma ficará marcada após o cursor do mouse não está mais em cima do item.

Aba Exibição

A aba de Exibição habilita ou desabilita algumas funcionalidades da grade.

Figura 1.2 - Aba que habilita alguns de itens a serem exibidos na grade. 

1. Permitir paginar: realiza a paginação dos itens, informando a página atual e botões para avançar e retroceder a lista;
2. Permitir ordenar: possibilita ordenar a lista baseada na coluna selecionada. O primeiro clique no cabeçalho da coluna ordena de forma crescente, o seguindo clique de forma decrescente e o terceiro retorna a ordenação da fonte de dados. A coluna ordenada além de exibir setas (↑ e ↓) ao lado do título no cabeçalho, fica em um tom mais escuro, destacando qual coluna está ordenando a grade. 
3. Permitir agrupar: gera agrupamento das colunas selecionadas, basta clicar e arrastar o cabeçalho de uma das coluna para a área logo acima da do cabeçalho;
4. Permitir atualizar grade: adiciona botão para atualização da grade sem a necessidade de carregar a página inteira;
5. Permitir seleção do total de páginas a exibir: (Ver a diferença).....

Aba Barra de ferramenta