Metode IOleDocumentView::SetRect (docobj.h)

Mengatur koordinat persegi panjang dari viewport tempat tampilan akan diaktifkan atau mengatur ulang koordinat viewport tempat tampilan saat ini diaktifkan.

Sintaks

HRESULT SetRect(
  [in] LPRECT prcView
);

Parameter

[in] prcView

Penunjuk ke struktur RECT yang berisi koordinat viewport.

Nilai kembali

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

Menampilkan kode	Deskripsi
E_FAIL	Operasi gagal.

Keterangan

Untuk aplikasi antarmuka dokumen tunggal (SDI), viewport adalah area klien jendela bingkai dikurangi ruang yang dialokasikan untuk toolbar, bilah status, dan semacamnya. Untuk jendela antarmuka beberapa dokumen (MDI), viewport adalah area klien jendela dokumen MDI dikurangi elemen antarmuka pengguna tingkat bingkai lainnya.

Catatan untuk Penelepon

Memanggil IOleDocumentView::SetRect atau IOleDocumentView::SetRectComplex adalah bagian dari urutan aktivasi normal untuk objek dokumen, biasanya mengikuti panggilan ke IOleDocumentView::UIActivate dan mendahului panggilan ke IOleDocumentView::Show.

Setiap kali jendela yang digunakan untuk menampilkan objek dokumen diubah ukurannya, kontainer harus memanggil IOleDocumentView::SetRect (atau IOleDocumentView::SetRectComplex) untuk memberi tahu objek tampilan dokumen untuk mengubah ukuran dirinya ke dimensi jendela baru.

Catatan untuk Pelaksana

Koordinat viewport berada dalam koordinat jendela tampilan, yang diperoleh melalui IOleWindow::GetWindow. Tampilan harus mengubah ukuran dirinya sendiri agar sesuai dengan koordinat baru yang diteruskan dalam prcView.

Metode ini didefinisikan dengan atribut [input_sync], yang berarti bahwa objek tampilan tidak dapat menghasilkan atau membuat panggilan RPC lain yang tidak input_sync saat menjalankan metode ini.

Tampilan dokumen harus menerapkan metode ini sepenuhnya; E_NOTIMPL bukan nilai pengembalian yang dapat diterima.

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

Lihat juga

IOleDocumentView