IDWriteTextRenderer::DrawGlyphRun メソッド

IDWriteTextLayout::Draw はこの関数を呼び出して、一連のグリフをレンダリングするようにクライアントに指示します。

構文

virtual HRESULT DrawGlyphRun(
        void * clientDrawingContext,
        FLOAT  baselineOriginX,
        FLOAT  baselineOriginY,
        DWRITE_MEASURING_MODE  measuringMode,
  [in]  const DWRITE_GLYPH_RUN * glyphRun,
  [in]  const DWRITE_GLYPH_RUN_DESCRIPTION * glyphRunDescription,
        IUnknown * clientDrawingEffect
) = 0;

パラメーター

• clientDrawingContext
  IDWriteTextLayout::Draw に渡されるアプリケーション定義の描画コンテキスト。

• baselineOriginX
  グリフ実行のベースラインの原点のピクセル位置 (X 座標)。

• baselineOriginY
  グリフ実行のベースラインの原点のピクセル位置 (Y 座標)。

• measuringMode
  レンダリング モードを決定するために他のプロパティで使用する、グリフ実行に含まれるグリフの測定方法。

• glyphRun [in]
  レンダリングするグリフ実行インスタンスへのポインター。

• glyphRunDescription [in]
  この実行に関連付けられた文字のプロパティを含む、省略可能なグリフ実行説明インスタンスへのポインター。

• clientDrawingEffect
  レンダリングするグリフのアプリケーション定義の描画効果。通常、この引数は、テキストの内部を塗りつぶす前景ブラシなどの効果を表します。

戻り値

メソッドが成功した場合は、S_OK が返されます。 それ以外の場合は、エラー コードが返されます。HRESULT.

解説

IDWriteTextLayout::Draw 関数は、レンダリングするグリフに関するすべての情報を含むこのコールバック関数を呼び出します。アプリケーションは、基になるプラットフォームのグラフィックス API (Direct2D など) の呼び出しを主にデリゲートしてこのコールバックを実装し、描画コンテキストにグリフを描画します。GDI を使用するアプリケーションは、IDWriteBitmapRenderTarget::DrawGlyphRun メソッドの観点でこのコールバックを実装できます。

要件

参照

IDWriteTextRenderer