HtmlWindow Klasse
Definition
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
-
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 |
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 |
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. |