IViewObjectEx::Metode GetRect (ocidl.h)

Artikel
02/29/2024

Mengambil persegi panjang yang menjelaskan aspek gambar yang diminta.

Sintaks

HRESULT GetRect(
  [in]  DWORD   dwAspect,
  [out] LPRECTL pRect
);

Parameter

[in] dwAspect

Aspek gambar yang diminta.

[out] pRect

Penunjuk ke persegi panjang yang menjelaskan aspek gambar yang diminta.

Nilai kembali

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

Menampilkan kode	Deskripsi
DV_E_DVASPECT	Metode ini tidak mendukung aspek yang ditentukan. Objek tidak mendukung aspek yang diminta atau aspeknya tidak persegi panjang.

Keterangan

Metode ini mengembalikan persegi panjang yang menjelaskan aspek gambar yang ditentukan. Persegi panjang yang dikembalikan berada di unit HIMETRIC , relatif terhadap asal objek. Persegi panjang yang dikembalikan tergantung pada aspek gambar sebagai berikut.

Aspek Menggambar	Deskripsi
DVASPECT_CONTENT	Objek harus mengembalikan persegi panjang pembatas dari seluruh objek. Sudut kiri atas berada di asal objek dan ukurannya sama dengan sejauh yang dikembalikan oleh IViewObject2::GetExtent.
DVASPECT_OPAQUE	Objek dengan wilayah buram persegi panjang harus mengembalikan persegi panjang tersebut. Yang lain harus gagal dan mengembalikan kode kesalahan DV_E_DVASPECT. Jika persegi panjang dikembalikan, dijamin akan benar-benar dikaburkan dengan memanggil IViewObject::D raw untuk aspek tersebut. Kontainer harus menggunakan persegi panjang tersebut untuk memotong bagian buram objek sebelum menggambar objek apa pun di belakangnya selama back to front pass. Jika metode ini gagal pada objek dengan wilayah buram non-persegi panjang, kontainer harus menggambar seluruh objek di bagian belakang ke depan menggunakan aspek DVASPECT_CONTENT.
DVASPECT_TRANSPARENT	Objek harus mengembalikan persegi panjang yang mencakup semua bagian transparan atau tidak teratur. Jika objek tidak memiliki bagian transparan atau tidak teratur, objek dapat mengembalikan DV_E_ASPECT. Kontainer dapat menggunakan persegi panjang ini untuk menentukan apakah ada objek lain yang tumpang tindih dengan bagian transparan dari objek tertentu.

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

Lihat juga

IViewObjectEx

Bagikan melalui