HtmlWindow.Open Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
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.