IDWriteFontFallback::MapCharacters-Methode (dwrite_2.h)

Artikel
08/23/2023

Bestimmt eine geeignete Schriftart, die zum Rendern des Anfangstextbereichs verwendet werden soll.

Syntax

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
);

Parameter

analysisSource

Typ: IDWriteTextAnalysisSource*

Die Textquellenimplementierung enthält den Text und das Gebietsschema.

textPosition

Typ: UINT32

Zu analysierende Startposition.

textLength

Typ: UINT32

Länge des zu analysierenden Texts.

[in, optional] baseFontCollection

Typ: IDWriteFontCollection*

Zu verwendende Standardschriftartensammlung.

[in, optional] baseFamilyName

Typ: const wchar_t*

Familienname der Basisschriftart. Wenn Sie NULL übergeben, wird kein Abgleich mit der Familie durchgeführt.

baseWeight

Typ: DWRITE_FONT_WEIGHT

Die gewünschte Gewichtung.

baseStyle

Typ: DWRITE_FONT_STYLE

Der gewünschte Stil.

baseStretch

Typ: DWRITE_FONT_STRETCH

Die gewünschte Dehnung.

[out] mappedLength

Typ: UINT32*

Länge des Texts, der der zugeordneten Schriftart zugeordnet ist. Dies ist immer kleiner oder gleich der Textlänge und größer als 0 (wenn die Textlänge ungleich 0 ist), sodass der Aufrufer mindestens ein Zeichen voranschreitet.

[out] mappedFont

Typ: IDWriteFont**

Die Schriftart, die zum Rendern der ersten zugeordnetenLength-Zeichen des Texts verwendet werden soll. Wenn NULL zurückgegeben wird, bedeutet dies, dass keine Schriftart den Text rendern kann, und mappedLength ist die Anzahl der zu überspringenden Zeichen (gerendert mit einer fehlenden Glyphe).

[out] scale

Typ: FLOAT*

Skalierungsfaktor, um die Em-Größe der zurückgegebenen Schriftart mit zu multiplizieren.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8.1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	dwrite_2.h
Bibliothek	Dwrite.lib
DLL	Dwrite.dll

Weitere Informationen

IDWriteFontFallback

Freigeben über