ClipWait

Wartet, bis die Zwischenablage Daten enthält.

Boolesch := ClipWait(Zeitlimit, WartenAuf)

Parameter

Zeitlimit

Typ: Integer oder Float

Wenn weggelassen, wird die Funktion 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.

WartenAuf

Typ: Integer

Wenn 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: Die Funktion 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: Die Funktion wartet darauf, dass Daten beliebiger Art in der Zwischenablage erscheinen.

Andere Werte sind für zukünftige Zwecke reserviert.

Rückgabewert

Typ: Integer (boolesch)

Diese Funktion gibt 0 (false) zurück, wenn die Funktion das Zeitlimit überschritten hat, andernfalls 1 (true) (also wenn die Zwischenablage Daten enthält).

Bemerkungen

Es ist besser, diese Funktion zu verwenden, als mit einer eigenen Schleife zu prüfen, ob die Zwischenablage leer ist. Die Funktion 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.

Diese Funktion 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 zugegriffen wird. Weitere Informationen finden Sie unter A_Clipboard.

Wenn der letzte Parameter 1 ist, wird die Funktion 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 die Funktion wartet, können neue Threads via Hotkeys, benutzerdefinierte Menüpunkte oder Timer gestartet werden.

A_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.

A_Clipboard := "" ; Leert die Zwischenablage
Send "^c"
if !ClipWait(2)
{
    MsgBox "Der Versuch, Text in die Zwischenablage zu kopieren, ist fehlgeschlagen."
    return
}
MsgBox "Zwischenablage = " A_Clipboard
return