HtmlWindow Třída

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

HtmlWindow.cs

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, kterou adresu URL se otevře jako první. Příklad kódu vyžaduje, aby formulář obsahuje 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

HtmlWindow by se nemělo zaměňovat s konceptem okna ve Windows Forms nebo rozhraní API systému Windows; neexistuje žádný HWND nebo podobný prostředek Systému Windows, který odpovídá přímo instanci HtmlWindow. Místo toho HtmlWindow poskytuje obecné 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ánka 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 přistupovat prostřednictvím Frames kolekce, která se skládá z jednoho nebo více HtmlWindow objektů.

Když je hostitelem WebBrowser ovládacího prvku v aplikaci Windows Forms, můžete zvolit interakci s uživatelem pomocí standardních tříd Modelu Windows Forms, jako Form je nebo MessageBoxnebo můžete použít metody definované HtmlWindow pro tento účel. Tato Alert metoda 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ání textu uživateli a 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 a vytvoří ji, pokud ještě neexistuje, zatímco OpenNew vždy se otevře její adresa URL v nově vytvořeném okně.

Vlastnosti

Name	Description
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 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 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žce zobrazené v okně.
WindowFrameElement	Získá rámeček element odpovídající tomuto okně.

Metody

Name	Description
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 typu 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 hashovací funkce pro určitý typ.
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, ve které se uživateli zobrazí zpráva a textové pole.
RemoveFocus()	Přesune fokus mimo aktuální okno.
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čené místo.
ScrollTo(Point)	Přesune okno na zadané souřadnice.

Operátory

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

Událost

Name	Description
Error	Nastane, když skript spuštěný uvnitř okna 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 dokončily inicializaci.
LostFocus	Nastane, když fokus vstupu uživatele opustí okno.
Resize	Nastane, když uživatel pomocí myši změní rozměry okna.
Scroll	Nastane, když se uživatel v okně posune a zobrazí text mimo obrazovku.
Unload	Nastane, když se aktuální stránka vybalí a zobrazí se nová stránka.

Viz také

• window – objekt
• IHTMLWindow2 – rozhraní