HtmlWindow.Open Methode

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Zeigt eine Datei im benannten Fenster an.

Überlädt

Name Beschreibung
Open(String, String, String, Boolean)

Zeigt eine Datei im benannten Fenster an.
Open(Uri, String, String, Boolean)

Zeigt eine Datei im benannten Fenster an.

Open(String, String, String, Boolean)

Quelle:
HtmlWindow.cs
Quelle:
HtmlWindow.cs
Quelle:
HtmlWindow.cs
Quelle:
HtmlWindow.cs
Quelle:
HtmlWindow.cs

Zeigt eine Datei im benannten Fenster an.

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

urlString
String

Der Uniform Resource Locator, der den Speicherort der zu ladenden Datei beschreibt.

target
String

Der Name des Fensters, in dem die Ressource geöffnet werden soll. Hierbei kann es sich um einen vom Entwickler angegebenen Namen oder um einen der folgenden speziellen Werte handeln:

_blank: Wird in einem neuen Fenster geöffnet urlString . Funktioniert genauso wie ein Aufruf von OpenNew(String, String).

_media: Wird in der Medienleiste geöffnet urlString .

_parent: Wird im Fenster geöffnet urlString , in dem das aktuelle Fenster erstellt wurde.

_search: Wird in der Suchleiste geöffnet urlString .

_self: Wird im aktuellen Fenster geöffnet urlString .

_top: Wird für ein Fenster aufgerufen, das zu einem FRAME Element gehört, wird das Fenster geöffnet urlString , in dem das FRAMESETElement gehostet wird. Andernfalls verhält es sich genauso wie _self.

windowOptions
String

Eine durch Trennzeichen getrennte Zeichenfolge, die aus null oder mehr der folgenden Optionen im Formular name=valuebesteht. Mit Ausnahme der leftOptionen , top, heightdie width beliebige ganze Zahlen annehmen, akzeptiert yes oder 1, und , nooder 0 , als gültige Werte.

channelmode: Wird mit der veralteten Kanaltechnologie von Internet Explorer 4.0 verwendet. Der Standardwert ist no.

directories: Gibt an, ob im Fenster Verzeichnisnavigationsschaltflächen angezeigt werden sollen. Der Standardwert ist yes.

height: Die Höhe des Clientbereichs des Fensters in Pixel. Das Mindestmaß beträgt 100; versucht, ein Fenster zu öffnen, das kleiner als dies ist, führt dazu, dass das Fenster gemäß den Internet Explorer Standardwerten geöffnet wird.

left: Die linke Position (x-Koordinate) des Fensters relativ zur oberen linken Ecke des Bildschirms des Benutzers in Pixel. Der Wert muss eine positive ganze Zahl sein.

location: Gibt an, ob die Adressleiste angezeigt werden soll, mit der Benutzer in das Fenster zu einer neuen URL navigieren können. Der Standardwert ist yes.

menubar: Gibt an, ob Menüs im neuen Fenster angezeigt werden sollen. Der Standardwert ist yes.

resizable: Gibt an, ob die Größe des Fensters vom Benutzer geändert werden kann. Der Standardwert ist yes.

scrollbars: Gibt an, ob das Fenster über horizontale und vertikale Bildlaufleisten verfügt. Der Standardwert ist yes.

status: Gibt an, ob das Fenster unten über eine Statusleiste verfügt. Der Standardwert ist yes.

titlebar: Gibt an, ob der Titel der aktuellen Seite angezeigt wird. Wenn Sie diese Option festlegen, dass no sie nicht innerhalb einer verwalteten Anwendung wirksam ist, wird die Titelleiste immer angezeigt.

toolbar: Gibt an, ob Symbolleistenschaltflächen wie "Zurück", " Vorwärts" und "Beenden " sichtbar sind. Der Standardwert ist yes.

top: Die obere Position (y-Koordinate) des Fensters relativ zur oberen linken Ecke des Bildschirms des Benutzers in Pixel. Der Wert muss eine positive ganze Zahl sein.

width: Die Breite des Clientbereichs des Fensters in Pixel. Das Mindestmaß beträgt 100; versucht, ein Fenster zu öffnen, das kleiner als dies ist, führt dazu, dass das Fenster gemäß den Internet Explorer Standardwerten geöffnet wird.

replaceEntry
Boolean

true um die URL des aktuellen Fensters durch urlString den Navigationsverlauf zu ersetzen. Dies wirkt sich auf den Vorgang von Methoden für die HtmlHistory Klasse aus.

Gibt zurück

HtmlWindow

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 Openerstellt wurde. Der Parameter kann auch auf ein Fenster zeigen, das geöffnet wird, indem er auf einen Hyperlink (A Element) oder ein FORM Element klickt, das das TARGET Attribut verwendet, um seine URL in einem neuen Fenster zu öffnen. Der folgende HTML-Code öffnet ein neues Fenster mit dem Namen 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 Statusleiste angeben möchten, werden die Menüleiste, die Symbolleiste, der Titel, die Bildlaufleiste usw. nicht angezeigt, es sei denn, Sie aktivieren diese explizit über windowOptions.

Wenn die datei, auf die von url verwiesen wird, eine HTML-Datei, Textdatei oder ein anderer Dateityp ist, der in 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 lang genug geöffnet, damit Internet Explorer die Ressource herunterladen kann. Es wird unmittelbar danach geschlossen.

Wenn Sie neue Fenster mithilfe von Open oder OpenNew erstellen, wird durch das HTML-Dokumentobjektmodell eine neue Instanz von Internet Explorer geöffnet. Wenn Sie Close nicht für alle von Ihnen erstellten Fenster aufrufen, wird diese Instanz von Internet Explorer auch nach dem Beenden der Anwendung weiterhin ausgeführt.

Wenn Sie Open eine URL in ein vorhandenes Fenster laden, windowOptions wird ignoriert. Das Fenster behält die Dimensionen, darstellung und Bildschirmposition zuerst durch den anfänglichen Aufruf von Open.

Gilt für:

Open(Uri, String, String, Boolean)

Quelle:
HtmlWindow.cs
Quelle:
HtmlWindow.cs
Quelle:
HtmlWindow.cs
Quelle:
HtmlWindow.cs
Quelle:
HtmlWindow.cs

Zeigt eine Datei im benannten Fenster an.

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

url
Uri

Der Uniform Resource Locator, der den Speicherort der zu ladenden Datei beschreibt.

target
String

Der Name des Fensters, in dem die Ressource geöffnet werden soll. Dabei kann es sich um einen vom Entwickler angegebenen Namen oder um einen der folgenden speziellen Werte handeln:

_blank: Wird in einem neuen Fenster geöffnet url . Funktioniert genauso wie ein Aufruf von OpenNew(String, String).

_media: Wird in der Medienleiste geöffnet url .

_parent: Wird im Fenster geöffnet url , in dem das aktuelle Fenster erstellt wurde.

_search: Wird in der Suchleiste geöffnet url .

_self: Wird im aktuellen Fenster geöffnet url .

_top: Wird für ein Fenster aufgerufen, das zu einem FRAME Element gehört, wird das Fenster geöffnet url , in dem das FRAMESETElement gehostet wird. Andernfalls verhält es sich genauso wie _self.

windowOptions
String

Eine durch Trennzeichen getrennte Zeichenfolge, die aus null oder mehr der folgenden Optionen im Formular name=valuebesteht. Mit Ausnahme der leftOptionen , top, heightdie width beliebige ganze Zahlen annehmen, akzeptiert yes oder 1, und , nooder 0 , als gültige Werte.

channelmode: Wird mit der veralteten Kanaltechnologie von Internet Explorer 4.0 verwendet. Der Standardwert ist no.

directories: Gibt an, ob im Fenster Verzeichnisnavigationsschaltflächen angezeigt werden sollen. Der Standardwert ist yes.

height: Die Höhe des Clientbereichs des Fensters in Pixel. Das Mindestmaß beträgt 100; versucht, ein Fenster zu öffnen, das kleiner als dies ist, führt dazu, dass das Fenster gemäß den Internet Explorer Standardwerten geöffnet wird.

left: Die linke Position (x-Koordinate) des Fensters relativ zur oberen linken Ecke des Bildschirms des Benutzers in Pixel. Der Wert muss eine positive ganze Zahl sein.

location: Gibt an, ob die Adressleiste angezeigt werden soll, mit der Benutzer in das Fenster zu einer neuen URL navigieren können. Der Standardwert ist yes.

menubar: Gibt an, ob Menüs im neuen Fenster angezeigt werden sollen. Der Standardwert ist yes.

resizable: Gibt an, ob die Größe des Fensters vom Benutzer geändert werden kann. Der Standardwert ist yes.

scrollbars: Gibt an, ob das Fenster über horizontale und vertikale Bildlaufleisten verfügt. Der Standardwert ist yes.

status: Gibt an, ob das Fenster unten über eine Statusleiste verfügt. Der Standardwert ist yes.

titlebar: Gibt an, ob der Titel der aktuellen Seite angezeigt wird. Wenn Sie diese Option festlegen, dass no sie nicht innerhalb einer verwalteten Anwendung wirksam ist, wird die Titelleiste immer angezeigt.

toolbar: Gibt an, ob Symbolleistenschaltflächen wie "Zurück", " Vorwärts" und "Beenden " sichtbar sind. Der Standardwert ist yes.

top: Die obere Position (y-Koordinate) des Fensters relativ zur oberen linken Ecke des Bildschirms des Benutzers in Pixel. Der Wert muss eine positive ganze Zahl sein.

width: Die Breite des Clientbereichs des Fensters in Pixel. Das Mindestmaß beträgt 100; versucht, ein Fenster zu öffnen, das kleiner als dies ist, führt dazu, dass das Fenster gemäß den Internet Explorer Standardwerten geöffnet wird.

replaceEntry
Boolean

true um die URL des aktuellen Fensters durch url den Navigationsverlauf zu ersetzen. Dies wirkt sich auf den Betrieb von Methoden für die HtmlHistory Klasse aus.

Gibt zurück

HtmlWindow

Eine HtmlWindow Darstellung des neuen Fensters oder des zuvor erstellten Fensters, das vom target Parameter benannt ist.

Beispiele

Das folgende Codebeispiel enthält zwei Methoden:

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

Beachten Sie, dass die Abmessungen des Fensters und der angezeigten Steuerelemente von der ERSTEN GEÖFFNETEN URL abhängen. Das Codebeispiel erfordert, dass Das 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 Openerstellt wurde. Der Parameter kann auch auf ein Fenster zeigen, das geöffnet wird, indem er auf einen Hyperlink (A Element) oder ein FORM Element klickt, das das TARGET Attribut verwendet, um seine URL in einem neuen Fenster zu öffnen. Der folgende HTML-Code öffnet ein neues Fenster mit dem Namen 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 Statusleiste angeben möchten, werden die Menüleiste, die Symbolleiste, der Titel, die Bildlaufleiste usw. nicht angezeigt, es sei denn, Sie aktivieren diese explizit über windowOptions.

Wenn die datei, auf die von url verwiesen wird, eine HTML-Datei, Textdatei oder ein anderer Dateityp ist, der in 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 lang genug geöffnet, damit Internet Explorer die Ressource herunterladen kann. Es wird unmittelbar danach geschlossen.

Wenn Sie neue Fenster mithilfe von Open oder OpenNew erstellen, wird durch das HTML-Dokumentobjektmodell eine neue Instanz von Internet Explorer geöffnet. Wenn Sie Close nicht für alle von Ihnen erstellten Fenster aufrufen, wird diese Instanz von Internet Explorer auch nach dem Beenden der Anwendung weiterhin ausgeführt.

Wenn Sie Open eine URL in ein vorhandenes Fenster laden, windowOptions wird ignoriert. Das Fenster behält die Dimensionen, darstellung und Bildschirmposition zuerst durch den anfänglichen Aufruf von Open.

Weitere Informationen

Gilt für: