Метод IOleDocumentView::Show (docobj.h)

Статья
02/26/2024

Активирует или деактивирует представление.

Синтаксис

HRESULT Show(
  [in] BOOL fShow
);

Параметры

[in] fShow

Если задано значение TRUE, представление будет отображаться. Если значение FALSE, представление будет скрывать себя.

Возвращаемое значение

Этот метод возвращает значение S_OK при успешном завершении. Другие возможные возвращаемые значения включают следующее.

Код возврата	Описание
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 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	docobj.h