IDWriteFactory：：CreateTextLayout 方法 (dwrite.h)

接受字串、文字格式和相關聯的條件約束，併產生代表完整分析及格式化結果的物件。

語法

HRESULT CreateTextLayout(
  [in]  WCHAR const       *string,
        UINT32            stringLength,
        IDWriteTextFormat *textFormat,
        FLOAT             maxWidth,
        FLOAT             maxHeight,
  [out] IDWriteTextLayout **textLayout
);

參數

[in] string

類型： const WCHAR*

字元陣列，其中包含要從中建立新 IDWriteTextLayout 物件的字串。 此陣列的長度必須是 stringLength ，而且可以包含內嵌 的 NULL 字元。

stringLength

類型： UINT32

字串中的字元數。

textFormat

類型： IDWriteTextFormat*

物件的指標，表示要套用至字串的格式。

maxWidth

類型： FLOAT

版面配置方塊的寬度。

maxHeight

類型： FLOAT

版面配置方塊的高度。

[out] textLayout

類型： IDWriteTextLayout**

當這個方法傳回時，會包含所產生文字配置物件的指標位址。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

規格需求

另請參閱

IDWriteFactory