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 memerah teks terlepas dari kuas dan latar belakang yang dipilih. GrayString menggunakan font yang saat ini dipilih untuk konteks perangkat yang ditentukan.

Jika thelpOutputFuncparameter 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.

Sintaksis

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 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 null, lpData harus menjadi penunjuk ke string yang akan dihasilkan.

[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 mencakup string.

[in] nWidth

Lebar, dalam unit perangkat, dari persegi panjang yang mengapit 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.

Mengembalikan nilai

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 berwarna abu-abu, nilai yang dikembalikan adalah nol.

Komentar

Tanpa memanggil GrayString, aplikasi dapat menggambar string abu-abu pada perangkat yang mendukung warna abu-abu solid. Warna sistem COLOR_GRAYTEXT adalah warna sistem solid-gray yang digunakan untuk menggambar teks yang dinonaktifkan. Aplikasi ini 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.

Persyaratan

Lihat juga

DrawText

GetSysColor

OutputProc

Fungsi Lukis dan Gambar

Gambaran Umum Lukisan dan Gambaran

SetTextColor

tabbedTextOut

TextOut