IDWriteFactory

以降のすべての DirectWrite オブジェクトを作成するために使用します。このインターフェイスは、すべての DirectWrite オブジェクトのルートとなるファクトリインターフェイスです。

IDWriteFactory オブジェクトは、DWriteCreateFactory 関数を使用して作成します。

if (SUCCEEDED(hr))
{
    hr = DWriteCreateFactory(
        DWRITE_FACTORY_TYPE_SHARED,
        __uuidof(IDWriteFactory),
        reinterpret_cast<IUnknown**>(&pDWriteFactory_)
        );
}

IDWriteFactory オブジェクトは、フォントローダーの登録やキャッシュされたフォントデータといった状態情報を保持します。この状態は共有することも分離することもできます。ほとんどのアプリケーションではメモリを節約できるため、共有が推奨されます。ただし、一部のオブジェクトに対して別個の状態を持たせたい場合には、分離が有用なことがあります。

インストールされているフォントの集合を表すオブジェクトを取得します。

Type: HRESULT

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

カスタムフォントコレクションローダーを使用してフォントコレクションを作成します。

Type: HRESULT

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

カスタムフォントコレクションローダーをファクトリオブジェクトに登録します。

Type: HRESULT

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

この関数はフォントコレクションローダーを DirectWrite に登録します。フォントコレクションローダーインターフェイスはシングルトンオブジェクトとして実装する必要があり、特定の種類のキーが与えられたときに、フォントコレクション内のフォントファイルを列挙する処理を担います。特定のインスタンスは一度だけ登録できます。以降の登録の試みはエラーを返し、すでに登録済みであることを示します。フォントファイルローダーの実装は、コンストラクター内で自身を DirectWrite に登録してはならず、デストラクター内で自身の登録を解除してもなりません。登録操作と登録解除操作は、それぞれオブジェクトの参照カウントを増加および減少させるためです。代わりに、フォントファイルローダーの DirectWrite への登録および登録解除は、フォントファイルローダーの実装の外部で行うべきです。

以前に RegisterFontCollectionLoader を使用して登録されたカスタムフォントコレクションローダーの登録を解除します。

Type: HRESULT

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

ローカルのフォントファイルからフォントファイル参照オブジェクトを作成します。

Type: HRESULT

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

アプリケーション固有のフォントファイルリソースへの参照を作成します。

Type: HRESULT

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

この関数は、アプリケーションやドキュメントが、システムにインストールすることなくプライベートフォントを使用する必要がある場合のために提供されています。fontFileReferenceKey は、この呼び出しで使用される fontFileLoader のスコープ内でのみ一意であれば十分です。

フォントフェイスを表すオブジェクトを作成します。

Type: HRESULT

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

プライマリモニターに対する既定の設定でレンダリングパラメーターオブジェクトを作成します。モニターごとにレンダリングパラメーターが異なる場合があります。詳細については「How to Add Support for Multiple Monitors(複数モニターのサポートを追加する方法)」のトピックを参照してください。

Type: HRESULT

標準的な HRESULT エラーコードです。

指定したモニターに対する既定の設定でレンダリングパラメーターオブジェクトを作成します。ほとんどの場合、これがレンダリングパラメーターオブジェクトを作成する推奨方法です。

Type: HRESULT

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

指定したプロパティでレンダリングパラメーターオブジェクトを作成します。(IDWriteFactory.CreateCustomRenderingParams)

Type: HRESULT

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

フォントファイルローダーを DirectWrite に登録します。

Type: HRESULT

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

この関数はフォントファイルローダーを DirectWrite に登録します。フォントファイルローダーインターフェイスはシングルトンオブジェクトとして実装する必要があり、キーから特定の種類のフォントファイルリソースを読み込む処理を担います。特定のインスタンスは一度だけ登録できます。以降の登録の試みはエラーを返し、すでに登録済みであることを示します。フォントファイルローダーの実装は、コンストラクター内で自身を DirectWrite に登録してはならず、デストラクター内で自身の登録を解除してもなりません。登録操作と登録解除操作は、それぞれオブジェクトの参照カウントを増加および減少させるためです。代わりに、フォントファイルローダーの DirectWrite への登録および登録解除は、フォントファイルローダーの実装の外部で行うべきです。

以前に RegisterFontFileLoader を使用して DirectWrite フォントシステムに登録されたフォントファイルローダーの登録を解除します。

Type: HRESULT

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

この関数は、フォントファイルローダーのコールバックを DirectWrite フォントシステムから登録解除します。フォントファイルローダーインターフェイスはシングルトンオブジェクトとして実装する必要があります。フォントファイルローダーの実装は、コンストラクター内で自身を DirectWrite に登録してはならず、デストラクター内で自身の登録を解除してもなりません。登録操作と登録解除操作は、それぞれオブジェクトの参照カウントを増加および減少させるためです。代わりに、フォントファイルローダーの DirectWrite への登録および登録解除は、フォントファイルローダーの実装の外部で行うべきです。

テキストレイアウトに使用するテキストフォーマットオブジェクトを作成します。(IDWriteFactory.CreateTextFormat)

Type: HRESULT

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

テキストレイアウトで使用するタイポグラフィオブジェクトを作成します。

Type: HRESULT

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

GDI との相互運用に使用するオブジェクトを作成します。

Type: HRESULT

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

文字列、テキストフォーマット、および関連する制約を受け取り、完全に解析および整形された結果を表すオブジェクトを生成します。

Type: HRESULT

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

文字列、フォーマット、および関連する制約を受け取り、特定の表示解像度と測定モードに合わせて整形された結果を表すオブジェクトを生成します。

Type: HRESULT

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

生成されたテキストレイアウトは、意図した解像度でのみ使用すべきです。テキストのスケーラビリティが必要な場合は、代わりに CreateTextLayout を使用してください。

省略記号(...)を省略のしるしとして使用する、トリミング用のインラインオブジェクトを作成します。

Type: HRESULT

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

省略記号は、ベースフォント、スタイル、および各種効果を含むフォーマットの現在の設定を使用して作成されます。別の省略のしるしは、IDWriteInlineObject を実装することでアプリケーション側で作成できます。

テキスト解析を実行するためのインターフェイスを返します。

Type: HRESULT

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

ロケール名、置換方法、およびユーザーによる上書きを無視するかどうか(無視する場合は、指定したカルチャに対する NLS の既定値を使用する)を示すフラグを使用して、数字置換オブジェクトを作成します。

Type: HRESULT

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

グリフランのレンダリングに使用される情報をカプセル化する、グリフラン解析オブジェクトを作成します。(IDWriteFactory.CreateGlyphRunAnalysis)

Type: HRESULT

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

グリフラン解析オブジェクトには、すべてのグリフの位置や、フォントキャッシュ内のラスタライズ済みのすべてのグリフへの参照を含む、グリフランの解析結果が格納されます。

例

次のコード例は、グリフラン解析オブジェクトを作成する方法を示します。この例では、空のグリフランを使用しています。

HRESULT CreateGlyphRunAnalysis(IDWriteFontFace *pFontFace, IDWriteGlyphRunAnalysis **ppGlyphRunAnalysis)
{
    HRESULT hr = S_OK;
    IDWriteFactory* pDWriteFactory = NULL;

    // Create the DirectWrite factory.
    hr = DWriteCreateFactory(
            DWRITE_FACTORY_TYPE_SHARED,
            __uuidof(IDWriteFactory),
            reinterpret_cast<IUnknown**>(&pDWriteFactory)
            );

    DWRITE_GLYPH_RUN emptyGlyphRun = { 0 };
    UINT16 glyphIndex = 0;
    
    emptyGlyphRun.fontFace = pFontFace;
    emptyGlyphRun.glyphIndices = &glyphIndex;
    emptyGlyphRun.glyphCount = 0;
   
    emptyGlyphRun.fontEmSize = 12;

    IDWriteGlyphRunAnalysis* pGlyphRunAnalysis = NULL;

    if (SUCCEEDED(hr))
    {
        hr = pDWriteFactory->CreateGlyphRunAnalysis(
            &emptyGlyphRun,
            1.0f, // pixelsPerDip,
            NULL, // transform,
            DWRITE_RENDERING_MODE_CLEARTYPE_GDI_CLASSIC,
            DWRITE_MEASURING_MODE_GDI_CLASSIC,
            0.0f, // baselineOriginX,
            0.0f, // baselineOriginY,
            &pGlyphRunAnalysis);
    }
    
    *ppGlyphRunAnalysis = pGlyphRunAnalysis;

    SafeRelease(&pDWriteFactory);

    return S_OK;
}