IPrintCoreHelperPS::GetFontSubstitution 方法 (prcomoem.h)

IPrintCoreHelperPS::GetFontSubstitution 方法會指出哪個裝置字型,如果有的話,會當做指定 TrueType 字型的替代字型使用。

語法

HRESULT GetFontSubstitution(
  [in]  IN PCWSTR  pszTrueTypeFontName,
  [out] OUT PCWSTR *ppszDevFontName
);

參數

[in] pszTrueTypeFontName

Null 終止 Unicode 字串的指標,其中包含 TrueType 字型的名稱。

[out] ppszDevFontName

接收 Null 終止 Unicode 字串位址之變數的指標。 此字串包含將用來取代 pszFontName 參數中所指定 TrueType 字型的裝置字型名稱。 如果沒有可作為指定 TrueType 字型替代的裝置字型,此參數將會設定為 NULL

傳回值

IPrintCoreHelperPS::GetFontSubstitution 應該傳回下列其中一個值:

傳回碼 描述
S_OK 方法會讀取指定功能的選項。
E_FAIL 要求的字型不存在或不是 TrueType 字型。
E_INVALIDARG 一或多個引數無效。
E_OUTOFMEMORY 核心驅動程式無法服務要求,因為記憶體不足。
E_UNEXPECTED或其他未列於此處的傳回碼 核心驅動程式似乎處於無效狀態。 呼叫端應該傳回失敗碼。

備註

如果應用程式嘗試列印使用 pszTrueTypeFontName 參數中指定的 TrueType 字型的文字,該文字會改為列印在 ppszDevFontName 參數中指定的裝置字型中。 裝置字型名稱必須是有效的已安裝字型。

字型是由其字型臉部名稱所識別,其出現在LOGFONT結構的 lfFaceName 成員中。

若要取得可用字型的清單,請建立目前印表機的資訊內容,並呼叫 SetGraphicsMode (hIC,GM_ADVANCED) 。 然後,藉由呼叫 EnumFontFamilies 來列舉裝置字型。 回呼參數 (請參閱 EnumFontFamProc) 的 EnumFontFamilies 應該藉由遞增位 AND 結果 (FontType & TRUETYPE_FONTTYPE) 為非零的每個字型,來篩選裝置字型的計數器。

規格需求

需求
目標平台 桌面
標頭 prcomoem.h (包括 Prcomoem.h)

另請參閱

IPrintCoreHelperPS

IPrintCoreHelperPS::SetFontSubstitution