HtmlWindow Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Reprezentuje okno logiczne zawierające co najmniej jedno wystąpienie elementu HtmlDocument.
public ref class HtmlWindow sealed
public sealed class HtmlWindow
type HtmlWindow = class
Public NotInheritable Class HtmlWindow
- Dziedziczenie
-
HtmlWindow
Przykłady
Poniższy przykład kodu zawiera dwie metody. Pierwszy otwiera adres URL w oknie o nazwie displayWindow
, który tworzy z wyświetlonym paskiem stanu. Drugi otwiera inny adres URL w tym samym oknie, ale określa, że powinien być wyświetlany tylko pasek lokalizacji. Zwróć uwagę, że wymiary okna i wyświetlane kontrolki zależą od tego, który adres URL jest otwierany jako pierwszy. Przykładowy kod wymaga, aby formularz zawierał kontrolkę WebBrowser o nazwie 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
Uwagi
HtmlWindow nie należy mylić z pojęciem okna w formularzach systemu Windows lub interfejsie API systemu Windows; nie HWND
ma lub podobnego zasobu systemu Windows, który odpowiada bezpośrednio wystąpieniu programu HtmlWindow.
HtmlWindow Zamiast tego zawiera ogólne opisy lokalizacji dokumentu na ekranie użytkownika, a także metody interakcji z użytkownikami za pomocą monitów i okien dialogowych.
HtmlWindow działa jako kontener logiczny dla dokumentów i metadanych strony sieci Web, takich jak lokalizacja dokumentu i możliwości przeglądarki sieci Web.
Strona sieci Web składa się z jednego dokumentu lub FRAMESET
zawierającego co najmniej jeden FRAME
element, z których każdy hostuje własny dokument. Deweloperzy sieci Web używają zestawów ramek do wyświetlania logicznie powiązanych stron obok siebie (na przykład strony zawartości obok strony nawigacji). Gdy strona składa się z jednego dokumentu, można uzyskać do niego dostęp za pośrednictwem właściwości HtmlWindow; jeśli strona używa ramek, można uzyskać dostęp do ich dokumentów za pośrednictwem DocumentFrames kolekcji, która składa się z jednego lub większej liczby HtmlWindow obiektów.
Podczas hostowania kontrolki WebBrowser w aplikacji Windows Forms możesz wybrać interakcję z użytkownikiem przy użyciu standardowych klas windows Forms, takich jak Form lub MessageBox, lub można użyć metod HtmlWindow zdefiniowanych w tym celu. Metoda przedstawia proste okno dialogowe z niestandardowym tekstem i przyciskiem OK. Prompt Przedstawia Alert wiersz niestandardowego tekstu i pola wprowadzania tekstu użytkownikowi oraz Confirm przedstawia okno dialogowe z wierszem niestandardowego tekstu i przyciskami OK i Anuluj.
Możesz użyć HtmlWindow polecenia , aby otworzyć nowe okna zawierające nowe dokumenty. Open ładuje określony adres URL do nazwanego okna, tworząc go, jeśli jeszcze nie istnieje, podczas gdy OpenNew zawsze otwiera adres URL w nowo utworzonym oknie.
Właściwości
Document |
Pobiera dokument HTML zawarty w oknie. |
DomWindow |
Pobiera niezarządzany interfejs opakowany przez tę klasę. |
Frames |
Pobiera odwołanie do każdego z elementów zdefiniowanych |
History |
Pobiera obiekt zawierający ostatnio odwiedzane adresy URL użytkownika. |
IsClosed |
Pobiera wartość wskazującą, czy to okno jest otwarte, czy zamknięte. |
Name |
Pobiera lub ustawia nazwę okna. |
Opener |
Pobiera odwołanie do okna, które otworzyło bieżące okno. |
Parent |
Pobiera okno znajdujące się powyżej bieżącej strony zawierającej ramki. |
Position |
Pobiera położenie obszaru klienta okna na ekranie. |
Size |
Pobiera lub ustawia rozmiar bieżącego okna. |
StatusBarText |
Pobiera lub ustawia tekst wyświetlany na pasku stanu okna. |
Url |
Pobiera adres URL odpowiadający bieżącemu elementowi wyświetlanemu w oknie. |
WindowFrameElement |
Pobiera element ramki odpowiadający temu oknie. |
Metody
Alert(String) |
Wyświetla pole komunikatu. |
AttachEventHandler(String, EventHandler) |
Dodaje procedurę obsługi zdarzeń dla nazwanego zdarzenia DOM HTML. |
Close() |
Zamyka okno. |
Confirm(String) |
Wyświetla okno dialogowe z komunikatem i przyciskami, aby poprosić o odpowiedź tak/bez. |
DetachEventHandler(String, EventHandler) |
Usuwa nazwaną procedurę obsługi zdarzeń. |
Equals(Object) |
Sprawdza obiekt pod kątem równości względem bieżącego obiektu. |
Focus() |
Umieszcza fokus na bieżącym oknie. |
GetHashCode() |
Pełni rolę funkcji skrótu dla określonego typu. |
GetType() |
Type Pobiera bieżące wystąpienie. (Odziedziczone po Object) |
MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
MoveTo(Int32, Int32) |
Przenosi okno do określonych współrzędnych na ekranie. |
MoveTo(Point) |
Przenosi okno do określonych współrzędnych na ekranie. |
Navigate(String) |
Wyświetla lub pobiera nową zawartość znajdującą się pod określonym adresem URL. |
Navigate(Uri) |
Wyświetla nowy dokument w bieżącym oknie. |
Open(String, String, String, Boolean) |
Wyświetla plik w nazwanym oknie. |
Open(Uri, String, String, Boolean) |
Wyświetla plik w nazwanym oknie. |
OpenNew(String, String) |
Wyświetla plik w nowym oknie. |
OpenNew(Uri, String) |
Wyświetla plik w nowym oknie. |
Prompt(String, String) |
Przedstawia okno dialogowe, które wyświetla komunikat i pole tekstowe dla użytkownika. |
RemoveFocus() |
Wyłącza fokus bieżącego okna. |
ResizeTo(Int32, Int32) |
Zmienia rozmiar okna na określone wymiary. |
ResizeTo(Size) |
Zmienia rozmiar okna na określone wymiary. |
ScrollTo(Int32, Int32) |
Przewija okno do wyznaczonej pozycji. |
ScrollTo(Point) |
Przenosi okno do określonych współrzędnych. |
ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |
Operatory
Equality(HtmlWindow, HtmlWindow) |
Sprawdza dwa HtmlWindow obiekty pod kątem równości. |
Inequality(HtmlWindow, HtmlWindow) |
Testuje dwa |
Zdarzenia
Error |
Występuje, gdy skrypt działający wewnątrz okna napotyka błąd czasu wykonywania. |
GotFocus |
Występuje, gdy bieżące okno uzyskuje fokus danych wejściowych użytkownika. |
Load |
Występuje, gdy dokument okna i wszystkie jego elementy zakończyły inicjowanie. |
LostFocus |
Występuje, gdy fokus wprowadzania danych użytkownika opuścił okno. |
Resize |
Występuje, gdy użytkownik używa myszy do zmiany wymiarów okna. |
Scroll |
Występuje, gdy użytkownik przewija okno, aby wyświetlić tekst poza ekranem. |
Unload |
Występuje, gdy bieżąca strona jest zwalniana, a nowa strona ma zostać wyświetlona. |