OleUIPasteSpecial
Invokes the standard Paste Special dialog box, allowing the user to select the
format of the clipboard object to be pasted or paste-linked.
UINT OleUIPasteSpecial(*
LPOLEUIPASTESPECIAL lpPS
| //In-out structure for this dialog
|
);
|
|
Parameter
lpPS
LPOLEUIPASTESPECIAL pointing to the in-out structure for this dialog.
Return Values
Standard Success/Error Definitions
OLEUI_FALSE
Unknown failure (unused).
OLEUI_SUCCESS
No error, same as OLEUI_OK
OLEUI_OK
The user pressed the OK button.
OLEUI_CANCEL
The user pressed the Cancel button.
Standard Field Validation Errors
OLEUI_ERR_STANDARDMIN
Errors common to all dialogs lie in the range OLEUI_ERR_STANDARDMIN to
OLEUI_ERR_STANDARDMAX. This value allows the application to test for standard messages
in order to display error messages to the user.
OLEUI_ERR_STRUCTURENULL
The pointer to an OLEUIXXX structure passed into the function was NULL.
OLEUI_ERR_STRUCTUREINVALID
Insufficient permissions for read or write access to an OLEUIXXX structure.
OLEUI_ERR_CBSTRUCTINCORRECT
The
cbstruct value is incorrect.
OLEUI_ERR_HWNDOWNERINVALID
The
hWndOwner value is invalid.
OLEUI_ERR_LPSZCAPTIONINVALID
The
lpszCaption value is invalid.
OLEUI_ERR_LPFNHOOKINVALID
The
lpfnHook value is invalid.
OLEUI_ERR_HINSTANCEINVALID
The
hInstance value is invalid.
OLEUI_ERR_LPSZTEMPLATEINVALID
The
lpszTemplate value is invalid.
OLEUI_ERR_HRESOURCEINVALID
The
hResource value is invalid.
Initialization Errors
OLEUI_ERR_FINDTEMPLATEFAILURE
Unable to find the dialog template.
OLEUI_ERR_LOADTEMPLATEFAILURE
Unable to load the dialog template.
OLEUI_ERR_DIALOGFAILURE
Dialog initialization failed.
OLEUI_ERR_LOCALMEMALLOC
A call to
LocalAlloc or the standard
IMalloc allocator failed.
OLEUI_ERR_GLOBALMEMALLOC
A call to
GlobalAlloc or the standard
IMalloc allocator failed.
OLEUI_ERR_LOADSTRING
Unable to
LoadString localized resources from the library.
OLEUI_ERR_OLEMEMALLOC
A call to the standard
IMalloc allocator failed.
Function Specific Errors
OLEUI_ERR_STANDARDMAX
Errors common to all dialogs lie in the range OLEUI_ERR_STANDARDMIN to
OLEUI_ERR_STANDARDMAX. This value allows the application to test for standard messages
in order to display error messages to the user.
OLEUI_IOERR_SRCDATAOBJECTINVALID
The
lpSrcDataObject field of
OLEUIPASTESPECIAL is invalid
OLEUI_IOERR_ARRPASTEENTRIESINVALID
The
arrPasteEntries field of
OLEUIPASTESPECIAL is invalid.
OLEUI_IOERR_ARRLINKTYPESINVALID
The
arrLinkTypes field of
OLEUIPASTESPECIAL is invalid
OLEUI_PSERR_CLIPBOARDCHANGED
The clipboard contents changed while the dialog was displayed.
OLEUI_PSERR_GETCLIPBOAARDFAILED
The
lpSrcDataObj member is incorrect.
Comments
The design of the paste special dialog assumes the following: if you are
willing to permit a user to link to an object, you are also willing to permit the
user to embed that object. For this reason, if any of the OLEUIPASTE_LINKTYPE
flags associated with the
OLEUIPASTEFLAG enumeration are set, then the OLEUIPASTE_PASTE flag must also be set in order
for the data formats to appear in the paste special box.
To free an HMETAFILEPICT returned from the Insert Object or Paste Special
dialog box, delete the attached metafile on the handle, as follows:
- oid FreeHmetafilepict(HMETAFILEPICT hmfp)
{
if (hmfp != NULL)
{
LPMETAFILEPICT pmfp = GlobalLock(hmfp);
DeleteMetaFile(pmfp->hMF);
GlobalUnlock(hmfp);
GlobalFree(hmfp);
}
} // FreeHmetafilepict
See Also
OLEUIPASTESPECIAL,
OLEUIPASTEFLAG
DeleteMetaFile,
GlobalUnlock,
GlobalFree in Win32
- Software for developers
-
Delphi Components
.Net Components
Software for Android Developers
- More information resources
-
MegaDetailed.Net
Unix Manual Pages
Delphi Examples
- Databases for Amazon shops developers
-
Amazon Categories Database
Browse Nodes Database
