Partilhar via

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

As grades apresentam dados em um formato tabular em aplicativos controlados por modelo. 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.
  • Grades editáveis: além de exibir dados em um formato tabular, fornece recursos avançados de edição em linha 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 é 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.

Obter 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 obter mais informações sobre como obter o contexto de grade para executar seu código JavaScript, consulte Contexto de grade da API do cliente

Events

Nome Description Aplicável para
Evento Subgrid OnLoad Ocorre sempre que a subgrade é atualizada. Isso inclui quando os usuários classificam os valores na subgrade 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 as informações atualizadas para o servidor e quando ocorre qualquer uma das seguintes situações: há uma alteração na seleção de registros, 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. Grelha 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 usada para habilitar grades editáveis para uma tabela ou uma grade somente leitura.

Objects

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

A hierarquia de objetos disponíveis em grades

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

Contexto da grade da API do cliente
Usar grades editáveis
Referência da API do cliente para aplicativos controlados por modelo
Visão geral do desenvolvedor de aplicativos orientados por modelo

  • Last updated on