HtmlWindow Osztály

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Forrás:

HtmlWindow.cs

Azt a logikai ablakot jelöli, amely egy vagy több példányt HtmlDocumenttartalmaz.

public ref class HtmlWindow sealed

public sealed class HtmlWindow

type HtmlWindow = class

Public NotInheritable Class HtmlWindow

Öröklődés

Object

HtmlWindow

Példák

Az alábbi példakód két metódust tartalmaz. Az első egy URL-címet nyit meg egy névvel ellátott displayWindowablakban, amelyet egy állapotsorsal hoz létre. A második egy másik URL-címet nyit meg ugyanabban az ablakban, de megadja, hogy csak a helysáv jelenjen meg. Figyelje meg, hogy az ablak méretei és a megjelenő vezérlők attól függenek, hogy melyik URL-címet nyitja meg először. A példakód megköveteli, hogy az űrlap tartalmazjon egy nevű vezérlőt WebBrowserWebBrowser1.

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

Megjegyzések

HtmlWindow nem tévesztendő össze az Windows Forms vagy a Windows API ablakának fogalmával; nincs HWND vagy hasonló Windows erőforrás, amely közvetlenül a HtmlWindow egy példányának felel meg. HtmlWindow Ehelyett a dokumentum helyének magas szintű leírását adja meg a felhasználó képernyőjén, valamint a felhasználókkal való interakció módszereit a parancssorok és párbeszédpanelek segítségével. HtmlWindow logikai tárolóként szolgál a weblap dokumentumaihoz és metaadataihoz, például a dokumentum helyéhez és a webböngésző képességeihez.

A weblapok egyetlen dokumentumból vagy FRAMESET egy vagy több FRAME elemet tartalmazó dokumentumból állnak, amelyek mindegyike saját dokumentumot tartalmaz. A webfejlesztők keretkészletekkel jelenítik meg egymás mellett a logikailag kapcsolódó lapokat (például egy navigációs oldal melletti tartalomlapot). Ha egy lap egyetlen dokumentumból áll, a tulajdonságon Documentkeresztül HtmlWindow érheti el. Ha a lap kereteket használ, a gyűjteményen keresztül érheti el a Frames dokumentumokat, amelyek egy vagy több HtmlWindow objektumból állnak.

Amikor egy Windows Forms alkalmazásban üzemelteti a WebBrowser vezérlőt, választhatja, hogy a felhasználóval szabványos Windows Forms osztályokat használ, például Form vagy MessageBox, vagy használhatja az erre a célra definiált HtmlWindow metódusokat. A Alert metódus egy egyszerű párbeszédpanelt jelenít meg egyéni szöveggel és EGY OK gombbal; Prompt bemutatja az egyéni szövegsort és egy szövegbeviteli mezőt a felhasználónak, és Confirm egy egyéni szövegsort, valamint az OK és a Mégse gombot tartalmazó párbeszédpanelt jelenít meg.

Új dokumentumokat tartalmazó új ablakokat nyithat HtmlWindow meg. Open betölti a megadott URL-címet a névvel ellátott ablakba, és létrehozza, ha még nem létezik, miközben OpenNew mindig megnyitja az URL-címét egy újonnan létrehozott ablakban.

Tulajdonságok

Name	Description
Document	Lekéri a HTML-dokumentumot az ablakban.
DomWindow	Lekéri az osztály által becsomagolt nem felügyelt felületet.
Frames	A weblapon definiált egyes FRAME elemekre mutató hivatkozást kap.
History	Lekéri a felhasználó legutóbb meglátogatott URL-címeit tartalmazó objektumot.
IsClosed	Beolvas egy értéket, amely jelzi, hogy ez az ablak nyitva vagy zárva van-e.
Name	Lekéri vagy beállítja az ablak nevét.
Opener	Az aktuális ablakot megnyitó ablakra mutató hivatkozást kap.
Parent	Lekéri az aktuális fölött található ablakot egy kereteket tartalmazó lapon.
Position	Lekéri az ablak ügyfélterületének pozícióját a képernyőn.
Size	Lekéri vagy beállítja az aktuális ablak méretét.
StatusBarText	Lekéri vagy beállítja az ablak állapotsorában megjelenő szöveget.
Url	Lekéri az ablakban megjelenő aktuális elemnek megfelelő URL-címet.
WindowFrameElement	Lekéri az ablaknak megfelelő keretelemet.

Metódusok

Name	Description
Alert(String)	Megjelenít egy üzenetmezőt.
AttachEventHandler(String, EventHandler)	Hozzáad egy eseménykezelőt a nevesített HTML DOM-eseményhez.
Close()	Bezárja az ablakot.
Confirm(String)	Egy üzenettel és gombokkal ellátott párbeszédpanelt jelenít meg, amely igen/nem választ kér.
DetachEventHandler(String, EventHandler)	Eltávolítja a nevesített eseménykezelőt.
Equals(Object)	Ellenőrzi az objektum egyenlőségét az aktuális objektummal szemben.
Focus()	A fókusz az aktuális ablakra kerül.
GetHashCode()	Egy adott típus kivonatfüggvénye.
MoveTo(Int32, Int32)	Az ablakot a képernyőn megadott koordinátákra helyezi át.
MoveTo(Point)	Az ablakot a képernyőn megadott koordinátákra helyezi át.
Navigate(String)	Megjeleníti vagy letölti a megadott URL-címen található új tartalmat.
Navigate(Uri)	Új dokumentumot jelenít meg az aktuális ablakban.
Open(String, String, String, Boolean)	Egy fájl megjelenítése a névvel ellátott ablakban.
Open(Uri, String, String, Boolean)	Egy fájl megjelenítése a névvel ellátott ablakban.
OpenNew(String, String)	Új ablakban jeleníti meg a fájlt.
OpenNew(Uri, String)	Új ablakban jeleníti meg a fájlt.
Prompt(String, String)	Egy párbeszédpanelt jelenít meg, amely egy üzenetet és egy szövegdobozt jelenít meg a felhasználónak.
RemoveFocus()	Kikapcsolja a fókuszt az aktuális ablakból.
ResizeTo(Int32, Int32)	Az ablak méretét a megadott méretekre módosítja.
ResizeTo(Size)	Az ablak méretét a megadott méretekre módosítja.
ScrollTo(Int32, Int32)	Görgeti az ablakot a kijelölt helyre.
ScrollTo(Point)	Az ablakot a megadott koordinátákra helyezi át.

Operátorok

Name	Description
Equality(HtmlWindow, HtmlWindow)	Teszteli a két HtmlWindow objektumot az egyenlőség érdekében.
Inequality(HtmlWindow, HtmlWindow)	Két HtmlWindow objektumot tesztel az egyenlőtlenség szempontjából.

esemény

Name	Description
Error	Akkor fordul elő, ha az ablakban futó szkript futásidejű hibát tapasztal.
GotFocus	Akkor fordul elő, ha az aktuális ablak beolvasja a felhasználói beviteli fókuszt.
Load	Akkor fordul elő, ha az ablak dokumentuma és annak minden eleme inicializálása befejeződött.
LostFocus	Akkor fordul elő, ha a felhasználói beviteli fókusz elhagyta az ablakot.
Resize	Akkor fordul elő, ha a felhasználó az egérrel módosítja az ablak méretét.
Scroll	Akkor fordul elő, ha a felhasználó görget az ablakban a képernyőn kívüli szöveg megtekintéséhez.
Unload	Az aktuális lap eltávolításakor következik be, és egy új lap jelenik meg.

Lásd még

• ablakobjektum
• IHTMLWindow2 interfész