GetThemeFont-Funktion (uxtheme.h)

  • Artikel

Ruft den Wert einer Schriftarteigenschaft ab.

Syntax

HRESULT GetThemeFont(
  [in]  HTHEME   hTheme,
  [in]  HDC      hdc,
  [in]  int      iPartId,
  [in]  int      iStateId,
  [in]  int      iPropId,
  [out] LOGFONTW *pFont
);

Parameter

[in] hTheme

Typ: HTHEME

Handle für die angegebenen Designdaten eines Fensters. Verwenden Sie OpenThemeData , um eine HTHEME zu erstellen.

[in] hdc

Typ: HDC

HDC. Dieser Parameter kann auf NULL festgelegt werden.

[in] iPartId

Typ: int

Der Wert vom Typ int , der den Teil angibt, der die Schriftarteigenschaft enthält. Weitere Informationen finden Sie unter Teile und Zustände.

[in] iStateId

Typ: int

Der Wert vom Typ int , der den Zustand des Teils angibt. Weitere Informationen finden Sie unter Teile und Zustände.

[in] iPropId

Typ: int

Der Wert vom Typ int , der die abzurufende Eigenschaft angibt. Eine Liste der möglichen Werte finden Sie unter Eigenschaftenbezeichner.

[out] pFont

Typ: LOGFONTW*

Zeiger auf eine LOGFONT-Struktur , die den Wert der Schriftarteigenschaft empfängt.

Rückgabewert

Typ: HRESULT

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

Hinweise

Die Schriftart wird für den aktuellen logischen Bildschirm in DPI (Dots per Inch) skaliert.

Wenn die Eigenschaft für den angegebenen Teil und Zustand nicht unterstützt wird, kann E_PROP_ID_UNSUPPORTED zurückgegeben werden.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile uxtheme.h
Bibliothek UxTheme.lib
DLL UxTheme.dll

Weitere Informationen

Eigenschaftsbezeichner