IViewObjectEx::Metode GetViewStatus (ocidl.h)

Mengambil informasi tentang keburaman objek, dan aspek gambar apa yang didukung.

Sintaks

HRESULT GetViewStatus(
  [out] DWORD *pdwStatus
);

Parameter

[out] pdwStatus

Penunjuk ke status tampilan. Informasi ini dikembalikan sebagai kombinasi dari nilai enumerasi VIEWSTATUS .

Nilai kembali

Metode ini mengembalikan S_OK pada keberhasilan.

Keterangan

Untuk mengoptimalkan proses menggambar, kontainer harus dapat menentukan apakah objek buram dan apakah memiliki latar belakang yang solid. Tidak perlu menggambar ulang objek yang sepenuhnya ditutupi oleh objek yang benar-benar buram. Operasi lain, seperti menggulir misalnya, juga dapat sangat dioptimalkan jika objek buram dan memiliki latar belakang yang solid.

Metode IViewObjectEx::GetViewStatus mengembalikan apakah objek sepenuhnya buram atau tidak (VIEWSTATUS_OPAQUE bit) dan apakah latar belakangnya padat (VIEWSTATUS_SOLIDBKGND bit). Informasi ini dapat berubah dalam waktu. Objek mungkin buram pada waktu tertentu dan menjadi transparan secara total atau sebagian nanti, misalnya, karena perubahan properti BackStyle. Objek harus memberi tahu situsnya ketika berubah menggunakan IAdviseSinkEx::OnViewStatusChange sehingga situs dapat menyimpan informasi ini untuk akses berkecepatan tinggi.

Objek yang tidak mendukung IViewObjectEx dianggap selalu transparan.

Metode IViewObjectEx::GetViewStatus juga mengembalikan kombinasi bit yang menunjukkan aspek mana yang didukung.

Jika aspek gambar tertentu tidak didukung, semua metode IViewObjectEx mengambil aspek gambar sebagai parameter input harus gagal dan mengembalikan E_INVALIDARG. Metode IViewObjectEx::GetViewStatus memungkinkan kontainer untuk mendapatkan kembali informasi tentang semua aspek gambar dalam satu panggilan cepat. Biasanya set aspek gambar yang didukung tidak boleh berubah seiring waktu. Namun, jika ini tidak terjadi, objek harus memberi tahu kontainernya menggunakan IAdviseSinkEx::OnViewStatusChange.

Aspek gambar mana yang didukung independen dari apakah objek buram, sebagian transparan, atau benar-benar transparan. Secara khusus, objek transparan yang tidak mendukung DVASPECT_TRANSPARENT harus digambar dengan benar selama back to front pass menggunakan DVASPECT_CONTENT. Namun, hal ini kemungkinan akan menghasilkan lebih banyak kedipan.

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

Lihat juga

IAdviseSinkEx::OnViewStatusChange

IViewObjectEx

VIEWSTATUS