╨рчЁрсюЄър яЁшыюцхэшщ фы  Internet

       

╩ырёё CWebBrowser


╬яЁхфхыхэшх ъырёёр CWebBrowser Ёрёяюыюцхэю т Їрщых webbrowser.h, шёїюфэ√щ ЄхъёЄ ъюЄюЁюую яЁхфёЄртыхэ т ышёЄшэух 4.1. ╠хЄюф√ GetClsid ш Create юяЁхфхыхэ√ эхяюёЁхфёЄтхээю т ёрьюь ъырёёх CWebBrowser. ╬ёЄры№э√х ьхЄюф√ ъырёёр CWebBrowser юяЁхфхыхэ√ т Їрщых webbrowser.cpp, ёюфхЁцр∙шьё  т ышёЄшэух 4.3. ╠√ юёЄртшыш ъюььхэЄрЁшш эр рэуышщёъюь  ч√ъх, ъюЄюЁ√х с√ыш фюсртыхэ√ тю тЁхь  тёЄртъш Microsoft Web Browser Control т яЁюхъЄ.

╦шёЄшэу 4.3. ╘рщы webbrowser.h

#ifndef __WEBBROWSER_H__

#define __WEBBROWSER_H__

// Machine generated IDispatch wrapper class(es) created by

// Microsoft Visual C++

// NOTE: Do not modify the contents of this file.а If this

// class is regenerated by Microsoft Visual C++, your

// modifications will be overwritten.

//////////////////////////////////////////////////////////////

// CWebBrowser wrapper class

class CWebBrowser : public CWnd

{



protected:

аа DECLARE_DYNCREATE(CWebBrowser)

public:

аа CLSID const& GetClsid()

аа {

ааааа static CLSID const clsid

аааааааа = { 0xeab22ac3, 0x30c1, 0x11cf,

аааааааааааа { 0xa7, 0xeb, 0x0, 0x0, 0xc0, 0x5b, 0xae, 0xb }

аааааааааа };

ааааа return clsid;

аа }

аа virtual BOOL Create(

ааааа LPCTSTR lpszClassName,

ааааа LPCTSTR lpszWindowName, DWORD dwStyle,

ааааа const RECT& rect,

ааааа CWnd* pParentWnd, UINT nID,

ааааа CCreateContext* pContext = NULL)

аа {

ааааа return CreateControl(

аааааааа GetClsid(),

аааааааа lpszWindowName,

аааааааа dwStyle,

аааааааа rect,

аааааааа pParentWnd,

аааааааа nID);

аа }

аа BOOL Create(LPCTSTR lpszWindowName, DWORD dwStyle,

ааааа const RECT& rect, CWnd* pParentWnd, UINT nID,

ааааа CFile* pPersist = NULL, BOOL bStorage = FALSE,

ааааа BSTR bstrLicKey = NULL)

аа {

ааааа return CreateControl(

аааааааа GetClsid(),

аааааааа lpszWindowName,

аааааааа dwStyle,

аааааааа rect,

аааааааа pParentWnd,

аааааааа nID,

аааааааа pPersist,

аааааааа bStorage,

аааааааа bstrLicKey);

аа }

// Operations


public:

   // method 'QueryInterface' not emitted because of invalid

   // return type or parameter type

   unsigned long AddRef();

   unsigned long Release();

   // method 'GetTypeInfoCount' not emitted because of invalid

   // return type or parameter type

   // method 'GetTypeInfo' not emitted because of invalid

   // return type or parameter type

   // method 'GetIDsOfNames' not emitted because of invalid

   // return type or parameter type

   // method 'Invoke' not emitted because of invalid return

   // type or parameter type

   void GoBack();

   void GoForward();

   void GoHome();

   void GoSearch();

   void Navigate(

      LPCTSTR URL, VARIANT* Flags, VARIANT* TargetFrameName,

      VARIANT* PostData, VARIANT* Headers);

   void Refresh();

   void Refresh2(VARIANT* Level);

   void Stop();

   LPDISPATCH GetApplication();

   LPDISPATCH GetParent();

   LPDISPATCH GetContainer();

   LPDISPATCH GetDocument();

   BOOL GetTopLevelContainer();

   CString GetType();

   long GetLeft();

   void SetLeft(long nNewValue);

   long GetTop();

   void SetTop(long nNewValue);

   long GetWidth();

   void SetWidth(long nNewValue);

   long GetHeight();

   void SetHeight(long nNewValue);

   CString GetLocationName();

   CString GetLocationURL();

   BOOL GetBusy();

};

#endif // __WEBBROWSER_H__

Не рекомендуется вносить изменения в исходные тексты класса CWebBrowser и тексты его методов, расположенные в файлах webbrowser.h и webbrowser.cpp. Эти файлы могут быть созданы Microsoft Visual C++ заново, если вы повторно вставите орган управления Microsoft Web Browser в проект. В этом случае все изменения, внесенные вами в файлы webbrowser.h и webbrowser.cpp будут уничтожены.

Если у вас все же возникнет необходимость модифицировать класс CWebBrowser, создайте новый класс, порожденный от класса CWebBrowser и используйте его.

¨     Когда вы добавляете в проект орган управления Microsoft Web Browser Control, в файле определения класса отмечается, что ряд методов (QueryInterface, AddRef, Release, GetTypeInfoCount, GetTypeInfo, GetIDsOfNames, Invoke) не подключены, так как они имеют неправильный тип возвращаемого значения или неправильный тип параметров. В случае если вы пользуетесь Microsoft Visual C++ версии 5.0 эти сообщения не появляются, но перечисленные методы также не будут доступны



Все методы класса CWebBrowser, за исключением метода GetClsid и двух модификаций метода Create, определены в файле webbrowser.cpp. Исходный текст этого файла представлен в листинге 4.4. Методы GetClsid и Create определены непосредственно в описании класса CWebBrowser (листинг 4.3).

Листинг 4.4. Файл webbrowser.cpp

// Machine generated IDispatch wrapper class(es) created by

// Microsoft Visual C++

// NOTE: Do not modify the contents of this file.  If this

// class is regenerated by Microsoft Visual C++, your

// modifications will be overwritten.

#include "stdafx.h"

#include "webbrowser.h"

//////////////////////////////////////////////////////////////

// CWebBrowser

IMPLEMENT_DYNCREATE(CWebBrowser, CWnd)

//////////////////////////////////////////////////////////////

// CWebBrowser properties

//////////////////////////////////////////////////////////////

// CWebBrowser operations

unsigned long CWebBrowser::AddRef()

{

   unsigned long result;

   InvokeHelper(0x60000001, DISPATCH_METHOD, VT_I4,

      (void*)&result, NULL);

   return result;

}

unsigned long CWebBrowser::Release()

{

   unsigned long result;

   InvokeHelper(0x60000002, DISPATCH_METHOD, VT_I4,

      (void*)&result, NULL);

   return result;

}

void CWebBrowser::GoBack()

{

   InvokeHelper(0x64, DISPATCH_METHOD, VT_EMPTY, NULL, NULL);

}

void CWebBrowser::GoForward()

{

   InvokeHelper(0x65, DISPATCH_METHOD, VT_EMPTY, NULL, NULL);

}

void CWebBrowser::GoHome()

{

   InvokeHelper(0x66, DISPATCH_METHOD, VT_EMPTY, NULL, NULL);

}

void CWebBrowser::GoSearch()

{

   InvokeHelper(0x67, DISPATCH_METHOD, VT_EMPTY, NULL, NULL);

}

void CWebBrowser::Navigate(

   LPCTSTR URL,

   VARIANT* Flags,

   VARIANT* TargetFrameName,

   VARIANT* PostData,

   VARIANT* Headers)

{

   static BYTE parms[] =

      VTS_BSTR VTS_PVARIANT VTS_PVARIANT

      VTS_PVARIANT VTS_PVARIANT;



   InvokeHelper(0x68, DISPATCH_METHOD, VT_EMPTY, NULL, parms,

       URL, Flags, TargetFrameName, PostData, Headers);

}

void CWebBrowser::Refresh()

{

   InvokeHelper(DISPID_REFRESH, DISPATCH_METHOD, VT_EMPTY,

      NULL, NULL);

}

void CWebBrowser::Refresh2(VARIANT* Level)

{

   static BYTE parms[] = VTS_PVARIANT;

   InvokeHelper(0x69, DISPATCH_METHOD, VT_EMPTY, NULL, parms,

      Level);

}

void CWebBrowser::Stop()

{

   InvokeHelper(0x6a, DISPATCH_METHOD, VT_EMPTY, NULL, NULL);

}

LPDISPATCH CWebBrowser::GetApplication()

{

   LPDISPATCH result;

   InvokeHelper(0xc8, DISPATCH_PROPERTYGET, VT_DISPATCH,

      (void*)&result, NULL);

   return result;

}

LPDISPATCH CWebBrowser::GetParent()

{

   LPDISPATCH result;

   InvokeHelper(0xc9, DISPATCH_PROPERTYGET, VT_DISPATCH,

      (void*)&result, NULL);

   return result;

}

LPDISPATCH CWebBrowser::GetContainer()

{

   LPDISPATCH result;

   InvokeHelper(0xca, DISPATCH_PROPERTYGET, VT_DISPATCH,

      (void*)&result, NULL);

   return result;

}

LPDISPATCH CWebBrowser::GetDocument()

{

   LPDISPATCH result;

   InvokeHelper(0xcb, DISPATCH_PROPERTYGET, VT_DISPATCH,

      (void*)&result, NULL);

   return result;

}

BOOL CWebBrowser::GetTopLevelContainer()

{

   BOOL result;

   InvokeHelper(0xcc, DISPATCH_PROPERTYGET, VT_BOOL,

      (void*)&result, NULL);

   return result;

}

CString CWebBrowser::GetType()

{

   CString result;

   InvokeHelper(0xcd, DISPATCH_PROPERTYGET, VT_BSTR,

      (void*)&result, NULL);

   return result;

}

long CWebBrowser::GetLeft()

{

   long result;

   InvokeHelper(0xce, DISPATCH_PROPERTYGET, VT_I4,

      (void*)&result, NULL);

   return result;

}

void CWebBrowser::SetLeft(long nNewValue)

{

   static BYTE parms[] = VTS_I4;

   InvokeHelper(0xce, DISPATCH_PROPERTYPUT, VT_EMPTY, NULL,

      parms, nNewValue);

}

long CWebBrowser::GetTop()



{

   long result;

   InvokeHelper(0xcf, DISPATCH_PROPERTYGET, VT_I4,

      (void*)&result, NULL);

   return result;

}

void CWebBrowser::SetTop(long nNewValue)

{

   static BYTE parms[] = VTS_I4;

   InvokeHelper(0xcf, DISPATCH_PROPERTYPUT, VT_EMPTY, NULL,

      parms, nNewValue);

}

long CWebBrowser::GetWidth()

{

   long result;

   InvokeHelper(0xd0, DISPATCH_PROPERTYGET, VT_I4,

      (void*)&result, NULL);

   return result;

}

void CWebBrowser::SetWidth(long nNewValue)

{

   static BYTE parms[] = VTS_I4;

   InvokeHelper(0xd0, DISPATCH_PROPERTYPUT, VT_EMPTY, NULL,

   parms, nNewValue);

}

long CWebBrowser::GetHeight()

{

   long result;

   InvokeHelper(0xd1, DISPATCH_PROPERTYGET, VT_I4,

      (void*)&result, NULL);

   return result;

}

void CWebBrowser::SetHeight(long nNewValue)

{

   static BYTE parms[] = VTS_I4;

   InvokeHelper(0xd1, DISPATCH_PROPERTYPUT, VT_EMPTY, NULL,

   parms, nNewValue);

}

CString CWebBrowser::GetLocationName()

{

   CString result;

   InvokeHelper(0xd2, DISPATCH_PROPERTYGET, VT_BSTR,

      (void*)&result, NULL);

   return result;

}

CString CWebBrowser::GetLocationURL()

{

   CString result;

   InvokeHelper(0xd3, DISPATCH_PROPERTYGET, VT_BSTR,

      (void*)&result, NULL);

   return result;

}

BOOL CWebBrowser::GetBusy()

{

   BOOL result;

   InvokeHelper(0xd4, DISPATCH_PROPERTYGET, VT_BOOL,

      (void*)&result, NULL);

   return result;

}

Все методы, определенные в файле webbrowser.cpp, вызывают вспомогательный метод InvokeHelper класса CWnd, передавая ему различные параметры. В зависимости от своих параметров, метод InvokeHelper, в свою очередь, вызывает те или иные методы органа управления ActiveX. В нашем случае в качестве этого органа управления выступает Microsoft Web Browser Control.

Подробное описание Microsoft Web Browser Control, включая описание управляющего класса, смотрите на странице http://www.microsoft.com сервера WWW компании Microsoft. В следующей таблице мы дадим краткое описание основных методов класса CWebBrowser:



Метод

Описание

GetBusy

Позволяет узнать, выполняет ли орган управления Microsoft Web Browser Control в данный момент времени загрузку данных из Internet

GetHeight

Определяет вертикальный размер окна (frame window), содержащего орган управления Web Browser

GetLeft

Определяет расстояние между внутренней левой стороной органа управления Web Browser и левой стороной его контейнера (содержащего его окна)

GetLocationName

Определяет имя ресурса Internet, который отображается органом управления Microsoft Web Browser Control

GetLocationURL

Определяет URL имя ресурса Internet, который отображается органом управления Microsoft Web Browser Control

GetTop

Определяет расстояние между внутренней верхней стороной органа управления Web Browser и верхней стороной его контейнера

GetWidth

Определяет горизонтальный размер окна (frame window), содержащего орган управления Web Browser

GoBack

Вернуться к просмотру предыдущей страницы WWW

GoForward

Перейти к просмотру следующей страницы WWW. Этот метод можно использовать, если вы вернулись к просмотру предыдущей страницы WWW с помощью метода GoBack

GoHome

Перейти к просмотру домашней страницы WWW. Адрес домашней страницы Microsoft Internet Explorer можно изменить через панель управления Control Panel, запустив приложение Internet. Приложение Internet отображает на экране диалоговую панель Internet Properties. В ней надо выбрать страницу Navigation, а затем выбрать из списка Page строку Start Page (начальная или домашняя страница) и ввести ее адрес в поле Address

GoSearch

Перейти к просмотру поисковой страницы WWW. Адрес поисковой страницы Microsoft Internet Explorer можно изменить через панель управления Control Panel, запустив приложение Internet

Navigate

Перейти к просмотру страницы WWW с заданным адресом. Именно этот метод мы будем использовать в приложении Look чтобы перейти к просмотру определенной страницы WWW

Refresh, Refresh2

Обновить информацию текущей страницы WWW

SetHeight

Устанавливает вертикальный размер окна (frame window), содержащего орган управления Web Browser

SetLeft

Устанавливает расстояние между внутренней левой стороной органа управления Web Browser и левой стороной его контейнера

SetTop

Устанавливает расстояние между внутренней верхней стороной органа управления Web Browser и верхней стороной его контейнера

SetWidth

Устанавливает горизонтальный размер окна (frame window), содержащего орган управления Web Browser

Stop

Остановить загрузку страницы WWW

<


Класс CWebBrowser, представляющий орган управления Microsoft Web Browser Control, также содержит целый ряд методов, которые вызываются в различных ситуациях. В следующей таблице мы привели список этих методов и дали им краткие описания.

Метод

Описание

BeforeNavigate

Вызывается когда навигатор переходит к просмотру другого URL

CommandStateChange

Выполнение определенных команд разрешено или запрещено

DownloadBegin

Началась загрузка ресурса

DownloadComplete

Загрузка ресурса завершается, останавливается или прерывается

FrameBeforeNavigate

Навигатор приступает к загрузке нового ресурса с другим адресом URL. Происходит, если на данной странице WWW присутствуют фреймы

FrameNavigateComplete

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

FrameNewWindow

Создано новое окно. Происходит, если на данной странице WWW присутствуют фреймы

NavigateComplete

Навигатор успешно загрузил новый ресурс

NewWindow

Новое окно должно быть создано для отображения ресурсса

ProgressChange

Изменилось состояние процесса загрузки

Quit

Приложение Internet Explorer готово завершиться

StatusTextChange

Изменяется текст в панели состояния

TitleChange

Заголовок документа в окне навигатора получен или изменен

WindowActivate

Окно навигатора получило упраавление

WindowMove

Окно навигатора переместилось

WindowResize

Изменен размер окна навигатора


╤юфхЁцрэшх Ёрчфхыр