Fungsi GetStockObject (wingdi.h)

Artikel
03/08/2023

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
BLACK_BRUSH	Kuas hitam.
DKGRAY_BRUSH	Kuas abu-abu tua.
DC_BRUSH	Kuas warna solid. Warna defaultnya adalah putih. Warna dapat diubah dengan menggunakan fungsi SetDCBrushColor . Untuk informasi lebih lanjut, lihat bagian Keterangan.
GRAY_BRUSH	Sikat abu-abu.
HOLLOW_BRUSH	Kuas berongga (setara dengan NULL_BRUSH).
LTGRAY_BRUSH	Kuas abu-abu muda.
NULL_BRUSH	Kuas null (setara dengan HOLLOW_BRUSH).
WHITE_BRUSH	Kuas putih.
BLACK_PEN	Pena hitam.
DC_PEN	Warna pena padat. Warna defaultnya adalah hitam. Warna dapat diubah dengan menggunakan fungsi SetDCPenColor . Untuk informasi lebih lanjut, lihat bagian Keterangan.
NULL_PEN	Pena kosong. Pena null tidak menggambar apa-apa.
WHITE_PEN	Pena putih.
ANSI_FIXED_FONT	Font sistem pitch tetap (monospace) Windows.
ANSI_VAR_FONT	Font sistem windows variable-pitch (ruang proporsional).
DEVICE_DEFAULT_FONT	Font yang bergantung pada perangkat.
DEFAULT_GUI_FONT	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.
OEM_FIXED_FONT	Font produsen peralatan asli (OEM) dependen fixed-pitch (monospace).
SYSTEM_FONT	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.
SYSTEM_FIXED_FONT	Font sistem pitch tetap (monospace). Objek stok ini disediakan hanya untuk kompatibilitas dengan versi Windows 16-bit yang lebih lama dari 3.0.
DEFAULT_PALETTE	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