HtmlWindow Klasse

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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: Object
HtmlWindow

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 die angezeigten Steuerelemente von der ersten GEÖFFNETen URL abhängen. Das Codebeispiel erfordert, dass Ihr Formular ein Steuerelement mit dem WebBrowser Namen " 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

Hinweise

HtmlWindowsollte nicht mit dem Konzept eines Fensters in Windows Forms oder der Windows-API verwechselt werden. Es gibt keine HWND oder ähnliche Windows Ressource, die direkt einer Instanz von HtmlWindow. HtmlWindow Stattdessen werden allgemeine Beschreibungen des Speicherorts eines Dokuments auf dem Bildschirm eines Benutzers sowie Methoden für die Interaktion mit Benutzern mithilfe von Eingabeaufforderungen und Dialogfeldern bereitgestellt. HtmlWindow dient als logischer Container für die Dokumente und metadaten einer Webseite, z. B. den Speicherort des Dokuments und die Funktionen des Webbrowsers.

Eine Webseite besteht aus einem einzelnen Dokument oder einem FRAMESET Element, das mindestens ein FRAME Element enthält, von denen jeweils ein eigenes Dokument gehostet wird. 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 HtmlWindow; wenn die Seite Frames verwendet, können Sie über die Frames Auflistung auf ihre Dokumente zugreifen, die aus einem oder mehreren HtmlWindow Objekten besteht.

Wenn Sie das WebBrowser Steuerelement in einer Windows Forms-Anwendung hosten, können Sie auswählen, dass sie mit dem Benutzer interagieren, indem Sie standard-Windows Forms Klassen verwenden, zForm. B. oder , oder MessageBoxSie können Methoden verwenden, die HtmlWindow für diesen Zweck definiert sind. Die Alert Methode stellt ein einfaches Dialogfeld mit benutzerdefiniertem Text und einer OK-Schaltfläche dar; Prompt stellt eine Zeile von benutzerdefiniertem Text und ein Texteingabefeld für den Benutzer dar, und Confirm es wird ein Dialogfeld mit einer Zeile mit benutzerdefiniertem Text und OK und Abbrechen-Schaltflächen angezeigt.

Sie können HtmlWindow neue Fenster öffnen, die neue Dokumente enthalten. Open lädt die angegebene URL in das benannte Fenster, erstellt sie, wenn sie noch nicht vorhanden ist, während die OpenNew 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 die einzelnen `FRAME`-Elemente ab, die in der Webseite definiert sind.
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