IDWriteFontFallback::MapCharacters メソッド (dwrite_2.h)

テキストの開始範囲をレンダリングするために使用する適切なフォントを決定します。

構文

HRESULT MapCharacters(
                 IDWriteTextAnalysisSource *analysisSource,
                 UINT32                    textPosition,
                 UINT32                    textLength,
  [in, optional] IDWriteFontCollection     *baseFontCollection,
  [in, optional] wchar_t const             *baseFamilyName,
                 DWRITE_FONT_WEIGHT        baseWeight,
                 DWRITE_FONT_STYLE         baseStyle,
                 DWRITE_FONT_STRETCH       baseStretch,
  [out]          UINT32                    *mappedLength,
  [out]          IDWriteFont               **mappedFont,
  [out]          FLOAT                     *scale
);

パラメーター

analysisSource

型: IDWriteTextAnalysisSource*

テキスト ソースの実装では、テキストとロケールが保持されます。

textPosition

型: UINT32

分析する開始位置。

textLength

型: UINT32

分析するテキストの長さ。

[in, optional] baseFontCollection

型: IDWriteFontCollection*

使用する既定のフォント コレクション。

[in, optional] baseFamilyName

型: const wchar_t*

基本フォントのファミリ名。 null を渡した場合、ファミリに対する照合は行われません。

baseWeight

種類: DWRITE_FONT_WEIGHT

目的の重み。

baseStyle

種類: DWRITE_FONT_STYLE

目的のスタイル。

baseStretch

種類: DWRITE_FONT_STRETCH

目的のストレッチ。

[out] mappedLength

種類: UINT32*

マップされたフォントにマップされたテキストの長さ。 これは常にテキスト長以下で、0 より大きい (テキストの長さが 0 以外の場合) ので、呼び出し元は少なくとも 1 文字進みます。

[out] mappedFont

型: IDWriteFont**

テキストの最初の mappedLength 文字をレンダリングするために使用するフォント。 NULL を返す場合は、テキストをレンダリングできるフォントがないことを意味し、 mappedLength はスキップする文字数です (不足しているグリフでレンダリングされます)。

[out] scale

型: FLOAT*

返されるフォントの em サイズを乗算する倍率。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

要件

こちらもご覧ください

IDWriteFontFallback