GetThemeTextExtent-Funktion (uxtheme.h)

Berechnet die Größe und Position des angegebenen Texts, wenn er in der Schriftart des visuellen Stils gerendert wird.

Syntax

HRESULT GetThemeTextExtent(
  [in]  HTHEME  hTheme,
  [in]  HDC     hdc,
  [in]  int     iPartId,
  [in]  int     iStateId,
  [in]  LPCWSTR pszText,
  [in]  int     cchCharCount,
  [in]  DWORD   dwTextFlags,
  [in]  LPCRECT pBoundingRect,
  [out] LPRECT  pExtentRect
);

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, in dem die Schriftart ausgewählt werden soll.

[in] iPartId

Typ: int

Der Wert vom Typ int , der den Teil angibt, in dem der Text gezeichnet wird. 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] pszText

Typ: LPCWSTR

Zeiger auf eine Zeichenfolge, die den zu zeichnenden Text enthält.

[in] cchCharCount

Typ: int

Wert des Typs int , der die Anzahl der zu zeichnenden Zeichen enthält. Wenn der Parameter auf -1 festgelegt ist, werden alle Zeichen in der Zeichenfolge gezeichnet.

[in] dwTextFlags

Typ: DWORD

DWORD , das einen oder mehrere Werte enthält, die die Formatierung der Zeichenfolge angeben. Mögliche Parameterwerte finden Sie unter Formatwerte .

[in] pBoundingRect

Typ: LPCRECT

Zeiger auf eine RECT-Struktur , die das Rechteck enthält, das zum Steuern des Layouts des Texts verwendet wird. Dieser Parameter kann auf NULL festgelegt werden.

[out] pExtentRect

Typ: LPRECT

Zeiger auf eine RECT-Struktur , die in logischen Koordinaten das Rechteck enthält, das zum Anpassen des gerenderten Texts erforderlich ist.

Rückgabewert

Typ: HRESULT

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

Anforderungen

Anforderung	Wert
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