Struktur DTTOPTS (uxtheme.h)

Menentukan opsi untuk fungsi DrawThemeTextEx .

Sintaks

typedef struct _DTTOPTS {
  DWORD             dwSize;
  DWORD             dwFlags;
  COLORREF          crText;
  COLORREF          crBorder;
  COLORREF          crShadow;
  int               iTextShadowType;
  POINT             ptShadowOffset;
  int               iBorderSize;
  int               iFontPropId;
  int               iColorPropId;
  int               iStateId;
  BOOL              fApplyOverlay;
  int               iGlowSize;
  DTT_CALLBACK_PROC pfnDrawTextCallback;
  LPARAM            lParam;
} DTTOPTS, *PDTTOPTS;

Anggota

dwSize

Jenis: DWORD

Ukuran struktur.

dwFlags

Jenis: DWORD

Kombinasi bendera yang menentukan apakah nilai tertentu dari struktur DTTOPTS telah ditentukan, dan cara menginterpretasikan nilai-nilai ini. Anggota ini bisa menjadi kombinasi dari berikut ini.

Nilai	Makna
DTT_TEXTCOLOR	Nilai anggota crText valid.
DTT_BORDERCOLOR	Nilai anggota crBorder valid.
DTT_SHADOWCOLOR	Nilai anggota crShadow valid.
DTT_SHADOWTYPE	Nilai anggota iTextShadowType valid.
DTT_SHADOWOFFSET	Nilai anggota ptShadowOffset valid.
DTT_BORDERSIZE	Nilai anggota iBorderSize valid.
DTT_FONTPROP	Nilai anggota iFontPropId valid.
DTT_COLORPROP	Nilai anggota iColorPropId valid.
DTT_STATEID	Nilai anggota iStateId valid.
DTT_CALCRECT	Parameter pRect dari fungsi DrawThemeTextEx yang menggunakan struktur ini akan digunakan sebagai parameter masuk dan keluar. Setelah fungsi kembali, parameter pRect akan berisi persegi panjang yang sesuai dengan wilayah yang dihitung untuk digambar.
DTT_APPLYOVERLAY	Nilai anggota fApplyOverlay valid.
DTT_GLOWSIZE	Nilai anggota iGlowSize valid.
DTT_CALLBACK	Nilai anggota pfnDrawTextCallback valid.
DTT_COMPOSITED	Menggambar teks dengan alfa yang diantisipasi. Penggunaan bendera ini memerlukan bagian DIB atas-bawah. Bendera ini hanya berfungsi jika HDC yang diteruskan ke fungsi DrawThemeTextEx memiliki bagian DIB atas-bawah yang saat ini dipilih di dalamnya. Untuk informasi selengkapnya, lihat Bitmap Independen Perangkat.
DTT_VALIDBITS	DTT_TEXTCOLOR | DTT_BORDERCOLOR | DTT_SHADOWCOLOR | DTT_SHADOWTYPE | DTT_SHADOWOFFSET | DTT_BORDERSIZE | DTT_FONTPROP | DTT_COLORPROP | DTT_STATEID | DTT_CALCRECT | DTT_APPLYOVERLAY | DTT_GLOWSIZE | DTT_COMPOSITED.

crText

Jenis: COLORREF

Menentukan warna teks yang akan digambar.

crBorder

Jenis: COLORREF

Menentukan warna kerangka yang akan digambar di sekitar teks.

crShadow

Jenis: COLORREF

Menentukan warna bayangan yang akan digambar di belakang teks.

iTextShadowType

Jenis: int

Menentukan jenis bayangan yang akan digambar di belakang teks. Anggota ini bisa memiliki salah satu nilai berikut.

Nilai	Makna
TST_NONE	Tidak ada bayangan yang akan digambar.
TST_SINGLE	Bayangan akan digambar agar tampak terperinci di bawah teks.
TST_CONTINUOUS	Bayangan akan digambar agar tampak kabur di bawah teks.

ptShadowOffset

Jenis: TITIK

Menentukan jumlah offset, dalam koordinat logis, antara bayangan dan teks.

iBorderSize

Jenis: int

Menentukan radius kerangka yang akan digambar di sekitar teks.

iFontPropId

Jenis: int

Menentukan properti font alternatif yang akan digunakan saat menggambar teks. Untuk daftar nilai yang mungkin, lihat GetThemeSysFont.

iColorPropId

Jenis: int

Menentukan properti warna alternatif yang akan digunakan saat menggambar teks. Jika nilai ini valid dan bendera yang sesuai diatur dalam dwFlags, nilai ini akan menggantikan nilai crText. Lihat nilai yang tercantum di GetSysColor untuk parameter nIndex .

iStateId

Jenis: int

Menentukan status alternatif yang akan digunakan. Anggota ini tidak digunakan oleh DrawThemeTextEx.

fApplyOverlay

Jenis: BOOL

Jika TRUE, teks akan digambar di atas efek bayangan dan kerangka. Jika FALSE, hanya efek bayangan dan kerangka yang akan digambar.

iGlowSize

Jenis: int

Menentukan ukuran cahaya yang akan digambar di latar belakang sebelum teks apa pun digambar.

pfnDrawTextCallback

Jenis: DTT_CALLBACK_PROC

Penunjuk ke fungsi panggilan balik untuk DrawThemeTextEx.

lParam

Jenis: LPARAM

Parameter untuk fungsi panggilan balik yang ditentukan oleh pfnDrawTextCallback.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Header	uxtheme.h