IDWriteTextFormat 介面 (dwrite.h)

IDWriteTextFormat介面描述用來格式化文字的字型和段落屬性，並描述地區設定資訊。

繼承

IDWriteTextFormat介面繼承自IUnknown介面。 IDWriteTextFormat 也有下列類型的成員：

方法

IDWriteTextFormat介面具有這些方法。

IDWriteTextFormat：：GetFlowDirection 取得文字線條流動的方向。
IDWriteTextFormat：：GetFontCollection 取得目前的字型集合。
IDWriteTextFormat：：GetFontFamilyName 取得字型系列名稱的複本。
IDWriteTextFormat：：GetFontFamilyNameLength 取得字型系列名稱的長度。
IDWriteTextFormat：：GetFontSize 取得 DIP 單位中的字型大小。
IDWriteTextFormat：：GetFontStretch 取得文字的字型延展。
IDWriteTextFormat：：GetFontStyle 取得文字的字型樣式。
IDWriteTextFormat：：GetFontWeight 取得文字的字型粗細。
IDWriteTextFormat：：GetIncrementalTabStop 取得累加定位停駐點位置。
IDWriteTextFormat：：GetLineSpacing 取得多行文欄位落的行距調整集。 (IDWriteTextFormat.GetLineSpacing)
IDWriteTextFormat：：GetLocaleName 取得地區設定名稱的複本。
IDWriteTextFormat：：GetLocaleNameLength 取得地區設定名稱的長度。
IDWriteTextFormat：：GetParagraphAlignment 取得段落的對齊選項，這個選項相對於版面配置方塊的上邊緣和下邊緣。
IDWriteTextFormat：：GetReadingDirection 取得段落中文字的目前閱讀方向。
IDWriteTextFormat：：GetTextAlignment 取得相對於版面配置方塊開頭和尾端邊緣的文字對齊選項。
IDWriteTextFormat：：GetTrimming 取得溢位版面配置方塊之文字的修剪選項。
IDWriteTextFormat：：GetWordWrapping 取得自動換行選項。
IDWriteTextFormat：：SetFlowDirection 設定段落流程方向。
IDWriteTextFormat：：SetIncrementalTabStop 設定兩個相鄰定位停駐點之間的固定距離。
IDWriteTextFormat：：SetLineSpacing 設定行距。
IDWriteTextFormat：：SetParagraphAlignment 設定相對於版面配置方塊頂端和下邊緣的段落對齊選項。
IDWriteTextFormat：：SetReadingDirection 設定段落閱讀方向。
IDWriteTextFormat：：SetTextAlignment 設定段落中文字的對齊方式，相對於 IDWriteTextFormat 介面之版面配置方塊的開頭和尾端邊緣。
IDWriteTextFormat：：SetTrimming 設定文字溢位版面配置寬度的修剪選項。
IDWriteTextFormat：：SetWordWrapping 設定自動換行選項。

備註

若要取得 IDWriteTextFormat 介面的參考，應用程式必須呼叫 IDWriteFactory：：CreateTextFormat 方法，如下列程式碼所示。

if (SUCCEEDED(hr))
{
    hr = pDWriteFactory_->CreateTextFormat(
        L"Gabriola",
        NULL,
        DWRITE_FONT_WEIGHT_REGULAR,
        DWRITE_FONT_STYLE_NORMAL,
        DWRITE_FONT_STRETCH_NORMAL,
        72.0f,
        L"en-us",
        &pTextFormat_
        );
}

使用CreateTextFormat函式建立IDWriteTextFormat物件時，應用程式會指定文字格式的字型系列、字型集合、字型粗細、字型大小和地區設定名稱。

建立 IDWriteTextFormat 物件之後，就無法變更這些屬性。 若要變更這些屬性，必須使用所需的屬性來建立新的 IDWriteTextFormat 物件。

IDWriteTextFormat介面可用來繪製具有單一格式的文字

若要繪製具有多種格式的文字，或使用自訂文字轉譯器，請使用 IDWriteTextLayout 介面。 IDWriteTextLayout 可讓應用程式變更字串內文字範圍的格式。 IDWriteFactory：：CreateTextLayout會採用IDWriteTextFormat物件做為參數，一開始會將格式資訊套用至整個字串。

此物件可能不是安全線程，而且可能會有文字格式變更的狀態。

DirectWrite 和 Direct2D

若要使用單一格式繪製簡單文字， Direct2D 會提供 ID2D1RenderTarget：:D rawText 方法，此方法會使用 IDWriteTextFormat 物件所提供的格式資訊來繪製字串。

需求

最低支援的用戶端	適用于 Windows Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	dwrite.h