ID2D1RenderTarget::D rawText(constWCHAR,UINT32,IDWriteTextFormat,constD2D1_RECT_F&,ID2D1Brush*,D2D1_DRAW_TEXT_OPTIONS,DWRITE_MEASURING_MODE) メソッド (d2d1.h)

[アーティクル]
01/10/2024

IDWriteTextFormat オブジェクトによって提供される書式情報を使用して、指定されたテキストを描画します。

構文

void DrawText(
  [in]  const WCHAR            *string,
        UINT32                 stringLength,
  [in]  IDWriteTextFormat      *textFormat,
  [ref] const D2D1_RECT_F &    layoutRect,
  [in]  ID2D1Brush             *defaultFillBrush,
        D2D1_DRAW_TEXT_OPTIONS options,
        DWRITE_MEASURING_MODE  measuringMode
);

パラメーター

[in] string

種類: WCHAR*

描画する Unicode 文字の配列へのポインター。

stringLength

型: UINT

文字列内の文字数。

[in] textFormat

型: IDWriteTextFormat*

描画するテキストの書式設定の詳細 (フォント、フォントサイズ、フロー方向など) を表すオブジェクト。

[ref] layoutRect

型: const D2D1_RECT_F

テキストが描画される領域のサイズと位置。

[in] defaultFillBrush

種類: ID2D1Brush*

テキストの塗りつぶしに使用するブラシ。

options

種類: D2D1_DRAW_TEXT_OPTIONS

テキストをピクセル境界にスナップするかどうか、およびレイアウト四角形にテキストをクリップするかどうかを示す値です。既定値は D2D1_DRAW_TEXT_OPTIONS_NONE です。これは、テキストをピクセル境界にスナップし、レイアウト四角形にクリップしないことを示します。

measuringMode

種類: DWRITE_MEASURING_MODE

書式設定時にグリフメトリックを使用してテキストを測定する方法を示す値。既定値は DWRITE_MEASURING_MODE_NATURAL です。

戻り値

なし

解説

IDWriteTextFormat オブジェクトを作成するには、IDWriteFactory を作成し、その CreateTextFormat メソッドを呼び出します。

失敗した場合、このメソッドはエラーコードを返しません。描画操作 (DrawText など) が失敗したかどうかを判断するには、ID2D1RenderTarget::EndDraw メソッドまたは ID2D1RenderTarget::Flush メソッドによって返される結果をチェックします。

例

例については、「方法: テキストを描画する」を参照してください。

要件


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