windows_programming_notes.nbk: Home | Index | Next Page: WM_CANCELJOURNAL | Previous Page: WM_ACTIVATEAPP

 WM_ASKCBFORMATNAME

The WM_ASKCBFORMATNAME message is sent to the clipboard owner by a clipboard viewer window to request the name of a CF_OWNERDISPLAY clipboard format.

A window receives this message through its WindowProc function.

    LRESULT CALLBACK WindowProc(
      HWND hwnd,       // handle to window
      UINT uMsg,       // WM_ASKCBFORMATNAME
      WPARAM wParam,   // size of buffer
      LPARAM lParam    // format name (LPTSTR)
    );

Parameters

• wParam
Specifies the size, in characters, of the buffer pointed to by the lParam parameter.
• lParam
Pointer to the buffer that is to receive the clipboard format name.

Return Values

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

Remarks

In response to this message, the clipboard owner should copy the name of the owner-display format to the specified buffer, not exceeding the buffer size specified by the wParam parameter.

A clipboard viewer window sends this message to the clipboard owner to determine the name of the CF_OWNERDISPLAY format — for example, to initialize a menu listing available formats.

Requirements

• Windows NT/2000 or later: Requires Windows NT 3.1 or later.
• Windows 95/98/Me: Requires Windows 95 or later.
• Header: Declared in Winuser.h; include Windows.h.

windows_programming_notes.nbk: Home | Index | Next Page: WM_CANCELJOURNAL | Previous Page: WM_ACTIVATEAPP

Notebook exported on Monday, 7 July 2008, 18:56:50 PM Eastern Daylight Time