Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function returns the first available clipboard format in the specified list.

Syntax 

int GetPriorityClipboardFormat(
  UINT* 
paFormatPriorityList, 
  int 
cFormats
);

Parameters

paFormatPriorityList

[in] Pointer to an array of unsigned integers identifying clipboard formats, in priority order. For a description of the standard clipboard formats, see SetClipboardData.

cFormats

[in] Integer that contains the number of entries in the paFormatPriorityListarray. This value must not be greater than the number of entries in the list.

Return Value

The first clipboard format in the list for which data is available indicates success. NULL indicates that the clipboard is empty. –1 indicates that the clipboard contains data, but not in any of the specified formats. To get extended error information, call GetLastError.

Remarks

During a copy or cut operation, a window calls SetClipboardDatato place data on the clipboard in as many clipboard formats as possible, ordered from the most descriptive clipboard format to the least descriptive. During a paste operation, an application can specify a different format priority order with GetPriorityClipboardFormat. This function returns the first format from the specified list that is found on the clipboard.

Requirements

Header winuser.h
Library Clipbd.lib
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also