Partager via

Vue d’ensemble du contrôle WebBrowser

  • Article

Le contrôle WebBrowser fournit un wrapper managé pour le contrôle ActiveX WebBrowser. Le wrapper managé vous permet d’afficher des pages web dans vos applications clientes Windows Forms. Vous pouvez utiliser le contrôle WebBrowser pour dupliquer les fonctionnalités de navigation web Internet Explorer dans votre application ou désactiver la fonctionnalité Internet Explorer par défaut et utiliser le contrôle en tant que visionneuse de documents HTML simple. 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 en toute transparence des contrôles Web avec des contrôles Windows Forms dans une seule application.

Propriétés, méthodes et événements fréquemment utilisés

Le contrôle WebBrowser a plusieurs propriétés, méthodes et événements que vous pouvez utiliser pour implémenter des contrôles trouvés dans Internet Explorer. Par exemple, vous pouvez utiliser la méthode Navigate pour implémenter une barre d’adresses et les méthodes GoBack, GoForward, Stopet Refresh pour implémenter des boutons de navigation dans une barre d’outils. Vous pouvez gérer l’événement Navigated pour mettre à jour la barre d’adresses avec la valeur de la propriété Url et la barre de titre avec la valeur de la propriété DocumentTitle.

Si vous souhaitez générer votre propre contenu de page dans votre application, vous pouvez définir la propriété DocumentText. Si vous êtes familiarisé avec le modèle dom (Document Object Model) HTML, vous pouvez également manipuler le contenu de la page Web active via la propriété Document. Avec cette propriété, vous pouvez stocker et modifier des documents en mémoire au lieu de naviguer entre les fichiers.

La propriété Document vous permet également d’appeler des méthodes implémentées dans le code de script de page Web à partir du code de votre application cliente. Pour accéder au code de votre application cliente à partir de votre code de script, définissez la propriété ObjectForScripting. L’objet que vous spécifiez est accessible par votre code de script en tant qu’objet window.external.

Nom Description
propriété Document Obtient un objet qui fournit un accès géré au modèle d’objet de document HTML (DOM) de la page Web active.
événement DocumentCompleted Se produit lorsqu’une page Web termine le chargement.
propriété DocumentText Obtient ou définit le contenu HTML de la page Web active.
propriété DocumentTitle Obtient le titre de la page Web actuelle.
méthode GoBack Accède à la page précédente dans l’historique.
méthode GoForward Accède à la page suivante dans l’historique.
méthode Navigate Accède à l’URL spécifiée.
Événement Navigating Se produit avant le début de la navigation, ce qui permet l’annulation de l’action.
propriété ObjectForScripting Obtient ou définit un objet que le code de script de page web peut utiliser pour communiquer avec votre application.
méthode Print Imprime la page Web actuelle.
méthode Refresh Recharge la page web active.
méthode Stop Arrête la navigation actuelle et arrête les éléments de page dynamiques tels que les sons et l’animation.
propriété Url Obtient ou définit l’URL de la page Web active. La définition de cette propriété permet au contrôle d’accéder à la nouvelle URL.

Voir aussi