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*

對應至對應字型的文字長度。 如果文字長度不是零) 則一律小於或等於文字長度，且大於零 (，因此呼叫者會前進至少一個字元。

[out] mappedFont

類型： IDWriteFont**

應該用來呈現文字第一個 mappedLength 字元的字型。 如果傳回 NULL，這表示沒有字型可以轉譯文字，而 mappedLength 是略過 (以遺漏字元) 轉譯的字元數。

[out] scale

類型： FLOAT*

縮放比例，將傳回字型的 em 大小乘以 。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

規格需求

需求 值
最低支援的用戶端 Windows 8.1 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 R2 [僅限傳統型應用程式]
目標平台 Windows
標頭 dwrite_2.h
程式庫 Dwrite.lib
Dll Dwrite.dll

另請參閱

IDWriteFontFallback