IF_WD_COMPONENT_USAGE 

Das Interface IF_WD_COMPONENT_USAGE erlaubt den Zugriff auf Methoden zur Manipulation einer verwendeten (fremden) Web-Dynpro-Component innerhalb einer Web-Dynpro-Component.

Die Verwendung einer anderen Web-Dynpro-Component muss sowohl bei den Eigenschaften der verwendenden Component selbst, als auch bei den Eigenschaften des Controllers, der auf die verwendete Component zugreifen will, gepflegt werden. Innerhalb dieses Controllers liefert dann folgender Methodenaufruf ein Objekt vom Typ IF_WD_COMPONENT_USAGE zurück:

data:     component_usage type ref to if_wd_component_usage.     component_usage = wd_this->wd_cpuse_<Name der Component-Usage>( ).

Methoden

CREATE_COMPONENT

Diese Methode erzeugt die Web-Dynpro-Component, auf die die Component-Usage zeigt.

Existiert zu dieser Component-Verwendung bereits eine aktive Instanz der Component, führt der Aufruf dieser Methode zu einem Laufzeitfehler. Prüfen Sie daher vor Aufruf dieser Methode mittels HAS_ACTIVE_COMPONENT, ob bereits eine aktive Instanz der Component existiert.

DELETE_COMPONENT

Diese Methode löscht die Web-Dynpro-Component, auf die die Component-Usage zeigt.

Der Aufruf dieser Methode ist ohne Wirkung, wenn zu der Component-Verwendung keine aktive Instanz der Component existiert.

HAS_ACTIVE_COMPONENT

Diese Methode gibt an, ob die Web-Dynpro-Component, auf die die Component-Usage zeigt, bereits erzeugt wurde und aktiv ist.

GET_IMPLEMENTING_IF_VIEW_INFO

Diese Methode gibt die Metadaten-Beschreibung eines Interface-Views zurück.

Das Ergebnis ist ein Objekt vom Typ IF_WD_RR_INTERFACE_VIEW.

GET_INTERFACE_CONTROLLER

Diese Methode gibt eine Referenz auf den Interface-Controller einer Web-Dynpro-Component zurück.

Der Ergebnistyp der Methode hängt von der konkreten Ausprägung des Interface Controllers einer Web-Dynpro-Component ab und kann den Eigenschaften dieses Controllers entnommen werden.

ADD_EVENT_HANDLER

Mit dieser Methode kann ein Ereignisbehandler dynamisch zur Laufzeit auf ein Ereignis registriert werden.

CREATE_COMP_USAGE_OF_SAME_TYPE

Diese Methode erzeugt eine Component-Usage, die auf die gleiche Component zeigt.

Das Ergebnis ist ein Objekt vom Typ IF_WD_COMPONENT_USAGE.

ENTER_REFERENCING_MODE

Mit dieser Methode können Sie festlegen, dass eine Component-Usage auf eine andere Component-Usage zeigt.

Beachten Sie dabei Folgendes:

·        Die Component-Usage, die auf eine andere Component-Usage zeigen soll (referenzierende Component-Usage), darf keine aktive Component haben.

·        Die referenzierende Component-Usage muss auf die gleiche Component zeigen wie die referenzierte Component-Usage

GET_COMPONENT_USAGE_INFO

Diese Methode gibt die Metadaten-Beschreibung der Component-Usage zurück.

Das Ergebnis ist ein Objekt vom Typ IF_WD_RR_COMPONENT_USAGE.

IS_REFERENCING

Diese Methode gibt an, ob die Component-Usage auf eine andere Component-Usage zeigt.

Das Ergebnis kann ’X’ (die Component-Usage zeigt auf eine andere Component-Usage) oder ’ ’ (die Component-Usage zeigt nicht auf eine andere Component-Usage) sein.

IS_REFERENCED

Diese Methode gibt an, ob die Component-Usage von einer anderen Component-Usage referenziert wird.

Das Ergebnis kann ’X’ (die Component-Usage wird von einer anderen Component-Usage referenziert) oder ’ ’ (die Component-Usage wird nicht von einer anderen Component-Usage referenziert) sein.

LEAVE_REFERENCING_MODE

Diese Methode bewirkt, dass die Component-Usage nicht mehr auf eine andere Component-Usage zeigt.

REMOVE_EVENT_HANDLER

Mit dieser Methode kann ein Ereignisbehandler dynamisch zur Laufzeit von einem Ereignis deregistriert werden.