Fungsi DrawStateA (winuser.h)

Artikel
11/20/2024

Fungsi DrawState menampilkan gambar dan menerapkan efek visual untuk menunjukkan status, seperti status dinonaktifkan atau default.

Sintaksis

BOOL DrawStateA(
  [in] HDC           hdc,
  [in] HBRUSH        hbrFore,
  [in] DRAWSTATEPROC qfnCallBack,
  [in] LPARAM        lData,
  [in] WPARAM        wData,
  [in] int           x,
  [in] int           y,
  [in] int           cx,
  [in] int           cy,
  [in] UINT          uFlags
);

Parameter

[in] hdc

Handel ke konteks perangkat untuk menggambar.

[in] hbrFore

Handel ke kuas yang digunakan untuk menggambar gambar, jika status yang ditentukan oleh parameter fuFlags DSS_MONO. Parameter ini diabaikan untuk status lain.

[in] qfnCallBack

Penunjuk ke fungsi panggilan balik yang ditentukan aplikasi yang digunakan untuk merender gambar. Parameter ini diperlukan jika jenis gambar di fuFlags DST_COMPLEX. Ini bersifat opsional dan dapat NULL jika jenis gambar DST_TEXT. Untuk semua jenis gambar lainnya, parameter ini diabaikan. Untuk informasi selengkapnya tentang fungsi panggilan balik, lihat fungsi DrawStateProc.

[in] lData

Informasi tentang gambar. Arti parameter ini tergantung pada jenis gambar.

[in] wData

Informasi tentang gambar. Arti parameter ini tergantung pada jenis gambar. Namun, nol diperluas untuk digunakan dengan fungsi DrawStateProc.

[in] x

Lokasi horizontal, dalam unit perangkat, untuk menggambar gambar.

[in] y

Lokasi vertikal, dalam unit perangkat, untuk menggambar gambar.

[in] cx

Lebar gambar, dalam unit perangkat. Parameter ini diperlukan jika jenis gambar DST_COMPLEX. Jika tidak, bisa nol untuk menghitung lebar gambar.

[in] cy

Tinggi gambar, dalam unit perangkat. Parameter ini diperlukan jika jenis gambar DST_COMPLEX. Jika tidak, bisa nol untuk menghitung tinggi gambar.

[in] uFlags

Jenis dan status gambar. Parameter ini bisa menjadi salah satu nilai jenis berikut.

Nilai (jenis)	Arti
DST_BITMAP	Gambar adalah bitmap. Parameter lData adalah handel bitmap. Perhatikan bahwa bitmap belum dapat dipilih ke dalam konteks perangkat yang ada.
DST_COMPLEX	Gambar adalah aplikasi yang ditentukan. Untuk merender gambar, DrawState memanggil fungsi panggilan balik yang ditentukan oleh parameter lpOutputFunc .
DST_ICON	Gambar adalah ikon. Parameter lData adalah handel ikon.
DST_PREFIXTEXT	Gambar adalah teks yang mungkin berisi mnemonic akselerator. DrawState menafsirkan karakter awalan ampersand (&) sebagai arahan untuk menggarisbawahi karakter berikut. Parameter lData adalah penunjuk ke string, dan parameter wData menentukan panjangnya. Jika wData adalah nol, string harus dihentikan null.
DST_TEXT	Gambarnya adalah teks. Parameter lData adalah penunjuk ke string, dan parameter wData menentukan panjangnya. Jika wData adalah nol, string harus dihentikan null.

Parameter ini juga bisa menjadi salah satu nilai status berikut.

Nilai (status)	Arti
DSS_DISABLED	Timbul gambar.
DSS_HIDEPREFIX	Mengabaikan karakter awalan ampersand (&) dalam teks, sehingga huruf berikut tidak akan digarisbawahi. Ini harus digunakan dengan DST_PREFIXTEXT.
DSS_MONO	Menggambar gambar menggunakan kuas yang ditentukan oleh parameter hbr.
DSS_NORMAL	Gambar tanpa modifikasi apa pun.
DSS_PREFIXONLY	Hanya menggambar garis bawah pada posisi huruf setelah karakter awalan ampersand (&). Tidak ada teks dalam string yang digambar. Ini harus digunakan dengan DST_PREFIXTEXT.
DSS_RIGHT	Meratakan teks ke kanan.
DSS_UNION	Melenyapkan gambar.

Untuk semua status kecuali DSS_NORMAL, gambar dikonversi ke monokrom sebelum efek visual diterapkan.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Komentar

Nota

Header winuser.h mendefinisikan DrawState sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	winuser.h (termasuk Windows.h)
Pustaka	User32.lib
DLL	User32.dll

Lihat juga

DrawStateProc

Fungsi Lukis dan Gambar

Gambaran Umum Lukisan dan Gambaran

Bagikan melalui