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.
Grades e subgrids apresentam dados em um formato tabular em aplicativos controlados por modelos. Use os eventos e objetos da API do cliente neste artigo para trabalhar com grades somente leitura e editáveis. 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 dentro da 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.
Obter 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 de grade
| Nome | Description | Aplicável a |
|---|---|---|
| Evento Subgrid OnLoad | Ocorre sempre que o subgrid é atualizado. Esse evento 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 nos eventos OnChange, OnRecordSelect e OnSave usando a guia Eventos da página de aplicativos controlados por modelo que você usa para habilitar grades editáveis para uma tabela ou uma grade somente leitura.
Objetos de grade
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
Guia do desenvolvedor de aplicativos controlados por modelos