IRichEditOleCallback::QueryAcceptData
Called on a paste or drag to determine if the data pasted/dragged should be accepted.
HRESULT QueryAcceptData(
LPDATAOBJECT lpdataobj, | |
CLIPFORMAT FAR * lpcfFormat, | |
DWORD reco, | |
BOOL fReally, | |
HGLOBAL hMetaPict | |
); |
Parameters
lpdataobj
Pointer to the DATAOBJECT structure specifying the data object being pasted or dragged.
lpcfFormat
Pointer to the clipboard format that will be used for the paste or drop operation. If the value pointed to by lpcfFormat is zero, the best available format will be used. If the callback changes the value pointed to by lpcfFormat, the rich edit control only uses that format and the operation will fail if the format is not available.
reco
Clipboard operation flag. Can be one of these values.
RECO_DROP | Drop operation (drag and drop). |
RECO_PASTE | Paste from the clipboard. |
fReally
Nonzero if the paste or drop is actually happening, zero if this is just a query, such as for EM_CANPASTE.
hMetaPict
Handle to a metafile containing the icon view of an object if DVASPECT_ICON is being imposed on a object by Paste Special.
Return Values
Returns success status. If the SCODE of the result is a failure SCODE, the rich edit control refuses the data and terminates the operation. If the SCODE of the result is S_OK, the control checks the data itself for acceptable formats. A return of a successful SCODE other than S_OK means that the callback either checked the data itself (if fReally is FALSE) or imported the data itself (if fReally is TRUE).
If the application returns a successful result other than S_OK, a rich edit control will not check the read-only state of the edit control.
See Also