Q_ObjSelectInput

Q_ObjSelectInput

Einleitung

Der Q_ObjSelectInput ist ein standardkonformer Funktionsbaustein zur programmatischen Auswahl von Eingabefeldern in Virtual Terminals, entwickelt unter EPL-2.0 Lizenz. Die Version 1.0 implementiert die ISO 11783-6 (Teil 6 - F.6) Spezifikation für VT-Eingabeelemente.

Q_ObjSelectInput

Schnittstellenstruktur

Ereignis-Eingänge

  • INIT: Initialisierungsanforderung (mit Objekt-ID)

  • REQ: Auswahlanforderung (mit Option-Parameter)

Ereignis-Ausgänge

  • INITO: Initialisierungsbestätigung

  • CNF: Auswahlbestätigung

Daten-Eingänge

  • u16ObjId (UINT): Eingabeobjekt-ID (16-bit)

  • u8Option (USINT): Auswahloption (0x00 oder 0xFF)

Daten-Ausgänge

  • STATUS (STRING): Betriebsstatusmeldung

  • u8OldOption (USINT): Vorherige Auswahloption

  • s16result (INT): ISO-konformer Ergebniscode

Funktionsweise

  1. Initialisierung:

    • INIT mit Zielobjekt-ID

    • INITO bestätigt Betriebsbereitschaft

  2. Feldauswahl:

    • REQ mit Auswahloption

    • Setzt den Fokus auf das Eingabefeld

    • CNF liefert Betriebsstatus und vorherige Option

  3. Optionen:

    • 0xFF: Standardauswahl (VT Version 3+)

    • 0x00: Erweiterte Auswahl (nur VT Version 4+)

Technische Besonderheiten

✔ ISO 11783-6 konform (F.6) ✔ VT-Versionsabhängig (Option 0x00 nur ab VT4) ✔ Sofortige Fokusänderung ✔ Rückmeldung des vorherigen Zustands

Optionsreferenz

u8Option

Beschreibung

VT-Version

0xFF

Standardauswahl

3+

0x00

Erweiterte Auswahl

4+

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

-129

VT_E_ISO_INSTANCE_INVALID

Ungültige VT-Instanz

-130

VT_E_NOT_ALIVE

VT nicht aktiv

Anwendungsszenarien

  • Formularnavigation: Automatische Feldauswahl

  • Eingabeassistenten: Geführte Bedienabläufe

  • Fehlermanagement: Direktes Springen zu Fehlerfeldern

  • Touch-Optimierung: Programmatische Fokussteuerung

⚖️ Vergleich mit ähnlichen Bausteinen

Feature

Q_ObjSelectInput

VtFocusControl

VtInputSelector

ISO-Standard

✔

✖

✖

VT-Version 4+

✔

✖

✔

Optionssteuerung

✔

✖

✖

Rückmeldung

✔

✖

✔

Fazit

Der Q_ObjSelectInput-Baustein bietet präzise Eingabefeldsteuerung:

  • Effizient: Direkte Fokusänderung

  • Flexibel: Versionsspezifische Optionen

  • Zuverlässig: ISO-konforme Implementierung

Unverzichtbar für:

  • Professionelle Formularanwendungen

  • Geführte Bedienprozesse

  • Touchscreen-Optimierte Oberflächen