Verwendung einer UDT-Instanz als Referenzobjekt

Sie können das Referenzobjekt einer eingebetteten Grafik konfigurieren und auf eine UDT-Instanz verweisen. Während der Laufzeit wird der relative Verweis me. durch die UDT-Instanz ersetzt. Sie können das Referenzobjekt auch während der Laufzeit auf eine andere UDT-Instanz aktualisieren.

Beispiel: Verwendung einer UDT-Instanz als Referenzobjekt

1. Öffnen Sie den WindowMaker und erstellen Sie eine Industriegrafik, indem Sie mit der rechten Maustaste auf den Bereich Industriegrafiken klicken und Neue Grafik wählen.

2. Doppelklicken Sie auf die neu erstellte Grafik, um sie im Industriegrafik-Editor zu öffnen.

3. Wählen Sie in der Symbolleiste das Symbol Industriegrafik einbetten.

4. Wählen Sie im daraufhin erscheinenden Fenster im Bereich Grafik-Objektsatz eine beliebige Grafik aus, die über die me.<Referenz> verfügt, und klicken Sie auf OK.

   Legen Sie im Raster Eigenschaften das Attribut OwningObject auf eine UDT-Instanz fest.

   Hinweis: Geben Sie den Instanznamen mit dem Präfix InTouch: für verwaltete InTouch-Projekte ein.

   

Sie können eine andere UDT-Instanz aus der Instanz erstellen, die Sie im Feld „OwningObject“ aktualisiert haben, sodass Sie zur Laufzeit mit Hilfe der Eingabeanimation zu einer anderen UDT-Instanz wechseln können.

Beispiel: Wechsel des Referenzobjekts zu einer anderen UDT-Instanz während der Laufzeit

5. Betten Sie die Grafik mit dem Referenzobjekt, das Sie im obigen Beispiel erstellt haben, in ein anderes Rahmenfenster ein.

   Setzen Sie die Eigenschaft „OwningObject“ der eingebetteten Grafik auf eine String-Benutzereingabe-Animation, damit die Änderung der Eingabe das besitzende Objekt und die entsprechenden Werte widerspiegelt.

6. Schließen Sie WindowViewer, falls das Programm noch läuft.

7. Wechseln Sie zu WindowViewer.

8. Überprüfen Sie, ob der relative Verweis „me.“ an die Instanz gebunden ist, die Sie im obigen Beispiel im Feld „OwningObject“ festgelegt haben.

Sie können mit dem Referenzobjekt zu einer anderen Instanz wechseln, die Sie im obigen Beispiel erstellt haben.

Instanzname in Industriegrafik zur Laufzeit anzeigen

Verwenden Sie „me.Tagname“, „me.HierarchicalName“ oder „me.ContainedName“, um über einen relativen Verweis auf den Namen zu verweisen, der der UDT-Instanz zugewiesen wurde.

Bei der Visualisierung von Daten aus UDT-Instanzen mit Industriegrafiken wird „me.Tagname“ dem Namen der UDT-Instanz zugeordnet, die derzeit über die Eigenschaft „OwningObject“ der Grafik mit der Grafik verbunden ist. 

Diese Funktionalität wird durch drei Punktfelder unterstützt:

• TagName

• HierarchicalName

• ContainedName

Um auf die Punktfelder in einer Grafik zuzugreifen, geben Sie den Namen der Instanz gefolgt von einem Punkt ein.

 

In der Wertanzeige-Animation können Sie auf der Registerkarte Name die Optionen „TagName“, „HierarchicalName“ und „ContainedName“ verwenden oder „me.Tagname“, „me.HierarchicalName“ und „me.ContainedName“ als String auf der Registerkarte „String“ eingeben, um die entsprechende Eigenschaft einer UDT-Instanz zu binden. 

 

Bei der Konfiguration einer Industriegrafik für die Verwendung mit eigenständigen InTouch-Projekten ist es möglich, den relativen Verweis „me.Tagname“ in allen Aspekten der Grafik zu verwenden: 

• Als Referenzbindung für benutzerdefinierte Eigenschaften 

• In Animationen wie der Wertanzeige für Strings 

• In Skriptbedingungen und -körpern 

Wenn die Felder „.TagName“, „.HierarchicalName“ oder „.ContainedName“ in einem Projekt verwendet werden, wird die Instanz nicht im Dienstprogramm zum Löschen nicht verwendeter Variablen angezeigt. Die Instanz wird stattdessen im Querverweis-Dienstprogramm angezeigt. 

Die Punktfelder können auch direkt von einer Instanz in Grafiken, Grafikskripten, nativen Animationen und nativen Skripten verwendet werden: 

• <UDTInstant>.Tagname 

• <UDTInstanz>.HierarchicalName 

• <UDTInstanz>.ContainedName 

Alle drei Punktfelder geben zur Laufzeit denselben Instanznamenwert zurück.

Hinweis: Die Punktfelder der UDT-Variablen „.Tagname“, „.HierarchicalName“ und „.ContainedName“ wird bei der Zählung der Variablenlizenzen nicht mitgezählt. Sowohl die Statusleiste als auch das Dialogfeld zur Aktualisierung des Benutzungszählers enthalten keine Punktfelder für UDT-Variablen.

Einschränkungen 

• Wenn TagName, ContainedName oder HierarchicalName als Name eines UDT-Mitglieds konfiguriert sind, wird ihr zur Laufzeit die Priorität als Mitglied gegeben und nicht deb Punktfeldern.  

• IntelliSense zeigt die Punktfelder nicht an, wenn TagName, ContainedName oder HierarchicalName als Name eines UDT-Mitglieds innerhalb einer Grafik konfiguriert sind. 

• „.TagName“, „.HierarchicalName“ und „.ContainedName“ unterstützen sowohl den Lesezugriff als auch den Schreibzugriff, wenn sie in einer Grafik zur Laufzeit verwendet werden.