IOleDocumentView：：Show 方法 (docobj.h)

發行項
03/05/2024

啟動或停用檢視。

語法

HRESULT Show(
  [in] BOOL fShow
);

參數

[in] fShow

如果 為TRUE，則檢視會自行顯示。如果 為 FALSE，則檢視會隱藏本身。

傳回值

此方法會在成功時傳回S_OK。其他可能的傳回值包括下列專案。

傳回碼	Description
E_FAIL	作業失敗。
E_OUTOFMEMORY	記憶體不足，無法運作。
E_UNEXPECTED	發生意外錯誤。

備註

呼叫 Show 是啟用順序的最後一個步驟，因為在顯示文件物件之前，檔對象必須確切知道它佔用的空間，並具有其所有可用的工具。

來電者的附註

為了啟用檢視的目的呼叫此方法，應該遵循呼叫 IOleDocumentView：：SetInPlaceSite、 IOleDocumentView：：UIActivate 和 IOleDocumentView：：SetRect (或 IOleDocumentView：：SetRectComplex) 。

實作者的注意事項

此方法的實作應該包含下列虛擬程式碼。

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
    }

文件物件的所有檢視至少都必須支援就地啟用;E_NOTIMPL不是可接受的值。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	docobj.h