HtmlWindow Classe

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Représente la fenêtre logique qui contient une ou plusieurs instances de HtmlDocument.

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

Document	Obtient le document HTML contenu dans la fenêtre.
DomWindow	Obtient l'interface non managée encapsulée par cette classe.
Frames	Obtient une référence à chacun des FRAME éléments définis dans la page web.
History	Obtient un objet contenant les dernières URL visitées par l'utilisateur.
IsClosed	Obtient une valeur indiquant si cette fenêtre est ouverte ou fermée.
Name	Obtient ou définit le nom de la fenêtre.
Opener	Obtient une référence à la fenêtre qui a ouvert la fenêtre active.
Parent	Obtient la fenêtre qui réside au-dessus de la fenêtre active dans une page contenant des frames.
Position	Obtient la position de la zone cliente de la fenêtre à l'écran.
Size	Obtient ou définit la taille de la fenêtre active.
StatusBarText	Obtient ou définit le texte affiché dans la barre d'état d'une fenêtre.
Url	Obtient l'URL correspondant à l'élément actuellement affiché dans la fenêtre.
WindowFrameElement	Obtient l'élément frame correspondant à cette fenêtre.

Méthodes

Alert(String)	Affiche une boîte de message.
AttachEventHandler(String, EventHandler)	Ajoute un gestionnaire d'événements pour l'événement nommé sur le modèle DOM HTML.
Close()	Ferme la fenêtre.
Confirm(String)	Affiche une boîte de dialogue avec un message et des boutons pour solliciter une réponse positive/négative.
DetachEventHandler(String, EventHandler)	Supprime le gestionnaire d'événements nommé.
Equals(Object)	Teste l'objet pour déterminer s'il est égal à l'objet actif.
Focus()	Place le focus sur la fenêtre active.
GetHashCode()	Sert de fonction de hachage pour un type particulier.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
MoveTo(Int32, Int32)	Déplace la fenêtre vers les coordonnées spécifiées sur l'écran.
MoveTo(Point)	Déplace la fenêtre vers les coordonnées spécifiées sur l'écran.
Navigate(String)	Affiche ou télécharge le nouveau contenu situé à l'URL spécifiée.
Navigate(Uri)	Affiche un nouveau document dans la fenêtre active.
Open(String, String, String, Boolean)	Affiche un fichier dans la fenêtre nommée.
Open(Uri, String, String, Boolean)	Affiche un fichier dans la fenêtre nommée.
OpenNew(String, String)	Affiche un fichier dans une nouvelle fenêtre.
OpenNew(Uri, String)	Affiche un fichier dans une nouvelle fenêtre.
Prompt(String, String)	Présente une boîte de dialogue qui affiche un message et une zone de texte à l'utilisateur.
RemoveFocus()	Retire le focus de la fenêtre active.
ResizeTo(Int32, Int32)	Remplace la taille de la fenêtre par les dimensions spécifiées.
ResizeTo(Size)	Remplace la taille de la fenêtre par les dimensions spécifiées.
ScrollTo(Int32, Int32)	Fait défiler la fenêtre à la position désignée.
ScrollTo(Point)	Déplace la fenêtre aux coordonnées spécifiées.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Opérateurs

Equality(HtmlWindow, HtmlWindow)	Teste si les deux objets HtmlWindow sont égaux.
Inequality(HtmlWindow, HtmlWindow)	Teste si deux objets HtmlWindow sont inégaux.

Événements

Error	Se produit lorsque le script qui s'exécute dans la fenêtre rencontre une erreur d'exécution.
GotFocus	Se produit lorsque la fenêtre active obtient le focus de l'entrée utilisateur.
Load	Se produit lorsque l'initialisation du document de la fenêtre et de tous ses éléments est terminée.
LostFocus	Se produit lorsque le focus d'entrée utilisateur quitte la fenêtre.
Resize	Se produit lorsque l'utilisateur utilise la souris pour modifier les dimensions de la fenêtre.
Scroll	Se produit lorsque l'utilisateur fait défiler la fenêtre pour consulter le texte hors écran.
Unload	Se produit lorsque la page active se décharge et une nouvelle page est sur le point de s'afficher.

Voir aussi

• window, objet
• IHTMLWindow2 Interface