IDWriteFont1::GetUnicodeRanges-Methode (dwrite_1.h)
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 |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
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 |