<< Inhaltsverzeichnis Suchen >>

GR_SHOWWINDOW

Funktion

Syntax:

GR_SHOWWINDOW(<UEBERSCHRIFT>,<TYP>)

<UEBERSCHRIFT>         = <STRING-AUSDRUCK>
<TYP>                                = <NUM-AUSDRUCK>

Bedeutung:

Diese Funktion bringt die WINDOWS-Anwendung mit der Main-Window-Überschrift <UEBERSCHRIFT> in den Vordergrund. <TYP> legt den Anzeigemodus des Main-Windows fest.

 

Wert von <TYP>

Anzeige des Main-Windows

 

1
2
3
4
jeder andere Wert

maximiert
restored
minimiert
unsichtbar
Wenn das Main-Window minimiert ist, wird es in der Größe vor der Minimierung angezeigt, andernfalls wird die Größe nicht geändert

 

<UEBERSCHRIFT> muß nicht die vollständige Überschrift enthalten. Es werden die in <UEBERSCHRIFT> enthaltenen Zeichen mit den Anfangszeichen der einzelnen Window-Überschriften verglichen. Stimmen alle Zeichen überein, so wird die Anwendung in den Vordergrund geholt und die Funktion wird beendet.

In <UEBERSCHRIFT> kann anstelle der Überschrift auch die Identifizierungsnummer (Handle) des Windows angegeben werden. Dazu muß das erste Zeichen in <UEBERSCHRIFT> der Strichpunkt ";" sein und es dürfen dann nur noch die Ziffern der Identifizierungsnummer folgen.

GR_SHOWWINDOW liefert als Ergebnis 0, wenn sie erfolgreich war.

 

-1 bedeutet:

Es wurde keine Anwendung mit der Überschrift <UEBERSCHRIFT> gefunden.

 

-2 bedeutet:

Es wurden überhaupt keine WINDOWS-Anwendungen gefunden.

 

Unter MS-DOS und UNIX liefert GR_SHOWWINDOW als Ergebnis stets -1.

Beispiel:

H% = GR_SHOWWINDOW("Microsoft Word",0)
IF H% <> 0
THEN ... /* Fehler
ENDIF

oder

HANDLE% = GR_FINDWINDOW("","Microsoft Word")
IF HANDLE% <> 0
THEN    H% = GR_SHOWWINDOW(";"+STRN$(HANDLE%),0)
               IF H% <> 0
               THEN ... /* Fehler
               ENDIF
ENDIF

siehe auch:

GR_HIDE, GR_FINDWINDOW, CALL __TOPMOST, GR_GET_WINDOW_HANDLES$, GR_GET_CLASS_NAME$, GR_GET_CHILDWINDOW_HANDLES$