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 隣接する 2 つのタブ位置間の固定距離を設定します。
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 インターフェイスは、1 つの形式でテキストを描画するために使用されます

複数の形式のテキストを描画したり、カスタム テキスト レンダラーを使用したりするには、 IDWriteTextLayout インターフェイスを使用します。 IDWriteTextLayout を使用すると、アプリケーションは文字列内のテキスト範囲の形式を変更できます。 IDWriteFactory::CreateTextLayout は、IDWriteTextFormat オブジェクトをパラメーターとして受け取り、最初に書式情報を文字列全体に適用します。

このオブジェクトはスレッド セーフではない可能性があり、テキスト形式の変更の状態を保持している可能性があります。

DirectWriteと Direct2D

1 つの形式で単純なテキストを描画するために、 Direct2D には ID2D1RenderTarget::D rawText メソッドが用意されています。このメソッドは、 IDWriteTextFormat オブジェクトによって提供される書式情報を使用して文字列を描画します。

要件

サポートされている最小のクライアント	Windows 7、Windows Vista SP2 と Windows Vista 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	dwrite.h