ClipWait

Wartet, bis die Zwischenablage Daten enthält.

ClipWait , Zeitlimit, WartenAuf

Parameter

Zeitlimit

Wenn leer oder weggelassen, wird der Befehl unendlich lang warten. Andernfalls geben Sie die maximale Wartezeit in Sekunden an. Um auf einen Bruchteil einer Sekunde zu warten, geben Sie eine Floating-Point-Zahl an, z.B. 0.25, um maximal 250 Millisekunden zu warten. Die Angabe von 0 entspricht der Angabe von 0.5. Dieser Parameter kann ein Ausdruck sein.

WartenAuf

Wenn leer oder weggelassen, wird standardmäßig 0 verwendet (nur auf Text oder Dateien warten). Andernfalls geben Sie eine der folgenden Zahlen an, um zu bestimmen, worauf gewartet werden soll:

0: Der Befehl ist selektiver und wartet gezielt auf das Erscheinen von Text oder Dateien ("Text" schließt alles ein, was Text erzeugen würde, wenn Sie es in Notepad einfügen).

1: Der Befehl wartet darauf, dass Daten beliebiger Art in der Zwischenablage erscheinen.

Dieser Parameter kann ein Ausdruck sein, auch einer, der nach der Auswertung 1, 0 oder eine leere Zeichenkette ergibt.

ErrorLevel

Nach Ablauf der Wartezeit wird ErrorLevel auf 1 gesetzt. Andernfalls (also wenn die Zwischenablage Daten enthält) wird ErrorLevel auf 0 gesetzt.

Bemerkungen

Es ist besser, diesen Befehl zu verwenden, als mit einer eigenen Schleife zu prüfen, ob die Zwischenablage leer ist. Der Befehl hat den Vorteil, dass die Zwischenablage nie geöffnet wird, was die Performanz verbessert und das Risiko von Konflikten mit anderen Anwendungen, die ebenfalls auf die Zwischenablage zugreifen, verringert.

Dieser Befehl behandelt alles, was in Text umgewandelt werden kann (z.B. HTML), als Text. Dateien, die z.B. mit Strg+C innerhalb eines Explorer-Fensters kopiert werden, werden ebenfalls als Text behandelt. Solche Dateien werden automatisch in ihre Dateinamen (mit vollständigem Pfad) umgewandelt, wann immer im Skript auf die Clipboard-Variable (%clipboard%) zugegriffen wird. Weitere Informationen finden Sie unter Clipboard.

Wenn der letzte Parameter 1 ist, wird der Befehl bereits zufriedengestellt, wenn irgendetwas in der Zwischenablage erscheint. Das ist in Verbindung mit ClipboardAll nützlich, um textlose Elemente wie z.B. Bilder zu speichern.

Während der Befehl wartet, können neue Threads via Hotkeys, benutzerdefinierte Menüpunkte oder Timer gestartet werden.

Clipboard, WinWait, KeyWait

Beispiele

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, andernfalls 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