Rasterkontext der Client-API

Der Client-API-Rasterkontext hilft Ihnen beim Zugreifen auf und Arbeiten mit tabellarischen Daten in Rastern und Untergrids in einem Formular. Raster können das gesamte Formular umfassen oder als Formularelemente als Untergrids angezeigt werden.

Der Client-API-Rasterkontext stellt einen Verweis auf ein Untergrid in einem Formular bereit, für das der aktuelle Code ausgeführt wird.

Verwenden Sie den formContext , um eine Instanz des Formulars abzurufen, in dem der Code ausgeführt wird, und rufen Sie dann das Untergrid-Steuerelement im Formular ab. Wenn Sie beispielsweise den Namen eines Unterraster-Steuerelements kennen (zum Beispiel das Unterraster Kontakte im Standardformular für Konten), können Sie mit dem folgenden Code darauf zugreifen:

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
}

Einschränkungen

  • Das Abrufen des Kontexts eines Gitters, das sich über das gesamte Formular erstreckt, wird nur von Ribbon-Befehlen unterstützt. Weitere Informationen finden Sie unter Formular- und Rasterkontext in Menübandaktionen.
  • Bei Verwendung von getControl() werden Aufrufe von gridContext nicht unterstützt.
  • Rasterkontexte haben die gleiche Gültigkeit wie ihr Ausführungskontext. Sobald der Ereignishandler für den Ausführungskontext beendet ist, ist bei der Verwendung dieser Kontexte besondere Vorsicht geboten. Siehe asynchrones Verwenden von Kontextobjekten.

Formularkontext der Client-API
Client-API-Ausführungskontext
Grundlegendes zum Client API-Objektmodell
Raster und Unterraster

  • Last updated on