Cuadrículas y subcuadrículas en aplicaciones basadas en modelo (referencia de API de cliente)

Las cuadrículas y las subgrids presentan datos en formato tabular en aplicaciones controladas por modelos. Use los eventos y objetos de la API de cliente de este artículo para trabajar con cuadrículas editables y de solo lectura. Las cuadrículas pueden abarcar todo el formulario o pueden ser uno de los elementos de un formulario; estos últimos se denominan subcuadrículas.

Tipos de cuadrículas

Hay dos tipos de cuadrículas en aplicaciones basadas en modelos:

• Cuadrículas de solo lectura: muestran datos en un formato de tabla. Para editar los datos que se muestran en una cuadrícula de solo lectura, debe seleccionar el registro en la cuadrícula para abrir el formulario, editar los datos y luego guardar.
• Cuadrículas editables: además de mostrar datos en un formato tabular, proporciona funcionalidades de edición en línea enriquecidas en clientes web y móviles, incluida la capacidad de agrupar, ordenar y filtrar datos dentro de la misma cuadrícula para que no tenga que cambiar registros o vistas. La cuadrícula editable es un control personalizado y se admite en la cuadrícula principal y en las subcuadrículas de un formulario del cliente web y de paneles, y en las cuadrículas de formulario de los clientes móviles. Aunque el control de cuadrícula editable proporcione la función de edición, respeta la configuración de metadatos de la cuadrícula de solo lectura y de seguridad a nivel de campo.

Obtención del contexto de cuadrícula

El contexto de la cuadrícula es la instancia de cuadrícula o subcuadrícula en un formulario con el que desea ejecutar el código. Para obtener más información sobre cómo obtener el contexto de cuadrícula para ejecutar el código JavaScript, consulte Contexto de cuadrícula de API de cliente.

Eventos de Grid

Nombre	Descripción	Aplicable a
Evento OnLoad de subcuadrícula	Se produce cada vez que se actualiza la subcuadrícula. Este evento incluye cuando los usuarios ordenan valores en subgrid haciendo clic en los encabezados de columna.	Cuadrícula de solo lectura
Cuadrícula OnChange	Se produce cuando un valor se modifica en una celda en la cuadrícula editable y la celda pierde el foco.	Cuadrícula editable
Cuadrícula OnRecordSelect	Se produce cuando una sola fila (registro) se selecciona en la cuadrícula editable.	Cuadrícula editable
Cuadrícula OnSave	Se produce antes de enviar la información actualizada al servidor y, cuando se produce cualquiera de las siguientes acciones: hay un cambio en la selección de registros, el usuario desencadena explícitamente una operación de guardado mediante el botón guardar de la cuadrícula editable o el usuario aplica una operación de ordenación, filtro, grupo, paginación o navegación desde la cuadrícula editable mientras hay cambios pendientes.	Cuadrícula editable

Nota

Puede registrarse para los eventos OnChange, OnRecordSelect y OnSave mediante la pestaña Eventos de la página de aplicaciones controladas por modelos que se usa para habilitar cuadrículas editables para una tabla o una cuadrícula de solo lectura.

Objetos de cuadrícula

Utilice los siguientes objetos para interactuar con las cuadrículas. Estos objetos forman una jerarquía, como se muestra en el siguiente diagrama:

Nombre	Descripción	Disponible para
GridControl	Proporciona métodos para trabajar con el control de cuadrícula o subcuadrícula.	Cuadrículas editables y de solo lectura
Grid	Proporciona los métodos para tener acceso a la información acerca de los datos de la cuadrícula.	Cuadrículas editables y de solo lectura
GridRow	Proporciona métodos para trabajar con filas o filas seleccionadas en la cuadrícula.	Cuadrículas editables y de solo lectura
GridRowData	Proporciona métodos para trabajar con filas o filas seleccionadas en la cuadrícula.	Cuadrículas editables y de solo lectura
GridEntity	Proporciona los métodos para tener acceso a datos acerca de registros específicos en las filas.	Cuadrículas editables y de solo lectura
GridAttribute	Proporciona métodos para obtener acceso a los datos en la celda de una cuadrícula editable.	Cuadrícula editable
GridCell	Proporciona métodos para acceder a los datos relacionados con el control en un formulario que está vinculado a una columna en una cuadrícula editable.	Cuadrícula editable
ViewSelector	Proporciona métodos para obtener o para establecer la información sobre el selector de vistas del control de subcuadrícula.	Cuadrícula de solo lectura

Artículos relacionados

Contexto de cuadrícula de la API del cliente
Usar cuadrículas editables
Referencia API de cliente para aplicaciones basadas en modelos
Guía para desarrolladores de aplicaciones controladas por modelos