Udostępnij za pośrednictwem


HtmlWindow Klasa

Definicja

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 FRAME 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żą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 HtmlWindow obiekty pod kątem nierówności.

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.

Dotyczy

Zobacz też