Show TOC Anfang des Inhaltsbereichs

Hintergrunddokumentation IF_WD_CONTEXT_NODE Dokument im Navigationsbaum lokalisieren

Das Interface IF_WD_CONTEXT_NODE ermöglicht das Befüllen eines Context-Knotens bzw. das Abholen von Daten von einem Context-Knoten.

Methoden

BIND_ELEMENT

Methode für das Binden eines Context-Elements an den Context-Knoten.

Parameter

Name

Art

Beschreibung

NEW_ITEM

Importparameter

Dies kann eine Referenz auf ein Context-Element sein (ref to IF_WD_CONTEXT_ELEMENT) oder eine Referenz auf eine Datenstruktur oder eine Datenstruktur selbst. Wenn es sich um eine Datenstruktur handelt, sollten Sie aus Performance-Gründen BIND_STRUCTURE nutzen.

SET_INITIAL_ELEMENTS

Importparameter

Falls dieser Parameter mit dem Standardwert belegt ist (=ABAP_TRUE), wird der bisherige Inhalt des Knotens weggeschmissen, d.h. der Knoten wird invalidiert, und dann wird das neue Element eingefügt. Ansonsten wird das Element in die Liste eingefügt.

INDEX

Importparameter

Gibt an, hinter welches Element das neue Element eingefügt werden soll (nur relevant, wenn SET_INITIAL_ELEMENTS = ABAP_FALSE). Beim Standardwert 0 wird das neue Element als erstes Element eingefügt.

ELEMENT

Rückgabeparameter

Die Referenz auf das neue Element wird zurückgegeben

 

Im Fehlerfall wird eine Ausnahme des Typs CX_WD_CONTEXT geworfen.

BIND_ELEMENTS

Methode für das Binden von Context-Elementen an den Context-Knoten. Damit entspricht diese Methode weitgehend der Methode BIND_ELEMENT, mit dem Unterschied, dass hier eine interne Tabelle angegeben werden muss, die entweder Element-Referenzen, Datenreferenzen oder Datenstrukturen enthält.

BIND_STRUCTURE

Mit dieser Methode kann eine Struktur als neues Element in einem Knoten angelegt werden. Die Struktur sollte möglichst gleich der deklarierten Struktur des Knotens sein, muss es aber nicht. Wenn die Strukturen nicht gleich sind, wird ein move-corresponding durchgeführt. Ansonsten verhält sich diese Methode wie BIND_ELEMENT.

BIND_TABLE

Methode für das Binden einer internen Tabelle an den Context-Knoten. Diese Methode ist eine optimierte Version von BIND_ELEMENTS. Es wird eine Tabelle mit Daten erwartet. Falls die Datenstruktur der Tabelle mit der deklarierten Struktur übereinstimmt, wird intern folgende Optimierung durchgeführt: An den Knoten wird nur die Tabelle selbst übergeben. Es werden noch keine Element-Instanzen angelegt. Wenn auf ein oder mehrere Elemente zugegriffen wird, werden genau die benötigten Element-Referenzen angelegt.

Außerdem wird bei der Tabellenübergabe das Copy-on-write-Prinzip des ABAP ausgenutzt, was bedeutet, dass die Tabelle nicht bei der Übergabe kopiert wird, sondern erst dann, wenn die Tabelle geändert wird.

CLEAR_SELECTION

Die aktuelle Selektion wird zurückgenommen.

CREATE_ELEMENT

Eine Element-Referenz wird erzeugt, die später über BIND_ELEMENT an den Knoten gehängt werden kann. Die Daten für das Element können mitgegeben werden oder später gesetzt werden. Die Element-Referenz wird zurückgegeben.

CREATE_ELEMENT_STATIC_ATTR

Achtung

Diese Methode ist veraltet, verwenden Sie sie daher nicht.

GET_ATTRIBUTE

Methode für das Liefern des Wertes eines Context-Attributes.

GET_ATTRIBUTE_REF

Methode für das Liefern einer Referenz mit dem Wert eines statischen oder dynamischen Attributs. Die Referenz wird neu angelegt. Das bedeutet, dass eine Änderung des Inhaltes der Referenz nicht das Attribut selbst ändert.

GET_CHILD_NODE

Methode für die Rückgabe eines bestimmten Unterknotens.

GET_CHILD_NODES

Methode für das Liefern aller Unterknoten.

GET_CONTEXT

Methode für das Liefern der Referenz auf den Controller-Context (also nicht den Context-Knoten). Die Referenz ist insbesondere für die Arbeit mit dem Context-Change-Log relevant.

GET_ELEMENT

Methode für das Liefern der Referenz auf ein Element, entweder mit einem speziellen Index oder das Lead-Selection-Element.

GET_ELEMENTS

Methode für das Liefern einer internen Tabelle mit allen Element-Referenzen.

GET_ELEMENT_COUNT

Methode für das Liefern der Anzahl der Elemente.

GET_LEAD_SELECTION

Methode für das Liefern der Referenz des Lead-Selection-Elementes.

GET_LEAD_SELECTION_INDEX

Methode für das Liefern des Index des Lead-Selection-Elementes.

GET_META_PATH

Methode für das Liefern des Pfads des Knotens in den Metadaten. Insbesondere enthält der Pfad keine Indizes.

GET_NODE_INFO

Methode für das Liefern der Referenz auf das Metadaten-Objekt (IF_WD_CONTEXT_NODE_INFO).

GET_PARENT_ELEMENT

Methode für das Liefern der Referenz auf das Element im Vaterknoten, zu dem dieser Knoten gehört.

GET_PATH

Methode für das Liefern des Pfades des Knotens im Original-Controller. Dieser Pfad enthält die Knotennamen und Indizes.

GET_SELECTED_ELEMENTS

Methode für das Liefern einer Liste aller selektierten Elemente.

GET_STATIC_ATTRIBUTES

Methode für das Liefern einer Kopie aller statisch deklarierten Attribute.

GET_STATIC_ATTRIBUTES_REF

Methode für das Liefern einer Referenz auf eine Kopie aller statischen Attribute.

GET_STATIC_ATTRIBUTES_TABLE

Methode für das Liefern aller statischen Attribute aller Elemente.

INVALIDATE

Methode für das Invalidieren aller Elemente des Knotens. Das bedeutet, dass alle Elemente gelöscht werden und alle Unterknoteninstanzen. Danach ist der Zustand des Knotens so wie ganz am Anfang. Wenn wieder ein Element oder ein Attribut angefordert werden, wird - falls vorhanden - die Supply-Methode aufgerufen.

IS_ALIVE

Methode für das Prüfen, ob der zugehörige Controller noch „am Leben“ ist, d.h. man kann noch auf ihn zugreifen und er ist noch nicht über WDDOEXIT beendet.

IS_ATTRIBUTE_NULL

IS_CHANGED_BY_CLIENT

IS_FINALIZED

IS_SELECTED

Methode für das Liefern der Information zu einem Index, ob das zugehörige Element selektiert ist.

IS_SUPPLIED

Methode für das Liefern der Information, ob der Knoten gefüllt oder noch im Initialzustand (bzw. invalidiert) ist.

MOVE_ELEMENT

MOVE_FIRST

Methode für das Setzen der Lead-Selection auf das erste Element

MOVE_LAST

Methode für das Setzen der Lead-Selection auf das letzte Element

MOVE_NEXT

Methode für das Weitersetzen der Lead-Selection um ein Element

MOVE_PREVIOUS

Methode für das Zurücksetzen der Lead-Selection um ein Element (der Index ist dann eins kleiner als vorher)

MOVE_TO

Methode für das Setzen der Lead-Selection auf ein Element mit angegebenem Index

PATH_GET_ATTRIBUTE

Methode für das Liefern einer Datenreferenz auf ein Attribut, das ausgehend von dem ME-Knoten durch einen relativen Pfad erreichbar ist.

Im Fehlerfall wird eine Ausnahme des Typs CX_WD_CONTEXT geworfen.

PATH_GET_ELEMENT

Diese Methode entspricht weitgehend PATH_GET_ATTRIBUTE, liefert aber eine Element-Referenz.

PATH_GET_NODE

Diese Methode entspricht weitgehend PATH_GET_ATTRIBUTE, liefert aber eine Knotenreferenz.

REMOVE_ELEMENT

Methode für das Löschen eines Elements aus dem Knoten. Das Element kann später wieder an den gleichen Knoten angehängt werden.

RESET_CHANGED_BY_CLIENT

SET_ATTRIBUTE

SET_ATTRIBUTE_NULL

SET_CHANGED_BY_CLIENT

SET_FINALIZED

SET_LEAD_SELECTION

SET_LEAD_SELECTION_INDEX

SET_SELECTED

SET_STATIC_ATTRIBUTES

SET_STATIC_ATTRIBUTES_NULL

TO_XML

Methode für die Serialisierung des Knotens in XML

Ende des Inhaltsbereichs