Método IDWriteTextLayout::SetFontWeight (dwrite.h)
Define o peso da fonte do texto dentro de um intervalo de texto especificado por uma estrutura DWRITE_TEXT_RANGE .
Sintaxe
HRESULT SetFontWeight(
DWRITE_FONT_WEIGHT fontWeight,
DWRITE_TEXT_RANGE textRange
);
Parâmetros
fontWeight
Tipo: DWRITE_FONT_WEIGHT
A espessura da fonte a ser definida para o texto dentro do intervalo especificado por textRange.
textRange
Tipo: DWRITE_TEXT_RANGE
Intervalo de texto ao qual essa alteração se aplica.
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
O peso da fonte pode ser definido como um dos valores de peso de fonte predefinidos fornecidos na enumeração DWRITE_FONT_WEIGHT ou um inteiro de 1 a 999. Valores fora desse intervalo farão com que o método falhe com um valor retornado E_INVALIDARG .
A ilustração a seguir mostra um exemplo de pesos Normal e UltraBold para a face de tipo Palatino Linotype.
Exemplos
O código a seguir ilustra como definir o peso da fonte como negrito.
// Set the font weight to bold for the entire string.
DWRITE_TEXT_RANGE textRange = {0, cTextLength_};
if (SUCCEEDED(hr))
{
hr = pTextLayout_->SetFontWeight(DWRITE_FONT_WEIGHT_BOLD, textRange);
}
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2008 R2, Windows Server 2008 com SP2 e Platform Update para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | dwrite.h |
| Biblioteca | Dwrite.lib |
| DLL | Dwrite.dll |