Fungsi GetObjectW (wingdi.h)

Fungsi GetObject mengambil informasi untuk objek grafis yang ditentukan.

Sintaksis

int GetObjectW(
        HANDLE h,
        int    c,
        LPVOID pv
);

Parameter

h

c

pv

Mengembalikan nilai

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

Komentar

Buffer yang ditunjukkan oleh parameter lpvObject harus cukup besar untuk menerima informasi tentang objek grafis. Bergantung pada objek grafik, fungsi menggunakanBITMAP , DIBSECTION, EXTLOGPEN, LOGBRUSH, LOGFONT, atau struktur LOGPEN, atau hitungan entri tabel (untuk palet logis).

Jika hgdiobj adalah handel ke bitmap yang dibuat dengan memanggilCreateDIBSection , dan buffer yang ditentukan cukup besar, fungsi GetObject mengembalikan struktur DIBSECTION. Selain itu, bmBits anggota struktur BITMAP yang terkandung dalam DIBSECTION akan berisi penunjuk ke nilai 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 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

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	wingdi.h (termasuk Windows.h)
Pustaka	Gdi32.lib
DLL	Gdi32.dll

Lihat juga

BITMAP

CreateDIBSection

DIBSECTION

Fungsi Konteks Perangkat

Gambaran Umum Konteks Perangkat

EXTLOGPEN

GetBitmapBits

GetDIBits

GetPaletteEntries

GetRegionData

LOGBRUSH

LOGFONT

LOGPALETTE

LOGPEN