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

Vedi anche

IDWriteTextAnalyzer