Share via

Metodo IDWriteFont1::GetUnicodeRanges (dwrite_1.h)

  • Articolo

Recupera l'elenco di intervalli di caratteri supportati da un tipo di carattere.

Sintassi

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

Parametri

maxRangeCount

Tipo: UINT32

Numero massimo di intervalli di caratteri passati dal client.

[out, optional] unicodeRanges

Tipo: DWRITE_UNICODE_RANGE*

Matrice di strutture DWRITE_UNICODE_RANGE riempite con gli intervalli di caratteri.

[out] actualRangeCount

Tipo: UINT32*

Puntatore al numero effettivo di intervalli di caratteri, indipendentemente dal conteggio massimo.

Valore restituito

Tipo: HRESULT

Questo metodo può restituire uno di questi valori.

Valore restituito Descrizione
S_OK
 Metodo eseguito correttamente.
E_NOT_SUFFICIENT_BUFFER
 Il buffer è troppo piccolo. ActualRangeCount è maggiore di maxRangeCount.

Commenti

L'elenco di intervalli di caratteri supportati da un tipo di carattere è utile per scenari come selezione di caratteri, visualizzazione glifi e ricerca efficiente della selezione dei tipi di carattere. GetUnicodeRanges è simile a GetFontUnicodeRanges di GDI, ad eccezione del fatto che restituisce l'intervallo Unicode completo, non solo a 16 bit UCS-2.

Questi intervalli provengono da cmap, non dal sistema operativo/2::ulCodePageRange1.

Se questo metodo non è disponibile, è possibile usare il metodo IDWriteFontFace::GetGlyphIndices per verificare la presenza di glifi mancanti. Il metodo restituisce l'indice 0 per glifi che non sono presenti nel tipo di carattere.

Il metodo IDWriteFont::HasCharacter è spesso più semplice nei casi in cui è necessario controllare un singolo carattere o una serie di singoli caratteri in successione, ad esempio nel fallback del tipo di carattere.

Requisiti

Requisito Valore
Client minimo supportato Windows 8 e aggiornamento della piattaforma per Windows 7 [app desktop | App UWP]
Server minimo supportato Windows Server 2012 e aggiornamento della piattaforma per Windows Server 2008 R2 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione dwrite_1.h
Libreria Dwrite_1.lib
DLL Dwrite_1.dll

Vedi anche

IDWriteFont1