Fungsi DrawThemeTextEx (uxtheme.h)

Menggambar teks menggunakan warna dan font yang ditentukan oleh gaya visual. Memperluas DrawThemeText dengan mengizinkan opsi format teks tambahan.

Sintaks

HRESULT DrawThemeTextEx(
  [in]      HTHEME        hTheme,
  [in]      HDC           hdc,
  [in]      int           iPartId,
  [in]      int           iStateId,
  [in]      LPCWSTR       pszText,
  [in]      int           cchText,
  [in]      DWORD         dwTextFlags,
  [in, out] LPRECT        pRect,
  [in]      const DTTOPTS *pOptions
);

Parameter

[in] hTheme

Jenis: HTHEME

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

[in] hdc

Jenis: HDC

HDC yang digunakan untuk menggambar.

[in] iPartId

Jenis: int

Bagian kontrol yang memiliki tampilan teks yang diinginkan. Lihat Bagian dan Negara Bagian. Jika nilai ini adalah 0, teks digambar dalam font default, atau font yang dipilih ke dalam konteks perangkat.

[in] iStateId

Jenis: int

Status kontrol yang memiliki tampilan teks yang diinginkan. Lihat Bagian dan Negara Bagian.

[in] pszText

Jenis: LPCWSTR

Penunjuk ke string yang berisi teks yang akan digambar.

[in] cchText

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 Format Nilai untuk kemungkinan nilai parameter.

[in, out] pRect

Jenis: LPRECT

Penunjuk ke struktur RECT yang berisi persegi panjang, dalam koordinat logis, di mana teks akan digambar.

[in] pOptions

Jenis: const DTTOPTS*

Struktur DTTOPTS yang menentukan opsi pemformatan tambahan yang akan diterapkan ke teks yang sedang digambar.

Menampilkan nilai

Jenis: HRESULT

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

Keterangan

Fungsi ini selalu menggunakan font bermasalah untuk bagian dan status yang ditentukan jika ditentukan. Jika tidak, ia menggunakan font yang saat ini dipilih ke dalam konteks perangkat. Untuk mengetahui apakah font bertema ditentukan, Anda dapat memanggil GetThemeFont atau GetThemePropertyOrigin dengan TMT_FONT sebagai pengidentifikasi properti.

Persyaratan

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