HtmlWindow Klass

Definition

public ref class HtmlWindow sealed

public sealed class HtmlWindow

type HtmlWindow = class

Public NotInheritable Class HtmlWindow

Arv

Object

HtmlWindow

Exempel

Följande kodexempel innehåller två metoder. Den första öppnar en URL i ett fönster med namnet displayWindow, som skapas med ett statusfält som visas. Den andra öppnar en annan URL i samma fönster, men anger att endast platsfältet ska visas. Observera att dimensionerna för fönstret och de kontroller som visas beror på vilken URL som öppnas först. Kodexemplet kräver att formuläret innehåller en WebBrowser kontroll med namnet 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

Kommentarer

HtmlWindow bör inte förväxlas med begreppet fönster i Windows Forms eller Windows API. Det finns ingen HWND eller liknande Windows resurs som motsvarar en instans av HtmlWindow. HtmlWindow Innehåller snarare beskrivningar på hög nivå av ett dokuments plats på en användares skärm, samt metoder för att interagera med användare genom uppmaningar och dialogrutor. HtmlWindow fungerar som en logisk container för en webbsidas dokument och dess metadata, till exempel dokumentets plats och funktionerna i webbläsaren.

En webbsida består av ett enda dokument, eller ett FRAMESET som innehåller ett eller flera FRAME element, som var och en är värd för sitt eget dokument. Webbutvecklare använder ramuppsättningar för att visa logiskt relaterade sidor sida vid sida (till exempel en innehållssida bredvid en navigeringssida). När en sida består av ett enda dokument kan du komma åt det via Document egenskapen HtmlWindowför . Om sidan använder ramar kan du komma åt deras dokument via Frames samlingen, som består av ett eller flera HtmlWindow objekt.

När din värd WebBrowser kontroll i ett Windows Forms program kan du välja att interagera med användaren med hjälp av standardklasser för Windows Forms, till exempel Form eller MessageBox, eller använda metoder på HtmlWindow definierat för detta ändamål. Metoden Alert visar en enkel dialogruta med anpassad text och en OK-knapp . Prompt Visar en rad med anpassad text och ett textinmatningsfält för användaren och Confirm visar en dialogruta med en rad anpassad text och OK - och Avbryt-knappar .

Du kan använda HtmlWindow för att öppna nya fönster som innehåller nya dokument. Open läser in den angivna URL:en i det namngivna fönstret och skapar den om den inte redan finns, samtidigt som OpenNew url:en alltid öppnas i ett nyligen skapat fönster.

Se även

• fönsterobjekt
• IHTMLWindow2-gränssnitt