Интерфейс IAxWinHostWindow

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

Важно!

Этот класс и его члены нельзя использовать в приложениях, выполняемых в среде выполнения Windows.

Синтаксис

interface IAxWinHostWindow : IUnknown

Участники

Методы

Имя	Описание
AttachControl	Присоединяет существующий элемент управления к объекту узла.
CreateControl	Создает элемент управления и присоединяет его к объекту узла.
CreateControlEx	Создает элемент управления, присоединяет его к объекту узла и при необходимости настраивает обработчик событий.
QueryControl	Возвращает указатель интерфейса на размещенный элемент управления.
SetExternalDispatch	Задает внешний IDispatch интерфейс.
SetExternalUIHandler	Задает внешний IDocHostUIHandlerDispatch интерфейс.

Замечания

Этот интерфейс предоставляется объектами управления ActiveX atL. Вызовите методы в этом интерфейсе, чтобы создать и (или) присоединить элемент управления к объекту узла, получить интерфейс из размещенного элемента управления или задать внешний обработчик dispinterface или пользовательского интерфейса для использования при размещении веб-браузера.

Требования

Определение этого интерфейса доступно как IDL или C++, как показано ниже.

Тип определения	Файл
IDL	ATLIFace.idl
C++	ATLIFace.h (также включен в ATLBase.h)

IAxWinHostWindow::AttachControl

Присоединяет существующий (и ранее инициализированный) элемент управления к объекту узла с помощью окна, определяемого hWnd.

STDMETHOD(AttachControl)(IUnknown* pUnkControl, HWND hWnd);

Параметры

pUnkControl
[in] Указатель на IUnknown интерфейс элемента управления, присоединенного к объекту узла.

hWnd
[in] Дескриптор окна, который будет использоваться для размещения.

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

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

IAxWinHostWindow::CreateControl

Создает элемент управления, инициализирует его и размещает его в окне, определяемом hWnd.

STDMETHOD(CreateControl)(
    LPCOLESTR lpTricsData,
    HWND hWnd,
    IStream* pStream);

Параметры

lpTricsData
[in] Строка, определяющая элемент управления для создания. Может быть CLSID (должен включать фигурные скобки), ProgID, URL-адрес или необработанный HTML (префикс MSHTML :).

hWnd
[in] Дескриптор окна, который будет использоваться для размещения.

pStream
[in] Указатель интерфейса для потока, содержащего данные инициализации для элемента управления. Может иметь значение NULL.

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

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

Замечания

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

Вызов этого метода эквивалентен вызову IAxWinHostWindow::CreateControlEx.

Сведения о создании лицензированного элемента ActiveX см. в разделе IAxWinHostWindowLic::CreateControlLic.

IAxWinHostWindow::CreateControlEx

Создает элемент ActiveX, инициализирует его и размещает его в указанном окне, аналогично IAxWinHostWindow::CreateControl.

STDMETHOD(CreateControlEx)(
    LPCOLESTR lpszTricsData,
    HWND hWnd,
    IStream* pStream,
    IUnknown** ppUnk,
    REFIID riidAdvise,
    IUnknown* punkAdvise);

Параметры

lpTricsData
[in] Строка, определяющая элемент управления для создания. Может быть CLSID (должен включать фигурные скобки), ProgID, URL-адрес или необработанный HTML (префикс с ПОМОЩЬЮ MSHTML:).

hWnd
[in] Дескриптор окна, который будет использоваться для размещения.

pStream
[in] Указатель интерфейса для потока, содержащего данные инициализации для элемента управления. Может иметь значение NULL.

ppUnk
[out] Адрес указателя, который получит IUnknown интерфейс созданного элемента управления. Может иметь значение NULL.

riidAdvise
[in] Идентификатор интерфейса исходящего интерфейса в содержащемся объекте. Можно IID_NULL.

punkAdvise
[in] Указатель на IUnknown интерфейс объекта приемника, который должен быть подключен к точке подключения к автономному объекту, указанному iidSink.

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

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

Замечания

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

Сведения о создании лицензированного элемента ActiveX см. в разделе IAxWinHostWindowLic::CreateControlLicEx.

IAxWinHostWindow::QueryControl

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

STDMETHOD(QueryControl)(
    REFIID riid,
    void** ppvObject);

Параметры

riid
[in] Идентификатор интерфейса для запрашиваемого элемента управления.

ppvObject
[out] Адрес указателя, который получит указанный интерфейс созданного элемента управления.

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

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

IAxWinHostWindow::SetExternalDispatch

Задает внешний dispinterface, который доступен для содержащихся элементов управления с помощью метода IDocHostUIHandlerDispatch::GetExternal .

STDMETHOD(SetExternalDispatch)(IDispatch* pDisp);

Параметры

pDisp
[in] Указатель на IDispatch интерфейс.

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

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

IAxWinHostWindow::SetExternalUIHandler

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

STDMETHOD(SetExternalUIHandler)(IDocHostUIHandlerDispatch* pDisp);

Параметры

pDisp
[in] Указатель на IDocHostUIHandlerDispatch интерфейс.

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

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

Замечания

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

См. также

Интерфейс IAxWinAmbientDispatch
CAxWindow::QueryHost
AtlAxGetHost