Q_ObjHideShow

---

Einleitung

Der Q_ObjHideShow ist ein standardkonformer Funktionsbaustein zur Sichtbarkeitssteuerung von Container-Objekten in Virtual Terminals, entwickelt unter EPL-2.0 Lizenz. Die Version 1.0 implementiert die ISO 11783-6 (Teil 6 - F.2) Spezifikation für VT-Container.

Schnittstellenstruktur

Ereignis-Eingänge

• INIT: Initialisierungsanforderung (mit Container-Objekt-ID)
• REQ: Sichtbarkeitsänderungs-Anforderung

Ereignis-Ausgänge

• INITO: Initialisierungsbestätigung
• CNF: Änderungsbestätigung

Daten-Eingänge

• u16ObjId (UINT): Container-Objekt-ID (16-bit)
• qVisible (BOOL): Sichtbarkeitsstatus (TRUE=anzeigen, FALSE=verstecken)

Daten-Ausgänge

• STATUS (STRING): Betriebsstatusmeldung
• qOldVisible (BOOL): Vorheriger Sichtbarkeitsstatus
• s16result (INT): ISO-konformer Ergebniscode

Funktionsweise

1. Initialisierung:
2. INIT mit Container-Objekt-ID

3. INITO bestätigt Betriebsbereitschaft

4. Sichtbarkeitsänderung:

5. REQ mit gewünschtem Sichtbarkeitsstatus
6. Ändert die Darstellung des Containers und aller enthaltenen Objekte

7. CNF liefert Betriebsstatus und vorherigen Zustand

8. Spezialfälle:

9. Bei ungültigen Objekt-IDs wird VT_E_HANDLE_INVALID zurückgegeben

Technische Besonderheiten

✔ ISO 11783-6 konform (F.2) ✔ Kaskadierender Effekt (Beeinflusst enthaltene Objekte) ✔ Sofortige GUI-Aktualisierung ✔ Zustandserhaltung (Merkt vorherigen Status)

Statusreferenz

qVisible	Containerzustand
FALSE (0)	Unsichtbar
TRUE (1)	Sichtbar

Rückgabecodes (s16result)

Code	Konstante	Bedeutung
0	VT_E_NO_ERR	Erfolgreiche Ausführung
-6	VT_E_OVERFLOW	Pufferüberlauf
-8	VT_E_NOACT	VT nicht bereit
-21	VT_E_NO_INSTANCE	Kein VT-Client verfügbar
-128	VT_E_HANDLE_INVALID	Ungültige Container-ID
-129	VT_E_ISO_INSTANCE_INVALID	Ungültige VT-Instanz
-130	VT_E_NOT_ALIVE	VT nicht aktiv

Anwendungsszenarien

• Dynamische Oberflächen: Kontextabhängige Anzeigen
• Bildschirmmanager: View-Wechsel
• Alarmmanagement: Störmeldungscontainer
• Benutzerführung: Schrittweise Anleitungen

⚖️ Vergleich mit ähnlichen Bausteinen

Feature	Q_ObjHideShow	VtContainerControl	VtVisibilityManager
ISO-Standard	✔	✖	✖
Containerfokus	✔	✔	✖
Kaskadierend	✔	✖	✔
Rückmeldung	✔	✖	✔

🛠️ Zugehörige Übungen

• Uebung_014

Fazit

Der Q_ObjHideShow-Baustein bietet zentrale Sichtbarkeitskontrolle:

• Effizient: Sofortige GUI-Aktualisierung
• Umfassend: Beeinflusst gesamte Containerelemente
• Zuverlässig: ISO-konforme Implementierung

Essential für: - Adaptive Benutzeroberflächen - Komplexe Maskenhierarchien - Zustandsgesteuerte Visualisierungen