HtmlWindow, classe

HtmlWindow ne doit pas être confondu avec le concept de fenêtre dans Windows Forms ou l'API Win32 ; aucun HWND ou ressource Windows semblable ne correspond directement à une instance de HtmlWindow. Au contraire, HtmlWindow fournit des descriptions de haut niveau de l'emplacement d'un document sur l'écran d'un utilisateur, ainsi que des méthodes pour interagir avec les utilisateurs par invites et boîtes de dialogue. HtmlWindow agit comme un conteneur logique pour les documents d'une page Web et ses métadonnées, tels que l'emplacement du document et les fonctions du navigateur Web.

Une page Web se compose d'un document seul ou d'un FRAMESET qui contient un ou plusieurs éléments FRAME chacun hébergeant son propre document. Les développeurs de site Web utilisent des jeux de frames pour afficher logiquement des pages associées côte à côte (par exemple, une page de contenu à côté d'une page de navigation). Lorsqu'une page se compose d'un document seul, vous pouvez y accéder par le biais de la propriété Document de HtmlWindow ; si la page utilise des frames, vous pouvez accéder à leurs documents par le biais de la collection Frames, qui se compose d'un ou de plusieurs objets HtmlWindow.

Lorsque vous hébergez le contrôle WebBrowser dans une application Windows Forms, vous pouvez choisir d'interagir avec l'utilisateur à l'aide de classes Windows Forms standard, telles que Form ou MessageBox ou vous pouvez utiliser des méthodes sur HtmlWindow définies à cette fin. La méthode Alert présente une boîte de dialogue simple avec du texte personnalisé et un bouton OK ; Prompt présente une ligne de texte personnalisé et un champ de saisie de texte à l'utilisateur ; et Confirm présente une boîte de dialogue avec une ligne de texte personnalisé et des boutons OK et Annuler.

Vous pouvez utiliser HtmlWindow pour ouvrir de nouvelles fenêtres qui contiennent de nouveaux documents. Open charge l'URL spécifiée dans la fenêtre nommée, en la créant si elle n'existe pas déjà, alors que OpenNew ouvre toujours son URL dans une nouvelle fenêtre.

Cet exemple de code se compose de deux méthodes. La première ouvre une URL dans une fenêtre nommée displayWindow, qui est créée avec une barre d'état affichée. La seconde ouvre une autre URL dans la même fenêtre, mais spécifie que seule la barre d'emplacement doit être affichée. Remarquez que les dimensions de la fenêtre et des contrôles affichés dépendent de l'URL ouverte en premier. L'exemple de code requiert que votre formulaire contienne un contrôle WebBrowser nommé WebBrowser1.

private void DisplayFirstUrl()
{
    if (webBrowser1.Document != null)
    {
        //If this is called first, the window will only have a status bar.
        webBrowser1.Document.Window.Open(new Uri("http://www.microsoft.com/"), "displayWindow", "status=yes,width=200,height=400", false);
    }
}

private void DisplaySecondUrl()
{
    if (webBrowser1.Document != null)
    {
        // If this is called first, the window will only have an Address bar.
        webBrowser1.Document.Window.Open(new Uri("http://msdn.microsoft.com/"), "displayWindow", "width=400,height=200,location=yes", false);
    }
}

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework