Freigeben über

Rasterkontext der Client-API

  • Artikel

Raster präsentieren Daten in einem tabellarischen Format. Raster können das gesamte Formular einschließen oder eines der Elemente in einem Formular sein; die letzteren werden als Unterraster bezeichnet.

Das Client-API-Rasterkontextobjekt bietet eine Referenz auf das Unterraster im Formular, für das der aktuelle Code ausgeführt wird.

Verwenden Sie das formContext-Objekt, um eine Instanz des Formulars zu erhalten, in dem Code ausgeführt wird, und die anschließend Unterrastersteuerelement im Formular anzuzeigen. Zum Beispiel, wenn Sie den Namen eines Unterrastersteuerelements kennen (beispielweise Kontakte-Unterraster im Standardfirmenformular), können Sie mithilfe des 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 Rasters (über das gesamte Formular) wird nur in Menübandbefehlen unterstützt. Weitere Informationen: Formular- und Rasterkontext in Menübandaktionen
  • Bei Verwendung von gridContext werden Aufrufe von getControl() nicht unterstützt.
  • Rasterkontexte haben die gleiche Gültigkeit wie ihr Ausführungskontext. Sobald der Ereignishandler für den Ausführungskontext abgeschlossen ist, erfordern diese Kontexte besondere Sorgfalt. Weitere Informationen finden Sie unter Asynchrones Verwenden von Kontextobjekten.

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