Grellas e subgrellas en aplicacións baseadas en modelos (Referencia da API do cliente)

As grellas presentan datos en formato tabular en aplicacións baseadas en modelos. As cuadrículas poden abarcar todo o formulario ou poden ser un dos elementos dun formulario; estas últimas chámanse subreixas.

Tipos de grellas

Existen dous tipos de grellas nas aplicacións baseadas en modelos:

• Cuadrículas de só lectura: Mostrar os datos nun formato tabular. Para editar os datos que se mostran nunha grella de só lectura, ten que seleccionar o rexistro na grella para abrir o formulario, editar os datos e, a continuación, gardar.
• Grellas editables: Ademais de mostrar datos nun formato tabular, ofrece ricas capacidades de edición en liña en clientes web e móbiles, incluíndo a posibilidade de agrupar, ordenar e filtrar datos dentro da mesma grella para que non teña que cambiar de rexistro ou vistas. A grella editable é un control personalizado e está soportada na grella principal e nas subgrellas dun formulario no cliente web e nos paneis de control e nas grellas de formularios nos clientes móbiles. Aínda que o control de grella editable proporciona capacidade de edición, respecta os metadatos da grella de só lectura e a configuración de seguridade a nivel de campo.

Obtención do contexto da grella

O contexto da grella é a instancia da grella ou subgrella nun formulario sobre o que se quere executar o código. Para obter máis información sobre como obter o contexto da grella para executar o código JavaScript, consulte Contexto da grella da API do cliente

Eventos

Nome	Descrición	Aplicable para
Evento de carga da subgrede	Ocorre cada vez que se actualiza a subgrella. Isto inclúe cando os usuarios ordenan os valores na subgrella facendo clic nas cabeceiras das columnas.	Grella de só lectura
Grella ao cambiar	Ocorre cando se cambia un valor nunha cela da grella editable e a cela perde o foco	Grade editable
Grella en RexistroSeleccionar	Ocorre cando se selecciona unha soa fila (rexistro) na grella editable	Grade editable
Grella ao gardar	Ocorre antes de enviar a información actualizada ao servidor, e cando ocorre algunha das seguintes circunstancias: hai un cambio na selección de rexistros, o usuario desencadea explicitamente unha operación de gardado usando o botón de gardar da grella editable, ou o usuario aplica unha operación de ordenación, filtro, agrupamento, paginación ou navegación desde a grella editable mentres hai cambios pendentes.	Grade editable

Nota

Pode rexistrarse para os eventos OnChange, OnRecordSelect e OnSave usando a pestana Eventos da páxina de aplicacións baseadas en modelos que se usa para habilitar cuadrículas editables para unha táboa ou unha grella de só lectura.

Obxectos

Utiliza os seguintes obxectos para interactuar coas grellas. Estes obxectos forman unha xerarquía, tal e como se mostra no seguinte diagrama:

Nome	Descrición	Dispoñible para
Grid Control	Proporciona métodos para traballar co control de grella ou subrede.	Grellas só de lectura e editables
Grella	Proporciona métodos para acceder á información sobre os datos da grella.	Grellas só de lectura e editables
Fila da grella	Proporciona métodos para traballar con filas ou filas seleccionadas na grella.	Grellas só de lectura e editables
GridRowData	Proporciona métodos para traballar con filas ou filas seleccionadas na grella.	Grellas só de lectura e editables
Entidade da grella	Proporciona métodos para acceder a datos sobre os rexistros específicos das filas.	Grellas só de lectura e editables
GridAttribute	Proporciona métodos para acceder aos datos da cela dunha grella editable.	Grade editable
Cela da grella	Proporciona métodos para acceder aos datos relacionados co control nun formulario que está vinculado a unha columna nunha grella editable.	Grade editable
Selector de vistas	Proporciona métodos para obter ou establecer información sobre o selector de vistas do control de subgrella.	Grella de só lectura

Artigos relacionados

Contexto da grella da API do cliente
Usar grellas editables
Client API Reference for model-driven apps
Visión xeral do desenvolvedor de aplicacións baseadas en modelos