Partager 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
}

Limitations

  • 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 grille ont la même validité que leur contexte d’exécution. Une fois le gestionnaire d’événements pour le contexte d’exécution terminé, ces contextes nécessitent une attention particulière lors de leur utilisation. Voir Utilisation asynchrone des objets de contexte

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

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).