IDWriteTextLayout::SetFontWeight-Methode (dwrite.h)

Legt die Schriftstärke für Text in einem Textbereich fest, der von einer DWRITE_TEXT_RANGE-Struktur angegeben wird.

Syntax

HRESULT SetFontWeight(
  DWRITE_FONT_WEIGHT fontWeight,
  DWRITE_TEXT_RANGE  textRange
);

Parameter

fontWeight

Typ: DWRITE_FONT_WEIGHT

Die Schriftartgewichtung, die für Text innerhalb des durch textRange angegebenen Bereichs festgelegt werden soll.

textRange

Typ: DWRITE_TEXT_RANGE

Textbereich, für den diese Änderung gilt.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Die Schriftgewichtung kann auf einen der vordefinierten Schriftgewichtungswerte in der DWRITE_FONT_WEIGHT-Enumeration oder auf eine ganze Zahl von 1 bis 999 festgelegt werden. Werte außerhalb dieses Bereichs führen dazu, dass die Methode mit einem E_INVALIDARG Rückgabewert fehlschlägt.

Die folgende Abbildung zeigt ein Beispiel für Normal- und UltraBold-Gewichte für die Schriftart Palatino Linotype.

Beispiele

Der folgende Code veranschaulicht, wie Sie die Schriftstärke auf Fett festlegen.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	dwrite.h
Bibliothek	Dwrite.lib
DLL	Dwrite.dll

Weitere Informationen

Idwritetextlayout