IPrintCoreHelperUni::SetFontSubstitution メソッド (prcomoem.h)
メソッドは IPrintCoreHelperUni::SetFontSubstitution 、指定された TrueType フォントの代わりに印刷するデバイス フォントを指定します。
構文
HRESULT SetFontSubstitution(
[in] IN PCWSTR pszTrueTypeFontName,
[in] IN PCWSTR pszDevFontName
);
パラメーター
[in] pszTrueTypeFontName
有効な TrueType フォント名を含む null で終わる Unicode 文字列へのポインター。 このパラメーターは NULL にすることはできません。
[in] pszDevFontName
デバイス フォントの名前を含む null で終わる Unicode 文字列へのポインター。
戻り値
IPrintCoreHelperUni::SetFontSubstitution は、次のいずれかの値を返す必要があります。
| リターン コード | 説明 |
|---|---|
|
メソッドは、指定された機能のオプションを読み取る。 |
|
要求されたフォントが存在しないか、TrueType フォントではありません。 |
|
1 つ以上の引数が無効です。 |
|
メモリ不足のため、コア ドライバーは要求をサービスできませんでした。 |
|
コア ドライバーが無効な状態になっているようです。 呼び出し元はエラー コードを返す必要があります。 |
注釈
指定した 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 を含む) |