Teilen über


HtmlWindow Klasse

Definition

Stellt das logische Fenster dar, das eine oder mehrere Instanzen von HtmlDocument enthält.

public ref class HtmlWindow sealed
public sealed class HtmlWindow
type HtmlWindow = class
Public NotInheritable Class HtmlWindow
Vererbung
HtmlWindow

Beispiele

Das folgende Codebeispiel enthält zwei Methoden. Die erste öffnet eine URL in einem Fenster namens displayWindow, das erstellt wird, wobei eine Statusleiste angezeigt wird. Die zweite öffnet eine andere URL im selben Fenster, gibt aber 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

HtmlWindow sollte nicht mit dem Konzept eines Fensters in Windows Forms oder der Windows-API verwechselt werden; es gibt keine HWND oder eine ähnliche Windows-Ressource, die direkt einer Instanz von HtmlWindowentspricht. HtmlWindow Stellt stattdessen allgemeine Beschreibungen des Speicherorts eines Dokuments auf dem Bildschirm eines Benutzers sowie Methoden für die Interaktion mit Benutzern über Eingabeaufforderungen und Dialogfelder bereit. HtmlWindow fungiert als logischer Container für die Dokumente einer Webseite und deren Metadaten, z. B. den Speicherort des Dokuments und die Funktionen des Webbrowsers.

Eine Webseite besteht aus einem einzelnen Dokument oder einem FRAMESET , das ein oder mehrere FRAME Elemente enthält, von denen jedes ein eigenes Dokument hostet. Webentwickler verwenden Framesets, um logisch verwandte Seiten nebeneinander anzuzeigen (z. B. eine Inhaltsseite neben einer Navigationsseite). Wenn eine Seite aus einem einzelnen Dokument besteht, können Sie über die Document -Eigenschaft von HtmlWindowdarauf zugreifen. Wenn die Seite Frames verwendet, können Sie über die Frames Sammlung, die aus einem oder mehreren HtmlWindow Objekten besteht, auf ihre Dokumente zugreifen.

Wenn Sie das WebBrowser Steuerelement in einer Windows Forms-Anwendung hosten, können Sie wählen, ob Sie mit dem Benutzer mithilfe von Windows Forms-Standardklassen wie oder FormMessageBoxinteragieren möchten, oder Sie können methoden HtmlWindow für diesen Zweck verwenden. Die Alert -Methode stellt ein einfaches Dialogfeld mit benutzerdefiniertem Text und einer OK-Schaltfläche dar, Prompt stellt dem Benutzer eine Zeile benutzerdefinierten Text und ein Texteingabefeld dar und Confirm stellt ein Dialogfeld mit einer Zeile benutzerdefinierten Text und den Schaltflächen OK und Abbrechen dar.

Sie können verwenden HtmlWindow , um neue Fenster mit neuen Dokumenten zu öffnen. Open lädt die angegebene URL in das benannte Fenster und erstellt sie, wenn sie noch nicht vorhanden ist, während OpenNew die URL immer in einem neu erstellten Fenster geöffnet wird.

Eigenschaften

Document

Ruft das im Fenster enthaltene HTML-Dokument ab.

DomWindow

Ruft die nicht verwaltete Schnittstelle ab, die von dieser Klasse umschlossen wird.

Frames

Ruft einen Verweis auf jedes der FRAME auf der Webseite definierten Elemente ab.

History

Ruft ein Objekt ab, das die zuletzt besuchten URLs des Benutzers enthält.

IsClosed

Ruft einen Wert ab, der angibt, ob dieses Fenster geöffnet oder geschlossen ist.

Name

Ruft den Namen des Fensters ab oder legt diesen fest.

Opener

Ruft einen Verweis auf das Fenster ab, aus dem das aktuelle Fenster geöffnet wurde.

Parent

Ruft das Fenster ab, das sich über dem aktuellen Fenster auf einer Seite befindet, die Frames enthält.

Position

Ruft für das Fenster die Position des Clientbereichs auf dem Bildschirm ab.

Size

Ruft die Größe des aktuellen Fensters ab oder legt diese fest.

StatusBarText

Ruft den auf der Statusleiste eines Fensters angezeigten Text ab oder legt diesen fest.

Url

Ruft die URL ab, die dem gegenwärtig im Fenster angezeigten Element entspricht.

WindowFrameElement

Ruft das Frameelement ab, das diesem Fenster entspricht.

Methoden

Alert(String)

Zeigt ein Meldungsfenster an.

AttachEventHandler(String, EventHandler)

Fügt einen Ereignishandler für das benannte HTML-DOM-Ereignis hinzu.

Close()

Schließt das Fenster.

Confirm(String)

Zeigt ein Dialogfeld mit einer Meldung und Schaltflächen für die Angabe einer Ja/Nein-Antwort an.

DetachEventHandler(String, EventHandler)

Entfernt den benannten Ereignishandler.

Equals(Object)

Überprüft das Objekt und das aktuelle Objekt auf Gleichheit.

Focus()

Legt den Fokus auf das aktuelle Fenster fest.

GetHashCode()

Dient als Hashfunktion für einen bestimmten Typ.

GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
MoveTo(Int32, Int32)

Verschiebt das Fenster an die angegebenen Koordinaten auf dem Bildschirm.

MoveTo(Point)

Verschiebt das Fenster an die angegebenen Koordinaten auf dem Bildschirm.

Navigate(String)

Zeigt den neuen Inhalt unter der angegebenen URL an oder lädt diesen herunter.

Navigate(Uri)

Zeigt ein neues Dokument im aktuellen Fenster an.

Open(String, String, String, Boolean)

Zeigt eine Datei im benannten Fenster an.

Open(Uri, String, String, Boolean)

Zeigt eine Datei im benannten Fenster an.

OpenNew(String, String)

Zeigt eine Datei in einem neuen Fenster an.

OpenNew(Uri, String)

Zeigt eine Datei in einem neuen Fenster an.

Prompt(String, String)

Zeigt ein Dialogfeld an, in dem für den Benutzer eine Meldung und ein Textfeld angezeigt werden.

RemoveFocus()

Entfernt den Fokus vom aktuellen Fenster.

ResizeTo(Int32, Int32)

Ändert die Größe des Fensters auf die angegebenen Dimensionen.

ResizeTo(Size)

Ändert die Größe des Fensters auf die angegebenen Dimensionen.

ScrollTo(Int32, Int32)

Ermöglicht das Scrollen des Fensters zur festgelegten Position.

ScrollTo(Point)

Verschiebt das Fenster an die angegebenen Koordinaten.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Operatoren

Equality(HtmlWindow, HtmlWindow)

Überprüft die beiden HtmlWindow-Objekte auf Gleichheit.

Inequality(HtmlWindow, HtmlWindow)

Überprüft zwei HtmlWindow-Objekte auf Ungleichheit.

Ereignisse

Error

Tritt ein, wenn bei der Ausführung eines Skripts innerhalb des Fensters ein Laufzeitfehler auftritt.

GotFocus

Tritt ein, wenn das aktuelle Fenster den Benutzereingabefokus erhält.

Load

Tritt ein, wenn die Initialisierung für das Dokument des Fensters und alle seine Elemente abgeschlossen wurde.

LostFocus

Tritt ein, wenn der Benutzereingabefokus das Fenster verlassen hat.

Resize

Tritt ein, wenn der Benutzer mithilfe der Maus die Dimensionen des Fensters ändert.

Scroll

Tritt ein, wenn der Benutzer einen Bildlauf durch das Fenster durchführt, um Text anzuzeigen, der sich außerhalb des Bildschirms befindet.

Unload

Tritt ein, wenn die aktuelle Seite entladen und eine neue Seite angezeigt wird.

Gilt für:

Weitere Informationen