<< Inhaltsverzeichnis Suchen >>

GR_FINDWINDOW

Funktion

Syntax:

GR_FINDWINDOW(<KLASSENNAME>,<UEBERSCHRIFT>)

<KLASSENNAME>         = <STRING-AUSDRUCK>
<UEBERSCHRIFT>         = <STRING-AUSDRUCK>

Bedeutung:

GR_FINDWINDOW liefert unter WINDOWS die Identifizierungsnummer (Handle) des Windows mit dem Klassennamen <KLASSENNAME> und der Überschrift <UEBERSCHRIFT>. Es werden keine Childwindows berücksichtigt.

Ist <KLASSENNAME> der Leerstring "", so wird die Identifizierungsnummer des ersten gefundenen Windows geliefert, das die angegebene Überschrift hat.

<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 Identifizierungsnummer des Windows geliefert, falls die Klasse übereinstimmt.

GR_FINDWINDOW liefert als Ergebnis 0, wenn kein passendes Window gefunden wurde.

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

Beispiel:

HANDLE% = GR_FINDWINDOW("","Microsoft Word")
/* Wenn Winword geladen ist, enthält HANDLE%
/* die Identifizierungsnummer des Windows

siehe auch:

GR_SHOWWINDOW, GR_GET_WINDOW_HANDLES$, GR_GET_CHILDWINDOW_HANDLES$, GR_GET_CLASS_NAME$