Contexto de la cuadrícula de la API del cliente

El contexto de cuadrícula de la API de cliente le ayuda a acceder a datos tabulares y trabajar con ellos en cuadrículas y subcuadrículas de un formulario. Las cuadrículas pueden abarcar todo el formulario o aparecer como elementos de formulario denominados subgrids.

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

Use formContext para obtener una instancia del formulario donde se ejecuta el código y, a continuación, obtenga el control de subcuadrícula del 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. Para obtener más información, consulte Formulario y cuadrícula en las acciones de la cinta.
  • Las llamadas a getControl() no se admiten cuando se usan gridContext.
  • Los contextos de 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 especial cuidado para su uso. Consulte Uso de objetos de contexto de forma asincrónica.

Contexto de formulario de la API del 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