Grades e subgrades em aplicativos controlados por modelo (referência da API do cliente)

Grelhas e subgrelhas apresentam dados em formato tabular em aplicações orientadas a modelos. Use os eventos e objetos da API do Cliente neste artigo para trabalhar com grelhas apenas de 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 grelhas

Há dois tipos de grades em aplicativos controlados por modelo:

• Grades somente leitura: exibem dados em 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.
• Grelhas editáveis: Para além de exibir dados em formato tabular, oferece capacidades ricas de edição em linha em clientes web e móveis, incluindo a possibilidade de agrupar, ordenar e filtrar dados dentro da mesma grelha, para que não tenha de mudar de registo ou vista. A grade editável é um controle personalizado e é suportada na grade principal e subgrades em um formulário no web client e em painéis e grades de formulário nos clientes móveis. Embora o controle de grade editável forneça capacidade de edição, ele respeita os metadados de grade somente leitura e as configurações de segurança no nível do campo.

Obtenha o contexto da grelha

Contexto de grade é a instância de grade ou subgrade em um formulário no qual você deseja executar seu código. Para mais informações sobre como obter o contexto da grelha para executar o seu código JavaScript, consulte Contexto da grelha da API do cliente.

Eventos de grelha

Nome	Description	Aplicável para
Evento Subgrid OnLoad	Ocorre sempre que a subgrade é atualizada. Este evento inclui quando os utilizadores ordenam valores na subgrelha clicando nos cabeçalhos das colunas.	Grelha só de leitura
Grade OnChange	Ocorre quando um valor é alterado em uma célula na grade editável e a célula perde o foco	Grelha editável
Grade OnRecordSelect	Ocorre quando uma única linha (registro) é selecionada na grade editável	Grelha editável
Grade OnSave	Ocorre antes de enviar a informação atualizada para o servidor, e quando ocorre qualquer uma das seguintes situações: há uma alteração na seleção do registo, o utilizador desencadeia explicitamente uma operação de gravação usando o botão de gravação da grelha editável, ou o utilizador aplica uma operação de ordenação, filtro, agrupamento, paginação ou navegação a partir da grelha editável enquanto há alterações pendentes.	Grelha editável

Observação

Pode registar-se nos eventos OnChange, OnRecordSelect e OnSave usando o separador Eventos da página de aplicações orientadas a modelos que utiliza para ativar grelhas editáveis para uma tabela ou uma grelha de apenas leitura.

Objetos da grelha

Use os seguintes objetos para interagir com grades. Esses objetos formam uma hierarquia conforme mostrado no diagrama a seguir:

Nome	Description	Disponível para
Controlo de grelha	Fornece métodos para trabalhar com o controle de grade ou subgrade.	Grades somente leitura e editáveis
Grelha	Fornece métodos para acessar informações sobre dados na grade.	Grades somente leitura e editáveis
Linha de grade	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.	Grelha editável
GridCell	Fornece métodos para acessar os dados relacionados ao controle em um formulário que está vinculado a uma coluna em uma grade editável.	Grelha editável
ViewSelector	Fornece métodos para obter ou definir informações sobre o seletor de exibição do controle de subgrade.	Grelha só de leitura

Artigos relacionados

Contexto da grade da API do cliente
Usar grades editáveis
Referência da API do cliente para aplicativos controlados por modelo
Guia para programadores de aplicações orientadas a modelos