Metode IOleInPlaceObject::SetObjectRects (oleidl.h)
Menentukan berapa banyak objek di tempat yang akan terlihat.
Sintaks
HRESULT SetObjectRects(
[in] LPCRECT lprcPosRect,
[in] LPCRECT lprcClipRect
);
Parameter
[in] lprcPosRect
Penunjuk ke struktur RECT yang berisi posisi objek di tempat menggunakan koordinat klien dari jendela induknya.
[in] lprcClipRect
Penunjuk ke persegi panjang luar yang berisi persegi panjang posisi objek di tempat (lprcPosRect). Persegi panjang ini relatif terhadap area klien jendela induk objek.
Nilai kembali
Metode ini mengembalikan S_OK pada keberhasilan. Nilai pengembalian lain yang mungkin termasuk yang berikut ini.
Menampilkan kode | Deskripsi |
---|---|
|
Penunjuk yang ditentukan tidak valid. |
|
Tidak tersedia cukup memori untuk operasi ini. |
|
Terjadi kesalahan tidak terduga. |
Keterangan
Dimungkinkan bagi lprcClipRect untuk berubah tanpa lprcPosRect berubah.
Ukuran persegi panjang objek di tempat selalu dihitung dalam piksel. Ini berbeda dari visualisasi objek OLE lainnya, yang ada di HIMETRIC.
Catatan untuk Penelepon
Kontainer harus memanggil IOleInPlaceObject::SetObjectRects setiap kali posisi jendela objek di tempat dan/atau bagian yang terlihat dari objek di tempat berubah.Catatan untuk Pelaksana
Objek harus mengukur jendela di tempatnya agar sesuai dengan persimpangan lprcPosRect dan lprcClipRect. Objek juga harus menggambar isinya ke jendela objek di tempat sehingga kliping yang tepat terjadi.Objek harus membandingkan lebar dan tingginya dengan yang disediakan oleh kontainernya (disampaikan melalui lprcPosRect). Jika perbandingan tidak menghasilkan kecocokan, kontainer menerapkan penskalaan ke objek. Objek kemudian harus memutuskan apakah objek harus melanjutkan pengeditan di tempat dalam mode skala/zoom atau menonaktifkan.
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 |