Metodo IDWriteTextAnalyzer::GetGlyphPlacements (dwrite.h)
Places output degli glifi dal metodo GetGlyphs in base al tipo di carattere e alle regole di rendering del sistema di scrittura.
Sintassi
HRESULT GetGlyphPlacements(
[in] WCHAR const *textString,
[in] UINT16 const *clusterMap,
[in] DWRITE_SHAPING_TEXT_PROPERTIES *textProps,
UINT32 textLength,
[in] UINT16 const *glyphIndices,
[in] DWRITE_SHAPING_GLYPH_PROPERTIES const *glyphProps,
UINT32 glyphCount,
IDWriteFontFace *fontFace,
FLOAT fontEmSize,
BOOL isSideways,
BOOL isRightToLeft,
[in] DWRITE_SCRIPT_ANALYSIS const *scriptAnalysis,
[in, optional] WCHAR const *localeName,
[in, optional] DWRITE_TYPOGRAPHIC_FEATURES const **features,
[in, optional] UINT32 const *featureRangeLengths,
UINT32 featureRanges,
[out] FLOAT *glyphAdvances,
[out] DWRITE_GLYPH_OFFSET *glyphOffsets
);
Parametri
[in] textString
Tipo: const WCHAR*
Matrice di caratteri contenente la stringa originale da cui sono venuti glifi.
[in] clusterMap
Tipo: const UINT16*
Puntatore al mapping da intervalli di caratteri a intervalli di glifi. Viene restituito da GetGlyphs.
[in] textProps
Tipo: DWRITE_SHAPING_TEXT_PROPERTIES*
Puntatore a una matrice di strutture che contiene le proprietà di forma per ogni carattere. Questa struttura viene restituita da GetGlyphs.
textLength
Tipo: UINT32
Lunghezza del testo di textString.
[in] glyphIndices
Tipo: const UINT16*
Matrice di indici glifi restituiti da GetGlyphs.
[in] glyphProps
Tipo: const DWRITE_SHAPING_GLYPH_PROPERTIES*
Puntatore a una matrice di strutture che contengono proprietà di forma per ogni glifo restituito da GetGlyphs.
glyphCount
Tipo: UINT32
Numero di glifi restituiti da GetGlyphs.
fontFace
Tipo: IDWriteFontFace*
Puntatore al viso del tipo di carattere che rappresenta l'origine per glifi di output.
fontEmSize
Tipo: FLOAT
Dimensioni dei caratteri logici in INDIRIZZI DIP.
isSideways
Tipo: BOOL
Flag booleano impostato su TRUE se il testo deve essere disegnato verticalmente.
isRightToLeft
Tipo: BOOL
Flag booleano impostato su TRUE per il testo da destra a sinistra.
[in] scriptAnalysis
Tipo: const DWRITE_SCRIPT_ANALYSIS*
Puntatore a un'analisi script risultante da una chiamata AnalysisScript .
[in, optional] localeName
Tipo: const WCHAR*
Matrice di caratteri contenenti le impostazioni locali da usare quando si selezionano glifi. Ad esempio, lo stesso carattere può essere mappato a glifi diversi per ja-jp rispetto a zh-chs. Se si tratta di NULL, viene usato il mapping predefinito in base allo script.
[in, optional] features
Tipo: const DWRITE_TYPOGRAPHIC_FEATURES**
Matrice di puntatori ai set di funzionalità tipografiche da usare in ogni intervallo di funzionalità.
[in, optional] featureRangeLengths
Tipo: const UINT32*
Lunghezza di ogni intervallo di funzionalità, in caratteri.
La somma di tutte le lunghezze deve essere uguale a textLength.
featureRanges
Tipo: UINT32
Numero di intervalli di funzionalità.
[out] glyphAdvances
Tipo: FLOAT*
Quando questo metodo restituisce, contiene la larghezza avanzata di ogni glifo.
[out] glyphOffsets
Tipo: DWRITE_GLYPH_OFFSET*
Quando questo metodo restituisce, contiene l'offset dell'origine di ogni glifo.
Valore restituito
Tipo: HRESULT
Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | dwrite.h |
| Libreria | Dwrite.lib |
| DLL | Dwrite.dll |