Attend jusqu'à ce que le presse-papier contienne des données.
| ClipWait [, Secondes_A_Attendre, 1] |
Paramètres
| Secondes_A_Attendre | Si omis, la commande attendra indéfiniment. Autrement, elle n'attendra pas plus longtemps que ces quelques secondes (peut contenir un point décimal ou être une expression). Spécifier 0 revient au même que spécifier 0.5. |
| 1 |
Si ce paramètre est omis, la commande est plus sélective, attendant spécifiquement que du texte ou des fichiers apparaissent. Dans la version 1.0.29+, si ce paramètre est 1 (peut être une expression), la commande attend que des données de n'importe quelle sorte apparaissent dans le presse-papier. |
ErrorLevel
Si la période d'attente expire, ErrorLevel sera positionné à 1. Autrement (i.e. le presse papier contient des données), ErrorLevel est positionné à 0.
Remarques
Il est mieux d'utiliser cette commande plutôt qu'une boucle que vous auriez faîte qui vérifie si le presse-papier est vide. Ceci parce que le presse-papier n'est jamais ouvert par cette commande, et donc cela fonctionne mieux et évite quelconque chance d'interférer avec une autre application qui peut être en train d'utiliser le presse-papier.
Cette commande considère que n'importe quoi convertible en texte (ex.: HTML) est du texte. Il considère aussi les fichiers, tels que ceux copiés dans une fenêtre de l'Explorateur via Control-C, comme du texte. De tels fichiers sont automatiquement convertis en leur nom de fichier (avec le chemin d'accès complet) quand la variable clipboard (%clipboard%) s'y rapporte dans le script. Voir Clipboard pour les détails.
Quand 1 est présent comme dernier paramètre, la commande sera satisfaite quand n'importe quelle donnée apparaîtra dans le presse-papier. Ceci peut être utilisé en conjonction avec ClipboardAll pour sauvegarder les objets non-texte tels que les images.
Lorsque la commande est en état d'attente, de nouvelles tâches peuvent être lancées via une combinaison de touches, un élément de menu personalisé, ou un minuteur.
Relations
Exemple
clipboard = ; Vide le presse-papier
Send, ^c
ClipWait, 2
if ErrorLevel <> 0
{
MsgBox, L'attente pour copier le texte du presse-papier à échouée.
return
}
MsgBox, clipboard = %clipboard%
return