Compartilhar via


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.

Ilustração da letra "W" em pesos Normal e UltraBold

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

Confira também

IDWriteTextLayout