Metode IViewObject2::GetExtent (oleidl.h)

Artikel
03/01/2024

Mengambil ukuran objek tampilan yang ditentukan akan digambar pada perangkat target yang ditentukan.

Sintaks

HRESULT GetExtent(
  [in]  DWORD          dwDrawAspect,
  [in]  LONG           lindex,
  [in]  DVTARGETDEVICE *ptd,
  [out] LPSIZEL        lpsizel
);

Parameter

[in] dwDrawAspect

Tampilan objek yang diminta yang ukurannya menarik. Nilai yang mungkin diambil dari DVASPECT dan enumerasi DVASPECT2 . Perhatikan bahwa objek dan kontainer yang lebih baru yang mendukung antarmuka gambar yang dioptimalkan mendukung nilai enumerasi DVASPECT2 . Objek dan kontainer lama yang tidak mendukung antarmuka gambar yang dioptimalkan mungkin tidak mendukung DVASPECT2.

[in] lindex

Bagian dari objek yang menarik. Saat ini, satu-satunya nilai yang mungkin adalah -1.

[in] ptd

Penunjuk ke struktur DVTARGETDEVICE yang menentukan perangkat target yang ukuran objeknya harus dikembalikan.

[out] lpsizel

Penunjuk ke tempat ukuran objek dikembalikan.

Nilai kembali

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

Menampilkan kode	Deskripsi
OLE_E_BLANK	Cache yang sesuai tidak tersedia.

Keterangan

Implementasi IViewObject2::GetExtent yang disediakan OLE mencari cache untuk ukuran objek tampilan.

Metode IOleObject::GetExtent di antarmuka IOleObject menyediakan beberapa informasi yang sama dengan IViewObject2::GetExtent.

Metode ini harus mengembalikan ukuran yang sama dengan DVASPECT_CONTENT untuk semua aspek baru dalam DVASPECT2. IOleObject::GetExtent harus melakukan hal yang sama.

Jika salah satu aspek baru diminta dalam dwAspect, metode ini dapat gagal atau mengembalikan persegi panjang yang sama seperti untuk aspek DVASPECT_CONTENT.

Catatan untuk Penelepon

Untuk mencegah objek dijalankan jika belum berjalan, Anda dapat memanggil IViewObject2::GetExtent daripada IOleObject::GetExtent untuk menentukan ukuran presentasi yang akan digambar.

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	oleidl.h
DLL	Adhocreportingexcelclient.dll