Partage via

Contexte de grille de l’API client

  • Article

Les grilles présentent des données dans un format tabulaire. Les grilles peuvent couvrir le formulaire entier ou peuvent être l’un des éléments d’un formulaire, ce que l’on appelle sous-grilles.

L’objet de contexte de grille d’API client fournit une référence à une sous-grille d’un formulaire dans lequel le code actuel est exécuté.

Utilisez l’objet formContext pour obtenir une instance du formulaire où le code est exécuté, puis récupérer le contrôle de sous-grille sur le formulaire. Par exemple, si vous connaissez le nom d’un contrôle de sous-grille (par exemple, la sous-grille Contacts du formulaire de compte par défaut), vous pouvez y accéder en utilisant le code suivant :

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
}

Limites

  • L’obtention du contexte d’une grille (couvrant le formulaire entier) est uniquement prise en charge dans les commandes du ruban. Plus d’informations : Contexte de formulaire et de grille dans les actions du ruban
  • Les appels à getControl() ne sont pas pris en charge lorsque vous utilisez gridContext.
  • Les contextes de grille ont la même validité que leur contexte d’exécution. Une fois que le gestionnaire d’événements pour le contexte d’exécution a terminé, l’utilisation de ces contextes nécessite un soin particulier. Consultez la section Utilisation asynchrone des objets de contexte

Contexte de formulaire de l’API client
Contexte d’exécution de l’API client
Comprendre le modèle objet de l’API client
Grilles et sous-grilles