Functions > Window >

WinList

Obtient une liste de fen�tres satisfaisant un crit�re.

WinList ( ["title" [, "text"]] )

Param�tres

title	[optionnel] Le titre/hWnd/class des fen�tres � lister. Consultez D�finition sp�ciale de titre.
text	[optionnel] Le texte des fen�tres � lister. La valeur par d�faut est une cha�ne vide. Consultez D�finition sp�ciale de texte.

Valeur de retour

Retourne un tableau correspondant aux titres et handles des fen�tres trouv�es.

Remarques

Si aucun titre ou texte n'est donn�, alors toutes les fen�tres de niveau sup�rieur sont retourn�es.
Le tableau retourn� est un tableau � deux dimensions compos� comme ceci:
    [0][0] = Nombre de fen�tres retourn�es
    [1][0] = Titre de la premi�re fen�tre
    [1][1] = Handle de la premi�re fen�tre (HWND)
    [2][0] = Titre de la deuxi�me fen�tre
    [2][1] = Handle de la deuxi�me fen�tre (HWND)
    ...
    [n][0] = Titre de la n-i�me fen�tre
    [n][1] = Handle de la n-i�me fen�tre (HWND)

En relation

WinGetHandle

Exemples

Exemple 1

#include <MsgBoxConstants.au3>

Example()

Func Example()
    ; R�cup�re une liste de handles de fen�tre.
    Local $aList = WinList()

    ; Boucle dans le tableau pour afficher uniquement les fen�tres visibles avec un titre.
    For $i = 1 To $aList[0][0]
        If $aList[$i][0] <> "" And BitAND(WinGetState($aList[$i][1]), 2) Then
            MsgBox($MB_SYSTEMMODAL, "", "Title: " & $aList[$i][0] & @CRLF & "Handle: " & $aList[$i][1])
        EndIf
    Next
EndFunc   ;==>Example

Exemple 2

#include <Array.au3>

Example()

Func Example()
    ; R�cup�re une liste de handles de fen�tre � l'aide d'une expression r�guli�re.
    ; L'expression r�guli�re recherche des titres qui contiennent le mot SciTE ou Internet Explorer.
    Local $aWinList = WinList("[REGEXPTITLE:(?i)(.*SciTE.*|.*Internet Explorer.*)]")
    _ArrayDisplay($aWinList)
EndFunc   ;==>Example