Freigeben über

IDWriteFont1::GetUnicodeRanges-Methode (dwrite_1.h)

  • Artikel

Ruft die Liste der Zeichenbereiche 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

Die maximale Anzahl von Zeichenbereichen, die vom Client übergeben werden.

[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

Die Liste der Zeichenbereiche, die von einer Schriftart unterstützt werden, ist nützlich für Szenarien wie Zeichenauswahl, Glyphenanzeige und effiziente Schriftartauswahlsuche. GetUnicodeRanges ähnelt dem GetFontUnicodeRanges von GDI, mit dem Unterschied, dass es den vollständigen Unicode-Bereich zurückgibt, 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

IDWriteFont1