COlePasteSpecialDialog::AddFormat

Call this function to add new formats to the list of formats your application can support in a Paste Special operation.

void AddFormat( 
   const FORMATETC& formatEtc, 
   LPTSTR lpszFormat, 
   LPTSTR lpszResult, 
   DWORD flags  
); 
void AddFormat( 
   UINT cf, 
   DWORD tymed, 
   UINT nFormatID, 
   BOOL bEnableIcon, 
   BOOL bLink  
);

Parameters

  • fmt
    Reference to the data type to add.

  • lpszFormat
    String that describes the format to the user.

  • lpszResult
    String that describes the result if this format is chosen in the dialog box.

  • flags
    The different linking and embedding options available for this format. This flag is a bitwise combination of one or more of the different values in the OLEUIPASTEFLAG enumerated type.

  • cf
    The clipboard format to add.

  • tymed
    The types of media available in this format. This is a bitwise combination of one or more of the values in the TYMED enumerated type.

  • nFormatID
    The ID of the string that identifies this format. The format of this string is two separate strings separated by a '\n' character. The first string is the same that would be passed in the lpstrFormat parameter, and the second is the same as the lpstrResult parameter.

  • bEnableIcon
    Flag that determines whether the Display As Icon check box is enabled when this format is chosen in the list box.

  • bLink
    Flag that determines whether the Paste Link radio button is enabled when this format is chosen in the list box.

Remarks

This function can be called to add either standard formats such as CF_TEXT or CF_TIFF or custom formats that your application has registered with the system. For more information about pasting data objects into your application, see the article Data Objects and Data Sources: Manipulation.

For more information, see the TYMED enumeration type and the FORMATETC structure in the Windows SDK.

For more information, see the OLEUIPASTEFLAG enumerated type in the Windows SDK.

Requirements

Header: afxodlgs.h

See Also

Reference

COlePasteSpecialDialog Class

Hierarchy Chart

COlePasteSpecialDialog::AddStandardFormats

Other Resources

COlePasteSpecialDialog Members