Aide:WinActivate.txt

Document original V3.3.6.1 :

###Function###
WinActivate

###Description###
Activates (gives focus to) a window.

###Syntax###
WinActivate ( "title" [, "text"] )


###Parameters###
@@ParamTable@@
title
	The title of the window to activate. See <a href="../intro/windowsadvanced.htm">Title special definition</a>.
text
	[optional] The text of the window to activate.
@@End@@


###ReturnValue###
@@ReturnTable@@
Success:	Returns the handle of the window.
Failure:	Returns 0 if window is not found or cannot be activated. 
@@End@@


###Remarks###
You can use the WinActive function to check if WinActivate succeeded.  If multiple windows match the criteria, the window that was most recently active is the one activated.  WinActivate works on minimized windows.  However, a window that is "Always On Top" could still cover up a window you Activated.

@extended contains additional info about how the activated process was done.

###Related###
WinClose, WinSetState, WinTitleMatchMode (Option), WinKill, WinMove


###Example###
@@IncludeExample@@

Document traduit V3.3.6.1 :

###Function###
WinActivate

###Description###
Active (donne le focus) à une fenêtre.


###Syntax###
WinActivate ( "title" [, "text"] )


###Parameters###
@@ParamTable@@
title
	Le titre de la fenêtre à activer. Voir <a href="../intro/windowsadvanced.htm">Définition spéciale de titre</a>.
text
	[optionnel] Le texte de la fenêtre à activer.
@@End@@


###ReturnValue###
@@ReturnTable@@
Succès:	Retourne le handle de la fenêtre.
Échec:	Retourne 0 si la fenêtre n'est pas trouvée ou ne peut pas être activée.
@@End@@


###Remarks###
Vous pouvez utiliser la fonction WinActive pour vérifier si WinActivate a réussi. Si plusieurs fenêtres correspondent aux critères, le titre de la fenêtre la plus récente sera utilisé. WinActivate fonctionne sur les fenêtres réduites. Toutefois, une fenêtre qui est «Always On Top" peut encore couvrir une fenêtre que vous avez activé.

@extended contient des informations complémentaires sur la manière dont le processus d'activation a été réalisé.


###Related###
<a href="WinClose.htm">WinClose</a>, <a href="WinSetState.htm">WinSetState</a>, <a href="WinTitleMatchMode.htm">WinTitleMatchMode(Option)</a>, <a href="WinKill.htm">WinKill</a>, <a href="WinMove.htm">WinMove</a>


###Example###
@@IncludeExample@@

Traducteur : Jerome

Contributeurs (pour les modifications avant le Wiki) : matwachich, Tlem