Fungsi GetObjectW (wingdi.h)
Fungsi GetObject mengambil informasi untuk objek grafis yang ditentukan.
Sintaks
int GetObjectW(
HANDLE h,
int c,
LPVOID pv
);
Parameter
h
c
pv
Nilai kembali
Jika fungsi berhasil, dan lpvObject adalah penunjuk yang valid, nilai yang dikembalikan adalah jumlah byte yang disimpan ke dalam buffer.
Jika fungsi berhasil, dan lpvObject adalah NULL, nilai yang dikembalikan adalah jumlah byte yang diperlukan untuk menyimpan informasi yang akan disimpan fungsi ke dalam buffer.
Jika fungsi gagal, nilai yang dikembalikan adalah nol.
Keterangan
Buffer yang diacu oleh parameter lpvObject harus cukup besar untuk menerima informasi tentang objek grafis. Bergantung pada objek grafis, fungsi ini menggunakan struktur BITMAP, DIBSECTION, EXTLOGPEN, LOGBRUSH, LOGFONT, atau LOGPEN , atau hitungan entri tabel (untuk palet logis).
Jika hgdiobj adalah handel ke bitmap yang dibuat dengan memanggil CreateDIBSection, dan buffer yang ditentukan cukup besar, fungsi GetObject mengembalikan struktur DIBSECTION . Selain itu, anggota bmBits dari struktur BITMAP yang terkandung dalam DIBSECTION akan berisi pointer ke nilai bitmap bitmap.
Jika hgdiobj adalah handel ke bitmap yang dibuat dengan cara lain, GetObject hanya mengembalikan informasi format lebar, tinggi, dan warna bitmap. Anda dapat memperoleh nilai bitmap dengan memanggil fungsi GetDIBits atau GetBitmapBits .
Jika hgdiobj adalah handel ke palet logis, GetObject mengambil bilangan bulat 2-byte yang menentukan jumlah entri dalam palet. Fungsi ini tidak mengambil struktur LOGPALETTE yang menentukan palet. Untuk mengambil informasi tentang entri palet, aplikasi dapat memanggil fungsi GetPaletteEntries .
Jika hgdiobj adalah handel ke font, LOGFONT yang dikembalikan adalah LOGFONT yang digunakan untuk membuat font. Jika Windows harus membuat beberapa interpolasi font karena LOGFONT yang tepat tidak dapat diwakili, interpolasi tidak akan tercermin dalam LOGFONT. Misalnya, jika Anda meminta versi vertikal font yang tidak mendukung lukisan vertikal, LOGFONT menunjukkan font vertikal, tetapi Windows akan melukisnya secara horizontal.
Contoh
Misalnya, lihat Menyimpan Gambar.
Catatan
Header wingdi.h mendefinisikan GetObject 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 | wingdi.h (sertakan Windows.h) |
| Pustaka | Gdi32.lib |
| DLL | Gdi32.dll |