Bewerken

Delen via


WM_RENDERALLFORMATS message

Sent to the clipboard owner before it is destroyed, if the clipboard owner has delayed rendering one or more clipboard formats. For the content of the clipboard to remain available to other applications, the clipboard owner must render data in all the formats it is capable of generating, and place the data on the clipboard by calling the SetClipboardData function.

A window receives this message through its WindowProc function.

#define WM_RENDERALLFORMATS             0x0306

Parameters

wParam

This parameter is not used and must be zero.

lParam

This parameter is not used and must be zero.

Return value

If an application processes this message, it should return zero.

Remarks

When responding to a WM_RENDERALLFORMATS message, the application must call the OpenClipboard function and then check that it is still the clipboard owner by calling the GetClipboardOwner function before calling SetClipboardData.

The application needs to check that it is still the clipboard owner after opening the clipboard because after it receives the WM_RENDERALLFORMATS message, but before it opens the clipboard, another application may have opened and taken ownership of the clipboard, and that application's data should not be overwritten.

In most cases, the application should not call the EmptyClipboard function before calling SetClipboardData, since doing so will erase the clipboard formats that the application has already rendered.

When the application returns, the system removes any unrendered formats from the list of available clipboard formats. For information about delayed rendering, see Delayed Rendering.

Requirements

Requirement Value
Minimum supported client
Windows 2000 Professional [desktop apps only]
Minimum supported server
Windows 2000 Server [desktop apps only]
Header
Winuser.h (include Windows.h)

See also

Reference

EmptyClipboard

OpenClipboard

SetClipboardData

WM_RENDERFORMAT

Conceptual

Clipboard