Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
As grades apresentam dados em um formato tabular em aplicativos controlados por modelos. As grades podem abranger todo o formulário ou podem ser um dos itens em um formulário; estes últimos são chamados de subgrids.
Tipos de grades
Há dois tipos de grades em aplicativos controlados por modelos:
- Grades somente leitura: exibir dados em um formato tabular. Para editar os dados exibidos em uma grade somente leitura, você precisa selecionar o registro na grade para abrir o formulário, editar os dados e salvar.
- Grades editáveis: além de exibir dados em um formato tabular, fornece recursos avançados de edição embutida em clientes web e móveis, incluindo a capacidade de agrupar, classificar e filtrar dados na mesma grade para que você não precise alternar registros ou exibições. A grade editável é um controle personalizado e tem suporte na grade principal e subgrids em um formulário no cliente Web e em painéis e em grades de formulário nos clientes móveis. Embora o controle de grade editável ofereça a capacidade de edição, ele respeita os metadados de grade em modo somente leitura e as configurações de segurança em nível de campo.
Obtendo o contexto de grade
O contexto de grade é a instância de grade ou subgrid em um formulário no qual você deseja executar seu código. Para obter mais informações sobre como obter o contexto de grade para executar seu código JavaScript, consulte o contexto de grade da API do Cliente
Eventos
| Nome | Description | Aplicável a |
|---|---|---|
| Evento Subgrid OnLoad | Ocorre sempre que o subgrid é atualizado. Isso inclui quando os usuários classificam valores na subgrid clicando nos títulos da coluna. | Grade somente leitura |
| Grid OnChange | Ocorre quando um valor é alterado em uma célula na grade editável e a célula perde o foco | Grade editável |
| Grid OnRecordSelect | Ocorre quando uma única linha (registro) é selecionada na grade editável | Grade editável |
| OnSave de grade | Ocorre antes de enviar as informações atualizadas para o servidor e, quando qualquer uma das seguintes ocorrências ocorre: há uma alteração na seleção de registro, o usuário dispara explicitamente uma operação de salvamento usando o botão salvar da grade editável ou o usuário aplica uma operação de classificação, filtro, grupo, paginação ou navegação da grade editável enquanto há alterações pendentes. | Grade editável |
Observação
Você pode se registrar para os eventos OnChange, OnRecordSelect e OnSave usando a guia Eventos da página de aplicativos controlados por modelo que é usada para habilitar grades editáveis para uma tabela ou uma grade somente leitura.
Objetos
Use os objetos a seguir para interagir com grades. Esses objetos formam uma hierarquia, conforme mostrado no diagrama a seguir:
| Nome | Description | Disponível para |
|---|---|---|
| GridControl | Fornece métodos para trabalhar com o controle de grade ou subgrid. | Grades somente leitura e editáveis |
| Grade | Fornece métodos para acessar informações sobre dados na grade. | Grades somente leitura e editáveis |
| GridRow | Fornece métodos para trabalhar com linhas ou linhas selecionadas na grade. | Grades somente leitura e editáveis |
| GridRowData | Fornece métodos para trabalhar com linhas ou linhas selecionadas na grade. | Grades somente leitura e editáveis |
| GridEntity | Fornece métodos para acessar dados sobre os registros específicos nas linhas. | Grades somente leitura e editáveis |
| GridAttribute | Fornece métodos para acessar os dados na célula de uma grade editável. | Grade editável |
| GridCell | Fornece métodos para acessar os dados relacionados ao controle em um formulário vinculado a uma coluna em uma grade editável. | Grade editável |
| ViewSelector | Fornece métodos para obter ou definir informações sobre o seletor de exibição do controle de subgrid. | Grade somente leitura |
Artigos relacionados
Contexto de grade da API do cliente
Usar grades editáveis
Referência de API do cliente para aplicativos controlados por modelo
Visão geral do desenvolvedor de aplicativos controlados por modelos