Funktionsreferenz

_ClipBoard_Empty

Leert die Zwischenablage und gibt die Verweise (Handles) auf die Daten in der Zwischenablage frei.

#Include <Clipboard.au3>
_ClipBoard_Empty()

 

Parameter

Keine

 

Rückgabewert

Erfolg: True
Fehler: False

 

Bemerkungen

Vor dem Aufruf dieser Funktion muss die Zwischenablage mit der Funktion _ClipBoard_Open geöffnet worden sein. Wenn beim Öffnen der Zwischenablage ein NULL Fensterverweis angegeben wurde, wird diese Funktion erfolgreich sein, setzt aber den Besitzer der Zwischenablage auf NULL.
Es ist zu beachten, das dadurch _ClipBoard_SetData fehlschlagen wird.

 

Verwandte Funktionen

_ClipBoard_Open, _ClipBoard_SetData, _ClipBoard_GetOwner, _ClipBoard_SetDataEx

 

Siehe auch

Suche in der MSDN Bibliothek nach EmptyClipboard

 

Beispiel


#include <GuiConstantsEx.au3>
#include <ClipBoard.au3>
#include <WinAPI.au3>
#include <WindowsConstants.au3>

Opt('MustDeclareVars', 1)

Global $iMemo

_Main()

Func _Main()
    Local $hGUI

    ; Erstellt eine GUI
    $hGUI = GUICreate("Clipboard", 600, 400)
    $iMemo = GUICtrlCreateEdit("", 2, 2, 596, 396, $WS_VSCROLL)
    GUICtrlSetFont($iMemo, 9, 400, 0, "Courier New")
    GUISetState()

    ; Öffnet die Zwischenablage
    If Not _ClipBoard_Open($hGUI) Then _WinAPI_ShowError("_ClipBoard_Open fehlgeschlagen")

    ShowData($hGUI)

    ; Leert die Zwischenablage
    If Not _ClipBoard_Empty() Then _WinAPI_ShowError("_ClipBoard_Empty fehlgeschlagen")

    ; Schließt die Zwischenablage
    _ClipBoard_Close()

    ; Die Schleife wiederholt sich, bis der Benutzer die Beenden-Aktion der GUI auslöst
    Do
    Until GUIGetMsg() = $GUI_EVENT_CLOSE

EndFunc   ;==>_Main

; Zeigt die Statistik der Zwischenablage
Func ShowData($hGUI)
    MemoWrite("GUI Handle ................: " & $hGUI)
    MemoWrite("Clipboard Besitzer ........: " & _ClipBoard_GetOwner())
    MemoWrite("Für Clipboard geöffnetes Fenster .: " & _ClipBoard_GetOpenWindow())
    MemoWrite("Clipboard Sequenz .........: " & _ClipBoard_GetSequenceNumber())
    MemoWrite()
EndFunc   ;==>ShowData

; Schreibt eine Nachricht in das Memo
Func MemoWrite($sMessage = "")
    GUICtrlSetData($iMemo, $sMessage & @CRLF, 1)
EndFunc   ;==>MemoWrite