Navigation

  • index
  • next |
  • previous |
  • Sculptor Reference Guide 6.3.10 documentation »
  • Standard include files »
  • sculptor.h »
  • Drag and drop and clipboard related definitions in sculptor.h

Drag and drop and clipboard related definitions in sculptor.h¶

The following values related to drag and drop operations are defined in <sculptor.h>:


  1. Clipboard formats. (Prefix CF_.) Used with drag and drop/clipboard functions. These are standard MSDN clipboard formats. Refer to the MSDN documentation for further information.


CF_TEXT

Text format. Each line ends with a carriage return/linefeed (CR-LF) combination. A null character signals the end of the data. Use this format for ANSI text.

CF_BITMAP

A handle to a bitmap (HBITMAP).

CF_METAFILEPICT

Handle to a metafile picture format as defined by the METAFILEPICT structure. When passing a CF_METAFILEPICT handle by means of Dynamic Data Exchange (DDE), the application responsible for deleting hMem should also free the metafile referred to by the CF_METAFILEPICT handle.

CF_SYLK

Microsoft Symbolic Link (SYLK) format.

CF_DIF

Software Arts’ Data Interchange Format.

CF_TIFF

Tagged-image file format.

CF_OEMTEXT

Text format containing characters in the OEM character set. Each line ends with a carriage return/linefeed (CR-LF) combination. A null character signals the end of the data.

CF_DIB

A memory object containing a BITMAPINFO structure followed by the bitmap bits.

CF_PALETTE

Handle to a colour palette. Whenever an application places data in the clipboard that depends on or assumes a colour palette, it should place the palette on the clipboard as well. If the clipboard contains data in the CF_PALETTE (logical colour palette) format, the application should use the SelectPalette and RealizePalette functions to realise (compare) any other data in the clipboard against that logical palette. When displaying clipboard data, the clipboard always uses as its current palette any object on the clipboard that is in the CF_PALETTE format.

CF_PENDATA

Data for the pen extensions to the Microsoft Windows for Pen Computing.

CF_RIFF

Represents audio data more complex than can be represented in a CF_WAVE standard wave format.

CF_WAVE

Represents audio data in one of the standard wave formats, such as 11 kHz or 22 kHz Pulse Code Modulation (PCM).

CF_UNICODETEXT

Windows NT/2000/XP: Unicode text format. Each line ends with a carriage return/linefeed (CR-LF) combination. A null character signals the end of the data.

CF_ENHMETAFILE

A handle to an enhanced metafile (HENHMETAFILE).

CF_HDROP

A handle to type HDROP that identifies a list of files. An application can retrieve information about the files by passing the handle to the DragQueryFile functions.

CF_LOCALE

The data is a handle to the locale identifier associated with text in the clipboard. When you close the clipboard, if it contains CF_TEXT data but no CF_LOCALE data, the system automatically sets the CF_LOCALE format to the current input language. You can use the CF_LOCALE format to associate a different locale with the clipboard text. An application that pastes text from the clipboard can retrieve this format to determine which character set was used to generate the text. Note that the clipboard does not support plain text in multiple character sets. To achieve this, use a formatted text data type such as Rich Text Format (RTF) instead. Windows NT/2000/XP: The system uses the code page associated with CF_LOCALE to implicitly convert from CF_TEXT to CF_UNICODETEXT. Therefore, the correct code page table is used for the conversion.

CF_MAX

CF_OWNERDISPLAY

Owner-display format. The clipboard owner must display and update the clipboard viewer window, and receive the WM_ASKCBFORMATNAME, WM_HSCROLLCLIPBOARD, WM_PAINTCLIPBOARD, WM_SIZECLIPBOARD, and WM_VSCROLLCLIPBOARD messages. The hMem parameter must be NULL.

CF_DSPTEXT

Text display format associated with a private format. The hMem parameter must be a handle to data that can be displayed in text format in lieu of the privately formatted data.

CF_DSPBITMAP

Bitmap display format associated with a private format. The hMem parameter must be a handle to data that can be displayed in bitmap format in lieu of the privately formatted data.

CF_DSPMETAFILEPICT

Metafile-picture display format associated with a private format. The hMem parameter must be a handle to data that can be displayed in metafile-picture format in lieu of the privately formatted data.

CF_DSPENHMETAFILE

Enhanced metafile display format associated with a private format. The hMem parameter must be a handle to data that can be displayed in enhanced metafile format in lieu of the privately formatted data.

CF_PRIVATEFIRST -
CF_PRIVATELAST

Range of integer values for private clipboard formats. Handles associated with private clipboard formats are not freed automatically; the clipboard owner must free such handles, typically in response to the WM_DESTROYCLIPBOARD message.

CF_GDIOBJFIRST -
CF_GDIOBJLAST

Range of integer values for application-defined Microsoft Windows Graphics Device Interface (GDI) object clipboard formats. Handles associated with clipboard formats in this range are not automatically deleted using the GlobalFree function when the clipboard is emptied. Also, when using values in this range, the hMem parameter is not a handle to a GDI object, but is a handle allocated by the GlobalAlloc function with the GMEM_MOVEABLE flag.


  1. Commonly used clipboard string formats. Unlike the CF_ prefix format, these must be registered with the register_clipboard string() function before use. (Prefix CFSTR_.)


CFSTR_EMBEDSOURCE

Embed source

CFSTR_EMBEDDEDOBJECT

Embedded object

CFSTR_LINKSOURCE

Link source

CFSTR_CUSTOMLINKSOURCE

Custom link source

CFSTR_OBJECTDESCRIPTOR

Object descriptor

CFSTR_LINKSRDESCRIPTOR

Link source descriptor


  1. Drop effect codes. (Prefix DROPEFFECT_.). See Drag and drop; Returning drop codes from the event function for more details.


DROPEFFECT_NONE

Drop refused.

DROPEFFECT_COPY

The object has been copied.

DROPEFFECT_MOVE

The object has been moved.

DROPEFFECT_LINK

The object has been linked.

DROPEFFECT_SCROLL

Scrolling is about to start or is currently occurring in the target program.


  1. Mouse button and key states. (Prefix MK_)


RELATED TOPICS

Drag and drop

The include file sculptor.h

Previous topic

exec_dll_method() definitions

Next topic

Control characters

Quick search

Navigation

  • index
  • next |
  • previous |
  • Sculptor Reference Guide 6.3.10 documentation »
  • Standard include files »
  • sculptor.h »
  • Drag and drop and clipboard related definitions in sculptor.h
© Copyright 2022, Sculptor Ltd..