Fungsi GrayStringA (winuser.h)
Fungsi GrayString menggambar teks abu-abu di lokasi yang ditentukan. Fungsi ini menggambar teks dengan menyalinnya ke dalam bitmap memori, memerah bitmap, lalu menyalin bitmap ke layar. Fungsi ini berwarna abu-abu pada teks terlepas dari kuas dan latar belakang yang dipilih. GrayString menggunakan font yang saat ini dipilih untuk konteks perangkat yang ditentukan.
Jika thelpOutputFuncparameter adalah NULL, GDI menggunakan fungsi TextOut , dan thelpDataparameter diasumsikan sebagai penunjuk ke string karakter untuk menjadi output. Jika karakter yang akan dihasilkan tidak dapat ditangani oleh TextOut (misalnya, string disimpan sebagai bitmap), aplikasi harus menyediakan fungsi outputnya sendiri.
Sintaks
BOOL GrayStringA(
[in] HDC hDC,
[in] HBRUSH hBrush,
[in] GRAYSTRINGPROC lpOutputFunc,
[in] LPARAM lpData,
[in] int nCount,
[in] int X,
[in] int Y,
[in] int nWidth,
[in] int nHeight
);
Parameter
[in] hDC
Handel ke konteks perangkat.
[in] hBrush
Handel ke kuas yang akan digunakan untuk abu-abu. Jika parameter ini NULL, teks berwarna abu-abu dengan kuas yang sama yang digunakan untuk menggambar teks jendela.
[in] lpOutputFunc
Penunjuk ke fungsi yang ditentukan aplikasi yang akan menggambar string, atau, jika TextOut akan digunakan untuk menggambar string, itu adalah penunjuk NULL . Untuk detailnya, lihat fungsi panggilan balik OutputProc .
[in] lpData
Penunjuk ke data yang akan diteruskan ke fungsi output. Jika parameter lpOutputFunc adalah NULL, lpData harus menjadi penunjuk ke string yang akan menjadi output.
[in] nCount
Jumlah karakter yang akan dihasilkan. Jika parameter nCount adalah nol, GrayString menghitung panjang string (dengan asumsi lpData adalah penunjuk ke string). Jika nCount adalah 1 dan fungsi yang ditunjukkan oleh lpOutputFunc mengembalikan FALSE, gambar ditampilkan tetapi tidak berwarna abu-abu.
[in] X
Koordinat x perangkat dari posisi awal persegi panjang yang mengapit string.
[in] Y
Koordinat y perangkat dari posisi awal persegi panjang yang mengapit string.
[in] nWidth
Lebar, dalam unit perangkat, dari persegi panjang yang menyertakan string. Jika parameter ini nol, GrayString menghitung lebar area, dengan asumsi lpData adalah penunjuk ke string.
[in] nHeight
Tinggi, dalam unit perangkat, dari persegi panjang yang mengapit string. Jika parameter ini nol, GrayString menghitung tinggi area, dengan asumsi lpData adalah penunjuk ke string.
Nilai kembali
Jika string digambar, nilai yang dikembalikan bukan nol.
Jika fungsi TextOut atau fungsi output yang ditentukan aplikasi mengembalikan nol, atau memori yang tidak mencukupi untuk membuat bitmap memori untuk abu-abu, nilai yang dikembalikan adalah nol.
Keterangan
Tanpa memanggil GrayString, aplikasi dapat menggambar string abu-abu pada perangkat yang mendukung warna abu-abu padat. Warna sistem COLOR_GRAYTEXT adalah warna sistem solid-abu-abu yang digunakan untuk menggambar teks yang dinonaktifkan. Aplikasi dapat memanggil fungsi GetSysColor untuk mengambil nilai warna COLOR_GRAYTEXT. Jika warna selain nol (hitam), aplikasi dapat memanggil fungsi SetTextColor untuk mengatur warna teks ke nilai warna lalu menggambar string secara langsung. Jika warna yang diambil berwarna hitam, aplikasi harus memanggil GrayString untuk memerah teks.
Catatan
Header winuser.h mendefinisikan GrayString sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | winuser.h (termasuk Windows.h) |
| Pustaka | User32.lib |
| DLL | User32.dll |