IPrintOemUni::TTDownloadMethod メソッド (prcomoem.h)

[アーティクル]
03/05/2024

IPrintOemUni::TTDownloadMethodメソッドを使用すると、レンダリングプラグインは、指定された TrueType ソフトフォントに Unidrv で使用する必要がある形式を示します。

構文

HRESULT TTDownloadMethod(
        PDEVOBJ     pdevobj,
        PUNIFONTOBJ pUFObj,
  [out] OUT DWORD   *pdwResult
);

パラメーター

pdevobj

呼び出し元が指定した DEVOBJ 構造体へのポインター。

pUFObj

UNIFONTOBJ 構造体への呼び出し元が指定したポインター。

[out] pdwResult

次のメソッド指定の定数値のいずれかを受け取ります。

値	定義
TTDOWNLOAD_BITMAP	Unidrv は、指定したフォントをビットマップとしてダウンロードする必要があります。
TTDOWNLOAD_DONTCARE	Unidrv では、フォント形式を選択できます。
TTDOWNLOAD_GRAPHICS	Unidrv では、フォントをダウンロードするのではなく、TrueType フォントをグラフィックスとして印刷する必要があります。
TTDOWNLOAD_TTOUTLINE	Unidrv は、指定したフォントをアウトラインとしてダウンロードする必要があります。詳細については、「解説」を参照してください。

戻り値

メソッドは、次のいずれかの値を返す必要があります。

リターンコード	説明
S_OK	操作が成功しました。
E_FAIL	操作が失敗しました。
E_NOTIMPL	このメソッドは実装されていません。

注釈

メソッドの目的は IPrintOemUni::TTDownloadMethod 、レンダリングプラグインで、指定した TrueType ソフトフォントのプリンターの優先形式を指定できるようにすることです。

レンダリングプラグインでメソッドが IPrintOemUni::TTDownloadMethod 実装されている場合、TrueType フォントを印刷スプーラーに送信する準備が整うたびに、Unidrv はメソッドを呼び出します。 Unidrv はフォントの種類を指定し、 IPrintOemUni::TTDownloadMethod メソッドは pdwResult が指す場所でプリンターの優先形式を指定する必要があります。

プリンターで TrueType フォントをラスター化できない限り、メソッドはTTDOWNLOAD_TTOUTLINEを返さないでください。レンダリングプラグインは、TrueType フォントファイルの読み取りと解析を行います。 TrueType フォントファイルへのポインターは、 FONTOBJ_pvTrueTypeFontFileを呼び出すことによって取得できます。

メソッドは IPrintOemUni::TTDownloadMethod 省略可能です。レンダリングプラグインがこのメソッドを実装する場合、プラグインの IPrintOemUni::GetImplementedMethod メソッドは、入力として "TTDownLoadMethod" を受け取ったときにS_OKを返す必要があります。

詳細については、「カスタマイズされたフォント管理」を参照してください。