type[, data] = GetClipboard()
GetClipboard() gibt zwei Werte zurück: Der erste Rückgabewert
type gibt das Format der Daten in der Zwischenablage an und
der zweite data enthält dann die formatspezifischen Daten.
Derzeit unterstützt Hollywood zwei verschiedene Arten von Daten
in der Zwischenablage: Text und Bilder.
Wenn momentan Text in der Zwischenablage gespeichert ist, gibt
GetClipboard() #CLIPBOARD_TEXT in type zurück und eine Zeichenfolge
enthält den Text in der Zwischenablage als zweiten Rückgabewert data.
Wenn zur Zeit ein Bild in der Zwischenablage gespeichert ist,
gibt GetClipboard() #CLIPBOARD_IMAGE in type zurück und der
zweite Rückgabewert data wird ein Pinsel sein, welcher das
Bild aus der Zwischenablage enthält. Sobald Sie die Arbeit
mit diesem Pinsel erledigt haben, sollten Sie FreeBrush()
für diesen Pinsel aufrufen, um die Speicherzuweisung frei zu geben.
Wenn weder Text noch ein Bild in der Zwischenablage ist, gibt
GetClipboard() #CLIPBOARD_UNKNOWN zurück. Der zweite Rückgabewert
wird in diesem Fall nicht benutzt. Wenn die Zwischenablage
leer ist, dann wird #CLIPBOARD_EMPTY zurückgegeben.
Um benachrichtigt zu werden, wenn sich der Inhalt der Zwischenablage
ändert, können Sie den ClipboardChange Ereignis-Handler unter
Verwendung von InstallEventHandler() installieren.
Wenn Sie nur das Format der Daten. die sich gegenwärtig in
der Zwischenablage sind, herausfinden wollen, ohne tatsächlich
eine Kopie dieser Daten zu empfangen, können Sie den Befehl
PeekClipboard() benutzen. Aber bedenken Sie, dass die Daten
in der Zwischenablage sich jederzeit ändern können. Es gibt
also keine Garantie, dass die Daten in der Zwischenablage beim
Aufruf von PeekClipboard() noch vorhanden
sind, wenn Sie später/anschließend GetClipboard() aufrufen.
#CLIPBOARD_EMPTY
oder #CLIPBOARD_UNKNOWN#CLIPBOARD_EMPTY
oder #CLIPBOARD_UNKNOWN ist, dann enthält dieser Rückgabewert die
tatsächlichen Daten, die aus der Zwischenablage abgerufen werden; Die
hier zurückgegebenen Daten hängen von dem Format ab (siehe oben).
SetClipboard(#CLIPBOARD_TEXT, "Hello clipboard!")
type, data = GetClipboard()
If type = #CLIPBOARD_TEXT
NPrint(data)
Else
NPrint("No text on the clipboard!")
EndIf
Der obige Code setzt den Text "Hello clipboard!" in die Zwischenablage
und ist dann der aktuelle Inhalt, der aus der Zwischenablage
abgerufen werden kann. Wenn sich kein anderes Programm mit
der Zwischenablage zwischen SetClipboard() und GetClipboard()
vermischt, sollte dieser Code "Hello clipboard!" auf dem Bildschirm erscheinen.