HtmlWindow Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Forms

Zestaw:: System.Windows.Forms.dll

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 klasy HtmlDocument.

public ref class HtmlWindow sealed

public sealed class HtmlWindow

type HtmlWindow = class

Public NotInheritable Class HtmlWindow

Dziedziczenie: Object
HtmlWindow

Przykłady

Poniższy przykład kodu zawiera dwie metody. Pierwszy otwiera adres URL w oknie o nazwie displayWindow, który zostanie utworzony 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

HtmlWindownie należy mylić z pojęciem okna w Windows Forms lub interfejsie API Windows; nie HWND ma ani podobnego zasobu Windows, który odpowiada bezpośrednio wystąpieniu HtmlWindowprogramu . HtmlWindow Zamiast tego udostępnia 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 strony sieci Web i jej metadanych, 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 stron powiązanych logicznie 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 Document właściwości HtmlWindow. Jeśli strona używa ramek, dostęp do dokumentów można uzyskać za pośrednictwem Frames kolekcji, która składa się z jednego lub większej liczby HtmlWindow obiektów.

Gdy kontrolka jest hostowana WebBrowser w aplikacji Windows Forms, możesz zdecydować się na interakcję z użytkownikiem przy użyciu standardowych klas Windows Forms, takich jak Form lub MessageBox, lub można użyć metod zdefiniowanych HtmlWindow w tym celu. Metoda Alert przedstawia proste okno dialogowe z tekstem niestandardowym i przyciskiem OK ; Prompt przedstawia wiersz tekstu niestandardowego i pole wprowadzania tekstu użytkownikowi, a Confirm następnie przedstawia okno dialogowe z wierszem tekstu niestandardowego oraz 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 `FRAME` zdefiniowanych na stronie sieci Web.
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żącego na stronie 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 okno komunikatu.
AttachEventHandler(String, EventHandler)	Dodaje program obsługi zdarzeń dla nazwanego zdarzenia DOM HTML.
Close()	Zamyka okno.
Confirm(String)	Wyświetla okno dialogowe z komunikatem i przyciskami w celu żądania odpowiedzi tak/bez.
DetachEventHandler(String, EventHandler)	Usuwa nazwaną procedurę obsługi zdarzeń.
Equals(Object)	Testuje 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 wartość bieżącego wystąpienia. (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)	Wyświetla okno dialogowe z komunikatem i polem tekstowym 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)	Testuje dwa HtmlWindow obiekty pod kątem równości.
Inequality(HtmlWindow, HtmlWindow)	Testuje dwa `HtmlWindow` obiekty pod kątem nierówności.

Zdarzenia

Error	Występuje, gdy skrypt uruchomiony wewnątrz okna napotka 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 danych wejściowych 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 zostanie zwolniona, a nowa strona zostanie wyświetlona.

Dotyczy