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 |
|
See also
-
Reference
-
Conceptual