IOleDocumentView::Tampilkan metode (docobj.h)

Artikel
03/13/2024

Mengaktifkan atau menonaktifkan tampilan.

Sintaks

HRESULT Show(
  [in] BOOL fShow
);

Parameter

[in] fShow

Jika TRUE, tampilannya adalah menampilkan dirinya sendiri. Jika FALSE, tampilannya adalah menyembunyikan dirinya sendiri.

Nilai kembali

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

Menampilkan kode	Deskripsi
E_FAIL	Operasi gagal.
E_OUTOFMEMORY	Memori tidak cukup tersedia untuk operasi.
E_UNEXPECTED	Terjadi kesalahan tak terduga.

Keterangan

Peragaan Panggilan adalah langkah terakhir dalam urutan aktivasi, karena sebelum menunjukkan dirinya objek dokumen harus tahu persis ruang apa yang ditempatinya dan memiliki semua alatnya yang tersedia.

Catatan untuk Penelepon

Panggilan ke metode ini untuk tujuan mengaktifkan tampilan harus mengikuti panggilan ke IOleDocumentView::SetInPlaceSite, IOleDocumentView::UIActivate, dan IOleDocumentView::SetRect (atau IOleDocumentView::SetRectComplex).

Catatan untuk Pelaksana

Implementasi metode ini harus mewujudkan pseudocode berikut.

if (fShow)
    {
    In-place activate the view but do not UI activate it.
    Show the view window. 
    }
else
    {
    Call IOleDocumentView::UIActivate(FALSE) on this view
    Hide the view window
    }

Semua tampilan objek dokumen setidaknya harus mendukung aktivasi di tempat; E_NOTIMPL bukan nilai 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