IDWriteFactory::CreateGdiCompatibleTextLayout メソッド (dwrite.h)

文字列、書式、および関連する制約を受け取り、特定の表示解像度と測定モード用に書式設定された結果を表すオブジェクトを生成します。

構文

HRESULT CreateGdiCompatibleTextLayout(
  [in]           WCHAR const         *string,
                 UINT32              stringLength,
                 IDWriteTextFormat   *textFormat,
                 FLOAT               layoutWidth,
                 FLOAT               layoutHeight,
                 FLOAT               pixelsPerDip,
  [in, optional] DWRITE_MATRIX const *transform,
                 BOOL                useGdiNatural,
  [out]          IDWriteTextLayout   **textLayout
);

パラメーター

[in] string

型: const WCHAR*

新しい IDWriteTextLayout オブジェクトを作成する文字列 含む文字の配列。 この配列は stringLength 長くする必要があり、埋め込み NULL 文字を含めることができます。

stringLength

型: UINT32

文字列の長さ (文字数)。

textFormat

型: IDWriteTextFormat*

文字列に適用するテキスト書式設定オブジェクト。

layoutWidth

型: FLOAT

レイアウト ボックスの幅。

layoutHeight

型: FLOAT

レイアウト ボックスの高さ。

pixelsPerDip

型: FLOAT

DIP あたりの物理ピクセル数 (デバイスに依存しないピクセル)。 たとえば、pixelsPerDip 96 DPI デバイスにレンダリングする場合は 1 です。 120 DPI デバイスにレンダリングする場合 pixelsPerDip は 1.25 (120/96) です。

[in, optional] transform

型: const DWRITE_MATRIX*

グリフとその位置に適用される省略可能な変換。 この変換は、スケーリングで DIP あたりのフォント サイズとピクセルを指定した後に適用されます。

useGdiNatural

型: BOOL

FALSE に設定すると、GDI のバイレベル テキストと同じメトリックを使用するようにテキスト レイアウト指示します。 TRUE をに設定すると、CLEARTYPE_NATURAL_QUALITYで作成されたフォントを使用して GDI によって測定されたテキストと同じメトリックを使用するようにテキスト レイアウトに指示します。

[out] textLayout

型: IDWriteTextLayout**

このメソッドが戻るときに、結果のテキスト レイアウト オブジェクトのポインターへのアドレスを格納します。

戻り値

型: HRESULT

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

備考

結果のテキスト レイアウトは、目的の解像度にのみ使用し、代わりに CreateTextLayout テキストのスケーラビリティが必要な場合にのみ使用する必要があります。

必要条件

要件	価値
サポートされる最小クライアント	Windows 7、Windows Vista SP2 および Windows Vista 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
サポートされる最小サーバー	Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	dwrite.h
ライブラリ	Dwrite.lib
DLL	Dwrite.dll

関連項目

IDWriteFactory