Articles Windows Clipboard Formats by Jochen Arndt

[emailx45]

Windows Clipboard Formats
Jochen Arndt - 07/Mar/2018

Спойлер: Content - 1st part

[SHOWTOGROUPS=4,20]
An overview of clipboard and Drag & Drop object formats.

Introduction
This reference gives you an overview of standard and common clipboard formats with links to the data structures.

Definitions

The following type definitions are used in the below tables:

• ANSI textNull terminated ANSI or multi byte string.
• Unicode textNull terminated Unicode (UTF-16LE) string.
• ANSI / Unicode text listList of null terminated strings followed by a NULL character (double NULL terminated).
• ASCII / ANSI textASCII 7-bit text by definition but ANSI 8-bit text may be supported.
• DWORD (BOOL)DWORD value representing a boolean value (true if not zero).

Links indicate the destination in brackets. For MSDN links in the tables the indication is omitted.

Standard Clipboard Formats

The Для просмотра ссылки Войди или Зарегистрируйся use numeric IDs defined in WinUser.h. All non-standard formats must be registered using a unique format name.

Format Identifier	Data Type	Description
CF_TEXT (1)	ANSI text	Text.
CF_BITMAP (2)	HBITMAP	Handle to a bitmap (GDI object).
CF_METAFILEPICT (3)	Для просмотра ссылки Войди или Зарегистрируйся	Для просмотра ссылки Войди или Зарегистрируйся picture.
CF_SYLK (4)	ANSI text	Microsoft Для просмотра ссылки Войди или Зарегистрируйся.
CF_DIF (5)	ASCII text	Software Arts Для просмотра ссылки Войди или Зарегистрируйся.
CF_TIFF (6)	Для просмотра ссылки Войди или Зарегистрируйся	TIFF image.
CF_OEMTEXT (7)	8-Bit DOS text	Text.
CF_DIB (8)	Для просмотра ссылки Войди или Зарегистрируйся	Structure followed by bitmap bits.
CF_PALETTE (9)	HPALETTE	Handle to a color palette (GDI object).
CF_PENDATA (10)	-	Windows 3.1 pen extension data.
CF_RIFF (11)	Для просмотра ссылки Войди или Зарегистрируйся	Resource Interchange File Format (RIFF) audio.
CF_WAVE (12)	WAVE	WAVE audio.
CF_UNICODETEXT (13)	Unicode text	Text.
CF_ENHMETAFILE (14)	HENHMETAFILE	Для просмотра ссылки Войди или Зарегистрируйся handle.
CF_HDROP (15)	Для просмотра ссылки Войди или Зарегистрируйся	List of file names.
CF_LOCALE (16)	DWORD (Для просмотра ссылки Войди или Зарегистрируйся)	LCID for CF_TEXT to CF_UNICODE conversion.
CF_DIBV5 (17)	Для просмотра ссылки Войди или Зарегистрируйся	Structure followed by bitmap bits
CF_DSPTEXT (0x0081)	ANSI text	Text.
CF_DSPBITMAP (0x0082)	HBITMAP	Handle to a bitmap (GDI object)
CF_DSPMETAFILEPICT (0x0083)	Для просмотра ссылки Войди или Зарегистрируйся	Для просмотра ссылки Войди или Зарегистрируйся picture.
CF_DSPENHMETAFILE (0x008E)	HENHMETAFILE	Для просмотра ссылки Войди или Зарегистрируйся handle.

Shell Clipboard Formats

The Для просмотра ссылки Войди или Зарегистрируйся are used to transfer shell objects via clipboard and Drag & Drop.

For most of them there is a definition for the format name in the header file shlobj.h:

Definition	Format Name
CFSTR_SHELLIDLIST	Shell IDList Array
CFSTR_SHELLIDLISTOFFSET	Shell Object Offsets
CFSTR_NETRESOURCES	Net Resource
CFSTR_FILEDESCRIPTORA	FileGroupDescriptor
CFSTR_FILEDESCRIPTORW	FileGroupDescriptorW
CFSTR_FILECONTENTS	FileContents
CFSTR_FILENAMEA	FileName
CFSTR_FILENAMEW	FileNameW
CFSTR_PRINTERGROUP	PrinterFriendlyName
CFSTR_FILENAMEMAPA	FileNameMap
CFSTR_FILENAMEMAPW	FileNameMapW
CFSTR_SHELLURL	UniformResourceLocator
CFSTR_INETURLA	UniformResourceLocator
CFSTR_INETURLW	UniformResourceLocatorW
CFSTR_PREFERREDDROPEFFECT	Preferred DropEffect
CFSTR_PERFORMEDDROPEFFECT	Performed DropEffect
CFSTR_PASTESUCCEEDED	Paste Succeeded
CFSTR_INDRAGLOOP	InShellDragLoop
CFSTR_DRAGCONTEXT	DragContext
CFSTR_MOUNTEDVOLUME	MountedVolume
CFSTR_PERSISTEDDATAOBJECT	PersistedDataObject
CFSTR_TARGETCLSID	TargetCLSID
CFSTR_LOGICALPERFORMEDDROPEFFECT	Logical Performed DropEffect
CFSTR_AUTOPLAY_SHELLIDLISTS	Autoplay Enumerated IDList Array
CFSTR_UNTRUSTEDDRAGDROP	UntrustedDragDrop
CFSTR_FILE_ATTRIBUTES_ARRAY	File Attributes Array
CFSTR_INVOKECOMMAND_DROPPARAM	InvokeCommand DropParam
CFSTR_SHELLDROPHANDLER	DropHandlerCLSID
CFSTR_DROPDESCRIPTION	DropDescription

Format Name	Data Type	Description
AsyncFlag	DWORD (BOOL)	Perform insert/paste operation in the background. Used by Explorer to avoid blocking the current instance.
Для просмотра ссылки Войди или Зарегистрируйся	Binary	File content.
Для просмотра ссылки Войди или Зарегистрируйся	Для просмотра ссылки Войди или Зарегистрируйся	Array of Для просмотра ссылки Войди или Зарегистрируйсяs.
Для просмотра ссылки Войди или Зарегистрируйся	Для просмотра ссылки Войди или Зарегистрируйся	Array of Для просмотра ссылки Войди или Зарегистрируйсяs.
Для просмотра ссылки Войди или Зарегистрируйся	ANSI text	Single file name in short (8.3) format.
Для просмотра ссылки Войди или Зарегистрируйся	Unicode text	Single file name.
Для просмотра ссылки Войди или Зарегистрируйся	ANSI text list	List of file names when renaming.
Для просмотра ссылки Войди или Зарегистрируйся	Unicode text list	List of file names when renaming.
Для просмотра ссылки Войди или Зарегистрируйся	Unicode text	Path for mounted volume.
Для просмотра ссылки Войди или Зарегистрируйся	Для просмотра ссылки Войди или Зарегистрируйся	Array of PIDL (pointer to Для просмотра ссылки Войди или Зарегистрируйся) offsets.
Autoplay Enumerated IDList Array	Для просмотра ссылки Войди или Зарегистрируйся	Array of PIDL (pointer to Для просмотра ссылки Войди или Зарегистрируйся) offsets.
Для просмотра ссылки Войди или Зарегистрируйся	Для просмотра ссылки Войди или Зарегистрируйся[]	Array of points.
File Attributes Array	Для просмотра ссылки Войди или Зарегистрируйся	Array of file attributes.
Для просмотра ссылки Войди или Зарегистрируйся	Для просмотра ссылки Войди или Зарегистрируйся	Array of Для просмотра ссылки Войди или Зарегистрируйся structures.
Для просмотра ссылки Войди или Зарегистрируйся	Для просмотра ссылки Войди или Зарегистрируйся	List of printer names.
Для просмотра ссылки Войди или Зарегистрируйся	ANSI text	URL
Для просмотра ссылки Войди или Зарегистрируйся	Unicode text	URL

[/SHOWTOGROUPS]

 

[emailx45]

Спойлер: Content - 2nd part

[SHOWTOGROUPS=4,20]
Drag & Drop Related Formats

These formats are used with Drag & Drop. Most of them are not documented.

Format Name	Data Type	Description
ComputedImage	DWORD	?
DisableDragText	DWORD (BOOL)	?
DragContext	IStream	Used internally by the Windows drag/drop helpers.
DragImageBits	Для просмотра ссылки Войди или Зарегистрируйся	Drag image bitmap.
DragSourceHelperFlags	DWORD	Value passed to Для просмотра ссылки Войди или Зарегистрируйся.
Для просмотра ссылки Войди или Зарегистрируйся	DWORD (HWND)	The window handle of the drag image window.
DropDescription	Для просмотра ссылки Войди или Зарегистрируйся	Aero drag cursor type and text.
DropHandlerCLSID	CLSID Для просмотра ссылки Войди или Зарегистрируйся	CLSID GUID of the drop handler.
Для просмотра ссылки Войди или Зарегистрируйся	DWORD (BOOL)	Nonzero when within a drag-and-drop loop.
InvokeCommand DropParam	Unicode text	?
IsComputingImage	DWORD (BOOL)	?
IsShowingLayered	DWORD (BOOL)	Nonzero when a drop target shows the drag image.
IsShowingText	DWORD (BOOL)	Nonzero when a drop target requests update of Aero cursor.
Для просмотра ссылки Войди или Зарегистрируйся	DWORD (Для просмотра ссылки Войди или Зарегистрируйся	Logically performed drop effect with optimized moves.
Для просмотра ссылки Войди или Зарегистрируйся	DWORD (Для просмотра ссылки Войди или Зарегистрируйся)	Set by target when delete-on-paste operation succeeded.
Для просмотра ссылки Войди или Зарегистрируйся	DWORD (Для просмотра ссылки Войди или Зарегистрируйся)	Performed drop effect set by the target.
Для просмотра ссылки Войди или Зарегистрируйся	DWORD (Для просмотра ссылки Войди или Зарегистрируйся)	Preferred drop effect set by source. Used also with clipboard.
Для просмотра ссылки Войди или Зарегистрируйся	CLSID Для просмотра ссылки Войди или Зарегистрируйся	CLSID GUID of the drop target.
Для просмотра ссылки Войди или Зарегистрируйся	DWORD	Для просмотра ссылки Войди или Зарегистрируйся.
UsingDefaultDragImage	DWORD (BOOL)	Nonzero when the drag image is a system default image.

OLE Formats

Format Name	Data Type	Description
Link	ANSI text list	OLE 1.0 link.
Native	Binary	OLE 1.0 data.
ObjectLink	ANSI text list	OLE 1.0 link.
OwnerLink	ANSI text list	OLE 1.0 link.
Data Object	Binary	OLE 2.0 data.
Embedded Object	Binary	OLE 2.0 data.
Object Descriptor	Для просмотра ссылки Войди или Зарегистрируйся	OLE 2.0 User interface information.
Link Source Descriptor	Для просмотра ссылки Войди или Зарегистрируйся	OLE 2.0 User interface information.
Link Source	Для просмотра ссылки Войди или Зарегистрируйся	OLE 2.0. Followed by document class ID.
Hyperlink	Для просмотра ссылки Войди или Зарегистрируйся	Methods to enable a hyperlink to navigate to its target.

Common Application Clipboard Formats

Many applications use the file extension or the Для просмотра ссылки Войди или Зарегистрируйся as format name and pass data using the corresponding file format.

The format names are case-insensitive but is is common practice to use all lower case for MIME types, all upper case for file extensions and Pascal case (upper case for first letter of each word) for descriptive names.

Clipboard and drop target applications that should be able to receive such formats should register all commonly used format name variations.

The header file UrlMon.h contains some definitions for MIME types (see Для просмотра ссылки Войди или Зарегистрируйся).

Common Text Formats

Format Name	Data Type	Description
text/plain	ASCII / ANSI text	See also CF_TEXT.
Для просмотра ссылки Войди или Зарегистрируйся	UTF-8 text	Microsoft specific HTML clipboard format.
text/html	Text	Для просмотра ссылки Войди или Зарегистрируйся file content. The encoding is defined by BOM and HTML headers.
HTML (Hyper Text Markup Language)	Text	See text/html.
text/csv	ASCII / ANSI text	Для просмотра ссылки Войди или Зарегистрируйся file content.
CSV	ASCII / ANSI text	See text/csv.
text/richtext	ASCII / ANSI text	Для просмотра ссылки Войди или Зарегистрируйся
Rich Text Format	ASCII / ANSI text	See above.
Rich Text Format Without Objects	ASCII / ANSI text	See above.
RichEdit Text and Objects	ASCII / ANSI text	See above.
RTF As Text	ASCII / ANSI text	See above.
text/uri-list	ASCII text	Для просмотра ссылки Войди или Зарегистрируйся.

Common Image Formats

Format Name	Data Type	Description
image/bmp	Для просмотра ссылки Войди или Зарегистрируйся	File header followed by info header (see CF_DIB and CF_DIBV5) and bitmap data.
BMP	Для просмотра ссылки Войди или Зарегистрируйся	See image/bmp.
image/gif	Binary	Для просмотра ссылки Войди или Зарегистрируйся file content.
GIF	Binary	See image/gif.
image/jpeg	Binary	Для просмотра ссылки Войди или Зарегистрируйся file content.
JPEG	Binary	See image/jpeg.
JPG	Binary	See image/jpeg.
image/png	Binary	Для просмотра ссылки Войди или Зарегистрируйся file content.
PNG	Binary	See image/png.
image/tiff	Binary	Для просмотра ссылки Войди или Зарегистрируйся file content. See also CF_TIFF.

Points of Interest
My article Для просмотра ссылки Войди или Зарегистрируйся contains a demo application that can be used to show the objects actually on the clipboard (clipboard viewer) and the drag objects when dropping on an info list.

References

• Для просмотра ссылки Войди или Зарегистрируйся
• Для просмотра ссылки Войди или Зарегистрируйся
• Для просмотра ссылки Войди или Зарегистрируйся
• Для просмотра ссылки Войди или Зарегистрируйся
• Для просмотра ссылки Войди или Зарегистрируйся
• Для просмотра ссылки Войди или Зарегистрируйся
• Для просмотра ссылки Войди или Зарегистрируйся
• Для просмотра ссылки Войди или Зарегистрируйся
• Для просмотра ссылки Войди или Зарегистрируйся

History

• 2016-04-08 Initial version.
• 2016-04-14 Minor text changings, added links to GUID and URL moniker formats.
• 2016-04-18 Splitted and re-arranged tables, added some OLE formats, added text/richtext, corrected enhanced meta file type.
• 2016-06-21 Added formats text/uri-list, image/bmp, BMP; added link to W3C clipboard API
• 2017-06-22 Added AsyncFlag format and that Preferred DropEffect also used with clipboard.
• 2018-03-08 Fixed wrong FileContents description.

License
This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL).


[/SHOWTOGROUPS]