Класс CHtmlView

Предоставляет функциональные возможности элемента управления WebBrowser в контексте архитектуры документов или представлений MFC.

Синтаксис

class CHtmlView : public CFormView

Участники

Открытые методы

Имя	Описание
CHtmlView::Create	Создает элемент управления WebBrowser.
CHtmlView::CreateControlSite	Переопределяемый класс, используемый для создания экземпляра сайта элемента управления для размещения элемента управления на форме.
CHtmlView::ExecFormsCommand	Выполняет указанную команду с помощью метода IOleCommandTarget::Exec .
CHtmlView::ExecWB	Выполняет команду.
CHtmlView::GetAddressBar	Определяет, видима ли адресная строка объекта Internet Explorer. (Элемент управления WebBrowser игнорирует; только Internet Explorer.)
CHtmlView::GetApplication	Возвращает объект приложения, который представляет приложение, содержащее текущий экземпляр приложения Internet Explorer.
CHtmlView::GetBusy	Возвращает значение, указывающее на то, выполняется ли все еще скачивание или другой процесс.
CHtmlView::GetContainer	Возвращает контейнер элемента управления WebBrowser.
CHtmlView::GetFullName	Извлекает полное имя, включая путь ресурса, отображаемого в веб-браузере. (Элемент управления WebBrowser игнорирует; только Internet Explorer.)
CHtmlView::GetFullScreen	Указывает, работает ли элемент управления WebBrowser в полноэкранном режиме или в обычном режиме окна.
CHtmlView::GetHeight	Получает высоту главного окна Internet Explorer.
CHtmlView::GetHtmlDocument	Получает активный документ HTML.
CHtmlView::GetLeft	Получает координату левого края главного окна Internet Explorer.
CHtmlView::GetLocationName	Получает имя ресурса, который в данный момент отображается элементом управления WebBrowser.
CHtmlView::GetLocationURL	Получает URL-адрес ресурса, который в данный момент отображается элементом управления WebBrowser.
CHtmlView::GetMenuBar	Получает значение, указывающее, является ли строка меню видимой.
CHtmlView::GetOffline	Получает значение, указывающее, находится ли элемент управления в автономном режиме.
CHtmlView::GetParentBrowser	Получает указатель на интерфейс IDispatch . Дополнительные сведения см. в IDispatch разделе "Реализация интерфейса".
CHtmlView::GetProperty	Возвращает текущее значение свойства, связанного с данным объектом.
CHtmlView::GetReadyState	Получает состояние готовности объекта веб-браузера.
CHtmlView::GetRegisterAsBrowser	Указывает, зарегистрирован ли элемент управления WebBrowser в качестве браузера верхнего уровня для разрешения целевых имен.
CHtmlView::GetRegisterAsDropTarget	Указывает, зарегистрирован ли элемент управления WebBrowser в качестве целевого объекта перетаскивания для навигации.
CHtmlView::GetSilent	Указывает, могут ли отображаться какие-либо диалоговые окна.
CHtmlView::GetSource	Исходный код HTML веб-страницы.
CHtmlView::GetStatusBar	Указывает, является ли строка состояния Internet Explorer видимой. (Элемент управления WebBrowser игнорирует; только Internet Explorer.)
CHtmlView::GetTheaterMode	Указывает, находится ли элемент управления WebBrowser в режиме театра.
CHtmlView::GetToolBar	Получает значение, указывающее, является ли панель инструментов видимой.
CHtmlView::GetTop	Получает координату верхнего края главного окна Internet Explorer.
CHtmlView::GetTopLevelContainer	Получает значение, указывающее, является ли текущий объект контейнером верхнего уровня для элемента управления WebBrowser.
CHtmlView::GetType	Получает имя типа объекта документа.
CHtmlView::GetVisible	Получает значение, указывающее, является ли объект видимым или скрытым.
CHtmlView::GetWidth	Получает ширину главного окна Internet Explorer.
CHtmlView::GoBack	Переходит к предыдущему элементу в списке журнала.
CHtmlView::GoForward	Переходит к следующему элементу в списке журнала.
CHtmlView::GoHome	Переходит к текущей домашней или начальной странице.
CHtmlView::GoSearch	Переходит к текущей странице поиска.
CHtmlView::LoadFromResource	Загружает ресурс в элементе управления WebBrowser.
CHtmlView::Navigate	Переходит к ресурсу, определяемому URL-адресом.
CHtmlView::Navigate2	Переходит к ресурсу, определяемому URL-адресом, или файлу, определяемому полным путем.
CHtmlView::OnBeforeNavigate2	Вызывается перед операцией навигации в заданном webBrowser (в элементе окна или набора кадров).
CHtmlView::OnCommandStateChange	Вызывается для уведомления приложения о том, что состояние выполнения команды веб-браузера изменилось.
CHtmlView::OnDocumentComplete	Вызывается для уведомления приложения о том, что документ достиг состояния READYSTATE_COMPLETE .
CHtmlView::OnDocWindowActivate	Вызывается из реализации IOleInPlaceActiveObject::OnDocWindowActivateInternet Explorer или MSHTML, которая уведомляет активный объект на месте при активации или деактивации окна документа контейнера.
CHtmlView::OnDownloadBegin	Вызывается для уведомления приложения о том, что начинается операция перехода.
CHtmlView::OnDownloadComplete	Вызывается, когда операция перехода закончилась, была остановлена или завершилась с ошибкой.
CHtmlView::OnEnableModeless	Вызывается для включения или отключения безрежимных диалоговых окон, когда контейнер создает или уничтожает модальное диалоговое окно.
CHtmlView::OnFilterDataObject	Вызывается Internet Explorer или MSHTML в основном приложении, чтобы разрешить ему заменить объект данных Internet Explorer или MSHTML.
CHtmlView::OnFrameWindowActivate	Вызывается для IOleInPlaceActiveObject::OnFrameWindowActivate уведомления объекта о активации или деактивации окна кадра верхнего уровня контейнера.
CHtmlView::OnFullScreen	Вызывается при FullScreen изменении свойства.
CHtmlView::OnGetDropTarget	Вызывается Internet Explorer или MSHTML при использовании в качестве целевого объекта удаления, чтобы разрешить узлу предоставлять альтернативу IDropTarget.
CHtmlView::OnGetExternal	Вызывается Internet Explorer или MSHTML для получения интерфейса IDispatch основного приложения.
CHtmlView::OnGetHostInfo	Возвращает возможности пользовательского интерфейса основного приложения Internet Explorer или MSHTML.
CHtmlView::OnGetOptionKeyPath	Возвращает раздел реестра, в котором хранятся пользовательские настройки Internet Explorer или MSHTML.
CHtmlView::OnHideUI	Вызывается при удалении меню и панелей инструментов Internet Explorer или MSHTML.
CHtmlView::OnMenuBar	Вызывается при MenuBar изменении свойства.
CHtmlView::OnNavigateComplete2	Вызывается после завершения навигации по гиперссылке (в элементе окна или набора кадров).
CHtmlView::OnNavigateError	Вызывается платформой, если переход по гиперссылке завершается ошибкой.
CHtmlView::OnNewWindow2	Вызывается, если для отображения ресурса должно быть создано окно.
CHtmlView::OnProgressChange	Вызывается для уведомления приложения о том, что ход операции скачивания был обновлен.
CHtmlView::OnPropertyChange	Вызывается для уведомления приложения о том, что PutProperty метод изменил значение свойства.
CHtmlView::OnQuit	Вызывается для уведомления приложения о том, что приложение Internet Explorer готово закрыться. (Применяется только в Internet Explorer.)
CHtmlView::OnResizeBorder	Вызывается из реализации IOleInPlaceActiveObject::ResizeBorderInternet Explorer или MSHTML, которая оповещает объект, который необходимо изменить размер пространства границы.
CHtmlView::OnShowContextMenu	Вызывается из Internet Explorer или MSHTML, когда будет отображаться контекстное меню.
CHtmlView::OnShowUI	Вызывается перед отображением меню и панелей инструментов в Internet Explorer или MSHTML.
CHtmlView::OnStatusBar	Вызывается при StatusBar изменении свойства.
CHtmlView::OnStatusTextChange	Вызывается для уведомления приложения о том, что текст строки состояния, связанной с элементом управления WebBrowser, изменился.
CHtmlView::OnTheaterMode	Вызывается при TheaterMode изменении свойства.
CHtmlView::OnTitleChange	Вызывается для уведомления приложения о том, что заголовок документа в элементе управления WebBrowser стал доступен или изменился.
CHtmlView::OnToolBar	Вызывается при ToolBar изменении свойства.
CHtmlView::OnTranslateAccelerator	Вызывается Internet Explorer или MSHTML, когда IOleInPlaceActiveObject::TranslateAccelerator или IOleControlSite::TranslateAccelerator вызывается для обработки сообщений акселератора ключей меню из очереди сообщений контейнера.
CHtmlView::OnTranslateUrl	Вызывается Internet Explorer или MSHTML, чтобы разрешить основному приложению изменять URL-адрес, который нужно загрузить.
CHtmlView::OnUpdateUI	Уведомляет основное приложение об изменении состояния команды.
CHtmlView::OnVisible	Вызывается, когда окно элемента управления WebBrowser должно быть показано или скрыто.
CHtmlView::PutProperty	Задает значение свойства, связанного с данным объектом.
CHtmlView::QueryFormsCommand	Запрашивает состояние одной или нескольких команд, созданных событиями пользовательского интерфейса.
CHtmlView::QueryStatusWB	Запрашивает состояние команды, обрабатываемой элементом управления WebBrowser.
CHtmlView::Refresh	Перезагружает текущий файл.
CHtmlView::Refresh2	Перезагружает текущий файл и при необходимости блокирует отправку заголовка pragma:nocache .
CHtmlView::SetAddressBar	Отображает или скрывает адресную строку объекта Internet Explorer. (Элемент управления WebBrowser игнорирует; только Internet Explorer.)
CHtmlView::SetFullScreen	Задает значение, которое указывает, работает ли элемент управления в полноэкранном режиме или в обычном режиме окна. (Элемент управления WebBrowser игнорирует; только Internet Explorer.)
CHtmlView::SetHeight	Задает высоту главного окна Internet Explorer.
CHtmlView::SetLeft	Задает положение главного окна Internet Explorer по горизонтали.
CHtmlView::SetMenuBar	Задает значение, указывающее, является ли строка меню элемента управления видимой. (Элемент управления WebBrowser игнорирует; только Internet Explorer.)
CHtmlView::SetOffline	Задает значение, указывающее, находится ли элемент управления в автономном режиме.
CHtmlView::SetRegisterAsBrowser	Задает значение, которое указывает, зарегистрирован ли элемент управления WebBrowser в качестве браузера верхнего уровня для разрешения целевых имен.
CHtmlView::SetRegisterAsDropTarget	Задает значение, которое указывает, зарегистрирован ли элемент управления WebBrowser в качестве целевого объекта перетаскивания для навигации.
CHtmlView::SetSilent	Задает значение, указывающее, будет ли элемент управления выводить диалоговые окна.
CHtmlView::SetStatusBar	Задает значение, которое указывает, является ли строка состояния Internet Explorer видимой. (Элемент управления WebBrowser игнорирует; только Internet Explorer.)
CHtmlView::SetTheaterMode	Задает значение, которое указывает, находится ли элемент управления WebBrowser в режиме театра.
CHtmlView::SetToolBar	Задает значение, указывающее, является ли панель инструментов элемента управления видимой. (Элемент управления WebBrowser игнорирует; только Internet Explorer.)
CHtmlView::SetTop	Задает положение главного окна Internet Explorer по вертикали.
CHtmlView::SetVisible	Задает значение, указывающее, является ли объект видимым или скрытым.
CHtmlView::SetWidth	Задает ширину главного окна Internet Explorer.
CHtmlView::Stop	Останавливает открытие файла.

Замечания

Элемент управления WebBrowser — это окно, в котором пользователь может просматривать сайты в Интернете, а также папки в локальной файловой системе и в сети. Элемент управления WebBrowser поддерживает гиперссылки и переход по URL-адресам. Кроме того, в нем ведется список журнала.

CHtmlView Использование класса в приложении MFC

В стандартном приложении платформы MFC (на основе SDI или MDI) объект представления обычно является производным от специального набора классов. Эти классы, производные от CView, предоставляют специальные возможности, которые отсутствуют у класса CView.

Если класс представления приложения основан на CHtmlView , представление обеспечивается элементом управления WebBrowser. Это фактически делает приложение веб-браузером. Предпочтительным способом создания приложений в стиле веб-браузера является использование мастера приложений MFC и указание CHtmlView в качестве класса представления. Дополнительные сведения о реализации и использовании элемента управления WebBrowser в приложениях MFC см. в разделе Создание приложения в стиле веб-браузера.

Примечание.

Элемент ActiveX WebBrowser (и, следовательно, CHtmlView) доступен только для программ, выполняемых под управлением ОС Windows NT версии 4.0 или более поздней, в которой установлен Internet Explorer 4.0 или более поздней версии.

CHtmlView предназначен для приложений, получающих доступ к Интернету (или документам HTML). Перечисленные ниже функции-члены CHtmlView относятся только к приложению Internet Explorer. Эти функции будут успешно работать в элементе управления WebBrowser, но они не будут иметь видимого эффекта.

• GetAddressBar
• GetFullName
• GetStatusBar
• SetAddressBar
• SetFullScreen
• SetMenuBar
• SetStatusBar
• SetToolBar

Иерархия наследования

CObject
CCmdTarget
CWnd
CView
CScrollView
CFormView

CHtmlView

Требования

Заголовок: afxhtml.h

CHtmlView::Create

Вызовите эту функцию-член, чтобы создать элемент управления WebBrowser или контейнер для исполняемого файла Internet Explorer.

virtual BOOL Create(
    LPCTSTR lpszClassName,
    LPCTSTR lpszWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    CCreateContext* pContext = NULL);

Параметры

lpszClassName
Указывает на строку символов, завершающую значение NULL, которая называет класс Windows. Имя класса может быть любым именем, зарегистрированным в глобальной AfxRegisterWndClass функции или RegisterClass функции Windows. Если NULLиспользует предопределенные атрибуты по умолчанию CFrameWnd .

lpszWindowName
Указывает на строку символов, завершающую значение NULL, представляющую имя окна.

dwStyle
Задает атрибуты стиля окна. По умолчанию WS_VISIBLE WS_CHILD задаются стили Windows.

rect
Ссылка на RECT структуру, указывающую размер и положение окна. Значение rectDefault позволяет Windows указать размер и положение нового окна.

pParentWnd
Указатель на родительское окно элемента управления.

nID
Идентификатор представления. По умолчанию значение равно AFX_IDW_PANE_FIRST.

pContext
Указатель на объект CCreateContext. По умолчанию: NULL.

CHtmlView::CreateControlSite

Переопределяемый класс, используемый для создания экземпляра сайта элемента управления для размещения элемента управления на форме.

virtual BOOL CreateControlSite(
    COleControlContainer* pContainer,
    COleControlSite** ppSite,
    UINT nID,
    REFCLSID clsid);

Параметры

pContainer
Указатель на COleControlContainer объект, содержащий элемент управления.

ppSite
Указатель на указатель на COleControlSite объект, предоставляющий сайт для элемента управления.

nID
Идентификатор размещенного элемента управления.

clsid
CLSID элемента управления для размещения

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

Возвращает успешность TRUE при FALSE сбое.

Замечания

Эту функцию-член можно переопределить, чтобы вернуть экземпляр собственного класса сайта управления.

CHtmlView::ExecFormsCommand

Выполняет указанную команду с помощью метода IOleCommandTarget::Exec .

HRESULT ExecFormsCommand(
    DWORD dwCommandID,
    VARIANT* pVarIn,
    VARIANT* pVarOut);

Параметры

dwCommandID
Команда для выполнения. Эта команда должна принадлежать CMDSETID3_Forms3 группе.

pVarIn
Указатель на структуру VARIANT , содержащую входные аргументы. Может иметь значение NULL.

pVarOut
Указатель на структуру для получения выходных VARIANT данных команды. Может иметь значение NULL.

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

Стандартное значение HRESULT . Полный список возможных значений см IOleCommandTarget::Exec . в пакете SDK для Windows.

Замечания

ExecFormsCommand реализует поведение IOleCommandTarget::Exec метода.

CHtmlView::ExecWB

Вызовите эту функцию-член, чтобы выполнить команду в WebBrowser или Internet Explorer.

void ExecWB(
    OLECMDID cmdID,
    OLECMDEXECOPT cmdexecopt,
    VARIANT* pvaIn,
    VARIANT* pvaOut);

Параметры

cmdID
Команда для выполнения.

cmdexecopt
Параметры, заданные для выполнения команды.

pvaIn
Вариант, используемый для указания аргументов ввода команд.

pvaOut
Вариант, используемый для указания аргументов выходных данных команд.

Замечания

См IWebBrowser2::ExecWB . в пакете SDK для Windows.

CHtmlView::GetAddressBar

Вызовите эту функцию-член, чтобы получить адресную строку Internet Explorer.

BOOL GetAddressBar() const;

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

Ненулевое значение, если адресная строка видна; в противном случае ноль.

Замечания

Применимо к Internet Explorer. Если этот вызов используется с элементом управления WebBrowser, он не вернет ошибки, но он будет игнорировать этот вызов.

CHtmlView::GetApplication

Вызовите эту функцию-член, чтобы получить объект автоматизации, поддерживаемый приложением, содержащим элемент управления WebBrowser.

LPDISPATCH GetApplication() const;

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

Указатель на IDispatch интерфейс активного объекта документа. Дополнительные сведения см. в IDispatch разделе "Реализация интерфейса".

Замечания

Применяется в Internet Explorer и WebBrowser.

CHtmlView::GetBusy

Вызовите эту функцию-член, чтобы определить, участвует ли элемент управления WebBrowser в операции навигации или загрузки.

BOOL GetBusy() const;

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

Ненулевое значение, если веб-браузер занят; в противном случае ноль.

Замечания

Применяется в Internet Explorer и WebBrowser.

CHtmlView::GetContainer

Вызовите эту функцию-член, чтобы получить объект, который оценивает контейнер веб-браузера.

LPDISPATCH GetContainer() const;

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

Указатель на IDispatch интерфейс активного объекта документа.

Замечания

Применяется в Internet Explorer и WebBrowser.

CHtmlView::GetFullName

Вызовите эту функцию-член, чтобы получить полный путь к файлу, который в настоящее время отображается Internet Explorer.

CString GetFullName() const;

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

CString Объект, содержащий путь и имя отображаемого файла. Если путь и имя файла не существуют, GetFullName возвращает пустое CStringзначение.

Замечания

Применимо к Internet Explorer. Если этот вызов используется с элементом управления WebBrowser, он не вернет ошибки, но он будет игнорировать этот вызов.

CHtmlView::GetFullScreen

Вызовите эту функцию-член, чтобы определить, работает ли элемент управления WebBrowser в полноэкранном режиме или в обычном режиме окна.

BOOL GetFullScreen() const;

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

Ненулевое значение, если WebBrowser работает в полноэкранном режиме; в противном случае ноль.

Замечания

В полноэкранном режиме основное окно Internet Explorer развернуто, а строка состояния, панель инструментов, панель меню и заголовок скрыты.

Применяется в Internet Explorer и WebBrowser.

CHtmlView::GetHeight

Вызовите эту функцию-член, чтобы получить высоту в пикселях окна фреймов элемента управления WebBrowser.

long GetHeight() const;

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

Высота окна окна элемента управления в пикселях.

CHtmlView::GetHtmlDocument

Вызовите эту функцию-член, чтобы получить HTML-документ для активного документа.

LPDISPATCH GetHtmlDocument() const;

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

Указатель на IDispatch интерфейс активного объекта документа.

Замечания

Применяется в Internet Explorer и WebBrowser.

CHtmlView::GetLeft

Вызовите эту функцию-член, чтобы получить расстояние между внутренним левым краем элемента управления WebBrowser и левым краем контейнера.

long GetLeft() const;

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

Расстояние слева от края в пикселях.

Замечания

Применяется в Internet Explorer и WebBrowser.

CHtmlView::GetLocationName

Вызовите эту функцию-член, чтобы получить имя ресурса, отображаемого в WebBrowser.

CString GetLocationName() const;

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

Объект CString , содержащий имя ресурса, отображаемого в webBrowser.

Замечания

Если ресурс является HTML-страницей в World Wide Web, это имя является заголовком этой страницы. Если ресурс является папкой или файлом на сетевом или локальном компьютере, это имя UNC или полный путь к папке или файлу.

Применяется в Internet Explorer и WebBrowser.

CHtmlView::GetLocationURL

Вызовите эту функцию-член, чтобы получить URL-адрес ресурса, отображаемого элементом управления WebBrowser.

CString GetLocationURL() const;

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

CString Объект, содержащий URL-адрес ресурса, отображаемого в webBrowser.

Замечания

Если ресурс является папкой или файлом на сетевом или локальном компьютере, это имя UNC или полный путь к папке или файлу.

Применяется в Internet Explorer и WebBrowser.

CHtmlView::GetMenuBar

Вызовите эту функцию-член, чтобы определить, отображается ли строка меню.

BOOL GetMenuBar() const;

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

Ненулевое значение, если отображается строка меню; в противном случае ноль.

Замечания

Применяется в Internet Explorer и WebBrowser.

CHtmlView::GetOffline

Вызовите эту функцию-член, чтобы определить, работает ли веб-браузер в автономном режиме.

BOOL GetOffline() const;

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

Ненулевое значение, если веб-браузер в настоящее время находится в автономном режиме; в противном случае ноль.

Замечания

Применяется в Internet Explorer и WebBrowser.

CHtmlView::GetParentBrowser

Вызовите эту функцию-член, чтобы получить указатель на родительский объект элемента управления WebBrowser.

LPDISPATCH GetParentBrowser() const;

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

Указатель на IDispatch интерфейс объекта, который является родительским элементом элемента управления WebBrowser.

Замечания

Применяется в Internet Explorer и WebBrowser.

CHtmlView::GetProperty

Вызовите эту функцию-член, чтобы получить значение свойства, связанного с элементом управления.

BOOL GetProperty(
    LPCTSTR lpszProperty,
    CString& strValue);

COleVariant GetProperty(LPCTSTR lpszProperty);

Параметры

lpszProperty
Указатель на строку, содержащую свойство для извлечения.

strValue
Ссылка на CString объект, получающий текущее значение свойства.

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

В первой версии ненулевое значение, если выполнено успешно; в противном случае ноль. Во второй версии COleVariant объект.

Замечания

Применяется в Internet Explorer и WebBrowser.

CHtmlView::GetReadyState

Вызовите эту функцию-член, чтобы получить готовое состояние объекта WebBrowser.

READYSTATE GetReadyState() const;

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

READYSTATE Значение, как описано в пакете SDK для Windows.

Замечания

Применяется в Internet Explorer и WebBrowser.

CHtmlView::GetRegisterAsBrowser

Вызовите эту функцию-член, чтобы определить, зарегистрирован ли объект WebBrowser в качестве браузера верхнего уровня для разрешения целевых имен.

BOOL GetRegisterAsBrowser() const;

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

Ненулевое значение, если браузер зарегистрирован в качестве браузера верхнего уровня; в противном случае ноль.

Замечания

Применяется в Internet Explorer и WebBrowser.

CHtmlView::GetRegisterAsDropTarget

Вызовите эту функцию-член, чтобы определить, зарегистрирован ли элемент управления WebBrowser в качестве целевого объекта удаления для навигации.

BOOL GetRegisterAsDropTarget() const;

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

Ненулевое значение, если браузер зарегистрирован в качестве целевого объекта удаления; в противном случае ноль.

Замечания

Применяется в Internet Explorer и WebBrowser.

CHtmlView::GetSilent

Вызовите эту функцию-член, чтобы определить, можно ли отображать любые диалоговые окна в элементе управления WebBrowser.

BOOL GetSilent() const;

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

Ненулевое значение, если диалоговые окна не могут отображаться из элемента управления WebBrowser; в противном случае ноль.

Замечания

Применяется в Internet Explorer и WebBrowser.

CHtmlView::GetSource

Вызовите эту функцию-член, чтобы получить исходный код HTML для веб-страницы.

BOOL GetSource(CString& strRef);

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

Ненулевое значение в случае успеха, иначе — 0.

Параметры

refString
Объект, CString который будет содержать исходный код.

Замечания

Эта функция эквивалентна команде View Source в Internet Explorer, за исключением того, что исходный код возвращается в объекте CString.

CHtmlView::GetStatusBar

Вызовите эту функцию-член, чтобы определить, отображает ли элемент управления WebBrowser строку состояния.

BOOL GetStatusBar() const;

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

Ненулевое значение, если можно отобразить строку состояния; в противном случае ноль.

Замечания

Применимо к Internet Explorer. Если этот вызов используется с элементом управления WebBrowser, он не вернет ошибки, но он будет игнорировать этот вызов.

CHtmlView::GetTheaterMode

Вызовите эту функцию-член, чтобы определить, находится ли веб-браузер в режиме театра.

BOOL GetTheaterMode() const;

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

Ненулевое значение, если веб-браузер находится в режиме театра; в противном случае ноль.

Замечания

Когда веб-браузер находится в режиме театра, главное окно браузера заполняет весь экран, панель инструментов с минимальным набором средств навигации отображается, а строка состояния отображается в правом верхнем углу экрана.

Применяется в Internet Explorer и WebBrowser.

CHtmlView::GetToolBar

Вызовите эту функцию-член, чтобы определить, отображается ли панель инструментов.

int GetToolBar() const;

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

Значение, указывающее, отображается ли панель инструментов. Ненулевое значение, если панель инструментов видна; в противном случае ноль.

CHtmlView::GetTop

Вызовите эту функцию-член, чтобы получить координату экрана верхнего края главного окна элемента управления WebBrowser.

long GetTop() const;

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

Адрес переменной, которая получает координату экрана верхнего края главного окна.

Замечания

Применяется в Internet Explorer и WebBrowser.

CHtmlView::GetTopLevelContainer

Вызовите эту функцию-член, чтобы определить, является ли Internet Explorer контейнером верхнего уровня элемента управления WebBrowser.

BOOL GetTopLevelContainer() const;

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

Контейнер ненулевого уровня является контейнером верхнего уровня; в противном случае ноль.

Замечания

Применяется в Internet Explorer и WebBrowser.

CHtmlView::GetType

Вызовите эту функцию-член, чтобы получить имя типа содержащегося активного документа.

CString GetType() const;

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

CString Объект, содержащий имя типа содержащегося активного документа.

Замечания

Применяется в Internet Explorer и WebBrowser.

CHtmlView::GetVisible

Вызовите эту функцию-член, чтобы определить, отображается ли содержащийся объект.

BOOL GetVisible() const;

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

Ненулевое значение, если объект виден; в противном случае ноль.

Замечания

Применяется в Internet Explorer и WebBrowser.

CHtmlView::GetWidth

Получает ширину главного окна Internet Explorer.

long GetWidth() const;

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

Текущая ширина окна в пикселях.

CHtmlView::GoBack

Перемещается назад один элемент в списке журнала.

void GoBack();

Замечания

Применяется в Internet Explorer и WebBrowser.

CHtmlView::GoForward

Перемещается один элемент в списке журнала.

void GoForward();

CHtmlView::GoHome

Переходит к текущей домашней или начальной странице, указанной в диалоговом окне "Свойства браузера" в Internet Explorer или в диалоговом окне "Свойства Интернета", доступном из панели управления.

void GoHome();

Замечания

Применяется в Internet Explorer и WebBrowser.

CHtmlView::GoSearch

Перейдите на текущую страницу поиска, как указано в диалоговом окне "Параметры браузера Internet Explorer" или в диалоговом окне "Свойства интернета", доступ к которому осуществляется из панель управления.

void GoSearch();

Замечания

Применяется в Internet Explorer и WebBrowser.

CHtmlView::LoadFromResource

Вызовите эту функцию-член, чтобы загрузить указанный ресурс в элемент управления WebBrowser.

BOOL LoadFromResource(LPCTSTR lpszResource);
BOOL LoadFromResource(UINT nRes);

Параметры

lpszResource
Указатель на строку, содержащую имя загружаемого ресурса.

nRes
Идентификатор буфера, содержащего имя загружаемого ресурса.

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

Ненулевое значение в случае успеха, иначе — 0.

Замечания

Применяется в Internet Explorer и WebBrowser.

CHtmlView::Navigate

Вызовите эту функцию-член, чтобы перейти к ресурсу, определенному URL-адресом.

void Navigate(
    LPCTSTR URL,
    DWORD dwFlags = 0,
    LPCTSTR lpszTargetFrameName = NULL,
    LPCTSTR lpszHeaders = NULL,
    LPVOID lpvPostData = NULL,
    DWORD dwPostDataLen = 0);

Параметры

URL
Строка, выделенная вызывающим объектом, содержащая URL-адрес для перехода, или полный путь к файлу для отображения.

dwFlags
Флаги переменной, указывающей, следует ли добавить ресурс в список журналов, чтение или запись из кэша и отображение ресурса в новом окне. Переменная может быть сочетанием значений, определенных BrowserNavConstants перечислением.

lpszTargetFrameName
Указатель на строку, содержащую имя кадра, в котором будет отображаться ресурс.

lpszHeaders
Указатель на значение, указывающее заголовки HTTP для отправки на сервер. Эти заголовки добавляются в заголовки Internet Explorer по умолчанию. Заголовки могут указывать такие вещи, как действие, необходимое для сервера, тип данных, передаваемых серверу, или код состояния. Этот параметр игнорируется, если URL не является URL-адресом HTTP.

lpvPostData
Указатель на данные для отправки с помощью транзакции HTTP POST. Например, транзакция POST используется для отправки данных, собранных html-формой. Если этот параметр не указывает данные о публикации, Navigate выдает транзакцию HTTP GET. Этот параметр игнорируется, если URL не является URL-адресом HTTP.

dwPostDataLen
Данные для отправки с помощью транзакции HTTP POST. Например, транзакция POST используется для отправки данных, собранных html-формой. Если этот параметр не указывает данные о публикации, Navigate выдает транзакцию HTTP GET. Этот параметр игнорируется, если URL не является URL-адресом HTTP.

Замечания

Применяется в Internet Explorer и WebBrowser.

CHtmlView::Navigate2

Вызовите эту функцию-член, чтобы перейти к ресурсу, определенному URL-адресом, или к файлу, определенному полным путем.

void Navigate2(
    LPITEMIDLIST pIDL,
    DWORD dwFlags = 0,
    LPCTSTR lpszTargetFrameName = NULL);

void Navigate2(
    LPCTSTR lpszURL,
    DWORD dwFlags = 0,
    LPCTSTR lpszTargetFrameName = NULL,
    LPCTSTR lpszHeaders = NULL,
    LPVOID lpvPostData = NULL,
    DWORD dwPostDataLen = 0);

void Navigate2(
    LPCTSTR lpszURL,
    DWORD dwFlags,
    CByteArray& baPostedData,
    LPCTSTR lpszTargetFrameName = NULL,
    LPCTSTR lpszHeader = NULL);

Параметры

pIDL
Указатель на структуру ITEMIDLIST .

dwFlags
Флаги переменной, указывающей, следует ли добавить ресурс в список журналов, чтение или запись из кэша и отображение ресурса в новом окне. Переменная может быть сочетанием значений, определенных BrowserNavConstants перечислением.

lpszTargetFrameName
Указатель на строку, содержащую имя кадра, в котором будет отображаться ресурс.

lpszURL
Указатель на строку, содержащую URL-адрес.

lpvPostData
Данные для отправки с помощью транзакции HTTP POST. Например, транзакция POST используется для отправки данных, собранных html-формой. Если этот параметр не указывает данные о публикации, Navigate2 выдает транзакцию HTTP GET. Этот параметр игнорируется, если URL не ЯВЛЯЕТСЯ URL-адресом HTTP или HTTPS.

dwPostDataLen
Длина в байтах данных, на которые указывает lpvPostData параметр.

lpszHeaders
Указатель на значение, указывающее заголовки HTTP или HTTPS для отправки на сервер. Эти заголовки добавляются в заголовки Internet Explorer по умолчанию. Заголовки могут указывать такие вещи, как действие, необходимое для сервера, тип данных, передаваемых серверу, или код состояния. Этот параметр игнорируется, если URL не ЯВЛЯЕТСЯ URL-адресом HTTP или HTTPS.

baPostedData
Ссылка на объект CByteArray.

Замечания

Эта функция-член расширяет Navigate функцию-член, поддерживая просмотр специальных папок, таких как Desktop и My Computer, которые представлены параметром pIDL.

Применяется в Internet Explorer и WebBrowser.

Пример

void CMyHtmlView::OnGoToMicrosoft()
{
   Navigate2(_T("http://home.microsoft.com"));
}

CHtmlView::OnBeforeNavigate2

Эта функция-член вызывается платформой, чтобы вызвать событие перед выполнением операции навигации в веб-браузере.

virtual void OnBeforeNavigate2(
    LPCTSTR lpszURL,
    DWORD nFlags,
    LPCTSTR lpszTargetFrameName,
    CByteArray& baPostedData,
    LPCTSTR lpszHeaders,
    BOOL* pbCancel);

Параметры

lpszURL
Указатель на строку, содержащую URL-адрес для перехода.

nFlags
Зарезервировано для последующего использования.

lpszTargetFrameName
Строка, содержащая имя кадра, в котором отображается ресурс, или NULL если именованный кадр не предназначен для ресурса.

baPostedData
Ссылка на CByteArray объект, содержащий данные для отправки на сервер, если используется транзакция HTTP POST.

lpszHeaders
Указатель на строку, содержащую другие заголовки HTTP для отправки на сервер (только URL-адреса HTTP). Заголовки могут указывать такие вещи, как действие, необходимое для сервера, тип данных, передаваемых серверу, или код состояния.

pbCancel
Указатель на флаг отмены. Приложение может задать для этого параметра ненулевое значение, чтобы отменить операцию навигации или нулю, чтобы разрешить ей продолжить.

CHtmlView::OnCommandStateChange

Эта функция-член вызывается платформой, чтобы уведомить приложение о том, что изменено состояние включенной команды веб-браузера.

virtual void OnCommandStateChange(
    long nCommand,
    BOOL bEnable);

Параметры

nCommand
Идентификатор команды, состояние которой включено изменено.

bEnable
Состояние включено. Этот параметр не является ненулевой, если команда включена или ноль, если она отключена.

CHtmlView::OnDocumentComplete

Эта функция-член вызывается платформой, чтобы уведомить приложение о том, что документ достиг READYSTATE_COMPLETE состояния.

virtual void OnDocumentComplete(LPCTSTR lpszURL);

Параметры

lpszURL
Указатель на строку, которая оценивает URL-адрес, имя UNC-файла или PIDL (указатель на список идентификаторов элементов), к которому был выполнен переход.

Замечания

Не каждый кадр будет запускать это событие, но каждый кадр, который запускает OnDownloadBegin событие, будет запускать соответствующее OnDocumentComplete событие.

URL-адрес, указанный по lpszURL url-адресу, может отличаться от URL-адреса, к которому был указан браузер, так как этот URL-адрес является канонизированным и квалифицированным URL-адресом. Например, если приложение указывает URL-адрес в вызове Navigate или Navigate2БУДЕТ передан OnNavigateComplete2 "<https://www.microsoft.com/>"URL-адрес"www.microsoft.com". Кроме того, если сервер перенаправил браузер на другой URL-адрес, перенаправленный URL-адрес будет отражен здесь.

CHtmlView::OnDocWindowActivate

Вызывается из реализации IOleInPlaceActiveObject::OnDocWindowActivateInternet Explorer или MSHTML, которая уведомляет активный объект на месте при активации или деактивации окна документа контейнера.

virtual HRESULT OnDocWindowActivate(BOOL fActivate);

Параметры

fActivate
Указывает состояние окна документа. Если это значение ненулевое, окно активируется. Если это значение равно нулю, окно деактивируется.

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

S_OK В случае успешного выполнения или кода ошибки, определяемого OLE, в противном случае.

Замечания

Переопределите OnDocWindowActivate , чтобы реагировать на OnDocWindowActivate уведомление из элемента управления Microsoft Web Browser. Дополнительные сведения см IDocHostUIHandler::OnDocWindowActivate . в пакете SDK для Windows.

CHtmlView::OnDownloadBegin

Эта функция-член вызывается платформой, чтобы начать скачивание документа.

virtual void OnDownloadBegin();

Замечания

Это событие запускается вскоре после OnBeforeNavigate2 события, если навигация не отменена. Любая анимация или "занята" указывает, что контейнеру необходимо подключиться к этому событию.

CHtmlView::OnDownloadComplete

Эта функция-член вызывается платформой, чтобы указать, что операция навигации завершена, остановлена или завершилась сбоем.

virtual void OnDownloadComplete();

CHtmlView::OnEnableModeless

Вызывается, когда Internet Explorer или MSHTML отображает модальный пользовательский интерфейс.

virtual HRESULT OnEnableModeless(BOOL fEnable);

Параметры

fEnable
Указывает, включены ли или отключены диалоговые окна узла без режима. Если это значение ненулевое, включено бессерверное диалоговое окно. Если это значение равно нулю, диалоговые окна без режима отключены.

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

S_OK В случае успешного выполнения или кода ошибки, определяемого OLE, в противном случае.

Замечания

Включает или отключает бессерверные диалоговые окна при создании или уничтожении модального диалогового окна контейнера. Переопределите OnEnableModeless , чтобы реагировать на EnableModeless уведомление из элемента управления Microsoft Web Browser. Дополнительные сведения см IDocHostUIHandler::EnableModeless . в пакете SDK для Windows.

CHtmlView::OnFilterDataObject

Вызывается Internet Explorer или MSHTML в основном приложении, чтобы разрешить ему заменить объект данных Internet Explorer или MSHTML.

virtual HRESULT OnFilterDataObject(
    LPDATAOBJECT pDataObject,
    LPDATAOBJECT* ppDataObject);

Параметры

pDataObject
Адрес интерфейса, предоставленного IDataObject Internet Explorer или MSHTML.

ppDataObject
Адрес, который получает IDataObject указатель интерфейса, предоставленный узлом. Содержимое этого параметра всегда должно быть инициализировано NULL, даже если метод завершается ошибкой.

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

S_OK Значение S_FALSE если объект данных не заменен, или код ошибки, определенный OLE, если возникает ошибка.

Замечания

Переопределите OnFilterDataObject , чтобы реагировать на FilterDataObject уведомление из элемента управления Microsoft Web Browser. Дополнительные сведения см IDocHostUIHandler::FilterDataObject . в пакете SDK для Windows.

CHtmlView::OnFrameWindowActivate

Вызывается для IOleInPlaceActiveObject::OnFrameWindowActivate уведомления объекта о активации или деактивации окна кадра верхнего уровня контейнера.

virtual HRESULT OnFrameWindowActivate(BOOL fActivate);

Параметры

fActivate
Указывает состояние окна кадра верхнего уровня контейнера. Если это значение ненулевое, окно активируется. Если это значение равно нулю, окно деактивируется.

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

S_OK В случае успешного выполнения или кода ошибки, определяемого OLE, в противном случае.

Замечания

Переопределите OnFrameWindowActivate , чтобы реагировать на OnFrameWindowActivate уведомление из элемента управления Microsoft Web Browser. Дополнительные сведения см IDocHostUIHandler::OnFrameWindowActivate . в пакете SDK для Windows.

CHtmlView::OnFullScreen

Эта функция-член вызывается платформой при FullScreen изменении свойства.

virtual void OnFullScreen(BOOL bFullScreen);

Параметры

bFullScreen
Ненулевое значение, если Internet Explorer находится в полноэкранном режиме; ноль в противном случае.

CHtmlView::OnGetDropTarget

Вызывается Internet Explorer или MSHTML при использовании в качестве целевого объекта удаления, чтобы разрешить узлу предоставлять альтернативу IDropTarget.

virtual HRESULT OnGetDropTarget(
    LPDROPTARGET pDropTarget,
    LPDROPTARGET* ppDropTarget);

Параметры

pDropTarget
IDropTarget Internet Explorer или MSHTML предлагает использовать.

ppDropTarget
IDropTarget Адрес, который получает IDropTarget указатель интерфейса, который узел хочет предоставить.

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

Ознакомьтесь IDocHostUIHandler::GetDropTarget со списком кодов возврата в пакете SDK для Windows.

Замечания

Переопределите OnGetDropTarget , чтобы реагировать на GetDropTarget уведомление из элемента управления Microsoft Web Browser. Дополнительные сведения см IDocHostUIHandler::GetDropTarget . в пакете SDK для Windows.

CHtmlView::OnGetExternal

Вызывается Internet Explorer или MSHTML для получения интерфейса IDispatch основного приложения.

virtual HRESULT OnGetExternal(LPDISPATCH* lppDispatch);

Параметры

lppDispatch
Указатель на адрес, который получает IDispatch указатель интерфейса ведущего приложения. Если узел предоставляет интерфейс автоматизации, он может предоставить ссылку на Internet Explorer или MSHTML через этот параметр. Содержимое этого параметра всегда должно быть инициализировано NULL, даже если метод завершается ошибкой.

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

S_OK В случае успешного выполнения или кода ошибки, определяемого OLE, в противном случае.

Замечания

Переопределите OnGetExternal , чтобы реагировать на GetExternal уведомление из элемента управления Microsoft Web Browser. Дополнительные сведения см IDocHostUIHandler::GetExternal . в пакете SDK для Windows.

CHtmlView::OnGetHostInfo

Возвращает возможности пользовательского интерфейса основного приложения Internet Explorer или MSHTML.

virtual HRESULT OnGetHostInfo(DOCHOSTUIINFO* pInfo);

Параметры

pInfo
DOCHOSTUIINFO Адрес структуры, которая получает возможности пользовательского интерфейса узла.

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

S_OK В случае успешного выполнения или кода ошибки, определяемого OLE, в противном случае.

Замечания

Переопределите OnGetHostInfo , чтобы реагировать на GetHostInfo уведомление из элемента управления Microsoft Web Browser. Дополнительные сведения см IDocHostUIHandler::GetHostInfo . в пакете SDK для Windows.

CHtmlView::OnGetOptionKeyPath

Вызовите эту функцию-член, чтобы получить раздел реестра, в котором Internet Explorer или MSHTML хранят настройки пользователя.

virtual HRESULT OnGetOptionKeyPath(
    LPOLESTR* pchKey,
    DWORD dwReserved);

Параметры

pchKey
Адрес, LPOLESTR получающий строку подраздела реестра, в которой узел хранит параметры по умолчанию. Этот подраздел будет находиться под ключом HKEY_CURRENT_USER . Выделение этой памяти с помощью CoTaskMemAlloc. Вызывающее приложение отвечает за освобождение этой памяти с помощью CoTaskMemFree. Этот параметр всегда должен быть инициализирован NULLв , даже если метод завершается ошибкой.

dwReserved
Зарезервировано для последующего использования. В настоящее время не используется.

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

S_OK в случае успешного выполнения или S_FALSE в противном случае. Если S_FALSEinternet Explorer или MSHTML по умолчанию использует собственные параметры пользователя.

Замечания

Переопределите OnGetOptionKeyPath , чтобы реагировать на GetOptionKeyPath уведомление из элемента управления Microsoft Web Browser. Дополнительные сведения см IDocHostUIHandler::GetOptionKeyPath . в пакете SDK для Windows.

CHtmlView::OnHideUI

Эта функция-член вызывается платформой, когда Internet Explorer или MSHTML удаляет меню и панели инструментов.

virtual HRESULT OnHideUI();

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

S_OK В случае успешного выполнения или кода ошибки, определяемого OLE, в противном случае.

Замечания

Переопределите OnHideUI , чтобы реагировать на HideUI уведомление из элемента управления Microsoft Web Browser. Дополнительные сведения см IDocHostUIHandler::HideUI . в пакете SDK для Windows.

CHtmlView::OnMenuBar

Эта функция-член вызывается платформой при MenuBar изменении свойства.

virtual void OnMenuBar(BOOL bMenuBar);

Параметры

bMenuBar
Ненулевое значение, если отображается строка меню Internet Explorer; ноль в противном случае.

CHtmlView::OnNavigateComplete2

Эта функция-член вызывается платформой после завершения навигации по гиперссылке (в элементе окна или набора кадров).

virtual void OnNavigateComplete2(LPCTSTR strURL);

Параметры

strURL
Строковое выражение, которое оценивает URL-адрес, имя UNC-файла или PIDL (указатель на список идентификаторов элементов), к которому был выполнен переход.

Замечания

Параметр URL-адреса может быть PIDL, если существует сущность пространства имен оболочки, для которой нет ПРЕДСТАВЛЕНИЯ URL-адреса.

URL-адрес, содержащийся в strURL нем, может отличаться от URL-адреса, к которому был указан браузер, так как этот URL-адрес является канонизированным и квалифицированным URL-адресом. Например, если приложение указывает URL-адрес в вызове Navigate или Navigate2БУДЕТ передан OnNavigateComplete2 "<https://www.microsoft.com/>"URL-адрес"www.microsoft.com". Кроме того, если сервер перенаправил браузер на другой URL-адрес, перенаправленный URL-адрес будет отражен здесь.

CHtmlView::OnNavigateError

Вызывается платформой, если переход по гиперссылке завершается ошибкой.

virtual void OnNavigateError(
    LPCTSTR lpszURL,
    LPCTSTR lpszFrame,
    DWORD dwError,
    BOOL* pbCancel);

Параметры

lpszURL
URL-адрес, для которого произошел сбой навигации.

lpszFrame
Имя кадра, в котором должен отображаться ресурс, или NULL если именованный кадр не предназначен для ресурса.

dwError
Код состояния ошибки, если он доступен. Список возможных HRESULT кодов состояния HTTP см. в разделе NavigateError "Коды состояния событий".

pbCancel
Указывает, следует ли отменить навигацию на страницу ошибки или любое дополнительное автоматическое поиск. Если TRUE (по умолчанию) перейдите на страницу ошибок или автопоиск; если FALSEотмена навигации на страницу ошибки или автопоиск.

Замечания

Переопределите этот метод, чтобы обеспечить пользовательскую обработку ошибок навигации.

Дополнительные сведения см. в разделе DWebBrowserEvents2::NavigateError.

CHtmlView::OnNewWindow2

Эта функция-член вызывается платформой при создании нового окна для отображения ресурса.

virtual void OnNewWindow2(
    LPDISPATCH* ppDisp,
    BOOL* Cancel);

Параметры

ppDisp
Указатель на указатель интерфейса, который, при необходимости, получает IDispatch указатель интерфейса нового объекта WebBrowser или Internet Explorer.

Cancel
Указатель на флаг отмены. Приложение может задать для этого параметра ненулевое значение, чтобы отменить операцию навигации или нулю, чтобы разрешить ей продолжить.

Замечания

Это событие предшествует созданию нового окна из WebBrowser.

CHtmlView::OnProgressChange

Эта функция-член вызывается платформой, чтобы уведомить приложение о том, что ход выполнения операции скачивания обновлен.

virtual void OnProgressChange(
    long nProgress,
    long nProgressMax);

Параметры

nProgress
Сумма общего хода выполнения, отображаемого или -1 при завершении выполнения.

nProgressMax
Максимальное значение хода выполнения.

Замечания

Контейнер может использовать сведения, предоставленные этим событием, чтобы отобразить количество скачанных байтов до сих пор или обновить индикатор хода выполнения.

CHtmlView::OnPropertyChange

Эта функция-член вызывается платформой, чтобы уведомить приложение, которое PutProperty изменило значение свойства.

virtual void OnPropertyChange(LPCTSTR lpszProperty);

Параметры

lpszProperty
Указатель на строку, содержащую имя свойства.

CHtmlView::OnQuit

Эта функция-член вызывается платформой, чтобы уведомить приложение о том, что приложение Internet Explorer готово к выходу.

virtual void OnQuit();

CHtmlView::OnResizeBorder

Вызывается из реализации IOleInPlaceActiveObject::ResizeBorderInternet Explorer или MSHTML, которая оповещает объект, который необходимо изменить размер пространства границы.

virtual HRESULT OnResizeBorder(
    LPCRECT prcBorder,
    LPOLEINPLACEUIWINDOW pUIWindow,
    BOOL fFrameWindow);

Параметры

prcBorder
Новый внешний прямоугольник для пограничного пространства.

pUIWindow
Указатель на интерфейс для объекта фрейма или окна документа, граница которого изменилась.

fFrameWindow
TRUE Значение , если окно фрейма вызывается IOleInPlaceActiveObject::ResizeBorder, в противном случае FALSE.

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

S_OK В случае успешного выполнения или кода ошибки, определяемого OLE, в противном случае.

Замечания

Переопределите OnResizeBorder , чтобы реагировать на ResizeBorder уведомление из элемента управления Microsoft Web Browser. Дополнительные сведения см IDocHostUIHandler::ResizeBorder . в пакете SDK для Windows.

CHtmlView::OnShowContextMenu

Вызывается из Internet Explorer или MSHTML, когда будет отображаться контекстное меню.

virtual HRESULT OnShowContextMenu(
    DWORD dwID,
    LPPOINT ppt,
    LPUNKNOWN pcmdtReserved,
    LPDISPATCH pdispReserved);

Параметры

dwID
Идентификатор отображаемого контекстного меню. Ознакомьтесь IDocHostUIHandler::ShowContextMenu со списком значений в пакете SDK для Windows.

ppt
Координаты экрана для меню.

pcmdtReserved
IOleCommandTarget интерфейс, используемый для запроса состояния команды и выполнения команд в этом объекте.

pdispReserved
IDispatch интерфейс объекта в координатах экрана. Это позволяет узлу различать определенные объекты для предоставления более конкретного контекста.

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

Ознакомьтесь IDocHostUIHandler::ShowContextMenu со списком значений в пакете SDK для Windows.

Замечания

Переопределите OnShowContextMenu , чтобы реагировать на ShowContextMenu уведомление из элемента управления Microsoft Web Browser. Дополнительные сведения см IDocHostUIHandler::ShowContextMenu . в пакете SDK для Windows.

CHtmlView::OnShowUI

Вызывается перед отображением меню и панелей инструментов в Internet Explorer или MSHTML.

virtual HRESULT OnShowUI(
    DWORD dwID,
    LPOLEINPLACEACTIVEOBJECT pActiveObject,
    LPOLECOMMANDTARGET pCommandTarget,
    LPOLEINPLACEFRAME pFrame,
    LPOLEINPLACEUIWINDOW pDoc);

Параметры

dwID
Зарезервировано для последующего использования.

pActiveObject
IOleInPlaceActiveObject интерфейс текущего активного объекта.

pCommandTarget
IOleCommandTarget интерфейс объекта.

pFrame
IOleInPlaceFrame интерфейс объекта. Это необходимо для меню и панелей инструментов.

pDoc
IOleInPlaceUIWindow интерфейс для объекта. Это необходимо для панелей инструментов.

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

Ознакомьтесь IDocHostUIHandler::ShowUI со списком значений в пакете SDK для Windows.

Замечания

Переопределите OnShowUI , чтобы реагировать на ShowUI уведомление из элемента управления Microsoft Web Browser. Дополнительные сведения см IDocHostUIHandler::ShowUI . в пакете SDK для Windows.

CHtmlView::OnStatusBar

Эта функция-член вызывается платформой при StatusBar изменении свойства.

virtual void OnStatusBar(BOOL bStatusBar);

Параметры

bStatusBar
Ненулевое значение, если строка состояния Internet Explorer видна или нулю в противном случае.

CHtmlView::OnStatusTextChange

Эта функция-член вызывается платформой для уведомления приложения о том, что текст строки состояния, связанной с элементом управления WebBrowser, изменился.

virtual void OnStatusTextChange(LPCTSTR lpszText);

Параметры

lpszText
Строка, содержащая новый текст строки состояния.

CHtmlView::OnTheaterMode

Эта функция-член вызывается платформой при TheaterMode изменении свойства.

virtual void OnTheaterMode(BOOL bTheaterMode);

Параметры

bTheaterMode
Ненулевое значение, если Internet Explorer находится в режиме театра; ноль в противном случае.

CHtmlView::OnTitleChange

Эта функция-член вызывается платформой, чтобы уведомить приложение, если название документа в элементе управления WebBrowser становится доступным или изменяется.

virtual void OnTitleChange(LPCTSTR lpszText);

Параметры

lpszText
Название нового документа.

Замечания

Для HTML название может измениться; пока HTML-код по-прежнему загружается, URL-адрес документа задается в качестве заголовка. После анализа реального заголовка (если есть один) анализируется с HTML, заголовок изменяется на отражение фактического заголовка.

CHtmlView::OnToolBar

Эта функция-член вызывается платформой при ToolBar изменении свойства.

virtual void OnToolBar(BOOL bToolBar);

Параметры

bToolBar
Ненулевое значение, если панель инструментов Internet Explorer отображается или ноль в противном случае.

CHtmlView::OnTranslateAccelerator

Вызывается Internet Explorer или MSHTML, когда IOleInPlaceActiveObject::TranslateAccelerator или IOleControlSite::TranslateAccelerator вызывается для обработки сообщений акселератора ключей меню из очереди сообщений контейнера.

virtual HRESULT OnTranslateAccelerator(
    LPMSG lpMsg,
    const GUID* pguidCmdGroup,
    DWORD nCmdID);

Параметры

lpMsg
Указывает на сообщение, которое может потребоваться перевести.

pguidCmdGroup
Идентификатор группы команд.

nCmdID
Идентификатор команды.

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

S_OK в случае успешного выполнения или S_FALSE в противном случае.

Замечания

Переопределите OnTranslateAccelerator , чтобы реагировать на TranslateAccelerator уведомление из элемента управления Microsoft Web Browser. Дополнительные сведения см IDocHostUIHandler::TranslateAccelerator . в пакете SDK для Windows.

CHtmlView::OnTranslateUrl

Вызывается Internet Explorer или MSHTML, чтобы разрешить основному приложению изменять URL-адрес, который нужно загрузить.

virtual HRESULT OnTranslateUrl(
    DWORD dwTranslate,
    OLECHAR* pchURLIn,
    OLECHAR** ppchURLOut);

Параметры

dwTranslate
Зарезервировано для последующего использования.

pchURLIn
Адрес строки, предоставленной Internet Explorer или MSHTML, который представляет URL-адрес для преобразования.

ppchURLOut
Адрес строкового указателя, который получает адрес преобразованного URL-адреса. Узел выделяет буфер с помощью распределителя памяти задачи. Содержимое этого параметра всегда должно быть инициализировано NULL, даже если URL-адрес не переведен или метод завершается ошибкой.

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

S_OK Значение S_FALSE если URL-адрес не был переведен или код ошибки, определенный OLE, если произошла ошибка.

Замечания

Переопределите OnTranslateUrl , чтобы реагировать на TranslateUrl уведомление из элемента управления Microsoft Web Browser. Дополнительные сведения см IDocHostUIHandler::TranslateUrl . в пакете SDK для Windows.

CHtmlView::OnUpdateUI

Уведомляет основное приложение об изменении состояния команды.

virtual HRESULT OnUpdateUI();

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

S_OK В случае успешного выполнения или кода ошибки, определяемого OLE, в противном случае.

Замечания

Узел должен обновить состояние кнопок панели инструментов. Этот метод вызывается независимо от возвращаемого значения ShowUI. Переопределите OnUpdateUI , чтобы реагировать на UpdateUI уведомление из элемента управления Microsoft Web Browser.

CHtmlView::OnVisible

Эта функция-член вызывается платформой, когда окно для WebBrowser должно отображаться или скрыто.

virtual void OnVisible(BOOL bVisible);

Параметры

bVisible
Ненулевое значение, если объект виден или нулю в противном случае.

Замечания

Это позволяет окне узла управления объектами вести себя так же, как и окно Internet Explorer.

CHtmlView::PutProperty

Вызовите эту функцию-член, чтобы задать свойство, связанное с заданным объектом.

void PutProperty(
    LPCTSTR lpszProperty,
    const VARIANT& vtValue);

void PutProperty(
    LPCTSTR lpszPropertyName,
    double dValue);

void PutProperty(
    LPCTSTR lpszPropertyName,
    long lValue);

void PutProperty(
    LPCTSTR lpszPropertyName,
    LPCTSTR lpszValue);

void PutProperty(
    LPCTSTR lpszPropertyName,
    short nValue);

Параметры

lpszProperty
Строка, содержащая заданное свойство.

vtValue
Новое значение свойства, lpszPropertyуказанного .

lpszPropertyName
Указатель на строку, содержащую имя заданного свойства.

dValue
Новое значение свойства.

lValue
Новое значение свойства.

lpszValue
Указатель на строку, содержащую новое значение свойства.

nValue
Новое значение свойства.

Замечания

Применяется в Internet Explorer и WebBrowser.

CHtmlView::QueryFormsCommand

Запрашивает состояние одной или нескольких команд, созданных событиями пользовательского интерфейса.

HRESULT QueryFormsCommand(
    DWORD dwCommandID,
    BOOL* pbSupported,
    BOOL* pbEnabled,
    BOOL* pbChecked);

Параметры

dwCommandID
Идентификатор запрашиваемой команды.

pbSupported
Указатель на BOOL указание, поддерживается ли команда (определяемая по dwCommandID) . Значение , если TRUEкоманда поддерживается; в противном случае FALSE.

pbEnabled
Указатель на BOOL указание, включена ли команда (определяемая по dwCommandID) . Значение , если TRUEкоманда поддерживается; в противном случае FALSE.

pbChecked
Указатель на BOOL указание, проверяется ли команда (определяемая по dwCommandID) . Значение , если TRUEкоманда поддерживается; в противном случае FALSE.

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

Стандартное значение HRESULT . Полный список возможных значений см IOleCommandTarget::QueryStatus . в пакете SDK для Windows.

Замечания

QueryFormsCommand реализует поведение IOleCommandTarget::QueryStatus метода.

CHtmlView::QueryStatusWB

Вызовите эту функцию-член для запроса состояния команды.

OLECMDF QueryStatusWB(OLECMDID cmdID) const;

Параметры

cmdID
OLECMDID Значение команды, для которой вызывающий объект нуждается в сведениях о состоянии.

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

Адрес OLECMDF значения, получающего состояние команды.

Замечания

QueryStatusWB реализует поведение IOleCommandTarget::QueryStatus метода.

Применяется в Internet Explorer и WebBrowser.

CHtmlView::Refresh

Перезагрузит URL-адрес или файл, отображаемый в веб-браузере.

void Refresh();

Замечания

Refresh не содержит параметров для настройки уровня обновления.

Применяется в Internet Explorer и WebBrowser.

CHtmlView::Refresh2

Перезагрузит файл, отображаемый в Internet Explorer.

void Refresh2(int nLevel);

Параметры

nLevel
Адрес переменной, указывающей уровень обновления. Возможные переменные определены в RefreshConstantsпакете SDK для Windows.

Замечания

В отличие от Refreshэтого, Refresh2 содержит параметр, указывающий уровень обновления.

Применяется в Internet Explorer и WebBrowser.

CHtmlView::SetAddressBar

Вызовите эту функцию-член, чтобы показать или скрыть адресную строку объекта Internet Explorer.

void SetAddressBar(BOOL bNewValue);

Параметры

bNewValue
Ненулевое отображение адресной строки; в противном случае ноль.

Замечания

Применимо к Internet Explorer. Если этот вызов используется с элементом управления WebBrowser, он не вернет ошибки, но он будет игнорировать этот вызов.

CHtmlView::SetFullScreen

Вызовите эту функцию-член, чтобы установить Internet Explorer на полноэкранный или обычный режим окна.

void SetFullScreen(BOOL bNewValue);

Параметры

bNewValue
Ненулевое значение для полноэкранного режима; в противном случае ноль.

Замечания

В полноэкранном режиме основное окно Internet Explorer развернуто, а строка состояния, панель инструментов, панель меню и заголовок скрыты.

Применимо к Internet Explorer. Если этот вызов используется с элементом управления WebBrowser, он не вернет ошибки, но он будет игнорировать этот вызов.

CHtmlView::SetHeight

Вызовите эту функцию-член, чтобы задать высоту главного окна Internet Explorer.

void SetHeight(long nNewValue);

Параметры

nNewValue
Высота в пикселях главного окна.

Замечания

Применяется в Internet Explorer и WebBrowser.

CHtmlView::SetLeft

Задает положение главного окна Internet Explorer по горизонтали.

void SetLeft(long nNewValue);

Параметры

nNewValue
Координата экрана левого края главного окна.

CHtmlView::SetMenuBar

Вызовите эту функцию-член, чтобы отобразить или скрыть строку меню Internet Explorer.

void SetMenuBar(BOOL bNewValue);

Параметры

bNewValue
Ненулевое значение для отображения строки меню; в противном случае ноль.

Замечания

Применимо к Internet Explorer. Если этот вызов используется с элементом управления WebBrowser, он не вернет ошибки, но он будет игнорировать этот вызов.

CHtmlView::SetOffline

Вызовите эту функцию-член, чтобы задать значение, указывающее, работает ли элемент управления WebBrowser в автономном режиме.

void SetOffline(BOOL bNewValue);

Параметры

bNewValue
Ненулевое чтение из локального кэша; в противном случае ноль.

Замечания

В автономном режиме браузер считывает HTML-страницы из локального кэша, а не из исходного документа.

Применяется в Internet Explorer и WebBrowser.

CHtmlView::SetRegisterAsBrowser

Вызовите эту функцию-член, чтобы задать значение, указывающее, зарегистрирован ли элемент управления WebBrowser в качестве браузера верхнего уровня для разрешения целевых имен.

void SetRegisterAsBrowser(BOOL bNewValue);

Параметры

bNewValue
Определяет, зарегистрирован ли Internet Explorer в качестве браузера верхнего уровня. Если ненулевое значение, веб-браузер регистрируется в качестве браузера верхнего уровня; Если ноль, это не браузер верхнего уровня. Значение по умолчанию равно нулю.

Замечания

Браузер верхнего уровня — это браузер, установленный в реестре в качестве браузера по умолчанию.

Применяется в Internet Explorer и WebBrowser.

CHtmlView::SetRegisterAsDropTarget

Вызовите эту функцию-член, чтобы задать значение, указывающее, зарегистрирован ли элемент управления WebBrowser в качестве целевого объекта удаления для навигации.

void SetRegisterAsDropTarget(BOOL bNewValue);

Параметры

bNewValue
Определяет, зарегистрирован ли элемент управления WebBrowser в качестве целевого объекта удаления для навигации. Если ненулевое значение, объект регистрируется в качестве целевого объекта удаления; Если ноль, это не целевой объект удаления.

Замечания

Применяется в Internet Explorer и WebBrowser.

CHtmlView::SetSilent

Вызовите эту функцию-член, чтобы задать значение, указывающее, можно ли отображать любые диалоговые окна.

void SetSilent(BOOL bNewValue);

Параметры

bNewValue
Если ненулевое значение, диалоговые окна не будут отображаться; Если ноль, будут отображаться диалоговые окна. Значение по умолчанию равно нулю.

Замечания

Применяется в Internet Explorer и WebBrowser.

CHtmlView::SetStatusBar

Вызовите эту функцию-член, чтобы отобразить строку состояния.

void SetStatusBar(BOOL bNewValue);

Параметры

bNewValue
Ненулевое значение, если строка состояния видна; в противном случае ноль.

Замечания

Применимо к Internet Explorer. Если этот вызов используется с элементом управления WebBrowser, он не вернет ошибки, но он будет игнорировать этот вызов.

CHtmlView::SetTheaterMode

Вызовите эту функцию-член, чтобы задать значение, указывающее, находится ли элемент управления WebBrowser в режиме театра.

void SetTheaterMode(BOOL bNewValue);

Параметры

bNewValue
Ненулевое значение для задания элемента управления WebBrowser в режиме театра; в противном случае ноль. Значение по умолчанию равно нулю.

Замечания

Когда веб-браузер находится в режиме театра, главное окно браузера заполняет весь экран, панель инструментов с минимальным набором средств навигации отображается, а строка состояния отображается в правом верхнем углу экрана.

Применяется в Internet Explorer и WebBrowser.

CHtmlView::SetToolBar

Вызовите эту функцию-член, чтобы отобразить или скрыть панель инструментов Internet Explorer.

void SetToolBar(int nNewValue);

Параметры

nNewValue
Указывает, следует ли отображать панель инструментов. Ненулевое значение, если панель инструментов должна отображаться; в противном случае ноль.

Замечания

Применимо к Internet Explorer. Если этот вызов используется с элементом управления WebBrowser, он не вернет ошибки, но он будет игнорировать этот вызов.

CHtmlView::SetTop

Вызовите эту функцию-член, чтобы задать расстояние между внутренним верхним краем элемента управления WebBrowser и верхним краем контейнера.

void SetTop(long nNewValue);

Параметры

nNewValue
Координата экрана верхнего края главного окна.

Замечания

Применяется в Internet Explorer и WebBrowser.

CHtmlView::SetVisible

Вызовите эту функцию-член, чтобы задать состояние видимости элемента управления WebBrowser.

void SetVisible(BOOL bNewValue);

Параметры

bNewValue
Ненулевое значение, если элемент управления отображается; в противном случае ноль.

Замечания

Применяется в Internet Explorer и WebBrowser.

CHtmlView::SetWidth

Задает ширину главного окна Internet Explorer.

void SetWidth(long nNewValue);

Параметры

nNewValue
Ширина в пикселях главного окна Internet Explorer.

CHtmlView::Stop

Вызовите эту функцию-член для отмены любой ожидающей операции навигации или загрузки и остановки всех динамических элементов страницы, таких как фоновые звуки и анимации.

void Stop();

Замечания

Применяется в Internet Explorer и WebBrowser.

См. также

Пример MFC MFCIE
Класс CFormView
Диаграмма иерархии
IWebBrowser2