Clipboard Owner

The clipboard owner is any application window connected to the clipboard data. Following are situations in which an application would call WinSetClipbrdOwner to become the clipboard owner:

The application calling WinSetClipbrdData passes a NULL pointer or handle to the clipboard, indicating that the application renders the data in a particular format on request. As a result, the system sends rendering requests to the current clipboard owner.
The application calling WinSetClipbrdData passes data with the CFI_OWNERFREE attribute, indicating that the application frees memory for data when the clipboard is emptied. As a result, the system sends owner-free requests to the current clipboard owner.
The application calling WinSetClipbrdData passes data with the CFI_OWNERDISPLAY attribute, indicating that the owner application draws the data in the clipboard viewer. As a result, the clipboard viewer sends drawing-related requests to the current clipboard owner.

The window specified in the call to the WinSetClipbrdOwner function responds to the following messages:

кФФФФФФФФФФФФФФФФФФФФТФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФПГMessage             ГDescription                             Г
УФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГWM_RENDERFMT        ГSent by the system to the clipboard     Г
Г                    Гowner when a particular format with     Г
Г                    Гdelayed rendering must be rendered.  TheГ
Г                    Гreceiver must render the data in the    Г
Г                    Гspecified format and pass it to the     Г
Г                    Гclipboard by calling the                Г
Г                    ГWinSetClipbrdData function.             Г
УФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГWM_RENDERALLFMTS    ГSent by the system to the clipboard     Г
Г                    Гowner just before the owner application Г
Г                    Гterminates.  The receiver must render   Г
Г                    Гthe clipboard data in all formats on theГ
Г                    Гclipboard with delayed rendering.  It   Г
Г                    Гmust pass the data for each format to   Г
Г                    Гthe clipboard by calling the            Г
Г                    ГWinSetClipbrdData function.             Г
УФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГWM_DESTROYCLIPBOARD ГSent by the system to the clipboard     Г
Г                    Гowner when the clipboard is cleared by  Г
Г                    Гanother application calling the         Г
Г                    ГWinEmptyClipbrd function.  The receiver Г
Г                    Гmust free the memory occupied by any    Г
Г                    Гclipboard formats using the             Г
Г                    ГCFI_OWNERFREE attribute.                Г
УФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГWM_SIZECLIPBOARD    ГSent by the clipboard viewer to the     Г
Г                    Гclipboard owner when the clipboard      Г
Г                    Гcontains the data handle with the       Г
Г                    ГCFI_OWNERDISPLAY attribute and when the Г
Г                    Гclipboard-viewer changes size.  When theГ
Г                    Гclipboard viewer is being destroyed or  Г
Г                    Гreduced to an icon, this message is sentГ
Г                    Гwith the coordinates of the opposite    Г
Г                    Гcorners set to (0,0), which permits the Г
Г                    Гowner to free its display resources.    Г
УФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГWM_VSCROLLCLIPBOARD ГSent by the clipboard viewer to the     Г
Г                    Гclipboard owner when the clipboard      Г
Г                    Гcontains data with the CFI_OWNERDISPLAY Г
Г                    Гattribute and when an event occurs in   Г
Г                    Гthe clipboard-viewer scroll bars.  The  Г
Г                    Гreceiver must respond to this message byГ
Г                    Гscrolling the image, invalidating the   Г
Г                    Гappropriate area of the clipboard       Г
Г                    Гviewer, and updating the slider         Г
Г                    Гposition.                               Г
УФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГWM_HSCROLLCLIPBOARD ГSent by the clipboard viewer to the     Г
Г                    Гclipboard owner when the clipboard      Г
Г                    Гcontains data with the CFI_OWNERDISPLAY Г
Г                    Гattribute and when an event occurs in   Г
Г                    Гthe scroll bars of the clipboard viewer.Г
Г                    ГThe receiver must respond to this       Г
Г                    Гmessage by scrolling the image,         Г
Г                    Гinvalidating the appropriate area of theГ
Г                    Гclipboard viewer, and updating the      Г
Г                    Гslider position.                        Г
УФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГWM_PAINTCLIPBOARD   ГSent by the clipboard viewer to the     Г
Г                    Гclipboard owner when the clipboard      Г
Г                    Гcontains data with the CFI_OWNERDISPLAY Г
Г                    Гattribute and when the clipboard-viewer Г
Г                    Гclient area needs repainting.  The      Г
Г                    Гreceiver must respond to this message byГ
Г                    Гpainting the requested format (by       Г
Г                    Гcalling WinGetPS for the window handle  Г
Г                    Гof the clipboard viewer).               Г
РФФФФФФФФФФФФФФФФФФФФСФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФй

An application automatically loses ownership of the clipboard when the clipboard data is cleared by the WinEmptyClipbrd function. Ownership is necessary only when data is present on the clipboard. Typically, an application loses ownership when another application places data on the clipboard.

[Back] [Next]