ShowGraphic()

Identität

Die Eigenschaft Identity ist ein eindeutiger Name, der identifiziert, welche Instanz die Grafik geöffnet hat.

Identity darf maximal 329 Zeichen umfassen und muss mindestens einen Buchstaben enthalten. Gültige Zeichen sind alphanumerische Zeichen und Sonderzeichen ($, #, _).

Dies ist eine erforderliche Eigenschaft des Datentyps Zeichenfolge.

Standardwert: none

Beispiel:

graphicInfo.Identity = "i1";

GraphicName

GraphicName ist der Name der anzuzeigenden Grafik.

GraphicName darf maximal 329 Zeichen umfassen und muss mindestens einen Buchstaben enthalten. Gültige Zeichen sind alphanumerische Zeichen und Sonderzeichen ($, #, _).

Dies ist eine erforderliche Eigenschaft des Datentyps Zeichenfolge.

Standardwert: none

Navigieren Sie durch Ihren HMI-/SCADA-Projekt-Browser, wie dem Galaxy-Browser anzeigen oder ähnlichem in Ihrer HMI-/SCADA-Software, oder geben Sie den Grafikname direkt ein. Der Projektname kann kommen von:

• Visualisierungs-Ordner, zum Beispiel:
  "Symbol_001"

• Instanzen, absolut oder hierarchisch, beispielsweise:
  "Userdefined_001.Symbol1", "Userdefined_001.Pump_001.S1"

• Relativer Verweis, zum Beispiel:
  "Me.Symbol_001"

  Verwenden Sie einen absoluten Namen, um GraphicName und OwningObject anzugeben, wenn Sie einen Objekt-Assistenten mit ausgewählten benutzerdefinierte Eigenschaften des Symbolassistenten verwenden. Dies ermöglicht, dass die korrekte Grafikkonfiguration für die Instanz angezeigt wird. Weitere Informationen finden Sie weiter unten unter OwningObject.

  Wenn ein ungültiges Zeichen eingegeben oder die maximale Anzahl an Zeichen überschritten wird, zeigt das System eine Warnmeldung in der Laufzeit an. Es gibt keine Validierung in der Entwurfszeit.

  Der Grafikname kann eine Verkettung von konstanten Zeichenfolgen und Verweis-Zeichenfolgen sein. Zum Beispiel:

  "Pump_001" + ".Symbol_001"; cp1 + ".Symbol_001", wobei der Wert von cp1 = "Pump_001"; oder Obj1.Str1 + ".Symbol_001", wobei der Wert von Obj.Str1 = "Pump_001".

  Beispiele:

  So geben Sie einen Visualisierungs-Ordner-Verweis an

  graphicInfo.GraphicName = "S1";

  So geben Sie einen absoluten Verweis an

  graphicInfo.GraphicName = "NameDesReferenzobjekts.Symbolname";

Referenzobjekt

Der Name des Referenzobjekts der Grafik, die von der Skriptfunktion ShowGraphic() angezeigt wird.

OwningObject ist eine optionale Eigenschaft. Es kann eine Verkettung von konstanten Zeichenfolgen und Referenzzeichenfolgen sein. OwningObject kann navigiert werden mit dem Automationsobjekt-Katalog anzeigen, oder es kann der Name des Referenzobjekts eingegeben werden.

Die Eigenschaft OwningObject setzt Verweise für die Grafik, ist aber nicht mit der Eigenschaft GraphicName assoziiert, wenn die Grafik Teil eines Objekt-Assistenten ist. Wenn Sie daher eine Grafik mit einem Referenzobjekt skripten, geben Sie den Namen des Referenzobjekts als Teil der Eigenschaft GraphicName an, also beispielsweise:

UserDefined_001.Pump_001.

Dies ist eine optionale Eigenschaft des Datentyps Zeichenfolge.

Standardwert: leer

Beispiel:

graphicInfo.OwningObject = "UserDefined_001";

HasTitleBar

HasTitleBar legt fest, ob die Grafik mit einer Titelleiste angezeigt wird.

Dies ist eine optionale Eigenschaft des Datentyps Boolean.

Standardwert: True

Beispiel:

graphicInfo.HasTitleBar = false;

WindowTitle

WindowTitle gibt den Titel an, der in der Titelleiste des Fensters angezeigt wird.

Dies ist eine optionale Eigenschaft des Datentyps Zeichenfolge.

Standardwert: Leer

Gültiger Bereich: Maximal 1.024 Zeichen.

WindowTitle kann eine konstante Zeichenfolge, ein Verweis oder ein Ausdruck sein. Wenn das Referenzobjekt gegen eine Automationsobjekt-Grafik getauscht wird, wird WindowTitle entsprechend aktualisiert. Wenn WindowTitle leer ist, wird der Wert der Eigenschaft Identity in der Titelleiste angezeigt.

Beispiel:

Dies ist eine optionale Eigenschaft des Datentyps Boolean.

graphicInfo.WindowTitle = "Graphic01";

WindowType

WindowType gibt an, ob der Fenstertyp modal oder nicht modal ist.

Dies ist eine optionale Eigenschaft des Datentyps Aufzählung.

Standardwert: Modeless

Gültiger Bereich: 0 oder 1. Dabei gilt:

• 0 = Modal

• 1 = Modeless

Beispiele:

graphicInfo.WindowType = aaGraphic.WindowType.<Fenstertyp>;

graphicInfo.WindowType = 1;

HasCloseButton

HasCloseButton legt fest, ob das Popup-Fenster eine Schließen-Schaltfläche hat.

Dies ist eine optionale Eigenschaft des Datentyps Boolean.

Standardwert: True

Beispiel:

graphicInfo.HasCloseButton = false;

Resizable

Resizable legt fest, ob das Popup-Fenster in der Größe veränderbar ist.

Dies ist eine optionale Eigenschaft des Datentyps Boolean.

Standardwert: False

Beispiel:

graphicInfo.Resizable = true;

WindowLocation

WindowLocation legt die Position des Popup-Fensters fest.

Dies ist eine optionale Eigenschaft des Datentyps Aufzählung.

Standardwert: 0 (Mitte)

Gültiger Bereich: 0 bis einschließlich 12, wobei die Position des Fensters durch die entsprechende Aufzählung festgelegt wird:

0 = Center
1 = Above
2 = TopLeftCorner
3 = Top
4 = TopRightCorner
5= LeftOf
6= LeftSide
7= RightSide
8 = RightOf
9 = BottomLeftCorner
10 = Bottom
11 = BottomRightCorner
12 = Below

Wenn Sie Desktop als WindowRelativePosition auswählen, sind Above (1), LeftOf (6), RightOf (8) und Below (12) ungültig. Weitere Informationen zum Verhalten des Parameters „WindowLocation“ finden Sie unter Mit den Skriptfunktionen „Grafik anzeigen/ausblenden“ arbeiten im Creating and Managing Graphics User’s Guide.

Beispiele:

graphicInfo.WindowLocation = aaGraphic.WindowLocation.<Fensterposition>;

graphicInfo.WindowLocation = 1;

WindowRelative
Position

WindowRelativePosition gibt die relative Position des Popup-Fensters an.

Dies ist eine optionale Eigenschaft des Datentyps Aufzählung.

Standardwert: 0 (Desktop)

Gültiger Bereich: 0 bis einschließlich 8, wobei die relative Position des Fensters durch die entsprechende Aufzählung festgelegt wird.

0 = Desktop
1 = Window
2 = ClientArea
3 = ParentGraphic
4 = ParentElement
5 = Mouse
6 = DesktopXY
7 = WindowXY
8 = ClientAreaXY

Beispiele:

graphicInfo.WindowRelativePosition = aaGraphic.WindowRelativePosition.<relative Fensterposition>;

graphicInfo.WindowRelativePosition = 1;

RelativeTo

RelativeTo gibt die Größe des Popup-Fensters relativ zu Grafik, Desktop oder benutzerdefinierte Breite und Höhe an.

Dies ist eine optionale Eigenschaft des Datentyps Aufzählung.

Standardwert: 0 (Graphic)

Gültiger Bereich: 0, 1, 2. Hierbei gilt:

0 = Graphic
1 = Desktop
2 = CustomizedWidthHeight

Wenn aaGraphic.RelativeTo.CustomizedWidthHeight eingegeben wird, können die Werte für Höhe und Breite in das Skript eingebunden werden. Ansonsten werden die Standardwerte verwendet.

Beispiele:

graphicInfo.RelativeTo = aaGraphic.RelativeTo.<RelativeTo-Element>;

graphicInfo.RelativeTo = 1;

X

X gibt die horizontale Position des Popup-Fensters an.

Dies ist eine optionale Eigenschaft des Datentyps Integer.

Standardwert: 0

Gültiger Bereich: -2.147.483.648 bis einschließlich 2.147.483.647

Wenn X außerhalb des Ganzzahlenbereichs liegt, erscheint eine Überlaufmeldung zur Laufzeit im Logger.

Dieser Parameter gilt nur, wenn der Parameter WindowRelativePosition den Wert DesktopXY, WindowXY oder ClientAreaXY hat. Im Gegensatz zur Animation ShowSymbol gibt es keine Grenze für diesen Wert.

Beispiel:

graphicInfo.X = 100;

J

Y gibt die vertikale Position des Popup-Fensters an.

Dies ist eine optionale Eigenschaft des Datentyps Integer.

Standardwert: 0

Gültiger Bereich: -2.147.483.648 bis einschließlich 2.147.483.647

Wenn Y außerhalb des Ganzzahlenbereichs liegt, erscheint eine geeignete Überlaufmeldung zur Laufzeit im Logger. Dieser Wert gilt nur, wenn WindowRelativePosition den WertDesktopXY, WindowXY oder ClientAreaXY hat. Im Gegensatz zur Animation ShowSymbol gibt es keine Grenze für diesen Wert.

Beispiel:

graphicInfo.Y = 100;

Breite

Width legt die Breite des Popup-Fensters fest.

Dies ist eine optionale Eigenschaft des Datentyps Integer.

Standardwert: 100

Gültiger Bereich: 0–10.000

Gilt nur, wenn RelativeTo den Wert CustomizedWidthHeight hat. Sie können entweder die Höhe oder die Breite des Popup-Fensters angeben. Das System berechnet das andere, basierend auf dem Seitenverhältnis der Grafik. Wenn ein Wert außerhalb der Grenzen angegeben wird, zeigt das System eine Meldung „außerhalb des Bereichs“ zur Laufzeit an. Wenn der Wert > 10000 ist, wird er auf 10000 gesetzt. Wenn der Wert < 0 ist, wird er auf 0 gesetzt.

Beispiel:

graphicInfo.width = 500;

Höhe

Height legt die Höhe des Popup-Fensters fest.

Dies ist eine optionale Eigenschaft des Datentyps Integer.

Standardwert: 100

Gültiger Bereich: 0–10.000

Height gilt nur, wenn RelativeTo der Wert des Parameters CustomizedWidthHeight ist. Es können entweder die Höhe oder die Breite des Popup-Fensters angegeben werden. Das System berechnet das andere, basierend auf dem Seitenverhältnis der Grafik. Wenn ein Wert außerhalb der Grenzen angegeben wird, zeigt das System eine Meldung „außerhalb des Bereichs“ zur Laufzeit an. Wenn der Wert > 10000 ist, wird er auf 10000 gesetzt. Wenn der Wert < 0 ist, wird er auf 0 gesetzt.

Beispiel:

graphicInfo.height = 500;

TopMost

TopMost setzt einen Wert, der angibt, ob ShowGraphic im Fenster mit oberst möglicher Z-Reihenfolge erscheint. Ein ShowGraphic-Fenster, dessen Eigenschaft TopMost auf „true“ gesetzt ist, erscheint über allen Fenstern, deren Eigenschaften vom Typ TopMost auf „false“ gesetzt sind (gleich wie Task-Manager von Windows).

Dies ist eine optionale Eigenschaft des Datentyps Boolean.

Standardwert: False

In einer Gruppe von Fenstern, deren Eigenschaft TopMost auf „true“ gesetzt ist, ist das aktive Fenster das oberste Fenster. Erstellen Sie keine Skripte, die ein Nicht-TopMost Modal Dialogfeld aus einem TopMost Dialogfeld starten. Benutzer können dann nicht mit der Ansicht interagieren, wenn das Modal-Dialogfeld vollständig durch ein TopMost-Fenster verdeckt ist.

Beispiel:

graphicInfo.TopMost = true;

ScalePercentage

ScalePercentage setzt den Prozentwert der Skalierung des Popup-Fensters und der Grafik, die es enthält.

Dies ist eine optionale Eigenschaft des Datentyps Integer.

Standardwert: 100

Gültiger Bereich: 0–1.000

Wenn ein Wert außerhalb der Grenzen angegeben wird, zeigt das System eine Meldung „außerhalb des Bereichs“ zur Laufzeit an. Ist der Wert größer als 1.000, wird er auf 1.000 festgelegt. Wenn der Wert < 0 ist, wird er auf 0 gesetzt.

Beispiel:

graphicInfo.ScalePercentage = 150;

KeepOnMonitor

KeepOnMonitor gibt an, dass ein Popup-Fenster komplett innerhalb der Grenzen eines Projektfensters erscheint.

Dies ist eine optionale Eigenschaft des Datentyps Boolean.

Standardwert: True

Beispiel:

graphicInfo.KeepOnMonitor = true;

StretchGraphicToFit
WindowSize

StretchGraphicToFitWindowSize legt fest, ob die Grafik auf die aktuelle Größe des Popup-Fensters skaliert wird.

Dies ist eine optionale Eigenschaft des Datentyps Boolean.

Standardwert: True

Gilt nur, wenn der Wert des Parameters ScalePercentage größer als 100 ist.

Beispiel:

graphicInfo.StretchGraphicToFitWindowSize = false;

StretchWindowTo
ScreenWidth

StretchWindowToScreenWidth legt fest, ob das Popup-Fenster auf dieselbe Breite wie die des Bildschirms skaliert wird.

Dies ist eine optionale Eigenschaft des Datentyps Boolean.

Standardwert: False

Gilt nur, wenn der Parameter WindowRelativePosition Desktop, Window, Client Area, ParentGraphic oder ParentElement ist.

Beispiel:

graphicInfo.StretchWindowToScreenWidth = true;

StretchWindowTo
ScreenHeight

StretchWindowToScreenHeight legt fest, ob das Popup-Fenster auf dieselbe Höhe wie die des Bildschirms skaliert wird.

Dies ist eine optionale Eigenschaft des Datentyps Boolean.

Standardwert: False

Gilt nur, wenn der Parameter WindowRelativePosition auf Desktop, Window, ClientArea, ParentGraphic oder ParentElement festgelegt ist.

Beispiel:

graphicInfo.StretchWindowToScreenHeight = true;

CustomProperties

CustomProperties ist ein ValuePair[]-Array zum Festlegen der benutzerdefinierten Eigenschaften der Grafik, die angezeigt wird.

Dies ist eine optionale Eigenschaft des Datentyps ValuePair[].

Die ersten drei Parameter sind:

• Name der Eigenschaft

• Wert

• ,IsConstant

  Sowohl benutzerdefinierte Eigenschaft als auch der Wert können eine konstante Zeichenfolge, ein Verweis oder eine Verkettung von Zeichenfolgen sein. Wenn der Parameter IsConstant = True ist, wird der Wert als eine Konstante behandelt. Ansonsten wird der Wert als Verweis behandelt. Der Array-Index beginnt bei 1.

  Beispiel:

  Dim cpValues [4] as aaGraphic.CustomPropertyValuePair;

  cpValues[1] = new aaGraphic.CustomPropertyValuePair("CP1", 20, true);

  cpValues[2] = new aaGraphic.CustomPropertyValuePair("CP2", Pump.PV.TagName, true);

  cpValues[3] = new aaGraphic.CustomPropertyValuePair("CP3", "CP"+var1, CP2 + "001" + ".Speed", true);

  cpValues[4] = new aaGraphic.CustomPropertyValuePair("CP3", "<HMI-Name>:Tag1", false);

  graphicInfo.CustomProperties = cpValues;