Functions > Window >

WinSetOnTop

Change l'attribut "Always On Top" d'une fenêtre.

WinSetOnTop ( "title", "text", flag )

Paramètres

title Le titre/hWnd/class de la fenêtre à traiter. Consultez Définition spéciale de titre.
text Le texte de la fenêtre à traiter. Consultez Définition spéciale de texte.
flag Détermine si la fenêtre doit avoir le paramètre "Mise en avant-plan (TOPMOST)" activé.
    $WINDOWS_NOONTOP (0) = Désactive le flag avant-plan
    $WINDOWS_ONTOP (1) = Active le flag avant-plan

Les constantes sont définies dans "AutoItConstants.au3"

Valeur de retour

Succès: Retourne 1.
Échec: Retourne 0 si la fenêtre n'est pas trouvée.

Remarque

Les programmes tiers incluant un menu contextuel "Toujours à l'avant plan (Always on Top)" ne pourront mettre à jour l'entrée de leur menu pour refléter le changement de statut de AutoIt en TOPMOST.

En relation

WinSetState

Exemple

#include <AutoItConstants.au3>

Example()

Func Example()
    ; Récupère le handle de la fenêtre active.
    Local $hWnd = WinGetHandle("[ACTIVE]")

    ; Définit la fenêtre active comme étant 'on top' à l'aide du handle retourné par WinGetHandle.
    WinSetOnTop($hWnd, "", 1)

    ; Attend 2 secondes pour afficher le changement.
    Sleep(2000)

    ; Supprime l'état "topmost" de la fenêtre active.
    WinSetOnTop($hWnd, "", $WINDOWS_NOONTOP)
EndFunc   ;==>Example