Compartir a través de

Contexto de cuadrícula de la API del cliente

  • Artículo

Las cuadrículas presentan datos en formato tabular. Las cuadrículas pueden abarcar todo el formulario o pueden ser uno de los elementos de un formulario; estos últimos se denominan subcuadrículas.

El objeto de contexto de cuadrícula de la API de cliente proporciona una referencia a una subcuadrícula en un formulario con respecto al que se ejecuta el código actual.

Utilice el objeto formContext para obtener una instancia del formulario donde el código se ejecuta y después recuperar el control de subcuadrícula en el formulario. Por ejemplo, cuando conoce el nombre de un control de subcuadrícula (por ejemplo, la subcuadrícula Contactos en el formulario de cuentas predeterminado), puede tener acceso a él utilizando el siguiente código, por ejemplo.

function doSomething(executionContext) {
   var formContext = executionContext.getFormContext(); // get the form Context
   var gridContext = formContext.getControl("Contacts"); // get the grid context

   // Perform operations on the subgrid
}

Limitaciones

  • Obtener el contexto de una cuadrícula (que abarca el formulario completo) solo se admite en comandos de la cinta de opciones. Más información: Formulario y cuadrícula en las acciones de la cinta
  • No se admiten llamadas a getControl() cuando utilizas gridContext.
  • Los contextos cuadrícula tienen la misma validez que su contexto de ejecución. Una vez que finaliza el controlador de eventos para el contexto de ejecución, estos contextos requieren un cuidado especial para su uso. Consulte Uso asincrónico de objetos de contexto

Contexto de formulario de la API de cliente
Contexto de ejecución de la API de cliente
Comprender el modelo de objetos de la API de cliente
Cuadrículas y subcuadrículas

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).