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 あたりの物理ピクセル数 (デバイスに依存しないピクセル)。 たとえば、96 DPI デバイス ピクセルへのレンダリング PerDip が 1 の場合です。 120 DPI デバイス ピクセルへのレンダリング PerDip が 1.25 (120/96) の場合。

[in, optional] transform

型: const DWRITE_MATRIX*

グリフとその位置に適用されるオプションの変換。 この変換は、スケーリングによって DIP ごとのフォント サイズとピクセルが指定された後に適用されます。

useGdiNatural

種類: BOOL

FALSE に設定すると、GDI BI レベルのテキストと同じメトリックを使用するようにテキスト レイアウトに指示 します。 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 アプリ]
対象プラットフォーム	Windows
ヘッダー	dwrite.h
Library	Dwrite.lib
[DLL]	Dwrite.dll

こちらもご覧ください

IDWriteFactory