IDWriteTextRenderer::DrawUnderline メソッド

IDWriteTextLayout::Draw はこの関数を呼び出して、下線を描画するようにクライアントに指示します。

構文

virtual HRESULT DrawUnderline(
        void * clientDrawingContext,
        FLOAT  baselineOriginX,
        FLOAT  baselineOriginY,
  [in]  const DWRITE_UNDERLINE * underline,
        IUnknown * clientDrawingEffect
) = 0;

パラメーター

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

• baselineOriginX
  下線を適用する実行のベースラインの原点のピクセル位置 (X 座標)。

• baselineOriginY
  下線を適用する実行のベースラインの原点のピクセル位置 (Y 座標)。

• underline [in]
  下線の論理情報を含む構造体へのポインター。

• clientDrawingEffect
  下線に適用するアプリケーション定義の効果。通常、この引数は、行の内部を塗りつぶす前景ブラシなどの効果を表します。

戻り値

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

解説

書式設定によって属性がどのように変更されるかに応じて、1 つの下線を複数の呼び出しに分割できます。フォントのサイズやスタイルが下線内で変更された場合、文字に応じて太さとオフセットの加重平均が計算されます。適切なピクセル開始位置を取得するには、ベースラインに underline::offset を追加します。それ以外の場合、テキストの行間はなくなります。X 座標は、テキストの方向に関係なく常に左側として渡されます。これにより、描画は簡単になり、空白や二重にスタンプされたアルファ ブレンドを引き起こす可能性がある丸めの問題が軽減されます。アルファが重ならないようにするには、終点を最も近いデバイス ピクセルに丸めます。

要件

参照

IDWriteTextRenderer