IXpsOMThumbnailGenerator：：GenerateThumbnail 方法 (xpsobjectmodel.h)

發行項
03/13/2024

產生頁面的縮圖影像。

語法

HRESULT GenerateThumbnail(
  [in]          IXpsOMPage          *page,
  [in]          XPS_IMAGE_TYPE      thumbnailType,
  [in]          XPS_THUMBNAIL_SIZE  thumbnailSize,
  [in]          IOpcPartUri         *imageResourcePartName,
  [out, retval] IXpsOMImageResource **imageResource
);

參數

[in] page

IXpsOMPage 介面的指標，其中包含將建立縮圖影像的頁面。

[in] thumbnailType

XPS_IMAGE_TYPE值，指定要建立的縮圖影像類型。

[in] thumbnailSize

XPS_THUMBNAIL_SIZE值，指定要建立之縮圖的影像大小。

[in] imageResourcePartName

IOpcPartUri 介面的指標，其中包含新縮圖影像元件的名稱。

[out, retval] imageResource

新 IXpsOMImageResource 介面的指標，其中包含此方法所建立的縮圖影像。

傳回值

方法會傳回 HRESULT。可能的值包括但不限於下列數據表中的值。如需此表格中未列出的 XPS 檔 API 傳回值的相關信息，請參閱 XPS 檔錯誤。

傳回碼	描述
S_OK	此方法已成功。
E_POINTER	page、 imageResourcePartName 或 imageResource 為 NULL。
E_INVALIDARG	下列其中一個參數包含無效的值： thumbnailType：影像類型必須是 PNG (XPS_IMAGE_TYPE_PNG) 或 JPEG (XPS_IMAGE_TYPE_JPEG) thumbnailSize：thumbnailSize 必須是 XPS_THUMBNAIL_SIZE 的成員

規格需求

需求	值
最低支援的用戶端	適用於 Windows Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [僅限桌面]
目標平台	Windows
標頭	xpsobjectmodel.h