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

Les quadrícules presenten dades en format tabular en aplicacions basades en models. 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.
• Quadrícules editables: a més de mostrar dades en format tabular, proporciona capacitats d'edició en línia enriquides en clients web i mòbils, inclosa la capacitat d'agrupar, ordenar i filtrar dades dins de la mateixa quadrícula de manera que no hàgiu de canviar de registre o visualització. 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.

Obtenir 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 obtenir més informació sobre com obtenir el context de la quadrícula per executar el codi JavaScript, vegeu Context de la quadrícula de l'API de client

Esdeveniments

Nom	Descripció	Aplicable per a
Incidència OnLoad de la subquadrícula	Es produeix cada vegada que s'actualitza la subquadrícula. Això inclou quan els usuaris ordenen els valors de la subquadrícula fent clic a les capçaleres de columna.	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 es produeix alguna de les situacions següents: hi ha un canvi en la selecció de registres, l'usuari activa explícitament una operació de desament mitjançant el botó de desar de la quadrícula editable o l'usuari aplica una operació d'ordenació, filtre, agrupació, paginació o navegació des de la quadrícula editable mentre hi ha canvis pendents.	Quadrícula editable

Nota

Podeu registrar-vos per als esdeveniments OnChange, OnRecordSelect i OnSave mitjançant la pestanya Esdeveniments de la pàgina d'aplicacions basades en models que s'utilitza per habilitar quadrícules editables per a una taula o una quadrícula només de lectura.

Objectes

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
Informació general per a desenvolupadors d'aplicacions basades en models