Metodo IDWriteFontFallback::MapCharacters (dwrite_2.h)

Articolo
02/26/2024

Determina un tipo di carattere appropriato da usare per eseguire il rendering dell'intervallo iniziale di testo.

Sintassi

HRESULT MapCharacters(
                 IDWriteTextAnalysisSource *analysisSource,
                 UINT32                    textPosition,
                 UINT32                    textLength,
  [in, optional] IDWriteFontCollection     *baseFontCollection,
  [in, optional] wchar_t const             *baseFamilyName,
                 DWRITE_FONT_WEIGHT        baseWeight,
                 DWRITE_FONT_STYLE         baseStyle,
                 DWRITE_FONT_STRETCH       baseStretch,
  [out]          UINT32                    *mappedLength,
  [out]          IDWriteFont               **mappedFont,
  [out]          FLOAT                     *scale
);

Parametri

analysisSource

Tipo: IDWriteTextAnalysisSource*

L'implementazione dell'origine testo contiene il testo e le impostazioni locali.

textPosition

Tipo: UINT32

Posizione iniziale da analizzare.

textLength

Tipo: UINT32

Lunghezza del testo da analizzare.

[in, optional] baseFontCollection

Tipo: IDWriteFontCollection*

Raccolta di caratteri predefinita da usare.

[in, optional] baseFamilyName

Tipo: const wchar_t*

Nome della famiglia del tipo di carattere di base. Se si passa null, non verrà eseguita alcuna corrispondenza contro la famiglia.

baseWeight

Tipo: DWRITE_FONT_WEIGHT

Peso desiderato.

baseStyle

Tipo: DWRITE_FONT_STYLE

Stile desiderato.

baseStretch

Tipo: DWRITE_FONT_STRETCH

Estensione desiderata.

[out] mappedLength

Tipo: UINT32*

Lunghezza del testo mappato al tipo di carattere mappato. Questa operazione sarà sempre minore o uguale alla lunghezza del testo e maggiore di zero (se la lunghezza del testo non è zero) in modo che il chiamante avanza almeno un carattere.

[out] mappedFont

Tipo: IDWriteFont**

Tipo di carattere che deve essere usato per eseguire il rendering dei primi caratteri mappatiLength del testo. Se restituisce NULL, ciò significa che nessun tipo di carattere può eseguire il rendering del testo e mappingdLength è il numero di caratteri da ignorare (sottoposto a rendering con un glifo mancante).

[out] scale

Tipo: FLOAT*

Fattore di scala per moltiplicare le dimensioni em del tipo di carattere restituito da.

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 8.1 [solo app desktop]
Server minimo supportato	Windows Server 2012 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	dwrite_2.h
Libreria	Dwrite.lib
DLL	Dwrite.dll

Vedi anche

IDWriteFontFallback

Condividi tramite