HtmlWindow.Open Méthode

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Affiche un fichier dans la fenêtre nommée.

Surcharges

Nom Description
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.

Open(String, String, String, Boolean)

Affiche un fichier dans la fenêtre nommée.

public:
 System::Windows::Forms::HtmlWindow ^ Open(System::String ^ urlString, System::String ^ target, System::String ^ windowOptions, bool replaceEntry);
public System.Windows.Forms.HtmlWindow Open(string urlString, string target, string windowOptions, bool replaceEntry);
member this.Open : string * string * string * bool -> System.Windows.Forms.HtmlWindow
Public Function Open (urlString As String, target As String, windowOptions As String, replaceEntry As Boolean) As HtmlWindow

Paramètres

urlString
String

Localisateur de ressources uniforme qui décrit l’emplacement du fichier à charger.

target
String

Nom de la fenêtre dans laquelle ouvrir la ressource. Il peut s’agir d’un nom fourni par le développeur ou de l’une des valeurs spéciales suivantes :

_blank: s’ouvre urlString dans une nouvelle fenêtre. Fonctionne de la même façon qu’un appel à OpenNew(String, String).

_media: s’ouvre urlString dans la barre multimédia.

_parent: s’ouvre urlString dans la fenêtre qui a créé la fenêtre active.

_search: s’ouvre urlString dans la barre de recherche.

_self: s’ouvre urlString dans la fenêtre active.

_top: s’il est appelé sur une fenêtre appartenant à un FRAME élément, s’ouvre urlString dans la fenêtre hébergeant son FRAMESET. Sinon, agit de la même façon que _self.

windowOptions
String

Chaîne délimitée par des virgules composée de zéro ou plusieurs des options suivantes sous la forme name=value. À l’exception des heightlefttopwidth entiers arbitraires, toutes les options acceptent yes ou 1acceptent 0des no valeurs valides.

channelmode : utilisé avec la technologie des canaux déconseillés de Internet Explorer 4.0. La valeur par défaut est no.

directories: indique si la fenêtre doit afficher les boutons de navigation du répertoire. La valeur par défaut est yes.

height: hauteur de la zone cliente de la fenêtre, en pixels. Le minimum est de 100 ; les tentatives d’ouverture d’une fenêtre inférieure à celle-ci entraînent l’ouverture de la fenêtre en fonction des Internet Explorer valeurs par défaut.

left: position gauche (coordonnée x) de la fenêtre, par rapport au coin supérieur gauche de l’écran de l’utilisateur, en pixels. Cette valeur doit être un entier positif.

location: indique s’il faut afficher la barre d’adresses, qui permet aux utilisateurs de naviguer dans la fenêtre vers une nouvelle URL. La valeur par défaut est yes.

menubar: indique s’il faut afficher des menus dans la nouvelle fenêtre. La valeur par défaut est yes.

resizable: indique si la fenêtre peut être redimensionnée par l’utilisateur. La valeur par défaut est yes.

scrollbars: indique si la fenêtre a des barres de défilement horizontales et verticales. La valeur par défaut est yes.

status: indique si la fenêtre a une barre d’état en bas. La valeur par défaut est yes.

titlebar: indique si le titre de la page active est affiché. La définition de cette option no n’a aucun effet dans une application gérée ; la barre de titre s’affiche toujours.

toolbar: indique si les boutons de barre d’outils tels que Précédent, Avant et Arrêt sont visibles. La valeur par défaut est yes.

top: position supérieure (coordonnée y) de la fenêtre, par rapport au coin supérieur gauche de l’écran de l’utilisateur, en pixels. Cette valeur doit être un entier positif.

width: largeur de la zone cliente de la fenêtre, en pixels. Le minimum est de 100 ; les tentatives d’ouverture d’une fenêtre inférieure à celle-ci entraînent l’ouverture de la fenêtre en fonction des Internet Explorer valeurs par défaut.

replaceEntry
Boolean

true pour remplacer l’URL urlString de la fenêtre active par celle de l’historique de navigation. Cela affecte l’opération des méthodes sur la HtmlHistory classe.

Retours

HtmlWindow

La nouvelle fenêtre, ou la fenêtre créée précédemment nommée par le target paramètre.

Remarques

Le target paramètre peut nommer une fenêtre qui a été créée à la suite d’un appel précédent à Open. Le paramètre peut également pointer vers une fenêtre ouverte en cliquant sur un lien hypertexte (A élément) ou un FORM élément qui utilise l’attribut TARGET pour ouvrir son URL dans une nouvelle fenêtre. Le code HTML suivant ouvre une nouvelle fenêtre nommée orderWindow lorsque l’utilisateur clique dessus :

<A HREF="/startOrder.aspx" TARGET="orderWindow">Click to Start Order</a>

Si vous fournissez des options pour le windowOptions paramètre, toute option non incluse est automatiquement désactivée. En d’autres termes, si vous spécifiez uniquement par le biais de cette barre d’état, la barre de menus, la barre d’outils, le titre, les barres de windowOptions défilement, et ainsi de suite ne s’affiche pas, sauf si vous les activez explicitement par le biais de windowOptions.

Si le fichier référencé par url est un fichier HTML, un fichier texte ou un autre type de fichier pouvant être hébergé à l’intérieur de Internet Explorer, il s’affiche dans la fenêtre nommée. Si le fichier ne peut pas être affiché à l’intérieur de Internet Explorer et que la fenêtre nommée par cible n’existe pas déjà, la fenêtre ne s’ouvre que suffisamment longtemps pour Internet Explorer télécharger la ressource ; elle se ferme immédiatement après.

Lorsque vous créez de nouvelles fenêtres à l’aide de Open ou OpenNew, le modèle objet de document HTML ouvre une nouvelle instance de Internet Explorer. Si vous n’appelez pas Close sur toutes les fenêtres que vous avez créées, cette instance de Internet Explorer reste en cours d’exécution même après la fin de votre application.

Si vous utilisez Open pour charger une URL dans une fenêtre existante, windowOptions elle est ignorée ; la fenêtre conserve les dimensions, l’apparence et l’emplacement de l’écran d’abord donnés par l’appel initial à Open.

S’applique à

Open(Uri, String, String, Boolean)

Affiche un fichier dans la fenêtre nommée.

public:
 System::Windows::Forms::HtmlWindow ^ Open(Uri ^ url, System::String ^ target, System::String ^ windowOptions, bool replaceEntry);
public System.Windows.Forms.HtmlWindow Open(Uri url, string target, string windowOptions, bool replaceEntry);
member this.Open : Uri * string * string * bool -> System.Windows.Forms.HtmlWindow
Public Function Open (url As Uri, target As String, windowOptions As String, replaceEntry As Boolean) As HtmlWindow

Paramètres

url
Uri

Localisateur de ressources uniforme qui décrit l’emplacement du fichier à charger.

target
String

Nom de la fenêtre dans laquelle ouvrir la ressource. Il peut s’agir d’un nom fourni par le développeur ou de l’une des valeurs spéciales suivantes :

_blank: s’ouvre url dans une nouvelle fenêtre. Fonctionne de la même façon qu’un appel à OpenNew(String, String).

_media: s’ouvre url dans la barre multimédia.

_parent: s’ouvre url dans la fenêtre qui a créé la fenêtre active.

_search: s’ouvre url dans la barre de recherche.

_self: s’ouvre url dans la fenêtre active.

_top: s’il est appelé sur une fenêtre appartenant à un FRAME élément, s’ouvre url dans la fenêtre hébergeant son FRAMESET. Sinon, agit de la même façon que _self.

windowOptions
String

Chaîne délimitée par des virgules composée de zéro ou plusieurs des options suivantes sous la forme name=value. À l’exception des heightlefttopwidth entiers arbitraires, toutes les options acceptent yes ou 1acceptent 0des no valeurs valides.

channelmode : utilisé avec la technologie des canaux déconseillés de Internet Explorer 4.0. La valeur par défaut est no.

directories: indique si la fenêtre doit afficher les boutons de navigation du répertoire. La valeur par défaut est yes.

height: hauteur de la zone cliente de la fenêtre, en pixels. Le minimum est de 100 ; les tentatives d’ouverture d’une fenêtre inférieure à celle-ci entraînent l’ouverture de la fenêtre en fonction des Internet Explorer valeurs par défaut.

left: position gauche (coordonnée x) de la fenêtre, par rapport au coin supérieur gauche de l’écran de l’utilisateur, en pixels. Cette valeur doit être un entier positif.

location: indique s’il faut afficher la barre d’adresses, qui permet aux utilisateurs de naviguer dans la fenêtre vers une nouvelle URL. La valeur par défaut est yes.

menubar: indique s’il faut afficher des menus dans la nouvelle fenêtre. La valeur par défaut est yes.

resizable: indique si la fenêtre peut être redimensionnée par l’utilisateur. La valeur par défaut est yes.

scrollbars: indique si la fenêtre a des barres de défilement horizontales et verticales. La valeur par défaut est yes.

status: indique si la fenêtre a une barre d’état en bas. La valeur par défaut est yes.

titlebar: indique si le titre de la page active est affiché. La définition de cette option no n’a aucun effet dans une application gérée ; la barre de titre s’affiche toujours.

toolbar: indique si les boutons de barre d’outils tels que Précédent, Avant et Arrêt sont visibles. La valeur par défaut est yes.

top: position supérieure (coordonnée y) de la fenêtre, par rapport au coin supérieur gauche de l’écran de l’utilisateur, en pixels. Cette valeur doit être un entier positif.

width: largeur de la zone cliente de la fenêtre, en pixels. Le minimum est de 100 ; les tentatives d’ouverture d’une fenêtre inférieure à celle-ci entraînent l’ouverture de la fenêtre en fonction des Internet Explorer valeurs par défaut.

replaceEntry
Boolean

true pour remplacer l’URL url de la fenêtre active par celle de l’historique de navigation. Cela affecte l’opération des méthodes sur la HtmlHistory classe.

Retours

HtmlWindow

Représentant HtmlWindow la nouvelle fenêtre ou la fenêtre précédemment créée nommée par le target paramètre.

Exemples

L’exemple de code suivant contient deux méthodes :

  • La première ouvre une URL dans une fenêtre nommée displayWindow, qu’elle crée avec une barre d’état affichée.
  • La deuxième 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 des contrôles affichés dépendent de l’URL ouverte en premier. L’exemple de code nécessite 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

Le target paramètre peut nommer une fenêtre qui a été créée à la suite d’un appel précédent à Open. Le paramètre peut également pointer vers une fenêtre ouverte en cliquant sur un lien hypertexte (A élément) ou un FORM élément qui utilise l’attribut TARGET pour ouvrir son URL dans une nouvelle fenêtre. Le code HTML suivant ouvre une nouvelle fenêtre nommée orderWindow lorsque l’utilisateur clique dessus :

<A HREF="/startOrder.aspx" TARGET="orderWindow">Click to Start Order</a>

Si vous fournissez des options pour le windowOptions paramètre, toute option non incluse est automatiquement désactivée. En d’autres termes, si vous spécifiez uniquement par le biais de cette barre d’état, la barre de menus, la barre d’outils, le titre, les barres de windowOptions défilement, et ainsi de suite ne s’affiche pas, sauf si vous les activez explicitement par le biais de windowOptions.

Si le fichier référencé par url est un fichier HTML, un fichier texte ou un autre type de fichier pouvant être hébergé à l’intérieur de Internet Explorer, il s’affiche dans la fenêtre nommée. Si le fichier ne peut pas être affiché à l’intérieur de Internet Explorer et que la fenêtre nommée par cible n’existe pas déjà, la fenêtre ne s’ouvre que suffisamment longtemps pour Internet Explorer télécharger la ressource ; elle se ferme immédiatement après.

Lorsque vous créez de nouvelles fenêtres à l’aide de Open ou OpenNew, le modèle objet de document HTML ouvre une nouvelle instance de Internet Explorer. Si vous n’appelez pas Close sur toutes les fenêtres que vous avez créées, cette instance de Internet Explorer reste en cours d’exécution même après la fin de votre application.

Si vous utilisez Open pour charger une URL dans une fenêtre existante, windowOptions elle est ignorée ; la fenêtre conserve les dimensions, l’apparence et l’emplacement de l’écran d’abord donnés par l’appel initial à Open.

Voir aussi

S’applique à