Export (0) Print
Expand All
4 out of 6 rated this helpful - Rate this topic

RegisterClipboardFormat function

Registers a new clipboard format. This format can then be used as a valid clipboard format.

Syntax


UINT WINAPI RegisterClipboardFormat(
  _In_  LPCTSTR lpszFormat
);

Parameters

lpszFormat [in]

Type: LPCTSTR

The name of the new format.

Return value

Type: UINT

If the function succeeds, the return value identifies the registered clipboard format.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

If a registered format with the specified name already exists, a new format is not registered and the return value identifies the existing format. This enables more than one application to copy and paste data using the same registered clipboard format. Note that the format name comparison is case-insensitive.

Registered clipboard formats are identified by values in the range 0xC000 through 0xFFFF.

When registered clipboard formats are placed on or retrieved from the clipboard, they must be in the form of an HGLOBAL value.

Examples

For an example, see Registering a Clipboard Format.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Winuser.h (include Windows.h)

Library

User32.lib

DLL

User32.dll

Unicode and ANSI names

RegisterClipboardFormatW (Unicode) and RegisterClipboardFormatA (ANSI)

See also

Reference
CountClipboardFormats
EnumClipboardFormats
GetClipboardFormatName
Conceptual
Clipboard

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.