Fungsi GetStockObject (wingdi.h)
Fungsi GetStockObject mengambil handel ke salah satu pena stok, kuas, font, atau palet.
Sintaks
HGDIOBJ GetStockObject(
[in] int i
);
Parameter
[in] i
Jenis objek stok. Parameter ini bisa menjadi salah satu nilai berikut.
| Nilai | Makna |
|---|---|
|
Kuas hitam. |
|
Kuas abu-abu tua. |
|
Kuas warna solid. Warna defaultnya adalah putih. Warna dapat diubah dengan menggunakan fungsi SetDCBrushColor . Untuk informasi lebih lanjut, lihat bagian Keterangan. |
|
Sikat abu-abu. |
|
Kuas berongga (setara dengan NULL_BRUSH). |
|
Kuas abu-abu muda. |
|
Kuas null (setara dengan HOLLOW_BRUSH). |
|
Kuas putih. |
|
Pena hitam. |
|
Warna pena padat. Warna defaultnya adalah hitam. Warna dapat diubah dengan menggunakan fungsi SetDCPenColor . Untuk informasi lebih lanjut, lihat bagian Keterangan. |
|
Pena kosong. Pena null tidak menggambar apa-apa. |
|
Pena putih. |
|
Font sistem pitch tetap (monospace) Windows. |
|
Font sistem windows variable-pitch (ruang proporsional). |
|
Font yang bergantung pada perangkat. |
|
Font default untuk objek antarmuka pengguna seperti menu dan kotak dialog. Tidak disarankan agar Anda menggunakan DEFAULT_GUI_FONT atau SYSTEM_FONT untuk mendapatkan font yang digunakan oleh dialog dan jendela; untuk informasi selengkapnya, lihat bagian keterangan.
Font defaultnya adalah Tahoma. |
|
Font produsen peralatan asli (OEM) dependen fixed-pitch (monospace). |
|
Font sistem. Secara default, sistem menggunakan font sistem untuk menggambar menu, kontrol kotak dialog, dan teks. Tidak disarankan agar Anda menggunakan DEFAULT_GUI_FONT atau SYSTEM_FONT untuk mendapatkan font yang digunakan oleh dialog dan jendela; untuk informasi selengkapnya, lihat bagian keterangan.
Font sistem default adalah Tahoma. |
|
Font sistem pitch tetap (monospace). Objek stok ini disediakan hanya untuk kompatibilitas dengan versi Windows 16-bit yang lebih lama dari 3.0. |
|
Palet default. Palet ini terdiri dari warna statis di palet sistem. |
Mengembalikan nilai
Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke objek logika yang diminta.
Jika fungsi gagal, nilai yang dikembalikan adalah NULL.
Keterangan
Tidak disarankan agar Anda menggunakan metode ini untuk mendapatkan font saat ini yang digunakan oleh dialog dan jendela. Sebagai gantinya, gunakan fungsi SystemParametersInfo dengan parameter SPI_GETNONCLIENTMETRICS untuk mengambil font saat ini. SystemParametersInfo akan memperhitungkan tema saat ini dan menyediakan informasi font untuk dialog keterangan, menu, dan pesan.
Gunakan objek stok DKGRAY_BRUSH, GRAY_BRUSH, dan LTGRAY_BRUSH hanya di jendela dengan gaya CS_HREDRAW dan CS_VREDRAW. Menggunakan sikat stok abu-abu dalam gaya jendela lainnya dapat menyebabkan ketidakselarasan pola kuas setelah jendela dipindahkan atau berukuran. Asal-usul kuas stok tidak dapat disesuaikan.
Objek stok HOLLOW_BRUSH dan NULL_BRUSH setara.
Tidak perlu (tetapi tidak berbahaya) untuk menghapus objek stok dengan memanggil DeleteObject.
Baik DC_BRUSH maupun DC_PEN dapat digunakan secara bergantian dengan objek stok lain seperti BLACK_BRUSH dan BLACK_PEN. Untuk informasi tentang mengambil warna pena atau kuas saat ini, lihat GetDCBrushColor dan GetDCPenColor. Lihat Mengatur Pena atau Warna Kuas untuk contoh warna pengaturan. Fungsi GetStockObject dengan argumen DC_BRUSH atau DC_PEN dapat digunakan secara bergantian dengan fungsi SetDCPenColor dan SetDCBrushColor .
Contoh
Misalnya, lihat Mengatur Pena atau Warna Kuas.
Persyaratan
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | wingdi.h (sertakan Windows.h) |
| Pustaka | Gdi32.lib |
| DLL | Gdi32.dll |