Элемент управления WebBrowser для пользователей Visual Basic 6.0

Статья
11/05/2008

Обновлен: Ноябрь 2007

Элемент управления WebBrowser в Visual Basic 6.0 заменяется элементом управления WebBrowser Windows Forms в Visual Basic 2008. Имена некоторых свойств, методов, событий и констант различаются, а в некоторых случаях имеется различие в их поведении.

Концептуальные различия

Элемент управления WebBrowser Visual Basic 6.0, известный также как Microsoft Internet Controls или Shdocvw.dll, является элементом управления ActiveX, который позволяет разместить Internet Explorer в приложении.

Элемент управления Visual Basic 2008WebBrowser предоставляет управляемую оболочку для элемента управления ActiveX WebBrowser. Это позволяет отображать веб-страницы в клиентских приложениях Windows Forms. С помощью элемента управления WebBrowser можно продублировать в приложении функциональные возможности веб-обозревателя Internet Explorer или отключить функциональные возможности Internet Explorer по умолчанию, и использовать этот элемент управления как простое средство просмотра HTML-документов. Данный элемент управления может также использоваться для добавления к форме DHTML-элементов пользовательского интерфейса, а также чтобы скрыть факт их размещения в элементе управления WebBrowser. Такой подход позволяет эффективно сочетать использование веб-элементов управления и элементов управления Windows Forms в рамках одного приложения.

Объект Internet Explorer

Элементы управления Microsoft Internet Controls для Visual Basic 6.0 состоят из двух компонентов: элемента управления WebBrowser и объекта Internet Explorer, который позволяет управлять экземпляром Internet Explorer через OLE-автоматизацию.

В Visual Basic 2008 отсутствует эквивалент объекта Internet Explorer, и его связанные свойства, методы и события более не существуют. OLE-автоматизация больше не поддерживается; можно управлять внешним экземпляром Internet Explorer с помощью языка сценариев VBScript.

Свойство документа

В Visual Basic 6.0 свойство Document возвращает строку, содержащую имя документа HTML; в Visual Basic 2008 оно возвращает сам документ HTML.

Методы Refresh, Refresh2

Метод Refresh2 Visual Basic 6.0 принимает параметр, указывающий уровень обновления; метод RefreshVisual Basic 2008 имеет дополнительный параметр, который можно использовать для определения уровня обновления.

Эквивалентность свойства, метода и события элемента управления WebBrowser

В следующей таблице приведен список свойств, методов и событий Visual Basic 6.0 с их эквивалентами Visual Basic 2008. Свойства, методы и события, имена и поведение которых остались без изменения, не указываются. Если не указано иное, все перечисления Visual Basic 2008 сопоставлены пространству имен System.Windows.Forms.

В этой таблице содержатся ссылки на разделы, в которых объясняются различия в поведении. Если нет прямого эквивалента в Visual Basic 2008, приводятся ссылки на разделы, содержащие альтернативные решения.

Свойства

Visual Basic 6.0	Эквивалент версии Visual Basic 2005
AddressBar	Новая реализация. Было свойством объекта Internet Explorer.
Application	Новая реализация. Было свойством объекта Internet Explorer.
Busy	IsBusy
Container	Parent
Document	Document Примечание. В Visual Basic 6.0 свойство Document возвращает строку, содержащую имя документа HTML; в Visual Basic 2008 оно возвращает сам документ HTML.
DragIcon DragMode	Новая реализация. Дополнительные сведения см. в разделе Действие перетаскивания для пользователей Visual Basic 6.0.
FullName	Новая реализация. Было свойством объекта Internet Explorer.
Height	Height, Size Примечание. Обработка координат в Visual Basic 2008 выполняется иначе. Дополнительные сведения см. в разделе Система координат (для пользователей Visual Basic 6.0).
HelpContextID	Новая реализация. Дополнительные сведения см. в разделе Поддержка справки (для пользователей Visual Basic 6.0).
HWnd	Handle
Index	Новая реализация. Дополнительные сведения см. в разделе Массивы элементов управления для пользователей Visual Basic 6.0.
Left	Left Примечание. Обработка координат в Visual Basic 2008 выполняется иначе. Дополнительные сведения см. в разделе Система координат (для пользователей Visual Basic 6.0).
LocationName LocationURL	Новая реализация. Было свойством объекта Internet Explorer.
MenuBar	Новая реализация. Было свойством объекта Internet Explorer.
Offline	IsOffline
Parent	Метод FindForm
Path	Новая реализация. Было свойством объекта Internet Explorer.
RegisterAsBrowser	Новая реализация. Было свойством объекта Internet Explorer.
RegisterAsDropTarget	AllowWebBrowserDrop
Resizable	Новая реализация. Было свойством объекта Internet Explorer.
Silent	ScriptErrorsSuppressed
StatusBar StatusText	Новая реализация. Было свойством объекта Internet Explorer.
TheaterMode	Новая реализация. Было свойством объекта Internet Explorer.
ToolBar	Новая реализация. Было свойством объекта Internet Explorer.
ToolTipText	Компонент ToolTip. Дополнительные сведения см. в разделе Поддержка подсказок (для пользователей Visual Basic 6.0).
Top	Top Примечание. Обработка координат в Visual Basic 2008 выполняется иначе. Дополнительные сведения см. в разделе Система координат (для пользователей Visual Basic 6.0).
TopLevelContainer	Новая реализация. Было свойством объекта Internet Explorer.
Type	DocumentType
WhatsThisHelpID	Новая реализация. Дополнительные сведения см. в разделе Поддержка справки (для пользователей Visual Basic 6.0).
Width	Width, Size Примечание. Обработка координат в Visual Basic 2008 выполняется иначе. Дополнительные сведения см. в разделе Система координат (для пользователей Visual Basic 6.0).

Методы

Visual Basic 6.0	Эквивалент версии Visual Basic 2005
ClientToWindow	PointToClient
Drag	Новая реализация. Дополнительные сведения см. в разделе Действие перетаскивания для пользователей Visual Basic 6.0.
ExecWB	Новая реализация. Был методом объекта Internet Explorer.
GetProperty	Новая реализация. Был методом объекта Internet Explorer.
Move	SetBounds Примечание. Обработка координат в Visual Basic 2008 выполняется иначе. Дополнительные сведения см. в разделе Система координат (для пользователей Visual Basic 6.0).
Navigate2	Новая реализация. Был методом объекта Internet Explorer.
OLEDrag	Новая реализация. Дополнительные сведения см. в разделе Действие перетаскивания для пользователей Visual Basic 6.0.
PutProperty	Новая реализация. Был методом объекта Internet Explorer.
QueryStatusWB	Новая реализация. Был методом объекта Internet Explorer.
Quit	Новая реализация. Был методом объекта Internet Explorer.
Refresh Refresh2	Refresh Примечание. Метод Refresh2 Visual Basic 6.0 принимает параметр, определяющий уровень обновления; метод RefreshVisual Basic 2008 содержит дополнительный параметр, который можно использовать для определения уровня обновления.
SetFocus	Focus
ShowBrowserBar	Новая реализация. Был методом объекта Internet Explorer.
ShowWhatsThis	Новая реализация. Дополнительные сведения см. в разделе Поддержка справки (для пользователей Visual Basic 6.0).
ZOrder	Функция BringToFront или SendToBack

События

Visual Basic 6.0	Эквивалент версии Visual Basic 2005
BeforeNavigate BeforeNavigate2	Navigating
ClientToHostWindow	Новая реализация. Было событием объекта Internet Explorer.
CommandStateChanged	CanGoBackChanged CanGoForwardChanged
DblClick	DoubleClick
DocumentComplete DownloadBegin DownloadComplete	DocumentCompleted
DragDrop DragOver	Новая реализация. Дополнительные сведения см. в разделе Действие перетаскивания для пользователей Visual Basic 6.0.
GotFocus	Enter
LostFocus	Leave
NavigateComplete NavigateComplete2	Navigated
NavigateError	Новая реализация. Было событием объекта Internet Explorer.
NewWindow NewWindow2 NewWindow3	NewWindow
OnFullScreen OnMenuBar OnQuit OnStatusBar OnTheaterMode OnToolBar OnVisible	Новая реализация. Было событием объекта Internet Explorer.
PrintTemplateInstantiation PrintTemplateTearDown PrivacyImpactedStateChange	Новая реализация. Было событием объекта Internet Explorer.
ProgressChange	ProgressChanged
PropertyChange	Новая реализация. Было событием объекта Internet Explorer.
SetSecureLockIcon	EncryptionLevelChanged
StatusTextChange	StatusTextChanged
TitleChange	DocumentTitleChanged
UpdatePageStatus	Новая реализация. Было событием объекта Internet Explorer.
Validate	Validating
WindowClosing WindowSetHeight WindowSetLeft WindowSetResizable WindowSetTop WindowSetWidth	Новая реализация. Было событием объекта Internet Explorer.

Замечания по обновлению

При обновлении приложения Visual Basic 6.0 до Visual Basic 2008 все элементы управления WebBrowser обновляются до элементов управления WebBrowser Windows Forms, а свойства, методы и события обновляются до их эквивалентов. Если возможно различие в поведении, в соответствующий код вставляются комментарии об обновлении.

См. также

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