| Objet : | Activer une fenêtre, définir son état ou modifier son titre |
| Format : | ACTIVATE [/=] [/R] "title" [MAX | MIN | RESTORE | DESKTOP | CLOSE | ENABLE | DISABLE | TOPMOST | NOTOPMOST | TOP | BOTTOM | HIDE | FORCEMIN | VDESKTOP=id | /FLASH=type,count | /ICON=iconfile | /POS=left,top,width,height | /TRANS=n | TRAY | "newtitle"] |
| /= | Appeler la boîte de dialogue de la commande ACTIVATE |
| title | Titre actuel de la fenêtre à activer |
| left | Nouvel emplacement du bord gauche de la fenêtre, en pixels |
| type | Une ou plusieurs des valeurs suivantes : |
0 - arrêt du clignotement
1 - fait clignoter le titre de la fenêtre
2 - clignotement du bouton de la barre des tâches
4 - clignotement continu jusqu'à ce que WINDOW soit appelé à nouveau avec le type /FLASH fixé à 0
12 - clignotement continu jusqu'à ce que la fenêtre passe au premier plan (ne peut être utilisé avec 4)
| count | Nombre de clignotements de la fenêtre |
| top | Nouvel emplacement de la bordure supérieure de la fenêtre, en pixels |
| iconfile | Nouvelle légende / icône de la barre des tâches (un fichier .ico ou un exécutable) |
| width | Nouvelle largeur de la fenêtre, en pixels |
| height | Nouvelle hauteur de la fenêtre, en pixels |
| newtitle | Nouveau titre de la fenêtre |
/R(restaurer la fenêtre d'origine)
Voir aussi : DÉPART, TITRE et FENÊTRE.
Utilisation :
ACTIVATE active, et éventuellement modifie, lafenêtre d' une autre session . Elle n'est pas destinée à modifier les caractéristiques de la session en cours (utilisez TITLE ou WINDOW). TCC session en cours (utilisez TITLE ou WINDOW à cette fin).
Title spécifie le nom de la fenêtre cible à activer. Vous pouvez utiliser des caractères génériques, y compris des caractères génériques étendus, dans title. Cela est utile pour les applications qui modifient le titre de leur fenêtre pour refléter le fichier en cours d'utilisation. Letitre doit être placé entre guillemets.
Si letitre commence par un =, on considère qu'il s'agit d'un identifiant de processus et non d'un titre. (Cette méthode est moins fiable que la fourniture d'un titre, car un processus peut avoir plusieurs fenêtres de premier niveau).
Chaque exécution d'ACTIVATE permet de modifier une propriété de la fenêtre cible. Pour effectuer plusieurs opérations, utilisez plusieurs commandes ACTIVATE.
Les options sont les suivantes :
MAX |
Agrandir la fenêtre jusqu'à sa taille maximale et l'activer. |
MIN |
Réduit la fenêtre à une icône. |
RESTORE |
Active la fenêtre à sa taille et à son emplacement par défaut. |
DESKTOP |
Active le bureau de Windows. |
CLOSE |
Envoi d'un message de "fermeture" pour fermer la fenêtre. |
ENABLE |
Active la souris et la saisie au clavier. |
DISABLE |
Désactive la saisie au clavier et à la souris. |
TOPMOST |
Maintient la fenêtre au-dessus de toutes les autres fenêtres jusqu'à ce qu'elle se ferme ou que NOTOPMOST soit utilisé. |
NOTOPMOST |
Permet aux autres fenêtres de se superposer à la fenêtre (c'est l'état normal de la plupart des fenêtres). |
TOP |
Déplace la fenêtre enhaut de l'ordre des fenêtres, au-dessus de toutes les autres fenêtresnonTOPMOST. |
BOTTOM |
Déplace la fenêtre en bas de l'ordre des fenêtres. |
HIDE |
Rend la fenêtre invisible (pour la rendre visible à nouveau, utilisez RESTORE). |
FLASH |
Fait clignoter la fenêtre. |
ICON |
Modifie la légende de la fenêtre et l'icône de la barre des tâches. |
POS |
Définit la position et la taille de la fenêtre (en pixels). |
TRANS |
Niveau de transparence, où n=0 (invisible) à 255 (opaque) (ne fonctionne pas pour les fenêtres de console). |
TRAY |
Déplace la fenêtre spécifiée dans la barre des tâches. |
VDESKTOP |
Déplacer la fenêtre vers un autre bureau virtuel. id peut être un numéro de bureau (1-n), le GUID de ce bureau ou le nom du bureau. Voir VDESKTOP pour plus de détails. |
FORCEMIN |
Force la réduction de la fenêtre même si lethread qui possède la fenêtre ne répond pas. |
"newtitle" |
Modifie le titre de la fenêtre. |
Numeric input may be entered in either decimal format (a sequence of 0-9 digits) or in hexadecimal format ("0x" followed by a sequence of 0-F hex digits).
Si vous spécifiez newtitle, il doit être entouré de guillemets doubles (qui n'apparaîtront pas dans le texte du titre).
ACTIVATE est souvent utilisé avant KEYSTACK pour s'assurer que la fenêtre appropriée reçoit les frappes.
ACTIVATE envoie des messages à lafenêtrenommée . Si la fenêtre ignore ou interprète mal les messages, ACTIVATE risque de ne pas avoir l'effet escompté.
Si ACTIVEZ est utilisé dans un fichier batch et que le fichier batch n'est pas lui-même exécuté dans la fenêtre active (la fenêtre dont la barre de titre est en surbrillance), il se peut que ACTIVEZ n'active pas la fenêtre souhaitée. En effet, sous Windows, il n'est pas possible d'activer une autre fenêtre, sauf si la fenêtre qui émet la commande est elle-même déjà active. Ils'agit d'une fonctionnalité de Windows qui permet d'éviter que des fenêtres qui ne sont pas au premier plan ne s'emparent de données destinées à d'autres fenêtres.
/POS - accepte une valeur * pour n'importe lequel des arguments. Si la valeur est *, ACTIVATE utilisera la position / largeur / hauteur existante. Par exemple, pour redimensionner une fenêtre sans la déplacer :
ACTIVATE "title" /POS=*,*,1200,800
Pour déplacer une fenêtre sans la redimensionner :
ACTIVATE "title" /POS=200,400,*,*
Exemples :
Les exemples ci-dessous maximisent d'abord, puis renomment la fenêtre initialement appelée "Take Command" :
activate "Take Command" max
activate "Take Command" "Take Command is Great!"