Metode IOleDocumentView::SetRectComplex (docobj.h)

Artikel
08/23/2023

Mengatur koordinat persegi panjang dari viewport, bilah gulir, dan kotak ukuran.

Sintaks

HRESULT SetRectComplex(
  [in] LPRECT prcView,
  [in] LPRECT prcHScroll,
  [in] LPRECT prcVScroll,
  [in] LPRECT prcSizeBox
);

Parameter

[in] prcView

Penunjuk ke struktur RECT yang berisi koordinat viewport.

[in] prcHScroll

Penunjuk ke struktur RECT yang berisi koordinat bilah gulir horizontal.

[in] prcVScroll

Penunjuk ke struktur RECT yang berisi koordinat bilah gulir vertikal.

[in] prcSizeBox

Penunjuk ke struktur RECT yang berisi koordinat kotak ukuran.

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.
E_NOTIMPL	Objek dokumen yang memiliki tampilan ini tidak mendukung persegi panjang yang kompleks.

Keterangan

Tampilkan bingkai yang mendukung metafora buku kerja, di mana satu dokumen terdiri dari beberapa lembar atau halaman, biasanya panggil metode ini untuk mengatur koordinat yang akan digunakan bersama oleh semua lembar atau halaman.

Catatan untuk Penelepon

Memanggil IOleDocumentView::SetRectComplex adalah bagian dari urutan aktivasi normal untuk objek dokumen yang mendukung persegi panjang kompleks, 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::SetRectComplex atau IOleDocumentView::SetRect untuk memberi tahu objek tampilan untuk mengubah ukuran dirinya ke dimensi jendela baru.

Catatan untuk Pelaksana

Objek dokumen yang mendukung persegi panjang kompleks menandai diri mereka dengan DOCMISC_SUPPORTCOMPLEXRECTANGLES, seperti yang dijelaskan dalam DOCMISC dan IOleDocument::GetDocMiscStatus. Objek dokumen yang tidak mendukung metode ini dapat mengembalikan E_NOTIMPL.

Setelah menerima panggilan ke metode ini, tampilan harus mengubah ukuran dirinya sendiri agar sesuai dengan koordinat yang ditentukan dalam prcView dan pas dengan bilah gulir dan kotak ukurannya ke area yang dijelaskan dalam prcHScroll, prcVScroll, dan prcSizeBox.

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

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

IOleDocument::GetDocMiscStatus

IOleDocumentView

Bagikan melalui