Método IDWriteFontFallback::MapCharacters (dwrite_2.h)
Determina una fuente adecuada que se va a usar para representar el intervalo inicial de texto.
Sintaxis
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
);
Parámetros
analysisSource
Tipo: IDWriteTextAnalysisSource*
La implementación del origen de texto contiene el texto y la configuración regional.
textPosition
Tipo: UINT32
Posición inicial que se va a analizar.
textLength
Tipo: UINT32
Longitud del texto que se va a analizar.
[in, optional] baseFontCollection
Tipo: IDWriteFontCollection*
Colección de fuentes predeterminada que se va a usar.
[in, optional] baseFamilyName
Tipo: const wchar_t*
Nombre de familia de la fuente base. Si pasa null, no se realizará ninguna coincidencia con la familia.
baseWeight
Tipo: DWRITE_FONT_WEIGHT
Peso deseado.
baseStyle
Tipo: DWRITE_FONT_STYLE
Estilo deseado.
baseStretch
Tipo: DWRITE_FONT_STRETCH
El tramo deseado.
[out] mappedLength
Tipo: UINT32*
Longitud del texto asignado a la fuente asignada. Esto siempre será menor o igual que la longitud del texto y mayor que cero (si la longitud del texto es distinto de cero), por lo que el autor de la llamada avanza al menos un carácter.
[out] mappedFont
Tipo: IDWriteFont**
Fuente que se debe usar para representar los primeros caracteres mappedLength del texto. Si devuelve NULL, significa que ninguna fuente puede representar el texto y mappedLength es el número de caracteres que se omitirán (representados con un glifo que falta).
[out] scale
Tipo: FLOAT*
Factor de escala para multiplicar el tamaño em de la fuente devuelta por.
Valor devuelto
Tipo: HRESULT
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8.1 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2012 R2 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | dwrite_2.h |
| Library | Dwrite.lib |
| Archivo DLL | Dwrite.dll |