HtmlWindow Klasse

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Quelle:

HtmlWindow.cs

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

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

HtmlWindow sollte 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 HtmlWindowentspricht. HtmlWindow Stellt vielmehr allgemeine Beschreibungen der Position eines Dokuments auf dem Bildschirm eines Benutzers sowie Methoden für die Interaktion mit Benutzern mithilfe von Eingabeaufforderungen und Dialogfeldern bereit. 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 oder mehreren FRAME Elementen, die jeweils ein eigenes Dokument hosten. 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 HtmlWindow mehreren Objekten besteht.

Wenn Sie das WebBrowser Steuerelement in einer Windows Forms-Anwendung hosten, können Sie sich für die Interaktion mit dem Benutzer entscheiden, indem Sie standardmäßige Windows Forms-Klassen verwenden, z Form . B. oder MessageBox, oder Sie können methoden HtmlWindow für diesen Zweck verwenden. Die Alert Methode stellt ein einfaches Dialogfeld mit benutzerdefiniertem Text und einer Schaltfläche "OK " dar; Prompt stellt dem Benutzer eine Zeile mit benutzerdefiniertem Text und ein Texteingabefeld dar und Confirm zeigt ein Dialogfeld mit einer Zeile mit benutzerdefiniertem Text und OK - und Abbrechen-Schaltflächen an.

Sie können neue HtmlWindow Fenster öffnen, die neue Dokumente enthalten. 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

Name	Beschreibung
Document	Ruft das IM Fenster enthaltene HTML-Dokument ab.
DomWindow	Ruft die nicht verwaltete Schnittstelle ab, die von dieser Klasse umbrochen wird.
Frames	Ruft einen Verweis auf die einzelnen Elemente ab, die FRAME innerhalb 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 den Namen fest.
Opener	Ruft einen Verweis auf das Fenster ab, das das aktuelle Fenster geöffnet hat.
Parent	Ruft das Fenster ab, das sich oberhalb des aktuellen Fensters auf einer Seite befindet, die Frames enthält.
Position	Ruft die Position des Clientbereichs des Fensters auf dem Bildschirm ab.
Size	Ruft die Größe des aktuellen Fensters ab oder legt diese fest.
StatusBarText	Dient zum Abrufen oder Festlegen des Texts, der in der Statusleiste eines Fensters angezeigt wird.
Url	Ruft die URL ab, die dem aktuellen Element entspricht, das im Fenster angezeigt wird.
WindowFrameElement	Ruft das Frameelement ab, das diesem Fenster entspricht.

Methoden

Name	Beschreibung
Alert(String)	Zeigt ein Meldungsfeld 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 Nachricht und Schaltflächen an, um eine Ja/Nein-Antwort anzufordern.
DetachEventHandler(String, EventHandler)	Entfernt den benannten Ereignishandler.
Equals(Object)	Testet das Objekt auf Gleichheit mit dem aktuellen Objekt.
Focus()	Platziert den Fokus auf das aktuelle Fenster.
GetHashCode()	Dient als Hashfunktion für einen bestimmten Typ.
MoveTo(Int32, Int32)	Verschiebt das Fenster zu den angegebenen Koordinaten auf dem Bildschirm.
MoveTo(Point)	Verschiebt das Fenster zu den angegebenen Koordinaten auf dem Bildschirm.
Navigate(String)	Zeigt den neuen Inhalt an, der sich unter der angegebenen URL befindet, oder lädt sie 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 dem Benutzer eine Nachricht und ein Textfeld angezeigt werden.
RemoveFocus()	Hebt den Fokus vom aktuellen Fenster ab.
ResizeTo(Int32, Int32)	Ändert die Größe des Fensters in die angegebenen Dimensionen.
ResizeTo(Size)	Ändert die Größe des Fensters in die angegebenen Dimensionen.
ScrollTo(Int32, Int32)	Scrollt das Fenster zur angegebenen Position.
ScrollTo(Point)	Verschiebt das Fenster zu den angegebenen Koordinaten.

Operatoren

Name	Beschreibung
Equality(HtmlWindow, HtmlWindow)	Testet die beiden HtmlWindow Objekte auf Gleichheit.
Inequality(HtmlWindow, HtmlWindow)	Testet zwei HtmlWindow Objekte auf Ungleichheit.

Ereignisse

Name	Beschreibung
Error	Tritt auf, wenn ein Skript, das innerhalb des Fensters ausgeführt wird, auf einen Laufzeitfehler stößt.
GotFocus	Tritt auf, wenn das aktuelle Fenster den Benutzereingabefokus abruft.
Load	Tritt auf, wenn das Dokument des Fensters und alle zugehörigen Elemente die Initialisierung abgeschlossen haben.
LostFocus	Tritt auf, wenn der Benutzereingabefokus das Fenster verlassen hat.
Resize	Tritt auf, wenn der Benutzer die Maus verwendet, um die Abmessungen des Fensters zu ändern.
Scroll	Tritt auf, wenn der Benutzer durch das Fenster scrollt, um Außerhalb des Bildschirmtexts anzuzeigen.
Unload	Tritt auf, wenn die aktuelle Seite entladen wird und eine neue Seite angezeigt werden soll.

Weitere Informationen

• window-Objekt
• IHTMLWindow2-Schnittstelle