HtmlWindow Classe

Définition

public ref class HtmlWindow sealed

public sealed class HtmlWindow

type HtmlWindow = class

Public NotInheritable Class HtmlWindow

Héritage

Object

HtmlWindow

Exemples

L’exemple de code suivant contient deux méthodes. Le premier ouvre une URL dans une fenêtre nommée displayWindow, qu’il 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. Notez que les dimensions de la fenêtre et les contrôles affichés dépendent de l’URL ouverte en premier. L’exemple de code exige que votre formulaire contienne un WebBrowser contrôle 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);
    }
}

Private Sub DisplayFirstUrl()
    If (WebBrowser1.Document IsNot Nothing) Then
        With WebBrowser1.Document
            ' If this is called first, the window will only have a status bar.
            .Window.Open(New Uri("http://www.microsoft.com/"), "displayWindow", "status=yes,width=200,height=400", False)
        End With
    End If
End Sub

Private Sub DisplaySecondUrl()
    If (WebBrowser1.Document IsNot Nothing) Then
        With WebBrowser1.Document
            ' If this is called first, the window will only have an Address bar.
            .Window.Open(New Uri("http://msdn.microsoft.com/"), "displayWindow", "width=400,height=200,location=yes", False)
        End With
    End If
End Sub

Remarques

HtmlWindow ne doit pas être confondu avec le concept d’une fenêtre dans Windows Forms ou l’API Windows ; il n’existe aucune HWND ressource Windows ou similaire qui correspond directement à une instance de HtmlWindow. HtmlWindow Fournit plutôt des descriptions générales de l’emplacement d’un document sur l’écran d’un utilisateur, ainsi que des méthodes d’interaction avec les utilisateurs au moyen d’invites et de boîtes de dialogue. HtmlWindow sert de conteneur logique pour les documents d’une page web et ses métadonnées, telles que l’emplacement du document et les fonctionnalités du navigateur Web.

Une page Web se compose d’un seul document ou d’un FRAMESETFRAME ou plusieurs éléments, chacun hébergeant son propre document. Les développeurs web utilisent des jeux de cadres pour afficher côte à côte des pages associées de manière logique (par exemple, une page de contenu en regard d’une page de navigation). Lorsqu’une page se compose d’un seul document, vous pouvez y accéder via la Document propriété de HtmlWindow; si la page utilise des cadres, vous pouvez accéder à ses documents via la Frames collection, qui se compose d’un ou plusieurs HtmlWindow objets.

Lorsque vous hébergez le WebBrowser contrôle 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 à cet effet. La Alert méthode 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ée et les boutons OK et Annuler .

Vous pouvez utiliser HtmlWindow pour ouvrir de nouvelles fenêtres contenant 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à, tout en OpenNew ouvrant toujours son URL dans une fenêtre nouvellement créée.

Propriétés

Méthodes

Opérateurs

Événements

S’applique à

Voir aussi

• window, objet
• IHTMLWindow2 Interface