IPrintCoreHelperPS::GetFontSubstitution メソッド (prcomoem.h)
IPrintCoreHelperPS::GetFontSubstitution メソッドは、指定された TrueType フォントの置換フォントとして使用されるデバイス フォント (存在する場合) を示します。
構文
HRESULT GetFontSubstitution(
[in] IN PCWSTR pszTrueTypeFontName,
[out] OUT PCWSTR *ppszDevFontName
);
パラメーター
[in] pszTrueTypeFontName
TrueType フォントの名前を含む null で終わる Unicode 文字列へのポインター。
[out] ppszDevFontName
null で終わる Unicode 文字列のアドレスを受け取る変数へのポインター。 この文字列には、 pszFontName パラメーターで指定された TrueType フォントの代わりに使用されるデバイス フォントの名前が含まれます。 指定した TrueType フォントの代わりに使用できるデバイス フォントがない場合、このパラメーターは NULL に設定されます。
戻り値
IPrintCoreHelperPS::GetFontSubstitution は、次のいずれかの値を返す必要があります。
| リターン コード | 説明 |
|---|---|
| S_OK | メソッドは、指定された機能のオプションを読み取る。 |
| E_FAIL | 要求されたフォントが存在しないか、TrueType フォントではありません。 |
| E_INVALIDARG | 1 つ以上の引数が無効です。 |
| E_OUTOFMEMORY | メモリ不足のため、コア ドライバーは要求に対応できませんでした。 |
| E_UNEXPECTED、またはここに記載されていないその他のリターン コード | コア ドライバーが無効な状態にあるようです。 呼び出し元はエラー コードを返す必要があります。 |
注釈
アプリケーションが pszTrueTypeFontName パラメーターで指定された TrueType フォントを使用するテキストを印刷しようとすると、代わりに ppszDevFontName パラメーターで指定されたデバイス フォントでそのテキストが印刷されます。 デバイスのフォント名は、有効なインストール済みフォントのフォントである必要があります。
フォントは、LOGFONT 構造体の lfFaceName メンバーに表示されるフォント名で識別されます。
使用可能なフォントの一覧を取得するには、現在のプリンターの情報コンテキストを作成し、 SetGraphicsMode(hIC, GM_ADVANCED)を呼び出します。 次に、 EnumFontFamilies の呼び出しによってデバイスフォントを列挙します。 EnumFontFamilies のコールバック パラメーター (EnumFontFamProc を参照) では、ビットごとの AND 結果 (FontType & TRUETYPE_FONTTYPE) が 0 以外のフォントごとにカウンターをインクリメントして、デバイス フォントをフィルター処理する必要があります。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | prcomoem.h (Prcomoem.h を含む) |