5.18 Waitbox - Arbeiten mit Windows-Control-Elementen


		Format: Call Waitbox using steuerfeld element1 ....

Allgemein:

Durch den Aufruf von WAITBOX wird der Eingabefokus auf ein Control-Element gesetzt und auf eine User-Aktion gewartet.

WAITBOX löst intern die Struktur von element1 auf, wenn es sich um einen DIALOG, MAINDIALOG, POPUPDIALOG,TABDIALOG handelt.

Zum Setzen des Einabefokus wird das Steuerfeld verwendet.

Es besitzt folgenden Aufbau:

       01 bnr           pic 9(5).
       01 bxnr redefines bnr.
        02 bid          pic 99.         id-nummer
        02 blnr         pic 999.        laufende nummer

Im Steuerfeld wird in den niederwertigen 3-Stellen die fortlaufende Nummer des Control-Elementes, in den höheren Stellen, die Id-Nummer (sofern vorhanden) abgestellt.

Die Control-Elemente, die einen Fokus erhalten können, werden in der Reihenfolge, wie sie in der Working-Storage Section beschrieben sind. durchnummeriert. Dies ist die laufende Nummer (blnr).

Dazu erzeugt WAITBOX intern eine Tabelle, in der sämtliche Control-Elemente abgespeichert sind, die den Fokus erhalten können.

Für den Aufruf von WAITBOX gilt:

Feldinhalte	Auswirkung
bid ungleich 0	Das Control-Element mit der Id- Nummer von bid erhält den Fokus
bid = 0 blnr ungleich 0	blnr enthält die Nummer des Control-Elements, das den Fokus erhält
bid = 0 blnr = 0	Das nächste Control-Element in der Reihenfolge erhält den Fokus

War die letzte Eingabe die TAB-Taste, wird das nächste Control- Element angesteuert, wenn bid nicht verändert wird.

WAITBOX setzt den Fokus und wartet auf eine Eingabe des Users.

Wenn der User eine Eingabe vorgenommen hat, wird das Steuerfeld entsprechend der Interaktion gesetzt.

Sonderwerte:

Inhalt von blnr	Ursache
0	Es wurde eine Menüauswahl vorgenommen
999	Es wurde die Hilfefunktion aktiviert (? oder F1) Nur in Verbindung mit einer HELPBOX möglich
-1	Die Escape-Taste wurde betätigt
-2	Eine mit CALL FUNDEF definierte Funktionstaste wurde gedrückt
-3	Es wurde ein Control-Element außerhalb der internen Liste aktiviert

In dem Programm accdemo.cob wird der Inhalt der Felder zur Demonstration angezeigt.

Siehe auch accdemo.cob

In dem Programm accdemoh.cob wurde zusätzlich eine HELPBOX zur Anzeige von Hilfetexten eingebunden.

Siehe auch accdemoh.cob

Zurück zu Timepicker-Controls - Eingabe von Uhrzeiten

Hoch zu Windows-Controls mit Acc-Cobol

Weiter zu GetAttribute - Auslesen der Attribute von Control-Elementen und Items