FindWindow

Aus API-Wiki
Wechseln zu: Navigation, Suche

Die API-Funktion FindWindow sucht ein Fenster mittels 2 Parameter und gibt deren Fensterhandle zurück.

">

Declare Function FindWindow Lib "user32" _
                 Alias "FindWindowA" ( _
                 ByVal lpClassName As String, _
                 ByVal lpWindowName As String) As Long


Parameter

lpClassName

Gibt den Klassennamen an, nach der gesucht wird. Ist der Klassennamen unwichtig, so wird
NullString'' verwendet.
''lpWindowName''
:Gibt den Fensternamen an, nach dem Gesucht wird. Ist der Fenstername unwichtig, so wird ''<syntaxhighlight lang="vb">NullString'' verwendet.


==Rückgabewerte==

Die Funktion gibt einen wert vom Typ long zurück und beinhaltet das Handle des gefundenen Fensters.
Wurde das Fenster nicht gefunden, so ist der Wert 0.




==Beispiel==
Der Aufruf ist simpel. In diesem Beispiel wird das Fenster des Windows Taschenrechners gesucht.

<syntaxhighlight lang="<syntaxhighlight lang="vb">">
Dim Handle As Long
   Handle = FindWindow(<syntaxhighlight lang="vb">NullString, "Rechner")

   If Handle <> 0 Then
      MsgBox "Der Windows-Rechner ist geladen!", <syntaxhighlight lang="vb">Information, "Fenster gefunden!"

   Else
      MsgBox "Der Windows-Rechner ist nicht geladen!", <syntaxhighlight lang="vb">Information, "Fenster nicht gefunden!"

   End If


Hinweise

Diese Funktion findet immer nur das erste Fenster mit dem angegebenen Titel oder Klassennamen. Sind zwei Fenster mit gleichem Titel geöffnet, so liefert die Funktion das erste gefundene Fenster.

Betriebsystem

Die Funktion ist unter folgenden Betriebssystemen funktionsfähig:

  • Windows NT 4.0
  • Windows NT 5.0 (2000)
  • Windows XP (ab SP2)
  • Windows Vista (nur x64)


Verweise

Quelle(n)

http://msdn.microsoft.com/en-us/library/ms633499.aspx