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 |
---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
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 |