Metodo IDWriteTextAnalyzer1::GetTextComplexity (dwrite_1.h)

Articolo
03/05/2024

Determina la complessità del testo e se è necessario chiamare IDWriteTextAnalyzer::GetGlyphs per il data shaping completo dello script.

Sintassi

HRESULT GetTextComplexity(
  [in]            WCHAR const     *textString,
                  UINT32          textLength,
                  IDWriteFontFace *fontFace,
  [out]           BOOL            *isTextSimple,
  [out]           UINT32          *textLengthRead,
  [out, optional] UINT16          *glyphIndices
);

Parametri

[in] textString

Tipo: const WCHAR*

Testo da verificare per la complessità. Questa stringa può essere UTF-16, ma tutti i caratteri supplementari verranno considerati complessi.

textLength

Tipo: UINT32

Lunghezza del testo da controllare.

fontFace

Tipo: IDWriteFontFace*

Carattere da leggere.

[out] isTextSimple

Tipo: BOOL*

Se true, il testo è semplice e la matrice glyphIndices avrà già i glifi nominale. In caso contrario, è necessario chiamare IDWriteTextAnalyzer::GetGlyphs per definire correttamente script complessi e funzionalità OpenType.

[out] textLengthRead

Tipo: UINT32*

Lunghezza della lettura del testo eseguita con la stessa complessità, semplice o complessa. È possibile chiamare di nuovo da quel punto in poi.

[out, optional] glyphIndices

Tipo: UINT16*

Indici di glifi facoltativi per il testo. Se la funzione ha restituito che il testo era semplice, sono già disponibili i glifi necessari. In caso contrario, gli indici del glifo non sono significativi ed è necessario chiamare IDWriteTextAnalyzer::GetGlyphs per la modellazione .

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Il testo non è semplice se i caratteri fanno parte di uno script con requisiti di data shaping complessi, richiedono l'analisi bidi, si combinano con altri caratteri, risiedono nei piani supplementari o dispongono di glifi che fanno parte di funzionalità OpenType standard. La lunghezza restituita non dividerà i segni di combinazione dai caratteri di base.

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.lib
DLL	Dwrite.dll

Vedi anche

IDWriteTextAnalyzer1

IDWriteTextAnalyzer::GetGlyphs

Condividi tramite