Compartir a través de

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

  • Artículo

Las cuadrículas presentan datos en un formato de tabla en aplicaciones basadas en modelos. 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 formato de tabla, proporciona funciones de edición en línea enriquecidas en clientes web y móviles, lo que incluye la capacidad de agrupar, ordenar y filtrar los datos dentro de la misma cuadrícula de manera que no tenga que cambiar de registro o de vista. 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.

Obtener el contexto de la 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 de JavaScript, vea contexto de cuadrícula de la API del cliente

Eventos

Nombre Descripción Aplicable a
Evento OnLoad de subcuadrícula Se produce cada vez que se actualiza la subcuadrícula. Esto incluye cuando los usuarios ordenan los valores de la subcuadrícula 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 alguno de los siguientes hechos: hay un cambio en la selección de registros, el usuario activa explícitamente una operación de guardado mediante el botón Guardar de la cuadrícula o el usuario aplica una operación de ordenación, filtrado, agrupación, 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 usando la pestaña Eventos de la página de las aplicaciones basadas en modelo que se utiliza para habilitar cuadrículas editables para una tabla o una cuadrícula de solo lectura.

Objetos

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

La jerarquía de los objetos disponibles en las cuadrículas

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

Contexto de cuadrícula de la API del cliente
Usar cuadrículas editables
Referencia API de cliente para aplicaciones basadas en modelos
Resumen de las aplicaciones orientadas a modelos de desarrollador

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).