通过

OleUIPasteSpecialA 函数 （oledlg.h）

  • 项目

调用标准 “选择性粘贴” 对话框，允许用户选择要粘贴或粘贴链接剪贴板对象的格式。

语法

UINT OleUIPasteSpecialA(
  [in] LPOLEUIPASTESPECIALA unnamedParam1
);

参数

[in] unnamedParam1

指向 OLEUIPASTESPECIAL 结构的指针。

返回值

标准成功/错误定义

返回代码 描述
OLEUI_FALSE
 未知故障（未使用）。
OLEUI_OK
 用户按下了“确定”按钮。
OLEUI_SUCCESS
 没有错误，与OLEUI_OK相同。
OLEUI_CANCEL
 用户按下了“取消”按钮。
 

标准字段验证错误

返回代码 描述
OLEUI_ERR_STANDARDMIN
 所有对话框常见的错误位于范围OLEUI_ERR_STANDARDMIN OLEUI_ERR_STANDARDMAX。 此值允许应用程序测试标准消息，以便向用户显示错误消息。
OLEUI_ERR_STRUCTURENULL
 传递给函数的 OLEUIXXX 结构的指针 NULL。
OLEUI_ERR_STRUCTUREINVALID
 权限不足，无法读取或写入对 OLEUIXXX 结构的访问权限。
OLEUI_ERR_CBSTRUCTINCORRECT
 cbstruct 值不正确。
OLEUI_ERR_HWNDOWNERINVALID
 hWndOwner 值无效。
OLEUI_ERR_LPSZCAPTIONINVALID
 lpszCaption 值无效。
OLEUI_ERR_LPFNHOOKINVALID
 lpfnHook 值无效。
OLEUI_ERR_HINSTANCEINVALID
 hInstance 值无效。
OLEUI_ERR_LPSZTEMPLATEINVALID
 lpszTemplate 值无效。
OLEUI_ERR_HRESOURCEINVALID
 hResource 值无效。
 

初始化错误

返回代码 描述
OLEUI_ERR_FINDTEMPLATEFAILURE
 找不到对话框模板。
OLEUI_ERR_LOADTEMPLATEFAILURE
 无法加载对话框模板。
OLEUI_ERR_DIALOGFAILURE
 对话框初始化失败。
OLEUI_ERR_LOCALMEMALLOC
 调用 LocalAlloc 或标准 IMalloc 分配器失败。
OLEUI_ERR_GLOBALMEMALLOC
 调用 GlobalAlloc 或标准 IMalloc 分配器失败。
OLEUI_ERR_LOADSTRING
 无法调用 LoadString 从库获取本地化资源。
OLEUI_ERR_OLEMEMALLOC
 对标准 IMalloc 分配器的调用失败。
 

函数特定错误

返回代码 描述
OLEUI_ERR_STANDARDMAX
 所有对话框常见的错误位于范围OLEUI_ERR_STANDARDMIN OLEUI_ERR_STANDARDMAX。 此值允许应用程序测试标准消息，以便向用户显示错误消息。
OLEUI_IOERR_SRCDATAOBJECTINVALID
 OLEUIPASTESPECIAL 的 lpSrcDataObject 成员无效。
OLEUI_IOERR_ARRPASTEENTRIESINVALID
OLEUIPASTESPECIAL 的 arrPasteEntries 成员无效。
OLEUI_IOERR_ARRLINKTYPESINVALID
 arrLinkTypesOLEUIPASTESPECIAL 的成员无效。
OLEUI_PSERR_CLIPBOARDCHANGED
 显示对话框时剪贴板内容已更改。
OLEUI_PSERR_GETCLIPBOAARDFAILED

 lpSrcDataObj 成员不正确。

言论

“粘贴特殊”对话框的设计假定，如果你愿意允许用户链接到对象，则你还愿意允许用户嵌入该对象。 因此，如果设置了与 OLEUIPASTEFLAG 枚举关联的任何OLEUIPASTE_LINKTYPE标志，则还必须设置OLEUIPASTE_PASTE标志，以便 “选择性”对话框中显示数据格式。

标准 “粘贴特殊”对话框 源 字段中显示的文本（在 Oledlg32.dll中实现）是 dwSrcofCopy 成员中为要粘贴对象的 OBJECTDESCRIPTOR 结构中指定的偏移量（以字节为单位）的空终止字符串。 如果 OBJECTDESCRIPTOR 结构不可用于此对象，则对话框将显示与CF_LINKSOURCEDESCRIPTOR关联的任何文本。 如果两个结构都不可用，对话框将查找CF_FILENAME。 如果未找到CF_FILENAME，则对话框将显示字符串“未知源”。

若要释放从 插入对象 或 粘贴特殊 对话框中返回的 HMETAFILEPICT，请删除句柄上的附加图元文件，如下所示。

void FreeHmetafilepict(HMETAFILEPICT hmfp)
{
    if (hmfp != NULL)
    {
        LPMETAFILEPICT pmfp = GlobalLock(hmfp);
 
        DeleteMetaFile(pmfp->hMF);
        GlobalUnlock(hmfp);
        GlobalFree(hmfp);
    }
    else
    {
        // Handle null pointers here.
        exit(0);
    }
}

注意

oledlg.h 标头将 OLEUIPASTESPECIAL 定义为基于 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本的别名。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows 2000 Professional [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
目标平台 窗户
标头 oledlg.h
库 OleDlg.lib
DLL OleDlg.dll

另请参阅

OLEUIPASTEFLAG