COlePasteSpecialDialog Class

Article
01/08/2013

Used for the OLE Paste Special dialog box.

class COlePasteSpecialDialog : public COleDialog

Members

Public Constructors

Name	Description
COlePasteSpecialDialog::COlePasteSpecialDialog	Constructs a COlePasteSpecialDialog object.

Public Methods

Name	Description
COlePasteSpecialDialog::AddFormat	Adds custom formats to the list of formats your application can paste.
COlePasteSpecialDialog::AddLinkEntry	Adds a new entry to the list of supported Clipboard formats.
COlePasteSpecialDialog::AddStandardFormats	Adds CF_BITMAP, CF_DIB, CF_METAFILEPICT, and optionally CF_LINKSOURCE to the list of formats your application can paste.
COlePasteSpecialDialog::CreateItem	Creates the item in the container document using the specified format.
COlePasteSpecialDialog::DoModal	Displays the OLE Paste Special dialog box.
COlePasteSpecialDialog::GetDrawAspect	Tells whether to draw item as an icon or not.
COlePasteSpecialDialog::GetIconicMetafile	Gets a handle to the metafile associated with the iconic form of this item.
COlePasteSpecialDialog::GetPasteIndex	Gets the index of available paste options that was chosen by the user.
COlePasteSpecialDialog::GetSelectionType	Gets the type of selection chosen.

Public Data Members

Name	Description
COlePasteSpecialDialog::m_ps	A structure of type OLEUIPASTESPECIAL that controls the function of the dialog box.

Remarks

Create an object of class COlePasteSpecialDialog when you want to call this dialog box. After a COlePasteSpecialDialog object has been constructed, you can use the AddFormat and AddStandardFormats member functions to add Clipboard formats to the dialog box. You can also use the m_ps structure to initialize the values or states of controls in the dialog box. The m_ps structure is of type OLEUIPASTESPECIAL.

For more information, see the OLEUIPASTESPECIAL structure in the Windows SDK.

For more information regarding OLE-specific dialog boxes, see the article Dialog Boxes in OLE.