Método IDWriteFontFace1::GetKerningPairAdjustments (dwrite_1.h)
Recupera os ajustes de par de kerning da tabela kern da fonte.
Sintaxe
HRESULT GetKerningPairAdjustments(
UINT32 glyphCount,
[in] UINT16 const *glyphIndices,
[out] INT32 *glyphAdvanceAdjustments
);
Parâmetros
glyphCount
Tipo: UINT32
Número de glifos para os qual recuperar ajustes.
[in] glyphIndices
Tipo: const UINT16*
Uma matriz de IDs de glifo para a qual recuperar ajustes.
[out] glyphAdvanceAdjustments
Tipo: INT32*
Os avanços, retornados em unidades de design de fonte, para cada glifo. O último ajuste de glifo é zero.
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.
Comentários
GetKerningPairAdjustments não é uma substituição direta para GetKerningPairs baseado em caracteres da GDI, mas serve à mesma função, sem que o cliente precise armazená-los em cache localmente. GetKerningPairAdjustments também usa ids de glifo diretamente em vez de caracteres UCS-2 (como a tabela kern realmente os armazena), o que evita o colapso e a ambiguidade do glifo, como o traço e o hífen, ou espaço e espaço sem interrupção.
Fontes mais recentes podem ter apenas kerning gpos em vez do kerning de tabela de pares herdado. Tais fontes, como Gabriola, só retornarão 0 para ajustes. GetKerningPairAdjustments não virtualiza e nivela essas entradas GPOS em pares de kerning.
Você pode obter um benefício de desempenho chamando IDWriteFontFace1::HasKerningPairs para determinar se você precisa chamar GetKerningPairAdjustments. Se você chamou anteriormente IDWriteFontFace1::HasKerningPairs e ele retornou FALSE, você pode evitar chamar GetKerningPairAdjustments porque a fonte não tem entradas de tabela de pares de kerning. Ou seja, nesta situação, uma chamada para GetKerningPairAdjustments seria uma no-op.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8 e Atualização de Plataforma para Windows 7 [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2012 e Atualização de Plataforma para Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | dwrite_1.h |
| Biblioteca | Dwrite_1.lib |
| DLL | Dwrite_1.dll |