Partager via


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

Visual Basic 6.0

Équivalent Visual Basic 2005

BeforeNavigate

BeforeNavigate2

Navigating

ClientToHostWindow

Nouvelle implémentation. Il s'agissait d'un événement de l'objet Internet Explorer.

CommandStateChanged

CanGoBackChanged

CanGoForwardChanged

DblClick

DoubleClick

DocumentComplete

DownloadBegin

DownloadComplete

DocumentCompleted

DragDrop

DragOver

Nouvelle implémentation. Pour plus d'informations, consultez Fonction de glisser-déplacer pour les utilisateurs de Visual Basic 6.0.

GotFocus

Enter

LostFocus

Leave

NavigateComplete

NavigateComplete2

Navigated

NavigateError

Nouvelle implémentation. Il s'agissait d'un événement de l'objet Internet Explorer.

NewWindow

NewWindow2

NewWindow3

NewWindow

OnFullScreen

OnMenuBar

OnQuit

OnStatusBar

OnTheaterMode

OnToolBar

OnVisible

Nouvelle implémentation. Il s'agissait d'un événement de l'objet Internet Explorer.

PrintTemplateInstantiation

PrintTemplateTearDown

PrivacyImpactedStateChange

Nouvelle implémentation. Il s'agissait d'un événement de l'objet Internet Explorer.

ProgressChange

ProgressChanged

PropertyChange

Nouvelle implémentation. Il s'agissait d'un événement de l'objet Internet Explorer.

SetSecureLockIcon

EncryptionLevelChanged

StatusTextChange

StatusTextChanged

TitleChange

DocumentTitleChanged

UpdatePageStatus

Nouvelle implémentation. Il s'agissait d'un événement de l'objet Internet Explorer.

Validate

Validating

WindowClosing

WindowSetHeight

WindowSetLeft

WindowSetResizable

WindowSetTop

WindowSetWidth

Nouvelle implémentation. Il s'agissait d'un événement de l'objet Internet Explorer.

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)