<<

Inhaltsverzeichnis

Suchen

>>

 

MESSAGEBOX

 

 

Funktion

 

 

Syntax:

MESSAGEBOX([<WAIT|NOWAIT>,<Exit-Makro>],<Überschrift>,<Text>,<Buttontexte>,<Buttontypen>, <Trennzeichen>,<Bildname>,<Bildposition>,<Voreinstellung>,<Schriftart>,<Schrifthöhe>,<Buttonhöhe>, <Buttonbreite>,<ESC zulässig>[,<Textfarbe Rot>,<Textfarbe Grün>,<Textfarbe Blau>[,<Hintergrundfarbe Rot>,<Hintergrundfarbe Grün>,<Hintergrundfarbe Blau>]])

 

<Exit-Makro>

= <MAKRONAME>

<Überschrift>

= <STRING-AUSDRUCK>

<Text>

= <STRING-AUSDRUCK>

<Buttontexte>

= <STRING-AUSDRUCK>

<Buttontypen>

= <STRING-AUSDRUCK>

<Trennzeichen>

= <STRING-AUSDRUCK>

<Bildname>

= <STRING-AUSDRUCK>

<Bildposition>

= <NUM-AUSDRUCK>

<Voreinstellung>

= <NUM-AUSDRUCK>

<Schriftart>

= <NUM-AUSDRUCK>

<Schrifthöhe>

= <NUM-AUSDRUCK>

<Buttonhöhe>

= <NUM-AUSDRUCK>

<Buttonbreite>

= <NUM-AUSDRUCK>

<ESC zulässig>

= <NUM-AUSDRUCK>

<Textfarbe Rot>

= <NUM-AUSDRUCK>

<Textfarbe Grün>

= <NUM-AUSDRUCK>

<Textfarbe Blau>

= <NUM-AUSDRUCK>

<Hintergrundfarbe Rot>

= <NUM-AUSDRUCK>

<Hintergrundfarbe Grün>

= <NUM-AUSDRUCK>

<Hintergrundfarbe Blau>

= <NUM-AUSDRUCK>

 

 

Bedeutung:

Erzeugt ein Hinweisfenster mit Auswahlbuttons.

 

Die Anweisung WINDOWPOS legt die Position des Fensters fest.

 

MESSAGEBOX liefert folgende Ergebniswerte:

 

0: ESC wurde gedrückt

1: Button Nr. 1 wurde gedrückt

2: Button Nr. 2 wurde gedrückt

…

Handle bei NOWAIT

-1: Interner Fehler

-99: Kein aktives Fenster gefunden

 

Bei NOWAIT wird das Meldungsfenster angezeigt, die Funktion kehrt sofort zurück und liefert die Identifizierungsnummer (Handle) der Messagebox. Mit der Anweisung CLOSE_MESSAGEBOX kann eine mit NOWAIT geöffnete Messagebox geschlossen werden. Der Macro <Exit-Makro> wird ausgeführt, nachdem die MESSAGEBOX beendet wurde. Die Variable EBUS_TRANSFER enthält dann den Returncode.

 

Bei WAIT wird MESSAGEBOX hierarchisch gestartet und die Funktion kehrt erst zurück, wenn die MESSAGEBOX beendet wurde.

 

Die Parameter <Textfarbe Rot>,<Textfarbe Grün> und <Textfarbe Blau> legen die Farbe fest, mit der der <Text> im Fenster angezeigt wird. Fehlen diese Parameter, so wird der Text schwarz (0,0,0) angezeigt.

 

Die Parameter <Hintergrundfarbe Rot>,<Hintergrundfarbe Grün> und <Hintergrundfarbe Blau> legen die Hintergrundfarbe des Windows fest. Fehlen diese Parameter oder hat einer der Parameter einen Wert < 0, so wird das Window in der Standardfarbe angezeigt.

 

Parameter:

WAIT|NOWAIT

WAIT: Die Funktion wartet, bis MESSAGEBOX beendet wurde.

NOWAIT: Die Funktion kehrt sofort zurück und liefert als Ergebnis die Identifizierungsnummer (Handle) des Fensters.

 

Exit-Makro

Wird ausgeführt, nachdem MESSAGEBOX beendet wurde. EBUS_TRANSFER enthält den Returncode

 

Überschrift

Überschrift des Windows

 

Text

Text, der im Fenster angezeigt werden soll. Jedes <Trennzeichen> im Text bewirkt einen Zeilenumbruch. Ist <Bildposition> = 0, so wird der <Text> rechts neben dem Bild angezeigt, andernfalls unter dem Bild.

 

Buttontexte

Enthält durch <Trennzeichen> getrennt die Texte, die auf den Buttons angezeigt werden sollen. Hiermit wird auch die Anzahl der zu erzeugenden Buttons festgelegt.

 

Buttontypen

Enthält durch <Trennzeichen> getrennt die Buttontypen. Es kann die Nummer eines Standardbildes oder @<Bildname> angegeben werden. Folgende Standardbilder stehen zur Verfügung:

 

1 =

2 =

3 =

4 =

5 =

 

Trennzeichen

Legt das Zeichen  für <Buttontexte>, <Buttontypen> und <Text> fest. Ist <Trennzeichen> der Leerstring "", so gilt der Strichpunkt ";" als Trennzeichen.

 

Bildname

Legt den Namen einer Bilddatei fest. Das Bild wird im Fenster oben angezeigt. Ist <Bildposition> = 0, so wird das Bild linksbündig angezeigt, andernfalls in der Mitte zentriert. Die Bilddatei sollte im Programm zusätzlich mit #ADD_IMAGE definiert werden, damit sie in die jar-Datei eingebunden werden kann. Das Stoppzeichen Stop.gif ist standardmäßig verfügbar. Ist <Bildname> der Leerstring "", so wird kein Bild angezeigt.

 

Bildposition

Legt die Position des Bildes fest:

0: linksbündig

sonst: in der Mitte

 

Voreinstellung

Legt die Nummer des Buttons fest, der voreingestellt wird.

 

Schriftart

Legt die Schriftart für die Anzeige des Textes fest. Es gelten dabei dieselben Zuordnungen wie bei der Anweisung PRINTFONT.

 

Schrifthöhe

Legt die Schrifthöhe der Texte als Vielfaches der Zeilenhöhe fest.

 

Buttonhöhe

Legt die Höhe der Buttons als Vielfaches der Zeilenhöhe fest.

 

Buttonbreite

Legt die Breite der Buttons in Spalten fest.

 

ESC zulässig

0: Das Fenster kann nicht mit ESC abgebrochen werden.

sonst: ESC kann gedrückt werden.

 

Textfarbe Rot

Farbanteil Rot

 

Textfarbe Grün

Farbanteil Grün

 

Textfarbe Blau

Farbanteil Blau

 

Hintergrundfarbe Rot

Farbanteil Rot

 

Hintergrundfarbe Grün

Farbanteil Grün

 

Hintergrundfarbe Blau

Farbanteil Blau

 

Beispiel:

WINDOWPOS(0,0)

H% = MESSAGEBOX(

     "Löschen",                              /* Überschrift

     "Soll der Datensatz gelöscht werden ?", /* Text

     "&Ja;&Nein;&Abbrechen",                 /* Button-Texte

     "1;2;@abbruch.jpg",                     /* Button-Typen

     ";",                                    /* Trennzeichen

     "stop.gif",                             /* Bilddatei

     0,                                      /* Bild links

     2,                                      /* Voreinstellung 'Nein'

     2,                                      /* Schriftart fett

     1.1,                                    /* Schrifthöhe

     1.5,                                    /* Buttonhöhe

     12,                                     /* Buttonbreite

     0,                                      /* ESC nicht zulässig

     255,0,0,                                /* Textfarbe rot

     255,255,255)                            /* Hintergrund weiß

 

IF H% = 1

THEN ... /* Ja wurde gewählt

ENDIF

 

Siehe auch:

MESSAGE

ERRORMES

CLOSE_MESSAGEBOX

EBUS_TRANSFER