HtmlWindow Třída

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Představuje logické okno, které obsahuje jednu nebo více instancí HtmlDocument.

public ref class HtmlWindow sealed

public sealed class HtmlWindow

type HtmlWindow = class

Public NotInheritable Class HtmlWindow

Dědičnost

Object

HtmlWindow

Příklady

Následující příklad kódu obsahuje dvě metody. První otevře adresu URL v okně s názvem displayWindow, které se vytvoří se stavovým řádkem. Druhá otevře další adresu URL ve stejném okně, ale určuje, že se má zobrazit pouze panel umístění. Všimněte si, že rozměry okna a zobrazené ovládací prvky závisí na tom, která adresa URL se otevře jako první. Příklad kódu vyžaduje, aby formulář obsahoval WebBrowser ovládací prvek s názvem 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

Poznámky

HtmlWindownemělo by být zaměňováno s konceptem okna v model Windows Forms nebo rozhraní API Windows; neexistuje žádná HWND nebo podobná Windows prostředek, který odpovídá přímo instanci HtmlWindow. HtmlWindow Místo toho poskytuje popisy umístění dokumentu na obrazovce uživatele a také metody pro interakci s uživateli pomocí výzev a dialogových oken. HtmlWindow funguje jako logický kontejner pro dokumenty webové stránky a jeho metadata, jako je umístění dokumentu a možnosti webového prohlížeče.

Webová stránka se skládá z jednoho dokumentu nebo FRAMESET obsahujícího jeden nebo více FRAME prvků, z nichž každý je hostitelem vlastního dokumentu. Weboví vývojáři používají sady rámců k zobrazení logicky souvisejících stránek vedle sebe (například stránku obsahu vedle navigační stránky). Když se stránka skládá z jednoho dokumentu, můžete k němu přistupovat prostřednictvím Document vlastnosti HtmlWindow; pokud stránka používá rámce, můžete k jejich dokumentům Frames přistupovat prostřednictvím kolekce, která se skládá z jednoho nebo více HtmlWindow objektů.

Pokud je hostitelem WebBrowser ovládacího prvku v aplikaci model Windows Forms, můžete se rozhodnout pracovat s uživatelem pomocí standardních tříd model Windows Forms, jako Form jsou nebo MessageBox, nebo můžete použít metody definované HtmlWindow pro tento účel. Metoda Alert představuje jednoduché dialogové okno s vlastním textem a tlačítkem OK ; Prompt představuje řádek vlastního textu a textové pole pro zadávání textu uživateli. Confirm Zobrazí dialogové okno s řádkem vlastního textu a tlačítky OK a Storno .

Můžete použít HtmlWindow k otevření nových oken obsahujících nové dokumenty. Open načte zadanou adresu URL do pojmenovaného okna, vytvoří ji, pokud ještě neexistuje, zatímco OpenNew vždy otevře její adresu URL v nově vytvořeném okně.

Vlastnosti

Document	Získá dokument HTML obsažený v okně.
DomWindow	Získá nespravované rozhraní zabalené touto třídou.
Frames	Získá odkaz na každý z elementů FRAME definovaných na webové stránce.
History	Získá objekt obsahující naposledy navštívené adresy URL uživatele.
IsClosed	Získá hodnotu označující, zda je toto okno otevřené nebo zavřené.
Name	Získá nebo nastaví název okna.
Opener	Získá odkaz na okno, které otevřelo aktuální okno.
Parent	Získá okno, které se nachází nad aktuální na stránce obsahující rámce.
Position	Získá pozici oblasti klienta okna na obrazovce.
Size	Získá nebo nastaví velikost aktuálního okna.
StatusBarText	Získá nebo nastaví text zobrazený na stavovém řádku okna.
Url	Získá adresu URL odpovídající aktuální položce zobrazené v okně.
WindowFrameElement	Získá prvek rámečku odpovídající tomuto okně.

Metody

Alert(String)	Zobrazí okno se zprávou.
AttachEventHandler(String, EventHandler)	Přidá obslužnou rutinu události pro pojmenovanou událost HTML DOM.
Close()	Zavře okno.
Confirm(String)	Zobrazí dialogové okno se zprávou a tlačítky pro vyžádání odpovědi ano/ne.
DetachEventHandler(String, EventHandler)	Odebere pojmenovanou obslužnou rutinu události.
Equals(Object)	Otestuje objekt pro rovnost proti aktuálnímu objektu.
Focus()	Umístí fokus na aktuální okno.
GetHashCode()	Slouží jako funkce hash pro určitý typ.
GetType()	Type Získá aktuální instanci. (Zděděno od Object)
MemberwiseClone()	Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object)
MoveTo(Int32, Int32)	Přesune okno na zadané souřadnice na obrazovce.
MoveTo(Point)	Přesune okno na zadané souřadnice na obrazovce.
Navigate(String)	Zobrazí nebo stáhne nový obsah umístěný na zadané adrese URL.
Navigate(Uri)	Zobrazí nový dokument v aktuálním okně.
Open(String, String, String, Boolean)	Zobrazí soubor v pojmenovaném okně.
Open(Uri, String, String, Boolean)	Zobrazí soubor v pojmenovaném okně.
OpenNew(String, String)	Zobrazí soubor v novém okně.
OpenNew(Uri, String)	Zobrazí soubor v novém okně.
Prompt(String, String)	Zobrazí dialogové okno, které uživateli zobrazí zprávu a textové pole.
RemoveFocus()	Přesune fokus z aktuálního okna.
ResizeTo(Int32, Int32)	Změní velikost okna na zadané dimenze.
ResizeTo(Size)	Změní velikost okna na zadané dimenze.
ScrollTo(Int32, Int32)	Posune okno na určenou pozici.
ScrollTo(Point)	Přesune okno na zadané souřadnice.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Operátory

Equality(HtmlWindow, HtmlWindow)	Otestuje dva HtmlWindow objekty pro rovnost.
Inequality(HtmlWindow, HtmlWindow)	Testuje dva HtmlWindow objekty pro nerovnost.

událost

Error	Nastane, když skript spuštěný v okně narazí na chybu za běhu.
GotFocus	Nastane, když aktuální okno získá fokus vstupu uživatele.
Load	Nastane, když dokument okna a všechny jeho prvky byly dokončeny inicializace.
LostFocus	Nastane, když fokus vstupu uživatele opustil okno.
Resize	Nastane, když uživatel pomocí myši změní rozměry okna.
Scroll	Nastane, když se uživatel posune v okně a zobrazí text mimo obrazovku.
Unload	Nastane, když se aktuální stránka odloží a zobrazí se nová stránka.

Viz také

• window – objekt
• IHTMLWindow2 – rozhraní