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

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)

Source:

HtmlWindow.cs

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

URL 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 manière 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é par rapport à 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 leftoptions , top, heightet width qui prennent des entiers arbitraires, chaque option accepte yes ou 1, et no ou 0, comme valeurs valides.

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

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

height : hauteur en pixels de la zone cliente de la fenêtre. Le minimum est 100 ; toute tentative d'ouverture d'une fenêtre plus petite provoque l'ouverture de la fenêtre conformément aux paramètres par défaut d'Internet Explorer.

left : position gauche (coordonnée x) de la fenêtre, relative 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, ce qui permet aux utilisateurs de naviguer dans la fenêtre jusqu’à une nouvelle URL. La valeur par défaut est yes.

menubar : indique s'il faut afficher les 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 de status 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 sur no n’a aucun effet dans une application managée ; la barre de titre s’affiche toujours.

toolbar: indique si les boutons de barre d’outils tels que Précédent, Précédent 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 100 ; toute tentative d'ouverture d'une fenêtre plus petite provoque l'ouverture de la fenêtre conformément aux paramètres par défaut d'Internet Explorer.

replaceEntry

Boolean

true pour remplacer l’URL de la fenêtre active par urlString dans l’historique de navigation. Cela aura un effet sur l'exécution de méthodes sur la classe HtmlHistory.

Retours

HtmlWindow

Nouvelle fenêtre ou fenêtre précédemment créée 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 windowOptions ce que vous souhaitez une barre d’status, la barre de menus, la barre d’outils, le titre, les barres de défilement, etc. ne s’affichent pas, sauf si vous les activez explicitement au moyen 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 d’Internet Explorer, il s’affiche dans la fenêtre nommée. Si le fichier ne peut pas être affiché à l’intérieur d’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 qu’Internet Explorer télécharge la ressource ; elle se ferme immédiatement après.

Lorsque vous créez de nouvelles fenêtres à l’aide Open de ou OpenNew, le modèle objet de document HTML ouvre une nouvelle instance de Explorer Internet. Si vous n’appelez Close pas sur toutes les fenêtres que vous avez créées, cette instance de Explorer Internet 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 sera ignorée ; la fenêtre conservera les dimensions, l’apparence et l’emplacement de l’écran d’abord donnés par l’appel initial à Open.

Open(Uri, String, String, Boolean)

Source:

HtmlWindow.cs

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

URL 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 manière 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é par rapport à 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 leftoptions , top, heightet width qui prennent des entiers arbitraires, chaque option accepte yes ou 1, et no ou 0, comme valeurs valides.

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

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

height : hauteur en pixels de la zone cliente de la fenêtre. Le minimum est 100 ; toute tentative d'ouverture d'une fenêtre plus petite provoque l'ouverture de la fenêtre conformément aux paramètres par défaut d'Internet Explorer.

left : position gauche (coordonnée x) de la fenêtre, relative 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, ce qui permet aux utilisateurs de naviguer dans la fenêtre jusqu’à une nouvelle URL. La valeur par défaut est yes.

menubar : indique s'il faut afficher les 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 de status 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 sur no n’a aucun effet dans une application managée ; la barre de titre s’affiche toujours.

toolbar: indique si les boutons de barre d’outils tels que Précédent, Précédent 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 100 ; toute tentative d'ouverture d'une fenêtre plus petite provoque l'ouverture de la fenêtre conformément aux paramètres par défaut d'Internet Explorer.

replaceEntry

Boolean

true pour remplacer l’URL de la fenêtre active par url dans l’historique de navigation. Cela affectera le fonctionnement des méthodes sur la HtmlHistory classe .

Retours

HtmlWindow

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

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 de status 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

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 sur 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 windowOptions ce que vous souhaitez une barre d’status, la barre de menus, la barre d’outils, le titre, les barres de défilement, etc. ne s’affichent 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 d’Internet Explorer, il s’affiche dans la fenêtre nommée. Si le fichier ne peut pas être affiché à l’intérieur d’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 qu’Internet Explorer télécharge la ressource ; elle se ferme immédiatement après.

Lorsque vous créez des fenêtres à l’aide Open de ou OpenNew, le modèle objet de document HTML ouvre une nouvelle instance de Explorer Internet. Si vous n’appelez Close pas sur toutes les fenêtres que vous avez créées, cette instance de Explorer Internet restera 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 sera ignoré ; la fenêtre conservera les dimensions, l’apparence et l’emplacement de l’écran qui lui ont été donnés par l’appel initial à Open.

Voir aussi

• open, méthode