IXpsOMVisual::SetName 方法 (xpsobjectmodel.h)

设置视觉对象的 Name 属性。

语法

HRESULT SetName(
  [in] LPCWSTR name
);

参数

[in] name

视觉对象的名称。 NULL 指针清除 Name 属性。

返回值

该方法返回 HRESULT。 可能的值包括但不限于下表中的值。 有关此表中未列出的 XPS 文档 API 返回值的信息,请参阅 XPS 文档错误

返回代码 说明
S_OK
方法成功。
XPS_E_INVALID_NAME
根据 XML 纸张规范,传入 名称 的字符串不是有效名称。

注解

名称必须唯一。

通过在 name 中传递 NULL 指针清除 Name 属性会将 IsHyperlinkTarget 属性设置为 FALSE

要求

   
最低受支持的客户端 Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用]
目标平台 Windows
标头 xpsobjectmodel.h

另请参阅

IXpsOMVisual

XML 纸张规范

XPS 文档错误