2.1.25.9 EmptyClipboard

Description

This function empties the clipboard and frees handles to data in the clipboard.

Syntax

BOOL EmptyClipboard( )

Parameters

Return

Returns TRUE for success.

Examples

EX1

void empty_clipboard()
{
    if(OpenClipboard(NULL))
    {
        EmptyClipboard();
        CloseClipboard();
    }
}

Remark

This function empties the clipboard and frees handles to data in the clipboard.

The function then assigns ownership of the clipboard to the window that currently has the clipboard open.

Before calling EmptyClipboard, an application must open the clipboard by using the OpenClipboard function.

If the application specifies a NULL window handle when opening the clipboard, EmptyClipboard succeeds but sets the clipboard owner to NULL.

See Also

OpenClipboard, SetClipboardData, CloseClipboard

Header to Include

origin.h

Reference