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

  • [アーティクル]

IPrintOemUni::TextOutAsBitmapメソッドを使用すると、ダウンロード可能なフォントが使用できない場合に備えて、レンダリング プラグインでテキスト文字列のビットマップ イメージを作成できます。

構文

HRESULT TextOutAsBitmap(
  SURFOBJ  *pso,
  STROBJ   *pstro,
  FONTOBJ  *pfo,
  CLIPOBJ  *pco,
  RECTL    *prclExtra,
  RECTL    *prclOpaque,
  BRUSHOBJ *pboFore,
  BRUSHOBJ *pboOpaque,
  POINTL   *pptlOrg,
  MIX      mix
);

パラメーター

pso

書き込むサーフェスを記述する SURFOBJ 構造体へのポインター。

pstro

レンダリングするグリフと、それらを配置する位置を定義する STROBJ 構造体へのポインター。

pfo

フォントとそのグリフに関する情報を取得する FONTOBJ 構造体へのポインター。

pco

すべてのレンダリングを実行する必要があるクリップ領域を定義する CLIPOBJ 構造体へのポインター。 ドライバーは、クリップ領域の外側のピクセルに影響を与えることはできません。

prclExtra

RECTL 構造体へのポインター。 GDI は、この関数の呼び出しで常にこのパラメーターを NULL に設定します。 ドライバーでは無視する必要があります。

prclOpaque

1 つの不透明な四角形を表す RECTL 構造体へのポインター。 この四角形は右下の排他的です。 この四角形内のピクセル (前景ではなくクリップされていないピクセル) は、不透明なブラシでレンダリングされます。 この四角形は、描画するテキストの境界を常に設定します。 このパラメーターが NULL の場合、不透明なピクセルはレンダリングされません。

pboFore

前景ピクセルに使用するブラシ オブジェクトを表す BRUSHOBJ 構造体へのポインター。 このブラシは常に純色のブラシになります。

pboOpaque

不透明なピクセルを表す BRUSHOBJ 構造体へのポインター。 このブラシの前景と背景の両方のミックス モードがR2_COPYPENと見なされます。 ドライバーが DEVINFO 構造体の flGraphicsCaps メンバーのGCAPS_ARBRUSHOPAQUE機能ビットを設定しない限り、常に純色ブラシで呼び出されます。

pptlOrg

両方のブラシのブラシの原点を定義する POINTL 構造体へのポインター。

mix

pboFore の前景と背景のラスター操作 (ミックス モード)。

戻り値

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

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

注釈

メソッドは IPrintOemUni::TextOutAsBitmap 、Unidrv の IPrintOemDriverUni::D rvUniTextOut メソッドから呼び出されます。そのメソッドがダウンロード可能なフォントを使用してテキスト文字列を作成できない場合は、フォントが使用できないか、回転されているためです。 IPrintOemUni::TextOutAsBitmap テキストのビットマップ イメージを作成し、印刷デバイスに送信する必要があります。

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

要件

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

こちらもご覧ください

IPrintOemDriverUni::D rvUniTextOut

IPrintOemUni

IPrintOemUni::GetImplementedMethod