IPrintCoreHelperPS::SetFontSubstitution メソッド (prcomoem.h)

  • [アーティクル]

IPrintCoreHelperPS::SetFontSubstitution メソッドは、指定された TrueType フォントの代わりに印刷するデバイス フォントを指定します。

構文

HRESULT SetFontSubstitution(
  [in] IN PCWSTR pszTrueTypeFontName,
  [in] IN PCWSTR pszDevFontName
);

パラメーター

[in] pszTrueTypeFontName

有効な TrueType フォント名を含む null で終わる Unicode 文字列へのポインター。 このパラメーターは NULL にすることはできません。

[in] pszDevFontName

デバイス フォントの名前を含む null で終わる Unicode 文字列へのポインター。

戻り値

IPrintCoreHelperPS::GetFontSubstitution は、次のいずれかの値を返す必要があります。

リターン コード 説明
S_OK
 メソッドは、指定された機能のオプションを読み取る。
E_FAIL
 要求されたフォントが存在しないか、TrueType フォントではありません。
E_INVALIDARG
 1 つ以上の引数が無効です。
E_OUTOFMEMORY
 メモリ不足のため、コア ドライバーは要求をサービスできませんでした。
E_UNEXPECTED、またはここに記載されていないその他のリターン コード
 コア ドライバーが無効な状態になっているようです。 呼び出し元はエラー コードを返す必要があります。

注釈

指定した TrueType フォントの代わりに使用するデバイス フォントの設定は、デバイス プロパティ シート セッション中にのみ実行でき、完全な UI 置換が有効になっている場合にのみ行うことができます。 pszTrueTypeFontName パラメーターで表されるフォントは、有効な TrueType フォントである必要があり、プリンターにインストールする必要があります。 pszDevFontName パラメーターで表されるデバイス フォントは、このプリンターの有効なフォントである必要があります。

指定した TrueType フォントの置換マッピングがこのキューに既に存在する場合、 SetFontSubstitution メソッドによってマッピングが自動的に置き換えられます。 置換マッピングを削除するには、pszTrueTypeFontName で指定された TrueType フォント名と、pszDevFontName で NULL を指定して、このメソッドを呼び出します。

有効なデバイス フォントの一覧を取得するには、現在のプリンターの情報コンテキストを作成し、 SetGraphicsMode(hIC, GM_ADVANCED) を呼び出します。 次に、 EnumFontFamilies を呼び出してデバイス フォントを列挙します。 EnumFontFamilies のコールバック パラメーター (Microsoft Windows SDK ドキュメントの EnumFontFamProc を参照) では、ビットごとの AND 結果 (FontType & TRUETYPE_FONTTYPE) が 0 以外のフォントごとにカウンターをインクリメントして、デバイス フォントをフィルター処理する必要があります。 SetGraphicsMode、EnumFontFamilies、EnumFontFamProc 関数については、Windows SDK のドキュメントで説明されています。

要件

要件 値
対象プラットフォーム デスクトップ
Header prcomoem.h (Prcomoem.h を含む)

こちらもご覧ください

IPrintCoreHelperPS

IPrintCoreHelperPS::GetFontSubstitution