HtmlWindow.Open Metod

Definition

Visar en fil i det namngivna fönstret.

Överlagringar

Name Description
Open(String, String, String, Boolean)

Visar en fil i det namngivna fönstret.

Open(Uri, String, String, Boolean)

Visar en fil i det namngivna fönstret.

Open(String, String, String, Boolean)

Källa:
HtmlWindow.cs
Källa:
HtmlWindow.cs
Källa:
HtmlWindow.cs
Källa:
HtmlWindow.cs
Källa:
HtmlWindow.cs

Visar en fil i det namngivna fönstret.

public:
 System::Windows::Forms::HtmlWindow ^ Open(System::String ^ urlString, System::String ^ target, System::String ^ windowOptions, bool replaceEntry);
public System.Windows.Forms.HtmlWindow Open(string urlString, string target, string windowOptions, bool replaceEntry);
public System.Windows.Forms.HtmlWindow? Open(string urlString, string target, string windowOptions, bool replaceEntry);
member this.Open : string * string * string * bool -> System.Windows.Forms.HtmlWindow
Public Function Open (urlString As String, target As String, windowOptions As String, replaceEntry As Boolean) As HtmlWindow

Parametrar

urlString
String

Den enhetliga resurslokaliseraren som beskriver platsen för filen som ska läsas in.

target
String

Namnet på fönstret där resursen ska öppnas. Detta kan vara ett namn som tillhandahålls av utvecklaren eller något av följande specialvärden:

_blank: Öppnas urlString i ett nytt fönster. Fungerar på samma sätt som ett anrop till OpenNew(String, String).

_media: Öppnas urlString i mediefältet.

_parent: Öppnas urlString i fönstret som skapade det aktuella fönstret.

_search: Öppnas urlString i sökfältet.

_self: Öppnas urlString i det aktuella fönstret.

_top: Om det anropas mot ett fönster som tillhör ett FRAME element öppnas urlString i fönstret som är värd för dess FRAMESET. Annars fungerar samma som _self.

windowOptions
String

En kommaavgränsad sträng som består av noll eller fler av följande alternativ i formuläret name=value. Förutom alternativen , , och som tar godtyckliga heltal, accepterar left varje alternativ eller top, och height eller width, som giltiga värden.yes1no0

channelmode: Används med den inaktuella kanaltekniken i Internet Explorer 4.0. Standard är no.

directories: Om fönstret ska visa katalognavigeringsknappar. Standard är yes.

height: Höjden på fönstrets klientområde, i bildpunkter. Minimivärdet är 100. försök att öppna ett fönster som är mindre än detta gör att fönstret öppnas enligt standardvärdena för Internet Explorer.

left: Fönstrets vänstra position (x-koordinat) i förhållande till det övre vänstra hörnet på användarens skärm, i bildpunkter. Måste vara ett positivt heltal.

location: Om adressfältet ska visas, vilket gör att användarna kan navigera i fönstret till en ny URL. Standard är yes.

menubar: Om menyer ska visas i det nya fönstret. Standard är yes.

resizable: Om fönstret kan ändras av användaren. Standard är yes.

scrollbars: Om fönstret har vågräta och lodräta rullningslister. Standard är yes.

status: Om fönstret har ett statusfält längst ned. Standard är yes.

titlebar: Om rubriken på den aktuella sidan visas. Om du anger det här alternativet till no har det ingen effekt i ett hanterat program. Namnlisten visas alltid.

toolbar: Om verktygsfältsknappar som Bakåt, Framåt och Stopp är synliga. Standard är yes.

top: Fönstrets övre position (y-koordinat), i förhållande till det övre vänstra hörnet på användarens skärm, i bildpunkter. Måste vara ett positivt heltal.

width: Bredden på fönstrets klientområde, i bildpunkter. Minimivärdet är 100. försök att öppna ett fönster som är mindre än detta gör att fönstret öppnas enligt standardvärdena för Internet Explorer.

replaceEntry
Boolean

true för att ersätta det aktuella fönstrets URL med urlString i navigeringshistoriken. Detta påverkar metodens funktion på HtmlHistory klassen.

Returer

Det nya fönstret eller det tidigare skapade fönstret med namnet av parametern target .

Kommentarer

Parametern target kan namnge ett fönster som skapades som ett resultat av ett tidigare anrop till Open. Parametern kan också peka på ett fönster som öppnas genom att klicka på en hyperlänk (A element) eller ett FORM element som använder TARGET attributet för att öppna url:en i ett nytt fönster. Följande HTML-kod öppnar ett nytt fönster med namnet orderWindow när användaren klickar på den:

<A HREF="/startOrder.aspx" TARGET="orderWindow">Click to Start Order</a>

Om du anger några alternativ för parametern windowOptions inaktiveras alla alternativ som inte ingår automatiskt. Med andra ord, om du bara anger windowOptions genom att du vill ha ett statusfält, visas inte menyraden, verktygsfältet, rubriken, rullningslisterna och så vidare om du inte uttryckligen aktiverar dem via windowOptions.

Om filen som refereras av url är en HTML-fil, textfil eller annan filtyp som kan finnas i Internet Explorer, visas den i det namngivna fönstret. Om filen inte kan visas inuti Internet Explorer, och fönstret som namnges av målet inte redan finns, öppnas fönstret bara tillräckligt länge för att Internet Explorer ska kunna ladda ned resursen. Det stängs omedelbart efteråt.

När du skapar nya fönster med hjälp av Open eller OpenNew, gör det att HTML-dokumentobjektmodellen öppnar en ny instans av Internet Explorer. Om du inte anropar Close på alla fönster som du har skapat fortsätter den här instansen av Internet Explorer att köras även efter att programmet har avslutats.

Om du använder Open för att läsa in en URL i ett befintligt fönster windowOptions ignoreras. Fönstret behåller dimensionerna, utseendet och skärmplatsen först efter det första anropet till Open.

Gäller för

Open(Uri, String, String, Boolean)

Källa:
HtmlWindow.cs
Källa:
HtmlWindow.cs
Källa:
HtmlWindow.cs
Källa:
HtmlWindow.cs
Källa:
HtmlWindow.cs

Visar en fil i det namngivna fönstret.

public:
 System::Windows::Forms::HtmlWindow ^ Open(Uri ^ url, System::String ^ target, System::String ^ windowOptions, bool replaceEntry);
public System.Windows.Forms.HtmlWindow Open(Uri url, string target, string windowOptions, bool replaceEntry);
public System.Windows.Forms.HtmlWindow? Open(Uri url, string target, string windowOptions, bool replaceEntry);
member this.Open : Uri * string * string * bool -> System.Windows.Forms.HtmlWindow
Public Function Open (url As Uri, target As String, windowOptions As String, replaceEntry As Boolean) As HtmlWindow

Parametrar

url
Uri

Den enhetliga resurslokaliseraren som beskriver platsen för filen som ska läsas in.

target
String

Namnet på fönstret där resursen ska öppnas. Detta kan vara ett namn som tillhandahålls av utvecklare eller något av följande specialvärden:

_blank: Öppnas url i ett nytt fönster. Fungerar på samma sätt som ett anrop till OpenNew(String, String).

_media: Öppnas url i mediefältet.

_parent: Öppnas url i fönstret som skapade det aktuella fönstret.

_search: Öppnas url i sökfältet.

_self: Öppnas url i det aktuella fönstret.

_top: Om det anropas mot ett fönster som tillhör ett FRAME element öppnas url i fönstret som är värd för dess FRAMESET. Annars fungerar samma som _self.

windowOptions
String

En kommaavgränsad sträng som består av noll eller fler av följande alternativ i formuläret name=value. Förutom alternativen , , och som tar godtyckliga heltal, accepterar left varje alternativ eller top, och height eller width, som giltiga värden.yes1no0

channelmode: Används med den inaktuella kanaltekniken i Internet Explorer 4.0. Standard är no.

directories: Om fönstret ska visa katalognavigeringsknappar. Standard är yes.

height: Höjden på fönstrets klientområde, i bildpunkter. Minimivärdet är 100. försök att öppna ett fönster som är mindre än detta gör att fönstret öppnas enligt standardvärdena för Internet Explorer.

left: Fönstrets vänstra position (x-koordinat) i förhållande till det övre vänstra hörnet på användarens skärm, i bildpunkter. Måste vara ett positivt heltal.

location: Om adressfältet ska visas, vilket gör att användarna kan navigera i fönstret till en ny URL. Standard är yes.

menubar: Om menyer ska visas i det nya fönstret. Standard är yes.

resizable: Om fönstret kan ändras av användaren. Standard är yes.

scrollbars: Om fönstret har vågräta och lodräta rullningslister. Standard är yes.

status: Om fönstret har ett statusfält längst ned. Standard är yes.

titlebar: Om rubriken på den aktuella sidan visas. Om du anger det här alternativet till no har det ingen effekt i ett hanterat program. Namnlisten visas alltid.

toolbar: Om verktygsfältsknappar som Bakåt, Framåt och Stopp är synliga. Standard är yes.

top: Fönstrets övre position (y-koordinat), i förhållande till det övre vänstra hörnet på användarens skärm, i bildpunkter. Måste vara ett positivt heltal.

width: Bredden på fönstrets klientområde, i bildpunkter. Minimivärdet är 100. försök att öppna ett fönster som är mindre än detta gör att fönstret öppnas enligt standardvärdena för Internet Explorer.

replaceEntry
Boolean

true för att ersätta det aktuella fönstrets URL med url i navigeringshistoriken. Detta påverkar hur metoderna fungerar i HtmlHistory klassen.

Returer

Ett HtmlWindow som representerar det nya fönstret eller det tidigare skapade fönstret med namnet av parametern target .

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

Parametern target kan namnge ett fönster som skapades som ett resultat av ett tidigare anrop till Open. Parametern kan också peka på ett fönster som öppnas genom att klicka på en hyperlänk (A element) eller ett FORM element som använder TARGET attributet för att öppna url:en i ett nytt fönster. Följande HTML-kod öppnar ett nytt fönster med namnet orderWindow när användaren klickar på den:

<A HREF="/startOrder.aspx" TARGET="orderWindow">Click to Start Order</a>

Om du anger några alternativ för parametern windowOptions inaktiveras alla alternativ som inte ingår automatiskt. Med andra ord, om du bara anger windowOptions genom att du vill ha ett statusfält, visas inte menyraden, verktygsfältet, rubriken, rullningslisterna och så vidare om du inte uttryckligen aktiverar dem via windowOptions.

Om filen som refereras av url är en HTML-fil, textfil eller annan filtyp som kan finnas i Internet Explorer, visas den i det namngivna fönstret. Om filen inte kan visas inuti Internet Explorer, och fönstret som namnges av målet inte redan finns, öppnas fönstret bara tillräckligt länge för att Internet Explorer ska kunna ladda ned resursen. Det stängs omedelbart efteråt.

När du skapar nya fönster med hjälp av Open eller OpenNew, gör det att HTML-dokumentobjektmodellen öppnar en ny instans av Internet Explorer. Om du inte anropar Close på alla fönster som du har skapat fortsätter den här instansen av Internet Explorer att köras även efter att programmet har avslutats.

Om du använder Open för att läsa in en URL i ett befintligt fönster windowOptions ignoreras. Fönstret behåller dimensionerna, utseendet och skärmplatsen först efter det första anropet till Open.

Se även

Gäller för