Wartet, bis die Zwischenablage Daten enthält.
ClipWait , Zeitlimit, AufAlleDatenWarten
Lässt man diesen Parameter weg, wird der Befehl unendlich lang warten. Ansonsten kann die maximale Wartezeit in Sekunden angegeben werden (dieser Parameter kann einen Dezimalpunkt enthalten oder ein Ausdruck sein). Die Angabe von 0 ist das gleiche wie, als würde man 0.5 angeben.
Wenn dieser Parameter weggelassen wird oder 0 (false) ist, arbeitet der Befehl selektiver; das heißt, dass der Befehl gezielt auf Text oder Dateien in der Zwischenablage wartet ("Text" bezieht sich auf Daten, die beim Einfügen in den Texteditor tatsächlich Text erzeugen). Wenn dieser Parameter 1 (true) ist (kann ein Ausdruck sein), wartet der Befehl auf Daten beliebiger Art in der Zwischenablage.
Nach Ablauf der Wartezeit wird ErrorLevel auf 1 gesetzt. Ansonsten (also wenn die Zwischenablage Daten enthält) wird ErrorLevel auf 0 gesetzt.
Es ist besser, diesen Befehl zu nutzen, anstatt auf eine selbstgemachte Schleife zurückzugreifen, die überprüft, ob die Zwischenablage leer ist. Der Vorteil dieses Befehls ist, dass er nie die Zwischenablage öffnet, was ihn performanter macht und die Möglichkeit ausschließt, mit anderen Anwendungen in Konflikt zu geraten, die ebenfalls auf die Zwischenablage zugreifen.
Dieser Befehl behandelt alles, was in Text umgewandelt werden kann (z. B. HTML), als Text. Dateien, die man zum Beispiel in einem Explorerfenster via Strg+C kopiert, werden ebenfalls als Text behandelt. Solche Dateien werden jedes Mal, wenn die Clipboard-Variable (%clipboard%) im Skript abgerufen wird, in ihre Dateinamen umgewandelt (mit vollständigem Pfad). Weitere Informationen finden Sie unter Clipboard.
Wenn der letzte Parameter 1 (true) ist, wird der Befehl bereits zufriedengestellt, wenn Daten beliebiger Art in der Zwischenablage erscheinen. Dieser Sachverhalt kann in Verbindung mit ClipboardAll genutzt werden, um textlose Elemente wie z. B. Bilder zu speichern.
Während der Befehl im Wartezustand ist, können neue Threads via Hotkeys, benutzerdefinierte Menüpunkte oder Timer gestartet werden.
Um auf den Bruchteil einer Sekunde zu warten, geben Sie einen Floating-Point-Wert für den ersten Parameter an; zum Beispiel 0.25, um maximal 250 Millisekunden zu warten.
Leert die Zwischenablage, kopiert die aktuelle Auswahl in die Zwischenablage und wartet maximal 2 Sekunden, bis die Zwischenablage Daten enthält. Wenn ClipWait das Zeitlimit überschreitet, wird eine Fehlermeldung angezeigt, ansonsten wird der Inhalt der Zwischenablage angezeigt.
Clipboard := "" ; Leert die Zwischenablage
Send, ^c
ClipWait, 2
if ErrorLevel
{
MsgBox, Der Versuch`, Text in die Zwischenablage zu kopieren`, ist fehlgeschlagen.
return
}
MsgBox, Zwischenablage = %Clipboard%
return