Поделиться через


Класс CDHtmlDialog

Используется для создания диалоговых окон, использующих HTML, а не диалоговые ресурсы для реализации пользовательского интерфейса.

Синтаксис

class CDHtmlDialog : public CDialog, public CDHtmlEventSink

Участники

Открытые конструкторы

Имя Описание
CDHtmlDialog::CDHtmlDialog Создает объект CDHtmlDialog.
CDHtmlDialog::~CDHtmlDialog Уничтожает объект CDHtmlDialog.

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

Имя Описание
CDHtmlDialog::CanAccessExternal Переопределяемая, которая вызывается в качестве проверки доступа, чтобы узнать, могут ли объекты скриптов на загруженной странице получить доступ к внешней диспетчеризации сайта управления. Проверяет, является ли отправка безопасной для сценариев или текущей зоны позволяет объектам, которые небезопасны для сценариев.
CDHtmlDialog::CreateControlSite Переопределяется, используемый для создания экземпляра сайта элемента управления для размещения элемента управления WebBrowser в диалоговом окне.
CDHtmlDialog::DDX_DHtml_AxControl Обмен данными между переменной-членом и значением свойства элемента ActiveX на HTML-странице.
CDHtmlDialog::DDX_DHtml_CheckBox Обмен данными между переменной-членом и флажоком на HTML-странице.
CDHtmlDialog::DDX_DHtml_ElementText Обмен данными между переменной-членом и любым свойством элемента HTML на HTML-странице.
CDHtmlDialog::DDX_DHtml_Radio Обмен данными между переменной-членом и переключателем на HTML-странице.
CDHtmlDialog::DDX_DHtml_SelectIndex Возвращает или задает индекс поля списка на HTML-странице.
CDHtmlDialog::DDX_DHtml_SelectString Возвращает или задает отображаемый текст записи поля списка (на основе текущего индекса) на HTML-странице.
CDHtmlDialog::DDX_DHtml_SelectValue Возвращает или задает значение записи поля списка (на основе текущего индекса) на HTML-странице.
CDHtmlDialog::DestroyModeless Удаляет диалоговое окно без режима.
CDHtmlDialog::EnableModeless Включает диалоговые окна без режима.
CDHtmlDialog::FilterDataObject Позволяет диалогу фильтровать объекты данных буфера обмена, созданные размещенным браузером.
CDHtmlDialog::GetControlDispatch Извлекает IDispatch интерфейс в элементе activeX, внедренном в HTML-документ.
CDHtmlDialog::GetControlProperty Извлекает запрошенное свойство указанного элемента управления ActiveX.
CDHtmlDialog::GetCurrentUrl Извлекает указатель универсального ресурса (URL-адрес), связанный с текущим документом.
CDHtmlDialog::GetDHtmlDocument Извлекает IHTMLDocument2 интерфейс в текущем загруженном HTML-документе.
CDHtmlDialog::GetDropTarget Вызывается элементом управления WebBrowser, когда он используется в качестве целевого объекта удаления, чтобы разрешить диалогу предоставлять альтернативу IDropTarget.
CDHtmlDialog::GetElement Возвращает интерфейс в элементе HTML.
CDHtmlDialog::GetElementHtml Извлекает innerHTML свойство HTML-элемента.
CDHtmlDialog::GetElementInterface Извлекает запрошенный указатель интерфейса из html-элемента.
CDHtmlDialog::GetElementProperty Извлекает значение свойства HTML-элемента.
CDHtmlDialog::GetElementText Извлекает innerText свойство HTML-элемента.
CDHtmlDialog::GetEvent Возвращает указатель на текущий IHTMLEventObj объект события.
CDHtmlDialog::GetExternal Возвращает интерфейс узла IDispatch .
CDHtmlDialog::GetHostInfo Извлекает возможности пользовательского интерфейса узла.
CDHtmlDialog::GetOptionKeyPath Извлекает раздел реестра, в котором хранятся настройки пользователя.
CDHtmlDialog::HideUI Скрывает пользовательский интерфейс узла.
CDHtmlDialog::IsExternalDispatchSafe Указывает, является ли интерфейс узла IDispatch безопасным для скриптов.
CDHtmlDialog::LoadFromResource Загружает указанный ресурс в элемент управления WebBrowser.
CDHtmlDialog::Navigate Переходит к указанному URL-адресу.
CDHtmlDialog::OnBeforeNavigate Вызывается платформой перед запуском события навигации.
CDHtmlDialog::OnDocumentComplete Вызывается платформой для уведомления приложения о достижении READYSTATE_COMPLETE состояния документа.
CDHtmlDialog::OnDocWindowActivate Вызывается платформой при активации или деактивации окна документа.
CDHtmlDialog::OnFrameWindowActivate Вызывается платформой при активации или деактивации окна фрейма.
CDHtmlDialog::OnInitDialog Вызывается в ответ на WM_INITDIALOG сообщение.
CDHtmlDialog::OnNavigateComplete Вызывается платформой после завершения события навигации.
CDHtmlDialog::ResizeBorder Оповещает объект, который он должен изменить размер пространства границы.
CDHtmlDialog::SetControlProperty Задает свойству элемента activeX новое значение.
CDHtmlDialog::SetElementHtml innerHTML Задает свойство HTML-элемента.
CDHtmlDialog::SetElementProperty Задает свойство HTML-элемента.
CDHtmlDialog::SetElementText innerText Задает свойство HTML-элемента.
CDHtmlDialog::SetExternalDispatch Задает интерфейс узла IDispatch .
CDHtmlDialog::SetHostFlags Задает флаги пользовательского интерфейса узла.
CDHtmlDialog::ShowContextMenu Вызывается при отображении контекстного меню.
CDHtmlDialog::ShowUI Отображает пользовательский интерфейс узла.
CDHtmlDialog::TranslateAccelerator Вызывается для обработки сообщений акселератора ключей меню.
CDHtmlDialog::TranslateUrl Вызывается для изменения URL-адреса для загрузки.
CDHtmlDialog::UpdateUI Вызывается для уведомления узла о том, что состояние команды изменилось.

Открытые члены данных

Имя Описание
CDHtmlDialog::m_bUseHtmlTitle Указывает, следует ли использовать заголовок HTML-документа в качестве заголовка диалогового окна.
CDHtmlDialog::m_nHtmlResID Идентификатор ресурса HTML для отображения.
CDHtmlDialog::m_pBrowserApp Указатель на веб-браузерное приложение.
CDHtmlDialog::m_spHtmlDoc Указатель на HTML-документ.
CDHtmlDialog::m_strCurrentUrl Текущий URL-адрес.
CDHtmlDialog::m_szHtmlResID Строка версии идентификатора ресурса HTML.

Замечания

CDHtmlDialog может загрузить HTML-код, отображаемый из ресурса HTML или URL-адреса.

CDHtmlDialog также может обмениваться данными с элементами управления HTML и обрабатывать события из элементов управления HTML, например нажатия кнопки.

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

CObject

CDHtmlSinkHandlerBase2

CDHtmlSinkHandlerBase1

CCmdTarget

CDHtmlSinkHandler

CWnd

CDHtmlEventSink

CDialog

CDHtmlDialog

Требования

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

DDX_DHtml Вспомогательные макросы

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

Макросы Обмена данными

Имя Описание
DDX_DHtml_ElementValue Задает или извлекает свойство Value из выбранного элемента управления.
DDX_DHtml_ElementInnerText Задает или извлекает текст между тегами начала и конца текущего элемента.
DDX_DHtml_ElementInnerHtml Задает или извлекает HTML-код между тегами начала и окончания текущего элемента.
DDX_DHtml_Anchor_Href Задает или извлекает конечный URL-адрес или точку привязки.
DDX_DHtml_Anchor_Target Задает или извлекает целевое окно или кадр.
DDX_DHtml_Img_Src Задает или извлекает имя изображения или клипа в документе.
DDX_DHtml_Frame_Src Задает или извлекает URL-адрес связанного кадра.
DDX_DHtml_IFrame_Src Задает или извлекает URL-адрес связанного кадра.

CDHtmlDialog::CanAccessExternal

Переопределяемая, которая вызывается в качестве проверки доступа, чтобы узнать, могут ли объекты скриптов на загруженной странице получить доступ к внешней диспетчеризации сайта управления. Проверяет, является ли отправка безопасной для сценариев или текущей зоны позволяет объектам, которые небезопасны для сценариев.

virtual BOOL CanAccessExternal();

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

Имеет ненулевое значение в случае успешного выполнения, иначе — 0.

CDHtmlDialog::CDHtmlDialog

Создает динамическое диалоговое окно HTML на основе ресурсов.

CDHtmlDialog();

CDHtmlDialog(
    LPCTSTR lpszTemplateName,
    LPCTSTR szHtmlResID,
    CWnd *pParentWnd = NULL);

CDHtmlDialog(
    UINT nIDTemplate,
    UINT nHtmlResID = 0,
    CWnd *pParentWnd = NULL);

Параметры

lpszTemplateName
Строка, завершающаяся значением NULL, которая является именем ресурса шаблона диалогового окна.

szHtmlResID
Строка, завершающаяся значением NULL, которая является именем ресурса HTML.

pParentWnd
Указатель на родительский или владелец объекта окна (типа CWnd), к которому принадлежит объект диалогового окна. Если это NULLтак, родительское окно объекта диалогового окна устанавливается в главное окно приложения.

nIDTemplate
Содержит идентификатор ресурса шаблона диалогового окна.

nHtmlResID
Содержит идентификатор html-ресурса.

Замечания

Вторая форма конструктора предоставляет доступ к ресурсу диалогового окна с помощью имени шаблона. Третья форма конструктора предоставляет доступ к ресурсу диалогового окна с помощью идентификатора шаблона ресурса. Обычно идентификатор начинается с IDD_ префикса.

CDHtmlDialog::~CDHtmlDialog

Уничтожает объект CDHtmlDialog .

virtual ~CDHtmlDialog();

Замечания

Функцию-член CWnd::DestroyWindow необходимо использовать для уничтожения бессерверных диалоговых окон, созданных с помощью CDialog::Create.

CDHtmlDialog::CreateControlSite

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

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

Параметры

pContainer
Указатель на объект COleControlContainer.

ppSite
Указатель на указатель на указатель COleControlSiteна .

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

Имеет ненулевое значение в случае успешного выполнения, иначе — 0.

Замечания

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

CDHtmlDialog::DDX_DHtml_AxControl

Обмен данными между переменной-членом и значением свойства элемента ActiveX на HTML-странице.

void DDX_DHtml_AxControl(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    VARIANT& var);

void DDX_DHtml_AxControl(
    CDataExchange* pDX,
    LPCTSTR szId,
    LPCTSTR szPropName,
    VARIANT& var);

Параметры

pDX
Указатель на объект CDataExchange.

szId
Значение параметра идентификатора тега объекта в источнике HTML для элемента activeX.

dispId
Идентификатор диспетчера свойства, с которым требуется обмениваться данными.

szPropName
Имя свойства.

var
Элемент данных, тип VARIANTилиCOleVariantCComVariant, содержащий значение, обменяемое свойством элемента управления ActiveX.

Пример

// COleVariant m_varSliderValue;
DDX_DHtml_AxControl(pDX, _T("slider1"), 0x0b /* Value */, m_varSliderValue);

CDHtmlDialog::DDX_DHtml_CheckBox

Обмен данными между переменной-членом и флажоком на HTML-странице.

void DDX_DHtml_CheckBox(
    CDataExchange* pDX,
    LPCTSTR szId,
    int& value);

Параметры

pDX
Указатель на объект CDataExchange.

szId
Значение, указанное для параметра идентификатора элемента управления HTML.

value
Значение, которое обменивается.

Пример

// int m_nItalic;
DDX_DHtml_CheckBox(pDX, L"italic", m_nItalic);

CDHtmlDialog::DDX_DHtml_ElementText

Обмен данными между переменной-членом и любым свойством элемента HTML на HTML-странице.

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    CString& value);

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    short& value);

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    int& value);

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    long& value);

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    DWORD& value);

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    float& value);

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    double& value);

Параметры

pDX
Указатель на объект CDataExchange.

szId
Значение, указанное для параметра идентификатора элемента управления HTML.

dispId
Идентификатор отправки HTML-элемента, с которым требуется обмениваться данными.

value
Значение, которое обменивается.

CDHtmlDialog::DDX_DHtml_Radio

Обмен данными между переменной-членом и переключателем на HTML-странице.

void DDX_DHtml_Radio(
    CDataExchange* pDX,
    LPCTSTR szId,
    long& value);

Параметры

pDX
Указатель на объект CDataExchange.

szId
Значение, указанное для параметра идентификатора элемента управления HTML.

value
Значение, которое обменивается.

CDHtmlDialog::DDX_DHtml_SelectIndex

Возвращает или задает индекс поля списка на HTML-странице.

void DDX_DHtml_SelectIndex(
    CDataExchange* pDX,
    LPCTSTR szId,
    long& value);

Параметры

pDX
Указатель на объект CDataExchange.

szId
Значение, указанное для параметра элемента управления id HTML.

value
Значение, которое обменивается.

CDHtmlDialog::DDX_DHtml_SelectString

Возвращает или задает отображаемый текст записи поля списка (на основе текущего индекса) на HTML-странице.

void DDX_DHtml_SelectString(
    CDataExchange* pDX,
    LPCTSTR szId,
    CString& value);

Параметры

pDX
Указатель на объект CDataExchange.

szId
Значение, указанное для параметра идентификатора элемента управления HTML.

value
Значение, которое обменивается.

CDHtmlDialog::DDX_DHtml_SelectValue

Возвращает или задает значение записи поля списка (на основе текущего индекса) на HTML-странице.

void DDX_DHtml_SelectValue(
    CDataExchange* pDX,
    LPCTSTR szId,
    CString& value);

Параметры

pDX
Указатель на объект CDataExchange.

szId
Значение, указанное для параметра идентификатора элемента управления HTML.

value
Значение, которое обменивается.

Пример

// CString m_strBlurDir;
DDX_DHtml_SelectValue(pDX, L"blurDir", m_strBlurDir);

CDHtmlDialog::DestroyModeless

Отсоединяет диалоговое окно без режима от CDHtmlDialog объекта и уничтожает объект.

void DestroyModeless();

CDHtmlDialog::EnableModeless

Включает диалоговые окна без режима.

STDMETHOD(EnableModeless)(BOOL fEnable);

Параметры

fEnable
См fEnable . в IDocHostUIHandler::EnableModeless пакете SDK для Windows.

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

Возвращает E_NOTIMPL.

Замечания

Эта функция-член является CDHtmlDialog реализацией IDocHostUIHandler::EnableModeless, как описано в пакете SDK для Windows.

CDHtmlDialog::FilterDataObject

Позволяет диалогу фильтровать объекты данных буфера обмена, созданные размещенным браузером.

STDMETHOD(FilterDataObject)(
    IDataObject* pDO,
    IDataObject** ppDORet);

Параметры

pDO
См pDO . в IDocHostUIHandler::FilterDataObject пакете SDK для Windows.

ppDORet
См ppDORet . в IDocHostUIHandler::FilterDataObject пакете SDK для Windows.

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

Возвращает S_FALSE.

Замечания

Эта функция-член является CDHtmlDialog реализацией IDocHostUIHandler::FilterDataObject, как описано в пакете SDK для Windows.

CDHtmlDialog::GetControlDispatch

Извлекает IDispatch интерфейс элемента управления ActiveX, внедренного в HTML-документ, возвращаемый GetDHtmlDocument.

HRESULT GetControlDispatch(
    LPCTSTR szId,
    IDispatch** ppdisp);

Параметры

szId
HTML-идентификатор элемента activeX.

ppdisp
Интерфейс IDispatch элемента управления, если он найден на веб-странице.

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

Стандартное значение HRESULT .

CDHtmlDialog::GetControlProperty

Извлекает запрошенное свойство указанного элемента управления ActiveX.

VARIANT GetControlProperty(
    LPCTSTR szId,
    LPCTSTR szPropName);

VARIANT GetControlProperty(
    LPCTSTR szId,
    DISPID dispId);

VARIANT GetControlProperty(
    IDispatch* pdispControl,
    DISPID dispId);

Параметры

szId
HTML-идентификатор элемента activeX.

szPropName
Имя свойства в языковом стандарте по умолчанию текущего пользователя.

pdispControl
Указатель IDispatch элемента управления ActiveX.

dispId
Идентификатор диспетчера свойства.

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

Вариант, содержащий запрошенное свойство или пустой вариант, если элемент управления или свойство не удалось найти.

Замечания

Перегрузки перечислены от наименее эффективных в верхней до наиболее эффективной в нижней части.

CDHtmlDialog::GetCurrentUrl

Извлекает указатель универсального ресурса (URL-адрес), связанный с текущим документом.

void GetCurrentUrl(CString& szUrl);

Параметры

szUrl
CString Объект, содержащий URL-адрес для извлечения.

CDHtmlDialog::GetDHtmlDocument

Извлекает IHTMLDocument2 интерфейс в текущем загруженном HTML-документе.

HRESULT GetDHtmlDocument(IHTMLDocument2 **pphtmlDoc);

Параметры

**pphtmlDoc Указатель на указатель на HTML-документ.

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

Стандартный HRESULT. Возвращает значение S_OK в случае успешного выполнения.

CDHtmlDialog::GetDropTarget

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

STDMETHOD(GetDropTarget)(
    IDropTarget* pDropTarget,
    IDropTarget** ppDropTarget);

Параметры

pDropTarget
См pDropTarget . в IDocHostUIHandler::GetDropTarget пакете SDK для Windows.

ppDropTarget
См ppDropTarget . в IDocHostUIHandler::GetDropTarget пакете SDK для Windows.

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

Возвращает E_NOTIMPL.

Замечания

Эта функция-член является CDHtmlDialog реализацией IDocHostUIHandler::GetDropTarget, как описано в пакете SDK для Windows.

CDHtmlDialog::GetElement

Возвращает интерфейс в элементе HTML, указанном в параметре szElementId.

HRESULT GetElement(
    LPCTSTR szElementId,
    IDispatch** ppdisp,
    BOOL* pbCollection = NULL);

HRESULT GetElement(
    LPCTSTR szElementId,
    IHTMLElement** pphtmlElement);

Параметры

szElementId
Идентификатор элемента HTML.

ppdisp
Указатель на запрошенный IDispatch элемент или коллекцию элементов.

pbCollection
Указывает BOOL , является ppdisp ли объект одним элементом или коллекцией элементов.

pphtmlElement
Указатель на запрошенный IHTMLElement элемент.

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

Стандартное значение HRESULT .

Замечания

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

Вторая перегрузка завершится ошибкой, если на странице имеется несколько элементов с одним и тем же идентификатором.

CDHtmlDialog::GetElementHtml

Извлекает innerHTML свойство HTML-элемента, определяемого szElementIdпо .

BSTR GetElementHtml(LPCTSTR szElementId);

Параметры

szElementId
Идентификатор элемента HTML.

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

innerHTML Свойство HTML-элемента, определяемого szElementId или NULL если элемент не удалось найти.

CDHtmlDialog::GetElementInterface

Извлекает запрошенный указатель интерфейса из html-элемента, определяемого szElementIdпо .

template <class Q> HRESULT GetElementInterface(
    LPCTSTR szElementId,
    Q** ppvObj);

HRESULT GetElementInterface(
    LPCTSTR szElementId,
    REFIID refiid,
    void** ppvObj);

Параметры

szElementId
Идентификатор элемента HTML.

ppvObj
Адрес указателя, который будет заполнен запрошенным указателем интерфейса, если элемент найден и запрос выполнен успешно.

refiid
Идентификатор интерфейса (IID) запрошенного интерфейса.

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

Стандартное значение HRESULT .

Пример

CComPtr<IHTMLInputButtonElement> spBtn1;
CComPtr<IHTMLInputButtonElement> spBtn2;
HRESULT hr = S_OK;

// Use the template overload
hr = GetElementInterface(L"Button1", &spBtn1);

// Use the nontemplate overload
hr = GetElementInterface(L"Button1", IID_IHTMLInputButtonElement,
                         reinterpret_cast<void **>(&spBtn2));

CDHtmlDialog::GetElementProperty

Извлекает значение свойства, определяемого из HTML-элемента, определяемого dispId szElementId.

VARIANT GetElementProperty(
    LPCTSTR szElementId,
    DISPID dispId);

Параметры

szElementId
Идентификатор элемента HTML.

dispId
Идентификатор диспетчера свойства.

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

Значение свойства или пустого варианта, если свойство или элемент не удалось найти.

CDHtmlDialog::GetElementText

Извлекает innerText свойство HTML-элемента, определяемого szElementIdпо .

BSTR GetElementText(LPCTSTR szElementId);

Параметры

szElementId
Идентификатор элемента HTML.

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

innerText Свойство HTML-элемента, определяемого szElementId или NULL если свойство или элемент не удалось найти.

CDHtmlDialog::GetEvent

IHTMLEventObj Возвращает указатель на текущий объект события.

HRESULT GetEvent(IHTMLEventObj** ppEventObj);

Параметры

ppEventObj
Адрес указателя, который будет заполнен IHTMLEventObj указателем интерфейса.

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

Стандартное значение HRESULT .

Замечания

Эта функция должна вызываться только из обработчика событий DHTML.

CDHtmlDialog::GetExternal

Возвращает интерфейс узла IDispatch .

STDMETHOD(GetExternal)(IDispatch** ppDispatch);

Параметры

ppDispatch
См ppDispatch . в IDocHostUIHandler::GetExternal пакете SDK для Windows.

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

Возвращает успешное выполнение или E_NOTIMPL сбойS_OK.

Замечания

Эта функция-член является CDHtmlDialog реализацией IDocHostUIHandler::GetExternal, как описано в пакете SDK для Windows.

CDHtmlDialog::GetHostInfo

Извлекает возможности пользовательского интерфейса узла.

STDMETHOD(GetHostInfo)(DOCHOSTUIINFO* pInfo);

Параметры

pInfo
См pInfo . в IDocHostUIHandler::GetHostInfo пакете SDK для Windows.

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

Возвращает S_OK.

Замечания

Эта функция-член является CDHtmlDialog реализацией IDocHostUIHandler::GetHostInfo, как описано в пакете SDK для Windows.

CDHtmlDialog::GetOptionKeyPath

Извлекает раздел реестра, в котором хранятся настройки пользователя.

STDMETHOD(GetOptionKeyPath)(
    LPOLESTR* pchKey,
    DWORD dw);

Параметры

pchKey
См pchKey . в IDocHostUIHandler::GetOptionKeyPath пакете SDK для Windows.

dw
См dw . в IDocHostUIHandler::GetOptionKeyPath пакете SDK для Windows.

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

Возвращает E_NOTIMPL.

Замечания

Эта функция-член является CDHtmlDialog реализацией IDocHostUIHandler::GetOptionKeyPath, как описано в пакете SDK для Windows.

CDHtmlDialog::HideUI

Скрывает пользовательский интерфейс узла.

STDMETHOD(HideUI)(void);

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

Возвращает E_NOTIMPL.

Замечания

Эта функция-член является CDHtmlDialog реализацией IDocHostUIHandler::HideUI, как описано в пакете SDK для Windows.

CDHtmlDialog::IsExternalDispatchSafe

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

virtual BOOL IsExternalDispatchSafe();

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

Возвращает FALSE.

CDHtmlDialog::LoadFromResource

Загружает указанный ресурс в элемент управления WebBrowser в диалоговом окне DHTML.

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

Параметры

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

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

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

Значение TRUE в случае успешного выполнения; в противном случае — значение FALSE.

CDHtmlDialog::m_bUseHtmlTitle

Указывает, следует ли использовать заголовок HTML-документа в качестве заголовка диалогового окна.

BOOL m_bUseHtmlTitle;

Замечания

Если m_bUseHtmlTitle это TRUEтак, заголовок диалогового окна равен названию HTML-документа; в противном случае используется заголовок в ресурсе диалога.

CDHtmlDialog::m_nHtmlResID

Идентификатор ресурса HTML для отображения.

UINT m_nHtmlResID;

Пример

CDHtmlDialog mydialog(IDD_MYDHTMLDLG);
mydialog.m_nHtmlResID = IDR_HTML_MYDHTMLDLG;
mydialog.DoModal();

CDHtmlDialog::m_pBrowserApp

Указатель на веб-браузерное приложение.

CComPtr <IWebBrowser2> m_pBrowserApp;

CDHtmlDialog::m_spHtmlDoc

Указатель на HTML-документ.

CComPtr<IHTMLDocument2> m_spHtmlDoc;

CDHtmlDialog::m_strCurrentUrl

Текущий URL-адрес.

CString m_strCurrentUrl;

CDHtmlDialog::m_szHtmlResID

Строка версии идентификатора ресурса HTML.

LPTSTR m_szHtmlResID;

Пример

CDHtmlDialog mydialog(IDD_MYDHTMLDLG);
TCHAR szResID[] = _T("HTML_PAGE");
mydialog.m_szHtmlResID = szResID;
mydialog.DoModal();

Переходит к ресурсу, определяемму URL-адресом, указанным в lpszURL.

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

Параметры

lpszURL
Указатель на строку, содержащую 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.

CDHtmlDialog::OnBeforeNavigate

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

virtual void OnBeforeNavigate(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Параметры

pDisp
Указатель на объект IDispatch.

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

CDHtmlDialog::OnDocumentComplete

Вызывается платформой для уведомления приложения о достижении READYSTATE_COMPLETE состояния документа.

virtual void OnDocumentComplete(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Параметры

pDisp
Указатель на объект IDispatch.

szUrl
Указатель на строку, содержащую URL-адрес, к которому был выполнен переход.

CDHtmlDialog::OnDocWindowActivate

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

STDMETHOD(OnDocWindowActivate)(BOOL fActivate);

Параметры

fActivate
См fActivate . в IDocHostUIHandler::OnDocWindowActivate пакете SDK для Windows.

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

Возвращает E_NOTIMPL.

Замечания

Эта функция-член является CDHtmlDialog реализацией IDocHostUIHandler::OnDocWindowActivate, как описано в пакете SDK для Windows.

CDHtmlDialog::OnFrameWindowActivate

Вызывается платформой при активации или деактивации окна фрейма.

STDMETHOD(OnFrameWindowActivate)(BOOL fActivate);

Параметры

fActivate
См fActivate . в IDocHostUIHandler::OnFrameWindowActivate пакете SDK для Windows.

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

Возвращает E_NOTIMPL.

Замечания

Эта функция-член является CDHtmlDialog реализацией IDocHostUIHandler::OnFrameWindowActivate, как описано в пакете SDK для Windows.

CDHtmlDialog::OnInitDialog

Вызывается в ответ на WM_INITDIALOG сообщение.

virtual BOOL OnInitDialog();

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

Реализация по умолчанию возвращает значение TRUE.

Замечания

Это сообщение отправляется в диалоговое окно во время CreateCreateIndirectвызовов или DoModal вызовов, которые происходят непосредственно перед отображением диалогового окна.

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

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

CDHtmlDialog::OnNavigateComplete

Вызывается платформой после завершения навигации по указанному URL-адресу.

virtual void OnNavigateComplete(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Параметры

pDisp
Указатель на объект IDispatch.

szUrl
Указатель на строку, содержащую URL-адрес, к которому был выполнен переход.

CDHtmlDialog::ResizeBorder

Оповещает объект, который он должен изменить размер пространства границы.

STDMETHOD(ResizeBorder)(
    LPCRECT prcBorder,
    IOleInPlaceUIWindow* pUIWindow,
    BOOL fRameWindow);

Параметры

prcBorder
См prcBorder . в IDocHostUIHandler::ResizeBorder пакете SDK для Windows.

pUIWindow
См pUIWindow . в IDocHostUIHandler::ResizeBorder пакете SDK для Windows.

fFrameWindow
См fFrameWindow . в IDocHostUIHandler::ResizeBorder пакете SDK для Windows.

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

Возвращает E_NOTIMPL.

CDHtmlDialog::SetControlProperty

Задает свойству элемента activeX новое значение.

void SetControlProperty(
    LPCTSTR szElementId,
    DISPID dispId,
    VARIANT* pVar);

void SetControlProperty(
    IDispatch* pdispControl,
    DISPID dispId,
    VARIANT* pVar);

void SetControlProperty(
    LPCTSTR szElementId,
    LPCTSTR szPropName,
    VARIANT* pVar);

Параметры

szElementId
HTML-идентификатор элемента activeX.

dispId
Идентификатор диспетчера заданного свойства.

pVar
Указатель на VARIANT значение нового свойства.

pdispControl
Указатель на интерфейс элемента управления IDispatch ActiveX.

szPropName
Строка, содержащая имя заданного свойства.

CDHtmlDialog::SetElementHtml

innerHTML Задает свойство HTML-элемента.

void SetElementHtml(
    LPCTSTR szElementId,
    BSTR bstrText);

void SetElementHtml(
    IUnknown* punkElem,
    BSTR bstrText);

Параметры

szElementId
Идентификатор элемента HTML.

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

punkElem
Указатель IUnknown html-элемента.

CDHtmlDialog::SetElementProperty

Задает свойство HTML-элемента.

void SetElementProperty(
    LPCTSTR szElementId,
    DISPID dispId,
    VARIANT* pVar);

Параметры

szElementId
Идентификатор элемента HTML.

dispId
Идентификатор диспетчера заданного свойства.

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

CDHtmlDialog::SetElementText

innerText Задает свойство HTML-элемента.

void SetElementText(
    LPCTSTR szElementId,
    BSTR bstrText);

void SetElementText(
    IUnknown* punkElem,
    BSTR bstrText);

Параметры

szElementId
Идентификатор элемента HTML.

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

punkElem
Указатель IUnknown html-элемента.

CDHtmlDialog::SetExternalDispatch

Задает интерфейс узла IDispatch .

void SetExternalDispatch(IDispatch* pdispExternal);

Параметры

pdispExternal
Новый IDispatch интерфейс.

CDHtmlDialog::SetHostFlags

Задает флаги пользовательского интерфейса узла.

void SetHostFlags(DWORD dwFlags);

Параметры

dwFlags
Возможные значения см DOCHOSTUIFLAG . в пакете SDK для Windows.

CDHtmlDialog::ShowContextMenu

Вызывается при отображении контекстного меню.

STDMETHOD(ShowContextMenu)(
    DWORD dwID,
    POINT* ppt,
    IUnknown* pcmdtReserved,
    IDispatch* pdispReserved);

Параметры

dwID
См dwID . в IDocHostUIHandler::ShowContextMenu пакете SDK для Windows.

ppt
См ppt . в IDocHostUIHandler::ShowContextMenu пакете SDK для Windows.

pcmdtReserved
См pcmdtReserved . в IDocHostUIHandler::ShowContextMenu пакете SDK для Windows.

pdispReserved
См pdispReserved . в IDocHostUIHandler::ShowContextMenu пакете SDK для Windows.

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

Возвращает S_FALSE.

Замечания

Эта функция-член является CDHtmlDialog реализацией IDocHostUIHandler::ShowContextMenu, как описано в пакете SDK для Windows.

CDHtmlDialog::ShowUI

Отображает пользовательский интерфейс узла.

STDMETHOD(ShowUI)(
    DWORD dwID,
    IOleInPlaceActiveObject* pActiveObject,
    IOleCommandTarget* pCommandTarget,
    IOleInPlaceFrame* pFrame,
    IOleInPlaceUIWindow* pDoc);

Параметры

dwID
См dwID . в IDocHostUIHandler::ShowUI пакете SDK для Windows.

pActiveObject
См pActiveObject . в IDocHostUIHandler::ShowUI пакете SDK для Windows.

pCommandTarget
См pCommandTarget . в IDocHostUIHandler::ShowUI пакете SDK для Windows.

pFrame
См pFrame . в IDocHostUIHandler::ShowUI пакете SDK для Windows.

pDoc
См pDoc . в IDocHostUIHandler::ShowUI пакете SDK для Windows.

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

Возвращает S_FALSE.

Замечания

Эта функция-член является CDHtmlDialog реализацией IDocHostUIHandler::ShowUI, как описано в пакете SDK для Windows.

CDHtmlDialog::TranslateAccelerator

Вызывается для обработки сообщений акселератора ключей меню.

STDMETHOD(TranslateAccelerator)(
    LPMSG lpMsg,
    const GUID* pguidCmdGroup,
    DWORD nCmdID);

Параметры

lpMsg
См lpMsg . в IDocHostUIHandler::TranslateAccelerator пакете SDK для Windows.

pguidCmdGroup
См pguidCmdGroup . в IDocHostUIHandler::TranslateAccelerator пакете SDK для Windows.

nCmdID
См nCmdID . в IDocHostUIHandler::TranslateAccelerator пакете SDK для Windows.

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

Возвращает S_FALSE.

Замечания

Эта функция-член является CDHtmlDialog реализацией IDocHostUIHandler::TranslateAccelerator, как описано в пакете SDK для Windows.

CDHtmlDialog::TranslateUrl

Вызывается для изменения URL-адреса для загрузки.

STDMETHOD(TranslateUrl)(
    DWORD dwTranslate,
    OLECHAR* pchURLIn,
    OLECHAR** ppchURLOut);

Параметры

dwTranslate
См dwTranslate . в IDocHostUIHandler::TranslateUrl пакете SDK для Windows.

pchURLIn
См pchURLIn . в IDocHostUIHandler::TranslateUrl пакете SDK для Windows.

ppchURLOut
См ppchURLOut . в IDocHostUIHandler::TranslateUrl пакете SDK для Windows.

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

Возвращает S_FALSE.

Замечания

Эта функция-член является CDHtmlDialog реализацией IDocHostUIHandler::TranslateUrl, как описано в пакете SDK для Windows.

CDHtmlDialog::UpdateUI

Вызывается для уведомления узла о том, что состояние команды изменилось.

STDMETHOD(UpdateUI)(void);

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

Возвращает E_NOTIMPL.

Замечания

Эта функция-член является CDHtmlDialog реализацией IDocHostUIHandler::UpdateUI, как описано в пакете SDK для Windows.

См. также

Пример MFC DHtmlExplore
DDX_DHtml Вспомогательные макросы
Диаграмма иерархии