次の方法で共有


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