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