Rasterkontext der Client-API
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
- Anrufe an
getControl()
werden nicht unterstützt, wenn Sie verwendengridContext
. - Raster-Kontexte 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 Sorgfalt erforderlich. Siehe Kontextobjekte asynchron verwenden
Ähnliche Artikel
Client-API-Formularkontext
Client-API-Ausführungskontext
Grundlegendes zum Client API-Objektmodell
Raster und Unterraster
Hinweis
Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)
Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).