HtmlWindow.Open Methode

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);

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

Parameter

Gibt zurück

Das neue Fenster oder das zuvor erstellte Fenster mit dem Namen des target Parameters.

Hinweise

Der target -Parameter kann ein Fenster benennen, das als Ergebnis eines vorherigen Aufrufs Openvon erstellt wurde. Der Parameter kann auch auf ein Fenster zeigen, das durch Klicken auf einen Link (A Element) geöffnet wird, oder auf ein FORM Element, das das TARGET -Attribut verwendet, um seine URL in einem neuen Fenster zu öffnen. Der folgende HTML-Code öffnet ein neues Fenster namens orderWindow , wenn der Benutzer darauf klickt:

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

Wenn Sie Optionen für den windowOptions Parameter angeben, wird jede nicht enthaltene Option automatisch deaktiviert. Anders ausgedrückt: Wenn Sie nur eine status Leiste angebenwindowOptions, werden die Menüleiste, die Symbolleiste, der Titel, die Bildlaufleiste usw. nur angezeigt, wenn Sie sie explizit über windowOptionsaktivieren.

Wenn es sich bei der Datei, auf die von url verwiesen wird, um eine HTML-Datei, eine Textdatei oder einen anderen Dateityp handelt, der innerhalb von Internet Explorer gehostet werden kann, wird sie im benannten Fenster angezeigt. Wenn die Datei nicht innerhalb von Internet Explorer angezeigt werden kann und das nach Ziel benannte Fenster noch nicht vorhanden ist, wird das Fenster nur so lange geöffnet, dass internet Explorer die Ressource herunterladen kann. Es wird unmittelbar danach geschlossen.

Wenn Sie neue Fenster mit Open oder OpenNewerstellen, wird durch das HTML-Dokumentobjektmodell eine neue instance von Internet Explorer geöffnet. Wenn Sie nicht in allen von Ihnen erstellten Fenstern aufrufenClose, wird diese instance von Internet Explorer auch nach dem Beenden Ihrer Anwendung weiterhin ausgeführt.

Wenn Sie verwenden Open , um eine URL in einem vorhandenen Fenster zu laden, windowOptions wird ignoriert. Das Fenster behält die Dimensionen, das Aussehen und die Bildschirmposition bei, die es zuerst durch den ersten Aufruf Openvon erhalten hat.

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);

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

Parameter

Gibt zurück

Ein HtmlWindow, das das neue Fenster darstellt, oder das zuvor erstellte Fenster, das durch den target-Parameter benannte wurde.

Beispiele

Das folgende Codebeispiel enthält zwei Methoden:

• Die erste öffnet eine URL in einem Fenster namens displayWindow, das erstellt wird, wobei eine status leiste angezeigt wird.
• Die zweite öffnet eine weitere URL im selben Fenster, gibt jedoch an, dass nur die Positionsleiste angezeigt werden soll.

Beachten Sie, dass die Dimensionen des Fensters und der angezeigten Steuerelemente davon abhängen, welche URL zuerst geöffnet wird. Das Codebeispiel erfordert, dass ihr Formular ein WebBrowser Steuerelement mit dem Namen WebBrowser1enthält.

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

Hinweise

Der target -Parameter kann ein Fenster benennen, das als Ergebnis eines vorherigen Aufrufs Openvon erstellt wurde. Der Parameter kann auch auf ein Fenster verweisen, das durch Klicken auf einen Link (A Element) geöffnet wird, oder auf ein FORM Element, das das TARGET Attribut verwendet, um seine URL in einem neuen Fenster zu öffnen. Der folgende HTML-Code öffnet ein neues Fenster namens, orderWindow wenn der Benutzer darauf klickt:

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

Wenn Sie Optionen für den windowOptions Parameter angeben, wird jede nicht enthaltene Option automatisch deaktiviert. Anders ausgedrückt: Wenn Sie nur eine windowOptions status Leiste angeben, werden menüleiste, Symbolleiste, Titel, Bildlaufleisten usw. nicht angezeigt, es sei denn, Sie aktivieren sie explizit über windowOptions.

Wenn es sich bei der Datei, auf die von url verwiesen wird, um eine HTML-Datei, textdatei oder einen anderen Dateityp handelt, der innerhalb von Internet Explorer gehostet werden kann, wird sie im benannten Fenster angezeigt. Wenn die Datei nicht innerhalb von Internet Explorer angezeigt werden kann und das Fenster nach Ziel noch nicht vorhanden ist, wird das Fenster nur lange genug geöffnet, damit internet Explorer die Ressource herunterladen können. Anschließend wird es geschlossen.

Wenn Sie neue Fenster mit Open oder OpenNewerstellen, führt dies dazu, dass das HTML-Dokumentobjektmodell eine neue instance von Internet Explorer öffnet. Wenn Sie nicht für alle fenster aufrufenClose, die Sie erstellt haben, wird diese instance von Internet Explorer auch nach dem Beenden Ihrer Anwendung weiterhin ausgeführt.

Wenn Sie Open verwenden, um eine URL in einem vorhandenen Fenster zu laden, windowOptions wird ignoriert. Das Fenster behält die Dimensionen, das Erscheinungsbild und die Bildschirmposition bei, die zuerst durch den ersten Aufruf Openvon angegeben wurden.

Weitere Informationen

• open-Methode