Fungsi GetThemeTextExtent (uxtheme.h)

Menghitung ukuran dan lokasi teks yang ditentukan saat dirender dalam font gaya visual.

Sintaks

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

Jenis: HTHEME

Menangani ke data tema yang ditentukan jendela. Gunakan OpenThemeData untuk membuat HTHEME.

[in] hdc

Jenis: HDC

HDC untuk memilih font ke dalamnya.

[in] iPartId

Jenis: int

Nilai tipe int yang menentukan bagian di mana teks akan digambar. Lihat Bagian dan Status.

[in] iStateId

Jenis: int

Nilai tipe int yang menentukan status bagian. Lihat Bagian dan Status.

[in] pszText

Jenis: LPCWSTR

Penunjuk ke string yang berisi teks untuk digambar.

[in] cchCharCount

Jenis: int

Nilai tipe int yang berisi jumlah karakter yang akan digambar. Jika parameter diatur ke -1, semua karakter dalam string akan digambar.

[in] dwTextFlags

Jenis: DWORD

DWORD yang berisi satu atau beberapa nilai yang menentukan pemformatan string. Lihat Memformat Nilai untuk kemungkinan nilai parameter.

[in] pBoundingRect

Jenis: LPCRECT

Penunjuk ke struktur RECT yang berisi persegi panjang yang digunakan untuk mengontrol tata letak teks. Parameter ini dapat diatur ke NULL.

[out] pExtentRect

Jenis: LPRECT

Penunjuk ke struktur RECT yang berisi, dalam koordinat logis, persegi panjang yang diperlukan agar pas dengan teks yang dirender.

Nilai kembali

Jenis: HRESULT

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	uxtheme.h
Pustaka	UxTheme.lib
DLL	UxTheme.dll

Lihat juga

Pengidentifikasi Properti