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é vytvoří se zobrazeným stavovým řádkem. Druhý otevře další adresu URL ve stejném okně, ale určuje, že se má zobrazit jenom panel umístění. Všimněte si, že rozměry okna a zobrazených ovládacích prvků závisí na tom, která adresa URL je otevřena 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

HtmlWindowby neměly být zaměňovány s konceptem okna v modelu Windows Forms nebo rozhraní API systému Windows; neexistuje žádný HWND nebo podobný prostředek Windows, který přímo odpovídá instanci .HtmlWindow Místo toho HtmlWindow poskytuje základní popisy umístění dokumentu na obrazovce uživatele a také metody pro interakci s uživateli prostřednictvím výzev a dialogových oken. HtmlWindow funguje jako logický kontejner pro dokumenty webové stránky a její 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ý hostuje svůj vlastní dokument. Weboví vývojáři používají sady rámců k zobrazení logicky souvisejících stránek vedle sebe (například stránky obsahu vedle navigační stránky). Pokud se stránka skládá z jednoho dokumentu, můžete k ní přistupovat prostřednictvím Document vlastnosti HtmlWindow. Pokud stránka používá rámce, můžete k jejím dokumentům přistupovat prostřednictvím Frames kolekce, která se skládá z jednoho nebo více HtmlWindow objektů.

Když je ovládací prvek hostitelem WebBrowser v aplikaci Modelu Windows Forms, můžete zvolit interakci s uživatelem pomocí standardních tříd modelu Windows Forms, jako Form je nebo MessageBox, nebo můžete použít metody definované HtmlWindow pro tento účel. Metoda Alert zobrazí jednoduché dialogové okno s vlastním textem a tlačítkem OK , Prompt uživateli zobrazí řádek vlastního textu a pole pro zadání textu a Confirm zobrazí dialogové okno s řádkem vlastního textu a tlačítky OK a Zrušit .

Pomocí příkazu HtmlWindow můžete otevřít nová okna obsahující nové dokumenty. Open načte zadanou adresu URL do pojmenovaného okna a vytvoří ji, pokud ještě neexistuje, a její OpenNew adresa URL se vždy otevře 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 FRAME prvků definovaných v rámci webové stránky.
History	Získá objekt obsahující uživatele naposledy navštívené adresy URL.
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í jeden na stránce obsahující rámce.
Position	Získá pozici klientské oblasti 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žky zobrazené v okně.
WindowFrameElement	Získá prvek rámce 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)	Testuje rovnost objektu 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á z aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (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řemísní fokus z aktuálního okna.
ResizeTo(Int32, Int32)	Změní velikost okna na zadané rozměry.
ResizeTo(Size)	Změní velikost okna na zadané rozměry.
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)	Testuje oba HtmlWindow objekty z hlediska rovnosti.
Inequality(HtmlWindow, HtmlWindow)	Testuje dva HtmlWindow objekty na nerovnost.

Událost

Error	Vyvolá se v případě, že skript spuštěný uvnitř okna narazí na chybu za běhu.
GotFocus	Vyvolá se, když aktuální okno získá fokus vstupu uživatele.
Load	Vyvolá se, když se dokončí inicializace dokumentu okna a všech jeho prvků.
LostFocus	Vyvolá se, když fokus vstupu uživatele opustí okno.
Resize	Vyvolá se, když uživatel pomocí myši změní rozměry okna.
Scroll	Vyvolá se, když uživatel prochází okno, aby zobrazil text mimo obrazovku.
Unload	Vyvolá se při uvolňování aktuální stránky a chystá se zobrazit nová stránka.

Viz také

• objekt window
• IHTMLWindow2 – rozhraní