↑  ←  Описание функции


_ClipBoard_Empty

Очищает буфер обмена и освобождает дескрипторы данных в буфере обмена

#include <Clipboard.au3>
_ClipBoard_Empty()

Возвращаемое значение

Успех:Возвращает True
Ошибка:Возвращает False

Примечания

Перед вызовом этой функции, вы должны открыть буфер обмена используя функцию _ClipBoard_Open. Если вы указали NULL в качестве дескриптора окна при открытии буфера обмена, то эта функция выполнится успешно, но установит в качестве владельца буфера обмена значение NULL.
Обратите внимание, что при этом _ClipBoard_SetData обречён на провал.

См. также

_ClipBoard_Open, _ClipBoard_SetData, _ClipBoard_GetOwner, _ClipBoard_SetDataEx

См. также

Искать EmptyClipboard в библиотеке MSDN

Пример

#include <GUIConstantsEx.au3>
#include <Clipboard.au3>
#include <WinAPI.au3>
#include <WindowsConstants.au3>

Global $iMemo

_Main()

Func _Main()
    Local $hGUI

    ; Создаёт GUI
    $hGUI = GUICreate("Clipboard", 600, 400)
    $iMemo = GUICtrlCreateEdit("", 2, 2, 596, 396, $WS_VSCROLL)
    GUICtrlSetFont($iMemo, 9, 400, 0, "Courier New")
    GUISetState()

    ; Открывает буфер обмена
    If _ClipBoard_Open($hGUI) Then

        ShowData($hGUI)

        ; Очищает буфер обмена
        If Not _ClipBoard_Empty() Then _WinAPI_ShowError("Ошибка функции _ClipBoard_Empty")

        ; Закрывает буфер обмена
        _ClipBoard_Close()
    Else
        _WinAPI_ShowError("Ошибка функции _ClipBoard_Open")
    EndIf

    ; Цикл выполняется, пока окно не будет закрыто
    Do
    Until GUIGetMsg() = $GUI_EVENT_CLOSE

EndFunc   ;==>_Main

; Показывает статистику буфера обмена
Func ShowData($hGUI)
    MemoWrite("Дескриптор GUI ........: " & $hGUI)
    MemoWrite("Владелец буфера .......: " & _ClipBoard_GetOwner())
    MemoWrite("Окно открывшее буфер ..: " & _ClipBoard_GetOpenWindow())
    MemoWrite("Clipboard sequence ....: " & _ClipBoard_GetSequenceNumber())
    MemoWrite()
EndFunc   ;==>ShowData

; Записывает строку в элемент для заметок
Func MemoWrite($sMessage = "")
    GUICtrlSetData($iMemo, $sMessage & @CRLF, 1)
EndFunc   ;==>MemoWrite