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 |