Класс `CDHtmlDialog`

Статья
10/12/2023

Используется для создания диалоговых окон, использующих 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();

`CDHtmlDialog::Navigate`

Переходит к ресурсу, определяемму 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 Вспомогательные макросы
Диаграмма иерархии

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

Класс CDHtmlDialog

Синтаксис

Участники

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

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

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

Замечания

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

Требования

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

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

CDHtmlDialog::CanAccessExternal

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

CDHtmlDialog::CDHtmlDialog

Параметры

Замечания

CDHtmlDialog::~CDHtmlDialog

Замечания

CDHtmlDialog::CreateControlSite

Параметры

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

Замечания

CDHtmlDialog::DDX_DHtml_AxControl

Параметры

Пример

CDHtmlDialog::DDX_DHtml_CheckBox

Параметры

Пример

CDHtmlDialog::DDX_DHtml_ElementText

Параметры

CDHtmlDialog::DDX_DHtml_Radio

Параметры

CDHtmlDialog::DDX_DHtml_SelectIndex

Параметры

CDHtmlDialog::DDX_DHtml_SelectString

Параметры

CDHtmlDialog::DDX_DHtml_SelectValue

Параметры

Пример

CDHtmlDialog::DestroyModeless

CDHtmlDialog::EnableModeless

Параметры

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

Замечания

CDHtmlDialog::FilterDataObject

Параметры

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

Замечания

CDHtmlDialog::GetControlDispatch

Параметры

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

CDHtmlDialog::GetControlProperty

Параметры

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

Замечания

CDHtmlDialog::GetCurrentUrl

Параметры

CDHtmlDialog::GetDHtmlDocument

Параметры

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

CDHtmlDialog::GetDropTarget

Параметры

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

Замечания

CDHtmlDialog::GetElement

Параметры

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

Замечания

CDHtmlDialog::GetElementHtml

Параметры

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

CDHtmlDialog::GetElementInterface

Параметры

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

Пример

CDHtmlDialog::GetElementProperty

Параметры

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

CDHtmlDialog::GetElementText

Класс `CDHtmlDialog`

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

`CDHtmlDialog::CanAccessExternal`

`CDHtmlDialog::CDHtmlDialog`

`CDHtmlDialog::~CDHtmlDialog`

`CDHtmlDialog::CreateControlSite`

`CDHtmlDialog::DDX_DHtml_AxControl`

`CDHtmlDialog::DDX_DHtml_CheckBox`

`CDHtmlDialog::DDX_DHtml_ElementText`

`CDHtmlDialog::DDX_DHtml_Radio`

`CDHtmlDialog::DDX_DHtml_SelectIndex`

`CDHtmlDialog::DDX_DHtml_SelectString`

`CDHtmlDialog::DDX_DHtml_SelectValue`

`CDHtmlDialog::DestroyModeless`

`CDHtmlDialog::EnableModeless`

`CDHtmlDialog::FilterDataObject`

`CDHtmlDialog::GetControlDispatch`

`CDHtmlDialog::GetControlProperty`

`CDHtmlDialog::GetCurrentUrl`

`CDHtmlDialog::GetDHtmlDocument`

`CDHtmlDialog::GetDropTarget`

`CDHtmlDialog::GetElement`

`CDHtmlDialog::GetElementHtml`

`CDHtmlDialog::GetElementInterface`

`CDHtmlDialog::GetElementProperty`

`CDHtmlDialog::GetElementText`

`CDHtmlDialog::GetEvent`

`CDHtmlDialog::GetExternal`

`CDHtmlDialog::GetHostInfo`

`CDHtmlDialog::GetOptionKeyPath`

`CDHtmlDialog::HideUI`

`CDHtmlDialog::IsExternalDispatchSafe`

`CDHtmlDialog::LoadFromResource`

`CDHtmlDialog::m_bUseHtmlTitle`

`CDHtmlDialog::m_nHtmlResID`

`CDHtmlDialog::m_pBrowserApp`

`CDHtmlDialog::m_spHtmlDoc`

`CDHtmlDialog::m_strCurrentUrl`

`CDHtmlDialog::m_szHtmlResID`

`CDHtmlDialog::Navigate`

`CDHtmlDialog::OnBeforeNavigate`

`CDHtmlDialog::OnDocumentComplete`

`CDHtmlDialog::OnDocWindowActivate`

`CDHtmlDialog::OnFrameWindowActivate`

`CDHtmlDialog::OnInitDialog`

`CDHtmlDialog::OnNavigateComplete`

`CDHtmlDialog::ResizeBorder`

`CDHtmlDialog::SetControlProperty`

`CDHtmlDialog::SetElementHtml`

`CDHtmlDialog::SetElementProperty`

`CDHtmlDialog::SetElementText`

`CDHtmlDialog::SetExternalDispatch`

`CDHtmlDialog::SetHostFlags`