共用方式為

IXpsRasterizationFactory2：：CreateRasterizer 方法 (xpsrassvc.h)

  • 發行項

CreateRasterizer 方法會建立 XPS 轉譯器物件，可使用 XPS 點陣化服務，將內容從 XPS 轉換成 PWG 點陣。 PWG 點陣支援非方形的 DPI。

語法

HRESULT CreateRasterizer(
  [in, optional]  IXpsOMPage              *xpsPage,
  [in]            FLOAT                   DPIX,
  [in]            FLOAT                   DPIY,
  [in]            XPSRAS_RENDERING_MODE   nonTextRenderingMode,
  [in]            XPSRAS_RENDERING_MODE   textRenderingMode,
  [in]            XPSRAS_PIXEL_FORMAT     pixelFormat,
  [in]            XPSRAS_BACKGROUND_COLOR backgroundColor,
  [out, optional] IXpsRasterizer          **ppIXpsRasterizer
);

參數

[in, optional] xpsPage

IXpsOMPage 物件的指標，代表要呈現的 XPS 固定頁面。 此物件會封裝 XPS 檔中的 FixedPage 區段。

[in] DPIX

套用至點陣化輸出位圖 x 維度的每英吋點數。 DPI 值是用來列印或顯示 XPS 固定頁面之裝置的解析度。

[in] DPIY

套用至點陣化輸出位圖 y 維度的點數。

[in] nonTextRenderingMode

點陣化輸出中非文字項目的轉譯模式。 此參數指出是否產生反鋸齒輸出。 將此參數設定為下列其中一個 XPSRAS_RENDERING_MODE 列舉值：

  • XPSRAS_RENDERING_MODE_ANTIALIASED

  • XPSRAS_RENDERING_MODE_ALIASED

[in] textRenderingMode

點陣化輸出中文字的轉譯模式。 此參數指出是否產生反鋸齒輸出。 將此參數設定為下列其中一個XPSRAS_RENDERING_MODE列舉值：

  • XPSRAS_RENDERING_MODE_ANTIALIASED

  • XPSRAS_RENDERING_MODE_ALIASED

[in] pixelFormat

允許呼叫端選取 IXpsRasterizer：：RasterizeRect 所傳回的IWICBitmap 所使用的圖元格式。 將此參數設定為下列其中一個 XPSRAS_PIXEL_FORMAT 列舉值：

  • XPSRAS_PIXEL_FORMAT_32BPP_PBGRA_UINT_SRGB

  • XPSRAS_PIXEL_FORMAT_64BPP_PRGBA_HALF_SCRGB

  • XPSRAS_PIXEL_FORMAT_128BPP_PRGBA_FLOAT_SCRGB

[in] backgroundColor

允許呼叫端選取背景色彩。 將此參數設定為下列其中一個 XPSRAS_BACKGROUND_COLOR 列舉值：

  • XPSRAS_BACKGROUND_COLOR_TRANSPARENT

  • XPSRAS_BACKGROUND_COLOR_OPAQUE

  • 默認背景色彩為 XPSRAS_BACKGROUND_COLOR_TRANSPARENT。

[out, optional] ppIXpsRasterizer

此參數指向方法將指標寫入新建立之 XPS 轉譯器物件的 IXpsRasterizer 介面的位置。 如果方法失敗，它會將 NULL 寫入這個位置，並傳回錯誤碼。

傳回值

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

規格需求

需求 值
最低支援的用戶端 Windows 10
目標平台 桌面
標頭 xpsrassvc.h (包含 Xpsrassvc.h)

另請參閱

IXpsRasterizationFactory2