Contrôle WebBrowser pour les utilisateurs de Visual Basic 6.0

Mise à jour : novembre 2007

Le contrôle WebBrowser de Visual Basic 6.0 est remplacé par le contrôle Windows Forms WebBrowser dans Visual Basic 2008. Les noms de certains événements, propriétés, méthodes et constantes ont changé. En outre, dans certains cas, leur comportement est également différent.

Différences conceptuelles

Le contrôle de Visual Basic 6.0 WebBrowser, également appelé contrôle Microsoft Internet ou Shdocvw.dll, est un contrôle ActiveX qui vous permet d'héberger Internet Explorer à l'intérieur de votre application.

Le contrôle Visual Basic 2008WebBrowser fournit un wrapper managé destiné au contrôle ActiveX WebBrowser. Vous pouvez ainsi afficher des pages Web dans vos applications clientes Windows Forms. Vous pouvez utiliser le contrôle WebBrowser pour dupliquer la fonctionnalité de navigation Web d'Internet Explorer dans votre application, ou désactiver la fonctionnalité Internet Explorer par défaut et utiliser le contrôle comme une simple visionneuse de documents HTML. Vous pouvez également utiliser le contrôle pour ajouter des éléments d'interface utilisateur DHTML à votre formulaire et masquer le fait qu'ils sont hébergés dans le contrôle WebBrowser. Cette approche vous permet de combiner de façon transparente les contrôles Web et Windows Forms dans une même application.

Objet Internet Explorer

Les Contrôles Microsoft Internet de Visual Basic 6.0 se composent de deux composants : le contrôle WebBrowser et un objet Internet Explorer qui vous permettent de contrôler une instance d'Internet Explorer via OLE Automation.

Il n'y a pas d'équivalent de l'objet Internet Explorer dans Visual Basic 2008, et ses propriétés, méthodes et événements associés n'existent plus. OLE Automation n'est plus pris en charge. Vous pouvez contrôler une instance externe d'Internet Explorer à l'aide d'un langage de script tel que VBScript.

Propriété du document

Dans Visual Basic 6.0, la propriété Document retourne une chaîne qui contient le nom d'un document HTML ; dans Visual Basic 2008, elle retourne le document HTML lui-même.

Méthodes Refresh, Refresh2

La méthode Refresh2 de Visual Basic 6.0 utilise un paramètre qui spécifie le niveau d'actualisation ; la méthode Visual Basic 2008Refresh possède un paramètre optionnel qui peut être utilisé pour spécifier le niveau d'actualisation.

Équivalences des propriétés, méthodes et événements du contrôle WebBrowser

Les tableaux ci-dessous répertorient les propriétés, les méthodes et les événements de Visual Basic 6.0, ainsi que leurs équivalents dans Visual Basic 2008. Ces propriétés, méthodes et événements qui ont les mêmes nom et comportement ne sont pas répertoriés. Sauf indication contraire, toutes les énumérations Visual Basic 2008 sont mappées à l'espace de noms System.Windows.Forms.

Ce tableau fournit des liens vers les rubriques qui expliquent des différences de comportement. Lorsqu'il n'existe pas d'équivalent direct dans Visual Basic 2008, des liens vous renvoient vers des rubriques proposant des alternatives.

Propriétés

Visual Basic 6.0	Équivalent Visual Basic 2005
AddressBar	Nouvelle implémentation. Il s'agissait d'une propriété de l'objet Internet Explorer.
Application	Nouvelle implémentation. Il s'agissait d'une propriété de l'objet Internet Explorer.
Busy	IsBusy
Container	Parent
Document	Document Remarque : Dans Visual Basic 6.0, la propriété Document retourne une chaîne qui contient le nom d'un document HTML ; dans Visual Basic 2008, elle retourne le document HTML lui-même.
DragIcon DragMode	Nouvelle implémentation. Pour plus d'informations, consultez Fonction de glisser-déplacer pour les utilisateurs de Visual Basic 6.0.
FullName	Nouvelle implémentation. Il s'agissait d'une propriété de l'objet Internet Explorer.
Height	Height, Size Remarque : Les coordonnées sont gérées différemment dans Visual Basic 2008. Pour plus d'informations, consultez Système de coordonnées pour les utilisateurs de Visual Basic 6.0.
HelpContextID	Nouvelle implémentation. Pour plus d'informations, consultez Prise en charge de l'aide pour les utilisateurs de Visual Basic 6.0.
HWnd	Handle
Index	Nouvelle implémentation. Pour plus d'informations, consultez Tableaux de contrôles pour les utilisateurs de Visual Basic 6.0.
Left	Left Remarque : Les coordonnées sont gérées différemment dans Visual Basic 2008. Pour plus d'informations, consultez Système de coordonnées pour les utilisateurs de Visual Basic 6.0.
LocationName LocationURL	Nouvelle implémentation. Il s'agissait d'une propriété de l'objet Internet Explorer.
MenuBar	Nouvelle implémentation. Il s'agissait d'une propriété de l'objet Internet Explorer.
Offline	IsOffline
Parent	Méthode FindForm
Path	Nouvelle implémentation. Il s'agissait d'une propriété de l'objet Internet Explorer.
RegisterAsBrowser	Nouvelle implémentation. Il s'agissait d'une propriété de l'objet Internet Explorer.
RegisterAsDropTarget	AllowWebBrowserDrop
Resizable	Nouvelle implémentation. Il s'agissait d'une propriété de l'objet Internet Explorer.
Silent	ScriptErrorsSuppressed
StatusBar StatusText	Nouvelle implémentation. Il s'agissait d'une propriété de l'objet Internet Explorer.
TheaterMode	Nouvelle implémentation. Il s'agissait d'une propriété de l'objet Internet Explorer.
ToolBar	Nouvelle implémentation. Il s'agissait d'une propriété de l'objet Internet Explorer.
ToolTipText	Composant ToolTip. Pour plus d'informations, consultez Prise en charge des info-bulles pour les utilisateurs de Visual Basic 6.0.
Top	Top Remarque : Les coordonnées sont gérées différemment dans Visual Basic 2008. Pour plus d'informations, consultez Système de coordonnées pour les utilisateurs de Visual Basic 6.0.
TopLevelContainer	Nouvelle implémentation. Il s'agissait d'une propriété de l'objet Internet Explorer.
Type	DocumentType
WhatsThisHelpID	Nouvelle implémentation. Pour plus d'informations, consultez Prise en charge de l'aide pour les utilisateurs de Visual Basic 6.0.
Width	Width, Size Remarque : Les coordonnées sont gérées différemment dans Visual Basic 2008. Pour plus d'informations, consultez Système de coordonnées pour les utilisateurs de Visual Basic 6.0.

Méthodes

Visual Basic 6.0	Équivalent Visual Basic 2005
ClientToWindow	PointToClient
Drag	Nouvelle implémentation. Pour plus d'informations, consultez Fonction de glisser-déplacer pour les utilisateurs de Visual Basic 6.0.
ExecWB	Nouvelle implémentation. Il s'agissait d'une méthode de l'objet Internet Explorer.
GetProperty	Nouvelle implémentation. Il s'agissait d'une méthode de l'objet Internet Explorer.
Move	SetBounds Remarque : Les coordonnées sont gérées différemment dans Visual Basic 2008. Pour plus d'informations, consultez Système de coordonnées pour les utilisateurs de Visual Basic 6.0.
Navigate2	Nouvelle implémentation. Il s'agissait d'une méthode de l'objet Internet Explorer.
OLEDrag	Nouvelle implémentation. Pour plus d'informations, consultez Fonction de glisser-déplacer pour les utilisateurs de Visual Basic 6.0.
PutProperty	Nouvelle implémentation. Il s'agissait d'une méthode de l'objet Internet Explorer.
QueryStatusWB	Nouvelle implémentation. Il s'agissait d'une méthode de l'objet Internet Explorer.
Quit	Nouvelle implémentation. Il s'agissait d'une méthode de l'objet Internet Explorer.
Refresh Refresh2	Refresh Remarque : La méthode Refresh2 de Visual Basic 6.0 utilisait un paramètre spécifiant le niveau d'actualisation ; la méthode Visual Basic 2008Refresh possède un paramètre optionnel qui peut être utilisé pour spécifier le niveau d'actualisation.
SetFocus	Focus
ShowBrowserBar	Nouvelle implémentation. Il s'agissait d'une méthode de l'objet Internet Explorer.
ShowWhatsThis	Nouvelle implémentation. Pour plus d'informations, consultez Prise en charge de l'aide pour les utilisateurs de Visual Basic 6.0.
ZOrder	Fonction BringToFront ou SendToBack

Événements

Mettre à niveau des remarques

Lorsqu'une application Visual Basic 6.0 est mise à niveau vers Visual Basic 2008, tous les contrôles WebBrowser sont mis à niveau vers des contrôles Windows Forms WebBrowser, et les propriétés, méthodes et événements sont mis à niveau vers leurs équivalents. Des commentaires de mise à niveau sont insérés dans le code aux endroits où des différences de comportement sont susceptibles de se produire.

Voir aussi

Tâches

Comment : utiliser le contrôle WebBrowser dans le .NET Compact Framework

Référence

Vue d'ensemble du contrôle WebBrowser

Autres ressources

WebBrowser, contrôle (Windows Forms)