共用方式為


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 檔規格,傳入 名稱 的字串不是有效的名稱。

備註

名稱必須是唯一的。

藉由在名稱中傳遞Null指標,清除Name屬性會將IsHyperlinkTarget屬性設定為FALSE

規格需求

   
最低支援的用戶端 適用于 Windows Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 xpsobjectmodel.h

另請參閱

IXpsOMVisual

XML Paper Specification

XPS 檔錯誤