Condividi tramite


Metodo IDWriteTextLayout::SetFontWeight (dwrite.h)

Imposta lo spessore del carattere per il testo all'interno di un intervallo di testo specificato da una struttura DWRITE_TEXT_RANGE .

Sintassi

HRESULT SetFontWeight(
  DWRITE_FONT_WEIGHT fontWeight,
  DWRITE_TEXT_RANGE  textRange
);

Parametri

fontWeight

Tipo: DWRITE_FONT_WEIGHT

Spessore del carattere da impostare per il testo all'interno dell'intervallo specificato da textRange.

textRange

Tipo: DWRITE_TEXT_RANGE

Intervallo di testo a cui si applica questa modifica.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Lo spessore del carattere può essere impostato su uno dei valori predefiniti di spessore del carattere forniti nell'enumerazione DWRITE_FONT_WEIGHT o un numero intero compreso tra 1 e 999. I valori esterni a questo intervallo causeranno l'esito negativo del metodo con un valore restituito E_INVALIDARG .

L'illustrazione seguente mostra un esempio di pesi Normal e UltraBold per il carattere tipografico Linotype DiMentino.

Illustrazione della lettera "W" nei pesi Normal e UltraBold

Esempio

Il codice seguente illustra come impostare lo spessore del carattere in grassetto.


// 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);
}


Requisiti

Requisito Valore
Client minimo supportato Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista [app desktop | App UWP]
Server minimo supportato Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione dwrite.h
Libreria Dwrite.lib
DLL Dwrite.dll

Vedi anche

IDWriteTextLayout