Fungsi OleDraw (ole2.h)

Artikel
02/29/2024

Memungkinkan menggambar objek dengan lebih mudah. Anda dapat menggunakannya alih-alih memanggil IViewObject::D raw secara langsung.

Sintaks

HRESULT OleDraw(
  [in] LPUNKNOWN pUnknown,
  [in] DWORD     dwAspect,
  [in] HDC       hdcDraw,
  [in] LPCRECT   lprcBounds
);

Parameter

[in] pUnknown

Arahkan ke antarmuka IUnknown pada objek tampilan yang akan digambar.

[in] dwAspect

Bagaimana objek akan diwakili. Representasi mencakup konten, ikon, gambar mini, atau dokumen cetak. Nilai yang mungkin diambil dari enumerasi DVASPECT .

[in] hdcDraw

Konteks perangkat yang akan digambar. Tidak dapat berupa konteks perangkat metafile.

[in] lprcBounds

Penunjuk ke struktur RECT yang menentukan persegi panjang tempat objek harus digambar. Parameter ini dikonversi ke struktur RECTL dan diteruskan ke IViewObject::D raw.

Nilai kembali

Fungsi ini mengembalikan S_OK pada keberhasilan. Nilai lain yang mungkin termasuk yang berikut ini.

Menampilkan kode	Deskripsi
OLE_E_BLANK	Tidak ada data untuk digambar.
E_ABORT	Operasi gambar dibatalkan.
VIEW_E_DRAW	Tidak ada data untuk digambar.
OLE_E_INVALIDRECT	Persegi panjang tidak valid.
E_INVALIDARG	Satu atau beberapa parameter tidak valid.
E_OUTOFMEMORY	Memori untuk operasi tidak cukup.
DV_E_NOIVIEWOBJECT	Objek tidak mendukung antarmuka IViewObject .

Keterangan

Fungsi pembantu OleDraw memanggil metode QueryInterface untuk objek yang ditentukan (pUnk), meminta antarmuka IViewObject pada objek tersebut. Kemudian, OleDraw mengonversi struktur RECT menjadi struktur RECTL , dan memanggil IViewObject::D raw sebagai berikut:

lpViewObj->Draw(dwAspect,-1,0,0,0,hdcDraw,&rectl,0,0,0);

Jangan gunakan fungsi ini untuk menggambar ke dalam metafile karena tidak menentukan parameter yang diperlukan untuk menggambar ke dalam metafiles.

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	ole2.h (termasuk Ole2.h)
Pustaka	Ole32.lib
DLL	Ole32.dll
Set API	ext-ms-win-com-ole32-l1-1-3 (diperkenalkan dalam Windows 10, versi 10.0.10240)

Lihat juga

IViewObject::D raw

Bagikan melalui