IDWriteTextLayout::D raw メソッド (dwrite.h)

指定したクライアント描画コンテキストを使用してテキストを描画します。

構文

HRESULT Draw(
  void                *clientDrawingContext,
  IDWriteTextRenderer *renderer,
  FLOAT               originX,
  FLOAT               originY
);

パラメーター

clientDrawingContext

型: void*

アプリケーション定義の描画コンテキスト。

renderer

型: IDWriteTextRenderer*

テキスト文字列の一部を描画するために使用されるコールバック関数のセットへのポインター。

originX

型: FLOAT

レイアウトの左側の x 座標。

originY

型: FLOAT

レイアウトの上端の y 座標。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

このメソッドを使用してテキストを描画するには、アプリケーションで IDWriteFactory::CreateTextLayout を使用して textLayout オブジェクトを作成する必要があります。

textLayout オブジェクトが取得されると、アプリケーションは IDWriteTextLayout::D raw メソッドを呼び出して、テキスト、装飾、およびインライン オブジェクトを描画します。 実際の描画は、 textRenderer 引数として渡されるコールバック インターフェイスを介して行われます。そこで、対応する DrawGlyphRun API が呼び出されます。

DWRITE_READING_DIRECTION_TOP_TO_BOTTOM (または下から上) を使用して SetReadingDirection を使用して IDWriteTextLayout に垂直テキストの読み取り方向を設定する場合は、IDWriteTextRenderer1 を実装するインターフェイスを渡す必要があります。 それ以外の場合は、元の IDWriteTextRenderer インターフェイスで水平テキストのみがサポートされているため、エラー DWRITE_E_TEXTRENDERERINCOMPATIBLEが発生します。

要件

サポートされている最小のクライアント	Windows 7、Windows Vista SP2 と Windows Vista 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	dwrite.h
Library	Dwrite.lib
[DLL]	Dwrite.dll

関連項目

IDWriteTextLayout