Freigeben über


IDWriteFontFace1::GetUnicodeRanges-Methode (dwrite_1.h)

Ruft eine Liste von Zeichenbereichen ab, die von einer Schriftart unterstützt werden.

Syntax

HRESULT GetUnicodeRanges(
                  UINT32               maxRangeCount,
  [out, optional] DWRITE_UNICODE_RANGE *unicodeRanges,
  [out]           UINT32               *actualRangeCount
);

Parameter

maxRangeCount

Typ: UINT32

Maximale Anzahl von Zeichenbereichen, die vom Client übergeben wurden.

[out, optional] unicodeRanges

Typ: DWRITE_UNICODE_RANGE*

Ein Array von DWRITE_UNICODE_RANGE Strukturen, die mit den Zeichenbereichen gefüllt sind.

[out] actualRangeCount

Typ: UINT32*

Ein Zeiger auf die tatsächliche Anzahl von Zeichenbereichen, unabhängig von der maximalen Anzahl.

Rückgabewert

Typ: HRESULT

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabewert BESCHREIBUNG
S_OK
Die Methode wurde erfolgreich ausgeführt.
E_NOT_SUFFICIENT_BUFFER
Der Puffer ist zu klein. Der tatsächlicheRangeCount war mehr als maxRangeCount.

Hinweise

Eine Liste von Zeichenbereichen, die von der Schriftart unterstützt werden, ist nützlich für Szenarien wie zeichenauswahl, Glyphenanzeige und effiziente Schriftartauswahlsuche. Dies ähnelt dem GetFontUnicodeRanges von GDI, mit dem Unterschied, dass der vollständige Unicode-Bereich zurückgegeben wird, nicht nur 16-Bit-UCS-2.

Diese Bereiche stammen von der cmap, nicht von OS/2::ulCodePageRange1.

Wenn diese Methode nicht verfügbar ist, können Sie die IDWriteFontFace::GetGlyphIndices-Methode verwenden, um nach fehlenden Glyphen zu suchen. Die -Methode gibt den Index 0 für Glyphen zurück, die in der Schriftart nicht vorhanden sind.

Die IDWriteFont::HasCharacter-Methode ist häufig einfacher, wenn Sie ein einzelnes Zeichen oder eine Reihe einzelner Zeichen nacheinander überprüfen müssen, z. B. im Schriftartenfallback.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile dwrite_1.h
Bibliothek Dwrite_1.lib
DLL Dwrite_1.dll

Weitere Informationen

IDWriteFontFace1