Quadrícules i subquadrícules en aplicacions basades en models (referència de l'API de client)

Les graelles i subgraelles presenten dades en format tabular en aplicacions basades en models. Utilitza els esdeveniments i objectes de l'API del client d'aquest article per treballar amb graelles de només lectura i editables. Les quadrícules poden abastar tot el formulari o poden ser un dels elements d'un formulari; aquestes últimes s'anomenen subquadrícules.

Tipus de quadrícules

Hi ha dos tipus de quadrícules a les aplicacions basades en models:

• Quadrícules només de lectura: mostren les dades en format tabular. Per editar les dades que es mostren en una quadrícula només de lectura, heu de seleccionar el registre de la quadrícula per obrir el formulari, editar les dades i desar-les.
• Graelles editables: A més de mostrar dades en format tabular, ofereix capacitats d'edició en línia molt avançades per a clients web i mòbils, incloent-hi la capacitat d'agrupar, ordenar i filtrar dades dins la mateixa graella perquè no hagis de canviar de registre o vistes. La quadrícula editable és un control personalitzat i s'admet a la quadrícula principal i a les subquadrícules d'un formulari del client web i als escriptoris digitals i a les quadrícules de formulari dels clients mòbils. Tot i que el control de quadrícula editable proporciona capacitat d'edició, respecta les metadades de la quadrícula només de lectura i la configuració de seguretat a nivell de camp.

Obtén el context de la quadrícula

El context de la quadrícula és la instància de quadrícula o subquadrícula d'un formulari en el qual voleu executar el codi. Per a més informació sobre com obtenir el context de graella per executar el teu codi JavaScript, vegeu Context de graella de l'API del client.

Esdeveniments de graella

Nom	Descripció	Aplicable per a
Incidència OnLoad de la subquadrícula	Es produeix cada vegada que s'actualitza la subquadrícula. Aquest esdeveniment inclou quan els usuaris ordenen valors a la subgraella fent clic als encapçalaments de les columnes.	Quadrícula només de lectura
Quadrícula OnChange	Es produeix quan es canvia un valor en una cel·la de la quadrícula editable i la cel·la perd el focus	Quadrícula editable
Quadrícula OnRecordSelect	Es produeix quan se selecciona una sola fila (registre) a la quadrícula editable	Quadrícula editable
Quadrícula OnSave	Es produeix abans d'enviar la informació actualitzada al servidor, i quan passa qualsevol de les següents situacions: hi ha un canvi en la selecció de registre, l'usuari activa explícitament una operació de desament utilitzant el botó de desar de la graella editable, o aplica una operació d'ordenació, filtre, grup, paginació o navegació des de la graella editable mentre hi ha canvis pendents.	Quadrícula editable

Nota

Pots registrar-te als esdeveniments OnChange, OnRecordSelect i OnSave utilitzant la pestanya Events de la pàgina d'aplicacions basades en models que utilitzes per activar graelles editables per a una taula o una graella de només lectura.

Objectes de la graella

Utilitzeu els objectes següents per interactuar amb les quadrícules. Aquests objectes formen una jerarquia com es mostra al diagrama següent:

Nom	Descripció	Disponible per a
QuadrículaControl	Proporciona mètodes per treballar amb el control de quadrícula o subquadrícula.	Quadrícules només de lectura i editables
Sida	Proporciona mètodes per accedir a la informació sobre les dades de la quadrícula.	Quadrícules només de lectura i editables
Fila de quadrícula	Proporciona mètodes per treballar amb files o files seleccionades a la quadrícula.	Quadrícules només de lectura i editables
GridRowData	Proporciona mètodes per treballar amb files o files seleccionades a la quadrícula.	Quadrícules només de lectura i editables
Entitat de quadrícula	Proporciona mètodes per accedir a les dades sobre els registres específics de les files.	Quadrícules només de lectura i editables
Atribut de quadrícula	Proporciona mètodes per accedir a les dades de la cel·la d'una quadrícula editable.	Quadrícula editable
Cèl·lula de quadrícula	Proporciona mètodes per accedir a les dades relacionades amb el control en un formulari que està lligat a una columna d'una quadrícula editable.	Quadrícula editable
Selector de visualització	Proporciona mètodes per obtenir o definir informació sobre el selector de visualització del control de subquadrícula.	Quadrícula només de lectura

Articles relacionats

Context de la quadrícula de l'API del client
Utilitzar quadrícules editables
Referència de l'API de client per a aplicacions basades en models
Guia per a desenvolupadors d'aplicacions basades en models