IDWriteFactory_CreateGdiCompatibleTextLayout

文字列、フォーマット、および付随する制約を受け取り、特定の表示解像度と計測モード向けに整形した結果を表すオブジェクトを生成する。

IDWriteFactory_CreateGdiCompatibleTextLayout this, string, stringLength, textFormat, layoutWidth, layoutHeight, pixelsPerDip, transform, useGdiNatural, textLayout

this : [comobj] IDWriteFactory インターフェースの COM オブジェクト変数
string : [int] 
stringLength : [int] 型: UINT32 文字列の長さ (文字数)。
textFormat : [comobj] 型: IDWriteTextFormat* 文字列に適用するテキストフォーマットオブジェクト。
layoutWidth : [float] 型: FLOAT レイアウトボックスの幅。
layoutHeight : [float] 型: FLOAT レイアウトボックスの高さ。
pixelsPerDip : [float] 型: FLOAT DIP (デバイス非依存ピクセル) あたりの物理ピクセル数。例えば 96 DPI のデバイスにレンダリングする場合は 1、120 DPI のデバイスの場合は 1.25 (120/96) となる。
transform : [var] 型: const DWRITE_MATRIX* グリフおよびその位置に適用する任意のトランスフォーム。このトランスフォームは、フォントサイズと DIP あたりのピクセル数による拡大縮小の後に適用される。
useGdiNatural : [int] 型: BOOL FALSE のとき、テキストレイアウトに GDI の二値テキストと同じメトリクスを使用させる。TRUE のとき、CLEARTYPE_NATURAL_QUALITY で作成されたフォントを用いて GDI が計測したテキストと同じメトリクスを使用させる。
textLayout : [comobj] 型: IDWriteTextLayout** メソッドが戻る際、生成されたテキストレイアウトオブジェクトへのポインタのアドレスを格納する。

(プラグイン / モジュール : com_misc.dll)

解説

文字列、フォーマット、および付随する制約を受け取り、特定の表示解像度と計測モード向けに整形した結果を表すオブジェクトを生成する。

[戻り値]
型: HRESULT このメソッドが成功した場合は S_OK を返す。そうでない場合は HRESULT エラーコードを返す。

[備考]
生成されたテキストレイアウトは意図した解像度でのみ使用すべきであり、テキストのスケーラビリティが必要な場合は
CreateTextLayout を使用すべきである。

情報