IDWriteTextFormat インターフェイス

IDWriteTextFormat インターフェイスは、テキストの書式設定に使用するフォント プロパティおよび段落プロパティを表すと共に、ロケール情報を示します。

メンバー

IDWriteTextFormat インターフェイス の継承元は次のとおりです: IUnknown インターフェイス. IDWriteTextFormat は次のメンバーも定義します:

• メソッド

メソッド

IDWriteTextFormat インターフェイス は次の項目を定義します: メソッド.

解説

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::DrawText メソッドが用意されています。このメソッドは、IDWriteTextFormat オブジェクトによって提供される書式情報を使用して文字列を描画します。

要件