Método IDWriteFontFallback::MapCharacters (dwrite_2.h)

  • Artigo

Determina uma fonte apropriada a ser usada para renderizar o intervalo inicial de texto.

Sintaxe

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*

A implementação da fonte de texto contém o texto e a localidade.

textPosition

Tipo: UINT32

Posição inicial a ser analisada.

textLength

Tipo: UINT32

Comprimento do texto a ser analisado.

[in, optional] baseFontCollection

Tipo: IDWriteFontCollection*

Coleção de fontes padrão a ser usada.

[in, optional] baseFamilyName

Tipo: const wchar_t*

Nome da família da fonte base. Se você passar nulo, nenhuma correspondência será feita em relação à família.

baseWeight

Tipo: DWRITE_FONT_WEIGHT

O peso desejado.

baseStyle

Tipo: DWRITE_FONT_STYLE

O estilo desejado.

baseStretch

Tipo: DWRITE_FONT_STRETCH

O trecho desejado.

[out] mappedLength

Tipo: UINT32*

Comprimento do texto mapeado para a fonte mapeada. Isso sempre será menor ou igual ao comprimento do texto e maior que zero (se o comprimento do texto for diferente de zero) para que o chamador avance pelo menos um caractere.

[out] mappedFont

Tipo: IDWriteFont**

A fonte que deve ser usada para renderizar os primeiros caracteres mappedLength do texto. Se ele retornar NULL, isso significa que nenhuma fonte pode renderizar o texto e mappedLength é o número de caracteres a serem ignorados (renderizado com um glifo ausente).

[out] scale

Tipo: FLOAT*

Fator de escala para multiplicar o tamanho em da fonte retornada por.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8.1 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho dwrite_2.h
Biblioteca Dwrite.lib
DLL Dwrite.dll

Confira também

IDWriteFontFallback