Freigeben über


IDWriteFontFamily::GetFirstMatchingFont-Methode (dwrite.h)

Ruft die Schriftart ab, die den angegebenen Eigenschaften am besten entspricht.

Syntax

HRESULT GetFirstMatchingFont(
        DWRITE_FONT_WEIGHT  weight,
        DWRITE_FONT_STRETCH stretch,
        DWRITE_FONT_STYLE   style,
  [out] IDWriteFont         **matchingFont
);

Parameter

weight

Typ: DWRITE_FONT_WEIGHT

Ein Wert, der verwendet wird, um einer angeforderten Schriftstärke zu entsprechen.

stretch

Typ: DWRITE_FONT_STRETCH

Ein Wert, der verwendet wird, um einem angeforderten Schriftgrad zu entsprechen.

style

Typ: DWRITE_FONT_STYLE

Ein Wert, der verwendet wird, um einer angeforderten Schriftart zu entsprechen.

[out] matchingFont

Typ: IDWriteFont**

Wenn diese Methode zurückgibt, enthält die Adresse eines Zeigers auf das neu erstellte IDWriteFont-Objekt .

Rückgabewert

Typ: HRESULT

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

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

IDWriteFontFamilie