Eigenschaften und Ereignisse des Panels

Panelname

Der Panelname ist eine eindeutige Bezeichnung des Panels, die nach dem Speichern im Fenstertitel angezeigt wird. Wenn Sie Panels in Skripts ansprechen wollen, müssen Sie Panelnamen vergeben. Der Name muss eindeutig sein.

Der Typname kann wie der Panelname bei Stylesheets zur genaueren Definition von Selektoren verwendet werden. Wie bei Grafikobjekten ist es auch möglich, den Typ eines Panels zur Laufzeit über getValue/setValue abzufragen bzw. zu setzen (z.B.: setValue(myModuleName() + "." + myPanelName() + ":", "type", "paneltype1" );).

Hinweis

Wird das "type"-Attribut zur Laufzeit geändert, muss das Stylesheet-Property erneut angewendet werden (siehe setApplicationProperty()).

Bei der Angabe des Typnamens sind nur ASCII-Zeichen erlaubt.

Die Höhe und Breite des Panels in Pixel. (verfügbar via CTRL) - size(width, height)

Hinweis: Mit Qt5 beträgt zwar die maximale mögliche Größe eines Panels QSize (16777215,16777215) Pixel, jedoch wird empfohlen die Größe von 32.000 x 32.000 Pixel nicht zu überschreiten, da nur dann jedes Pixel dargestellt wird. Jedoch ist auch vom Erstellen in dieser Größe abzuraten, wenn keine hochleistungsfähige Grafikkarte verwendet wird. Ebenso kann es unter Windows zu einem zu hohen GDI-Ressourcenverbrauch führen. Somit wird empfohlen, mehr kleine Panels als ein großes zu erstellen.

Gibt an, ob Layoutmanagement verwendet werden soll und wenn ja, in welcher Form. Zur Auswahl stehen:

• HBox (horizontale Box)

• VBox (vertikale Box)

Eine nähere Beschreibung finden Sie im Kapitel Layoutmanagement.

Zeigt die sichtbaren Ebenen

Beim Klick in dieses Feld öffnet sich das Layerfenster (siehe auch Das Layerfenster (Layer-Einstellungen)).

Es gibt die Standardebene (Default = 1) und weitere sieben Ebenen. Beispielsweise weisen Sie das Grafikobjekt der Ebene 2 zu, indem Sie in dem Feld die Ebene 2 auswählen.

Im Layerfenster können Sie auch Ebenennamen vergeben, die Ebenen ausblenden (Checkbox Visible).

Definiert über den angegebenen Dateinamen (z.B. myIcon.jpg) ein Icon, welches zur Laufzeit links in der Titelleiste des Panels angezeigt wird.

Das Icon muss im /pictures Verzeichnis abgelegt werden. Bei einem Leerstring wird wieder das Default-Icon angezeigt.

Damit bleibt das Panel nach dem Schließen im Speicher.

Mit dem Attribut können Sie wählen, ob das Panel im Arbeitsspeicher bleiben soll. Da defaultmäßig gespeichert wird, können Sie durch ein No die Speicherbelastung verringern. (verfügbar via CTRL) - keepInMemory(bool)

Hinweis

Wenn man in einem Panel mit der Defaulteinstellung "Im Speicher halten" Referenzen verwendet und diese ändert, so wirkt sich die Änderung erst nach einem UI-Neustart aus.

Liefert den Pfad der Panel Referenz basierend auf von der Position des obersten Parent Panels. (read-only; verfügbar via CTRL) - namePath()

Nur verfügbar für Panelreferenzen.

Liefert einen Pointer auf das angegebene Panel (Nur Lesen; Verfügbar via CTRL) - panel(string panelName, shape &panel)

Nicht verfügbar für Panelreferenzen.

Die Hintergrundfarbe und/oder das Hintergrundbild des Panels.

Den Panelhintergrund können Sie mit einer Farbfläche (Es öffnet sich der Farbselektor) und/oder mit einem Bild ausgestalten. Das Bild muss im Unterverzeichnis /picturesliegen und kann von anderen Benutzern in mehreren Panels angewendet werden.

Hinweis

• Die Skalierung von Hintergrundbildern kann sich zwischen Schaltflächen und anderen Grafikobjekten unterscheiden.
• Ein transparenter Childpanel Hintergrund kann nur verwendet werden wenn die Eigenschaft "windowFlags" die Option "FramelessWindowHint" aktiviert hat. Diese kann mittels CTRL gesetzt werden.
• Wenn keine Hintergrundfarbe explizit gesetzt wird verwendet das Panel die Default Hintergrundfarbe. Dies gilt auch, wenn ein Hintergrundbild definiert wurde.
• Der Hintergrund eines Nicht-Childpanels kann nicht transparent gesetzt werden.

Das Attribut Sende Mausclick verschickt bei Yes die X- und Y-Position eines Mausklicks im Panel auf Datenpunktelemente des jeweiligen UI-Managers. Dabei wird neben der X- und Y-Koordinate auch zugehöriges Modul und Panel im Datenpunkt gespeichert. Damit können z.B. die Koordinaten des letzten Mausklicks abgefragt werden.

Default: No.

Sprachumschaltung nur neu zeichnen, TRUE: Die Umschaltung wird nur durch "Neuzeichnen" aller statischen Paneltexte und Ausführen des "LangChanged" durchgeführt. Verwenden Sie diese Option bei neuen Panels, wo keine "Initialize"-Skripts definiert sind, mit denen Texte auf Objekte übertragen werden.

Default: Sprachumschaltung nur neu zeichnen, FALSE: zusätzlich werden alle Childpanels geschlossen, alle CTRL-Skripts gestoppt (auch das Skript mit der switchLang()-Funktion) und alle "Initialize" ausgeführt. Diese Option ist defaultmäßig aktiviert und sollte bei älteren Panels aktiviert werden, die beim Aufschalten Texte an Objekte in den Panels übergeben.

X-Position eines Panel beim Aufschalten des Panels.

Y-Position eines Panels beim Aufschalten des Panels.

Aufschaltenskript starten

Löst EventInitialize und EventTerminate aus, wenn Panel als Referenz verwendet wird. Default: Yes.

Start-Modus von Scripts

Das Attribut "startInit-Script Modus" wirkt sich auf alle Shapes des eigenen Panel aus. Werden in einem Panel auch Referenzen verwendet, wird das Startverhalten der Shapes innerhalb der Referenz durch dessen eigenes "startInit-ScriptModus"-Attribut beeinflusst.

All Objects: (Default): Beim Aufschalten werden alle "Initialize"-Skripts gestartet. Ob das Objekt innerhalb des Bildschirmes oder in einer sichtbaren Ebene liegt, wird hierbei nicht berücksichtigt.

Visible Objects: Beim Aufschalten des Panels werden nur die Scripts von Objekten, die sich innerhalb des Bildschirmes und auf einer sichtbaren Ebene befinden, ausgeführt.

Der weitere Panelbereich wird erst zur Laufzeit durch Scrollen nach links/recht/oben/unten mit seinen Objekten aufgebaut, unter Berücksichtigung der Cluttering-Einstellungen für die verschiedenen Ebenen.

Die auf Objekte parametrierten "Initialize"-Skripts werden erst dann ausgeführt, wenn das Objekt innerhalb des Bildschirmes und in einer sichtbaren Ebene liegt. Siehe auch Kapitel: Cluttering/Decluttering.

Innerhalb der Referenzen werden aber auch die Scripts von Shapes, die noch nicht sichtbar sind, gestartet.

D.h. wenn das startInit-ScriptModus einer Referenz = All Objects ist

und vom Main-Panel startInit-ScriptModus = Visible Objects ist, werden die Scripts aller sichtbaren Referenzen gestartet. Innerhalb der Referenzen werden aber auch die Scripts von Objekten, die noch nicht sichtbar sind, gestartet.

Dieses Verhalten wird Ihnen anhand der folgenden Tabelle verdeutlicht:

Liefert oder setzt spezifische Flags die das Verhalten des Panels definieren. Mehrere Flags können unter Verwendung des Pipe Zeichens ("|") angegeben werden. (Verfügbar via CTRL) - windowFlags(string)

Folgende Flags sind verfügbar:

• "FramelessWindowHint" ... Liefert ein Fenster ohne Rahmen. Der Benutzer kann das rahmenlose Fenster nicht mehr verschieben oder in der Größe verändern. Unter X11 hängt das Ergebnis dieses Flags davon ab ob Motif und/oder NETWM unterstützt werden.
• "NoDropShadowWindowHint" ... Deaktiviert den Fenster Drop Schatten auf unterstützen Plattformen.
• "CustomizeWindowHint" ... Das CustomizeWindowHint Flag wird verwendet um Anpassungen an den Fenster Kontroll Elementen zu erlauben. Muss gesetzt werden um die Flags WindowTitleHint, WindowSystemMenuHint, WindowMinimizeButtonHint, WindowMaximizeButtonHint and WindowCloseButtonHint verwenden zu können..
• "WindowTitleHint" ...Gibt dem Fenster eine Titelleiste.
• "WindowSystemMenuHint" ... Fügt ein System Menü innerhalb des Fensters ein und wenn möglich eine "Schließen" Schaltfläche. Wenn es darum geht die "Schließen" Schaltfläche anzuzeigen oder zu verstecken wird die stattdessen das Flag WindowCloseButtonHint empfohlen.
• "WindowMinimizeButtonHint" ... Fügt eine "Minimieren" Schaltfläche ein. Auf manchen Betriebssystemen ist hierfür zusätzlich "WindowSystemMenuHint" erforderlich.
• "WindowMaximizeButtonHint" ... Fügt eine "Maximieren" Schaltfläche ein. Auf manchen Betriebssystemen ist hierfür zusätzlich "WindowSystemMenuHint" erforderlich.
• "WindowCloseButtonHint" ... Fügt eine "Schließen" Schaltfläche ein. Auf manchen Betriebssystemen ist hierfür zusätzlich "WindowSystemMenuHint" erforderlich.
• "WindowShadeButtonHint" ...Fügt eine "Shade" Schaltfläche ein wenn der zugrunde liegende Fenster Manager es unterstützt.
• "WindowStaysOnTopHint" ... Gibt an, dass das Fenster immer im Vordergrund bleiben soll.
• "WindowStaysOnBottomHint" ... Gibt an, dass das Fenster immer im Hintergrund bleiben soll.
• "WindowTransparentForInput" ... Gibt an, dass das Fenster nur für die Ausgabe/Anzeige verwendet werden soll und Eingabe Ereignisse entsprechend nicht behandelt und an das darunter befindliche Objekt weitergeleitet werden.
• "WindowDoesNotAcceptFocus" ... Gibt an, dass das Fenster nicht den Eingabe Fokus erhalten soll.

Dieses Attribut beinhaltet die Geometrie des Fensters inklusive des Rahmens. Kann verwendet werden um das Fenster zu bewegen oder in der Größe zu verändern. (Verfügbar via CTRL) - windowFrameGeometry(x, y, w, h).

Hinweis

• Kann auch mittels der Funktion animate() verändert werden. Hierbei müssen die vier Werte mittels dyn_int Element übergeben werden.
• Kann nicht für ein Panel innerhalb eines Embedded Modules verwendet werden.
• Für ein Child Panel sind die Koordinaten relativ zum Parent Panel.
• Wenn die Geometrie des Panels abgefragt wird bevor das Panel sichtbar ist, dann sind die zurückgelieferten Werte nicht korrekt, da diese erst asynchron durch den Window Manager gesetzt werden sobald das Fenster platziert wurde.

Dieses Attribut beinhaltet die Geometrie des Fensters exklusive des Rahmens. Kann verwendet werden um das Fenster zu bewegen oder in der Größe zu verändern. (Verfügbar via CTRL) - windowFrameGeometry(x, y, w, h).

Hinweis

• Kann auch mittels der Funktion animate() verändert werden. Hierbei müssen die vier Werte mittels dyn_int Element übergeben werden.
• Kann nicht für ein Panel innerhalb eines Embedded Modules verwendet werden.
• Für ein Child Panel sind die Koordinaten relativ zum Parent Panel.
• Wenn die Geometrie des Panels abgefragt wird bevor das Panel sichtbar ist, dann sind die zurückgelieferten Werte nicht korrekt, da diese erst asynchron durch den Window Manager gesetzt werden sobald das Fenster platziert wurde.

Dieses Attribut erlaubt es die Deckkraft des kompletten top-level Fensters (Modul oder Child Panel) festzulegen. Der gültige Wertebereich liegt zwischen 0.0 (komplett transparent) und 1.0 (komplett undurchlässig). Der Standardwert ist 1.0. (Verfügbar via CTRL) - windowOpacity(float)

Hinweis

• Dieses Attribut ist nicht verfügbar wenn das Panel innerhalb eines Embedded Modules verwendet wird.
• Semi-transparente Updates und Größenänderungen des Fensters sind signifikant langsamer als Updates oder Größenänderungen von undurchlässigen Fenstern.

Dieses Attribut erlaubt es den Zustand des Fensters festzulegen. (Verfügbar via CTRL) - windowState(string)

Folgende Zustände können gesetzt werden:

• WindowNoState (default - Normaler Zustand)
• WindowMinimized
• WindowMaximized
• WindowFullScreen
• WindowActive

Hinweis

• Mehrere Zustände können mittels "|" kombiniert werden, z.B. "WindowMaximized|WindowActive"
• Die Änderungen des Zustand erfolgt bei unsichtbaren Panels erst, wenn diese sichtbar geschalten werden. Bei sichtbaren Panels erfolgt die Änderung sofort.
• Bei manchen Fenster Managern kann es vorkommen, dass der WindowActive Zustand nicht sofort oder gar nicht ausgelöst wird.

Das Attribut erlaubt das Setzen oder Lesen der Sichtbarkeit des Panels (verfügbar via CTRL) - windowVisible(bool)

Hinweis

Dieses Attribut ist nicht verfügbar wenn das Panel innerhalb eines Embedded Modules verwendet wird.

Das Attribut erlaubt es ein Panel per Skript zu speichern. (Verfügbar via CTRL) - writeToFile(string fileName, string format)

Hinweise

• Der "fileName" Parameter entspricht dem Namen des Panels inklusive dem relativen Pfad in welchem das Panel gespeichert werden soll. Der relative Pfad ist ausgehend vom Projekt Verzeichnis proj_path/panels/.
• Der "format" Parameter definiert in welchem Panel Format das Panel gespeichert werden soll. Hier kann entweder "PNL", "XML" oder ein Leerstring angegeben werden. Bei der Verwendung eines Leerstrings wird das Standard Format des Projektes gewählt, siehe defaultPanelFormat.
• Es ist zu beachten, dass Eigenschaften von Objekten nicht innerhalb des Panels gespeichert werden wenn "writeToFile" verwendet wird, d.h. diese müssen mittels entsprechender Public Funktionen innerhalb des "Initialize" Skriptes des Objekts gesetzt werden.

Wenn aktiviert (=TRUE) wird die Größe des Moduls nicht an das Panel angepasst sondern die Dimensionen aus der PVSS00ui.ini werden herangezogen (falls verfügbar)

Die Eigenschaft muss für das Panel gesetzt werden in welchem die neuen Module aufgeschalten werden (z.B. mittels moduleAddDockModule()).

Der Klick kann mit der Linken oder anderen verfügbaren Maustasten ausgelöst werden. Die Ausnahme bildet hierbei der Rechtsklick, für welchen ein eigenes Ereignis existiert. Die verwendete Maustaste wird in dem Mapping "event", welches an das Script weitergegeben wird, spezifiziert.

Hinweis: Um die mittlere Maustaste zum Starten von Skripten zu verwenden, muss zuvor das Panning mit dem Config-Eintrag [ui] middleMousePanning deaktiviert werden.

Dieses Ereignis wird nur dann gestartet, wenn das Panel Drops akzeptiert und nicht deaktiviert ist. Das Panel muss entscheiden, ob die bereit ist, dropped-Information zu akzeptieren. Wenn ja, muss das Panel die CTRL-Funktion aufrufen:

int dropAccept( bool accept = true)

Für mehr Information siehe Drag & Drop zur Laufzeit.

Dieses Ereignis wird durch ein Swipe-Gesture (Bewegung mit einem oder zwei Fingern) gestartet. Das Ereignis funktioniert nur, wenn das Panel im Modul nicht größer als das Darstellungsfeld ist (sodass Scrollbars nicht benötigt werden und Sie das komplette Panel sehen). Sonst wird durch die Swipe-Bewegung Panning ausgelöst. Panning löst jedoch nicht das Gesture-Script aus.

Das Ereignis steht auch für eingebettete Module zur Verfügung. Wenn Sie das Ereignis für beide, das Panel und für das eingebettete Modul in einem Panel verwenden, wird das Ereignis des eingebetteten Moduls ausgelöst, wenn Sie das Modul swipen. Wenn Sie das Panel swipen (außerhalb des eingebetteten Moduls) wird das Ereignis des Panels ausgelöst. Wenn das eingebettete Modul auch ein Panel und das Ereignis "GestureTriggered" enthält, werden beide das Ereignis des eingebetteten Moduls und des Panels das im Modul geladen wird, ausgelöst.

Das Script enthält folgende Argumente:

main(string type, mapping data)

type = "swipe"

Das Mapping data enthält die folgenden key/value Paare:

• "angle"/float ... die Richtung der Fingerbewegung
• "horizontal"/string ... Eine von: "right", "left" oder "none"
• "vertical"/string ... eine von: "up", "down", "none"
• "touchpoints"/int ... entweder 1 (Bewegung mit 1 Finger) oder 2 (Bewegung mit 2 Fingern)
• "startPos"/dyn_int ... x,y koordiniert den Startpunkt der Panelkoordinaten (nicht gezooomt)
• "endPos"/dyn_int ... x,y koordiniert den Endpunkt der Panelkoordinaten (nicht gezooomt)

Die Werte für "horizontal" und "vertical" werden intern berechnet: Wenn der Finger z.B. rechts und leicht nach oben bewegt wird, sind die Werte folgende: horizontal: "right", vertical: "none"

type = "scrollToPanel"

Das Mapping data enthält folgende key/value Paare:

• "targetPos" ... Integer Wert der Postion zu welcher gescrollt wurde, vergleichbar mit der Funktion "scrollToPanel".

In diesem Skript im Attribut-Editor können Sie Funktionen und (Skript-globale) Variablen deklarieren, welche von allen Objekten innerhalb des Panels (mit Ausnahme von Panel-Referenzen) verwendet werden können, als seien sie in den jeweiligen einzelnen Skripts deklariert worden. Panel-globale Variablen sind wirklich nur einmal vorhanden und können von allen Skripts verändert werden.

Hinweis

Die Initialisierung der ScopeLib innerhalb des GEDIs erfolgt nur wenn zumindest ein #property definiert wurde.

Beim Schließen mit PanelOff() etc. erfolgt ein sofortiges Schließen. Es ist nur ein letztes dpSet() möglich beispielsweise, um eine Sperre aufzuheben.

Der Aufruf der Funktion LogoutDialog() löst das "Terminate" Event ebenfalls aus.

Beim Zoomen. "Zoom" ist nicht für Standardpanels der Version möglich.

Syntax: main (string moduleName, string panelName)