Component-Verwendungen 

Einbetten einer verwendeten Component

Um eine fremde Component (unabhängig davon, ob es sich um eine oberflächenfreie Component oder eine vollständige Component handelt) zu verwenden, muss zunächst eine Component-Verwendung deklariert werden. Die dafür nötigen Schritte werden im Folgenden erläutert:

Vorgehensweise

Wählen Sie zunächst durch Doppelklick in der Objektliste die Component aus, die Sie als nächstes bearbeiten wollen. Sie befinden sich dann im Component Editor.

       1.      Wählen Sie einen Namen für die neue Component-Verwendung und tragen Sie diesen in die erste Spalte der Tabelle ein.

       2.      Wählen Sie die zu verwendende Component aus (F4-Hilfe).

 

 

       3.      Anschließend sollten Sie folgende Überlegung anstellen:

·         Soll die fremde Component nur von einer einzigen View Ihrer Component verwendet werden ist es sinnvoll, die Instanz der fremden Component in einer Controller-Methode dieser View zu erzeugen.

·         Soll die fremde Component jedoch für mehrere Views zugänglich sein, sollte die Instanz der fremden Component an einem zentralen Ort erzeugt werden. Dafür bietet sich die Methode wdDoInit des Component-Controllers an.

(Allgemeine Informationen über Controller finden Sie im Dokument Controller Editor). Unabhängig davon, ob Sie den Controller einer View oder einen View-übergreifenden Controller als Instanziierungspunkt für die fremde Component gewählt haben, muss die fremde Component nun auch auf der Registerkarte Eigenschaften dieses Controllers eingetragen werden. Die weitere Vorgehensweise dafür ist die folgende:

       4.      Doppelklicken Sie auf das gewünschte Objekt in der Objektliste (also auf den Eintrag einer View oder eines Controllers). Sie werden je nach Objekt auf den Controller Editor oder den View Editor geführt.

       5.      Wechseln Sie auf die Registerkarte Eigenschaften.

       6.      Um in der Tabelle Verwendete Controller/Components  eine neue Verwendung anzulegen klicken Sie die Anlegen-Schaltfläche. Stellen Sie sicher, dass sich der Editor im Änderungsmodus befindet.

       7.      Im folgenden Dialogfenster werden Ihnen alle zur Verwendung verfügbaren Components und Controller aufgelistet. Neben allen globalen Controllern der eigenen Component finden Sie in dieser Liste auch die fremde Component sowie deren Interface-Controller.

Ob Sie an dieser Stelle nur die fremde Component oder sowohl die fremde Component als auch deren Interface-Controller auswählen hängt von folgender Überlegung ab:

●     Wollen Sie die verwendete Component lediglich zur Anzeige bringen, also aus Ihrer aktuellen Component heraus aufrufen, dann fahren Sie fort mit dem Dokument

Component-Verwendung ohne Controller-Zugriff

●     Wollen Sie jedoch der aktuellen Component den Zugriff auf den Interface-Controller der verwendeten Component ermöglichen, fahren Sie fort mit dem Dokument

Component-Verwendung mit Controller-Zugriff.