IOleObject::GetExtent method (oleidl.h)

Artikel
03/15/2023

Mengambil ukuran tampilan objek yang sedang berjalan.

Sintaks

HRESULT GetExtent(
  [in]  DWORD dwDrawAspect,
  [out] SIZEL *psizel
);

Parameter

[in] dwDrawAspect

Aspek objek yang batasnya akan diambil; nilai diperoleh dari enumerasi DVASPECT dan dari 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. Nilai yang paling umum untuk metode ini adalah DVASPECT_CONTENT, yang menentukan penyajian penuh objek dalam kontainernya.

[out] psizel

Penunjuk ke tempat ukuran objek akan dikembalikan.

Nilai kembali

Metode ini mengembalikan S_OK pada keberhasilan. Kemungkinan nilai pengembalian lainnya termasuk yang berikut ini.

Menampilkan kode	Deskripsi
E_INVALIDARG	Nilai dwDrawAspect yang disediakan tidak valid.

Keterangan

Kontainer memanggil IOleObject::GetExtent pada objek yang sedang berjalan untuk mengambil ukuran tampilannya saat ini. Jika kontainer dapat mengakomodasi ukuran tersebut, biasanya akan melakukannya karena objek , setelah semua, tahu ukuran apa yang harus lebih baik daripada kontainer. Kontainer biasanya melakukan panggilan ini sebagai bagian dari menginisialisasi objek.

Ukuran tampilan yang dikembalikan oleh IOleObject::GetExtent mungkin berbeda dari ukuran yang terakhir diatur oleh IOleObject::SetExtent karena metode terakhir menentukan ruang tampilan objek pada saat metode dipanggil tetapi tidak selalu mengubah ukuran asli objek, seperti yang ditentukan oleh aplikasinya.

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

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

Catatan untuk Penelepon

Karena kontainer dapat melakukan panggilan ini hanya ke objek yang sedang berjalan, kontainer harus memanggil IViewObject2::GetExtent jika ingin mendapatkan ukuran tampilan objek yang dimuat dari cache-nya.

Catatan untuk Pelaksana

Implementasi terdiri dari mengisi struktur ukuran dengan tinggi dan lebar objek.

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