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 |