IRichEditOleCallback::QueryAcceptData 方法 (richole.h)
在粘贴操作或拖动事件期间, 确定是否应接受粘贴或拖动的数据。
语法
HRESULT QueryAcceptData(
LPDATAOBJECT lpdataobj,
CLIPFORMAT *lpcfFormat,
DWORD reco,
BOOL fReally,
HGLOBAL hMetaPict
);
参数
lpdataobj
类型: LPDATAOBJECT
要粘贴或拖动的数据对象。
lpcfFormat
类型: CLIPFORMAT*
将用于粘贴或删除操作的剪贴板格式。 如果 lpcfFormat 指向的值为零,则将使用最佳可用格式。 如果回调更改 了 lpcfFormat 指向的值,则 Rich edit 控件仅使用该格式,如果格式不可用,操作将失败。
reco
类型: DWORD
剪贴板操作标志,可以是其中一个值。
值 | 含义 |
---|---|
|
拖放操作 (拖放) 。 |
|
从剪贴板粘贴。 |
fReally
类型: BOOL
指示拖放是否实际发生,或者是否只是一个查询。 非零值表示实际发生粘贴或删除操作。 零值表示操作只是一个查询,例如 ,对于EM_CANPASTE。
hMetaPict
类型: HGLOBAL
如果通过粘贴特殊操作对对象施加 DVASPECT_ICON ,则包含对象的图标视图的图元文件的句柄。
返回值
类型: HRESULT
如果成功,则返回 S_OK。 请参阅“备注”。
注解
失败时,Rich edit 控件会拒绝数据并终止操作。 否则,控件会检查数据本身是否可接受格式。 除 S_OK 以外的成功代码意味着,如果 fReally 为 FALSE) ,回调 (检查数据本身,或者 (fReally 为 TRUE) 导入数据本身。 如果应用程序返回S_OK以外的成功代码,则控件不会检查编辑控件的只读状态。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | richole.h |
DLL | Msftedit.dll |