HtmlWindow.Open Methode

Definitie

Geeft een bestand weer in het benoemde venster.

Overloads

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

Geeft een bestand weer in het benoemde venster.

Open(Uri, String, String, Boolean)

Geeft een bestand weer in het benoemde venster.

Open(String, String, String, Boolean)

Bron:
HtmlWindow.cs
Bron:
HtmlWindow.cs
Bron:
HtmlWindow.cs
Bron:
HtmlWindow.cs
Bron:
HtmlWindow.cs

Geeft een bestand weer in het benoemde venster.

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

Parameters

urlString
String

De Uniform Resource Locator die de locatie beschrijft van het te laden bestand.

target
String

De naam van het venster waarin de resource moet worden geopend. Dit kan een door de ontwikkelaar opgegeven naam zijn of een van de volgende speciale waarden:

_blank: Wordt geopend urlString in een nieuw venster. Werkt hetzelfde als een aanroep naar OpenNew(String, String).

_media: Wordt geopend urlString in de mediabalk.

_parent: Wordt geopend urlString in het venster dat het huidige venster heeft gemaakt.

_search: Wordt geopend urlString in de zoekbalk.

_self: Wordt geopend urlString in het huidige venster.

_top: Als het wordt aangeroepen tegen een venster dat hoort bij een FRAME element, wordt geopend urlString in het venster dat als FRAMESEThost fungeert voor het element. Anders werkt hetzelfde als _self.

windowOptions
String

Een door komma's gescheiden tekenreeks die bestaat uit nul of meer van de volgende opties in de vorm name=value. Behalve de leftopties , topen heightwidth opties, die willekeurige gehele getallen aannemen, accepteert yes of1, en no of 0, als geldige waarden.

channelmode: Wordt gebruikt met de afgeschafte kanalentechnologie van Internet Explorer 4.0. De standaardwaarde is no.

directories: Geeft aan of in het venster de navigatieknoppen voor mappen moeten worden weergegeven. De standaardwaarde is yes.

height: De hoogte van het clientgebied van het venster, in pixels. Het minimum is 100; probeert een venster te openen dat kleiner is dan dit, waardoor het venster wordt geopend volgens de standaardinstellingen van de Internet Explorer.

left: De linkerpositie (x-coördinaat) van het venster, ten opzichte van de linkerbovenhoek van het scherm van de gebruiker, in pixels. Moet een positief geheel getal zijn.

location: Of de adresbalk moet worden weergegeven, zodat gebruikers in het venster naar een nieuwe URL kunnen navigeren. De standaardwaarde is yes.

menubar: Of menu's in het nieuwe venster moeten worden weergegeven. De standaardwaarde is yes.

resizable: Of het venster kan worden gewijzigd door de gebruiker. De standaardwaarde is yes.

scrollbars: Of het venster horizontale en verticale schuifbalken bevat. De standaardwaarde is yes.

status: Of het venster onderaan een statusbalk heeft. De standaardwaarde is yes.

titlebar: Of de titel van de huidige pagina wordt weergegeven. Als u deze optie instelt op no geen effect binnen een beheerde toepassing, wordt de titelbalk altijd weergegeven.

toolbar: Of werkbalkknoppen, zoals Vorige, Doorsturen en Stoppen , zichtbaar zijn. De standaardwaarde is yes.

top: De bovenpositie (y-coördinaat) van het venster, ten opzichte van de linkerbovenhoek van het scherm van de gebruiker, in pixels. Moet een positief geheel getal zijn.

width: De breedte van het clientgebied van het venster, in pixels. Het minimum is 100; probeert een venster te openen dat kleiner is dan dit, waardoor het venster wordt geopend volgens de standaardinstellingen van de Internet Explorer.

replaceEntry
Boolean

true om de URL urlString van het huidige venster te vervangen door in de navigatiegeschiedenis. Dit heeft invloed op de werking van methoden op de HtmlHistory klasse.

Retouren

Het nieuwe venster of het eerder gemaakte venster met de naam van de target parameter.

Opmerkingen

De target parameter kan een venster een naam geven dat is gemaakt als gevolg van een vorige aanroep naar Open. De parameter kan ook verwijzen naar een venster dat is geopend door te klikken op een hyperlink (A element) of een FORM element dat het kenmerk gebruikt om de TARGET URL ervan in een nieuw venster te openen. Met de volgende HTML-code wordt een nieuw venster geopend met de naam orderWindow wanneer de gebruiker erop klikt:

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

Als u opties voor de windowOptions parameter opgeeft, wordt een optie die niet is opgenomen, automatisch uitgeschakeld. Met andere woorden, als u alleen opgeeft windowOptions dat u een statusbalk wilt, worden de menubalk, werkbalk, titel, schuifbalken enzovoort niet weergegeven, tenzij u deze expliciet inschakelt.windowOptions

Als het bestand waarnaar wordt verwezen door url een HTML-bestand, tekstbestand of ander bestandstype is dat binnen Internet Explorer kan worden gehost, wordt het weergegeven in het benoemde venster. Als het bestand niet kan worden weergegeven in Internet Explorer en het venster met de naam van het doel nog niet bestaat, wordt het venster alleen lang genoeg geopend voor Internet Explorer om de resource te downloaden. Het wordt onmiddellijk daarna gesloten.

Wanneer u nieuwe vensters maakt met Open of OpenNew, zorgt dit ervoor dat het HTML-documentobjectmodel een nieuw exemplaar van Internet Explorer opent. Als u Close niet aanroept voor alle vensters die u hebt gemaakt, blijft dit exemplaar van Internet Explorer actief, zelfs nadat uw toepassing is afgesloten.

Als u Open een URL in een bestaand venster laadt, windowOptions wordt deze genegeerd. Het venster behoudt de afmetingen, het uiterlijk en de locatie van het scherm eerst door de eerste aanroep naar Open.

Van toepassing op

Open(Uri, String, String, Boolean)

Bron:
HtmlWindow.cs
Bron:
HtmlWindow.cs
Bron:
HtmlWindow.cs
Bron:
HtmlWindow.cs
Bron:
HtmlWindow.cs

Geeft een bestand weer in het benoemde venster.

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

Parameters

url
Uri

De Uniform Resource Locator die de locatie beschrijft van het te laden bestand.

target
String

De naam van het venster waarin de resource moet worden geopend. Dit kan een door de ontwikkelaar opgegeven naam of een van de volgende speciale waarden zijn:

_blank: Wordt geopend url in een nieuw venster. Werkt hetzelfde als een aanroep naar OpenNew(String, String).

_media: Wordt geopend url in de mediabalk.

_parent: Wordt geopend url in het venster dat het huidige venster heeft gemaakt.

_search: Wordt geopend url in de zoekbalk.

_self: Wordt geopend url in het huidige venster.

_top: Als het wordt aangeroepen tegen een venster dat hoort bij een FRAME element, wordt geopend url in het venster dat als FRAMESEThost fungeert voor het element. Anders werkt hetzelfde als _self.

windowOptions
String

Een door komma's gescheiden tekenreeks die bestaat uit nul of meer van de volgende opties in de vorm name=value. Behalve de leftopties , topen heightwidth opties, die willekeurige gehele getallen aannemen, accepteert yes of1, en no of 0, als geldige waarden.

channelmode: Wordt gebruikt met de afgeschafte kanalentechnologie van Internet Explorer 4.0. De standaardwaarde is no.

directories: Geeft aan of in het venster de navigatieknoppen voor mappen moeten worden weergegeven. De standaardwaarde is yes.

height: De hoogte van het clientgebied van het venster, in pixels. Het minimum is 100; probeert een venster te openen dat kleiner is dan dit, waardoor het venster wordt geopend volgens de standaardinstellingen van de Internet Explorer.

left: De linkerpositie (x-coördinaat) van het venster, ten opzichte van de linkerbovenhoek van het scherm van de gebruiker, in pixels. Moet een positief geheel getal zijn.

location: Of de adresbalk moet worden weergegeven, zodat gebruikers in het venster naar een nieuwe URL kunnen navigeren. De standaardwaarde is yes.

menubar: Of menu's in het nieuwe venster moeten worden weergegeven. De standaardwaarde is yes.

resizable: Of het venster kan worden gewijzigd door de gebruiker. De standaardwaarde is yes.

scrollbars: Of het venster horizontale en verticale schuifbalken bevat. De standaardwaarde is yes.

status: Of het venster onderaan een statusbalk heeft. De standaardwaarde is yes.

titlebar: Of de titel van de huidige pagina wordt weergegeven. Als u deze optie instelt op no geen effect binnen een beheerde toepassing, wordt de titelbalk altijd weergegeven.

toolbar: Of werkbalkknoppen, zoals Vorige, Doorsturen en Stoppen , zichtbaar zijn. De standaardwaarde is yes.

top: De bovenpositie (y-coördinaat) van het venster, ten opzichte van de linkerbovenhoek van het scherm van de gebruiker, in pixels. Moet een positief geheel getal zijn.

width: De breedte van het clientgebied van het venster, in pixels. Het minimum is 100; probeert een venster te openen dat kleiner is dan dit, waardoor het venster wordt geopend volgens de standaardinstellingen van de Internet Explorer.

replaceEntry
Boolean

true om de URL url van het huidige venster te vervangen door in de navigatiegeschiedenis. Dit is van invloed op de werking van methoden op de HtmlHistory klasse.

Retouren

Een HtmlWindow weergave van het nieuwe venster of het eerder gemaakte venster met de naam van de target parameter.

Voorbeelden

Het volgende codevoorbeeld bevat twee methoden:

  • De eerste opent een URL in een venster met de naam displayWindow, die wordt gemaakt met een statusbalk die wordt weergegeven.
  • De tweede opent een andere URL in hetzelfde venster, maar geeft aan dat alleen de locatiebalk moet worden weergegeven.

U ziet dat de afmetingen van het venster en de besturingselementen die worden weergegeven, afhankelijk zijn van welke URL het eerst wordt geopend. Het codevoorbeeld vereist dat uw formulier een besturingselement met de WebBrowser naam WebBrowser1bevat.

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

Opmerkingen

De target parameter kan een venster een naam geven dat is gemaakt als gevolg van een vorige aanroep naar Open. De parameter kan ook verwijzen naar een venster dat is geopend door te klikken op een hyperlink (A element) of een FORM element dat het kenmerk gebruikt om de TARGET URL ervan in een nieuw venster te openen. Met de volgende HTML-code wordt een nieuw venster geopend met de naam orderWindow wanneer de gebruiker erop klikt:

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

Als u opties voor de windowOptions parameter opgeeft, wordt een optie die niet is opgenomen, automatisch uitgeschakeld. Met andere woorden, als u alleen opgeeft windowOptions dat u een statusbalk wilt, worden de menubalk, werkbalk, titel, schuifbalken enzovoort niet weergegeven, tenzij u deze expliciet inschakelt.windowOptions

Als het bestand waarnaar wordt verwezen door url een HTML-bestand, tekstbestand of ander bestandstype is dat binnen Internet Explorer kan worden gehost, wordt het weergegeven in het benoemde venster. Als het bestand niet kan worden weergegeven in Internet Explorer en het venster met de naam van het doel nog niet bestaat, wordt het venster alleen lang genoeg geopend voor Internet Explorer om de resource te downloaden. Het wordt onmiddellijk daarna gesloten.

Wanneer u nieuwe vensters maakt met Open of OpenNew, zorgt dit ervoor dat het HTML-documentobjectmodel een nieuw exemplaar van Internet Explorer opent. Als u Close niet aanroept voor alle vensters die u hebt gemaakt, blijft dit exemplaar van Internet Explorer actief, zelfs nadat uw toepassing is afgesloten.

Als u Open een URL in een bestaand venster laadt, windowOptions wordt deze genegeerd. Het venster behoudt de afmetingen, het uiterlijk en de locatie van het scherm eerst door de eerste aanroep naar Open.

Zie ook

Van toepassing op