HtmlWindow.OpenNew Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Displays a file in a new window.
Overloads
| OpenNew(String, String) |
Displays a file in a new window. |
| OpenNew(Uri, String) |
Displays a file in a new window. |
OpenNew(String, String)
Displays a file in a new window.
public:
System::Windows::Forms::HtmlWindow ^ OpenNew(System::String ^ urlString, System::String ^ windowOptions);public System.Windows.Forms.HtmlWindow OpenNew (string urlString, string windowOptions);public System.Windows.Forms.HtmlWindow? OpenNew (string urlString, string windowOptions);member this.OpenNew : string * string -> System.Windows.Forms.HtmlWindowPublic Function OpenNew (urlString As String, windowOptions As String) As HtmlWindowParameters
- urlString
- String
The Uniform Resource Locator that describes the location of the file to load.
- windowOptions
- String
A comma-delimited string consisting of zero or more of the following options in the form name=value. See Open(String, String, String, Boolean) for a full description of the valid options.
Returns
An HtmlWindow representing the new window.
Remarks
If the file referenced by url is an HTML file, text file, or other file type that can be hosted inside of Internet Explorer, it will be displayed in a new window. If the file cannot be displayed inside of Internet Explorer, then the window will open only long enough for Internet Explorer to download the resource; it will close immediately afterwards.
When you create new windows using Open or OpenNew, it causes the HTML Document Object Model to open a new instance of Internet Explorer. If you do not call Close on all of the windows you have created, this instance of Internet Explorer will remain running even after your application has quit.
If you want to load a document into a previously opened window, see the Open method.
Applies to
OpenNew(Uri, String)
Displays a file in a new window.
public:
System::Windows::Forms::HtmlWindow ^ OpenNew(Uri ^ url, System::String ^ windowOptions);public System.Windows.Forms.HtmlWindow OpenNew (Uri url, string windowOptions);public System.Windows.Forms.HtmlWindow? OpenNew (Uri url, string windowOptions);member this.OpenNew : Uri * string -> System.Windows.Forms.HtmlWindowPublic Function OpenNew (url As Uri, windowOptions As String) As HtmlWindowParameters
- url
- Uri
The Uniform Resource Locator that describes the location of the file to load.
- windowOptions
- String
A comma-delimited string consisting of zero or more of the following options in the form name=value. See Open(String, String, String, Boolean) for a full description of the valid options.
Returns
An HtmlWindow representing the new window.
Remarks
If the file referenced by url is an HTML file, text file, or other file type that can be hosted inside of Internet Explorer, it will be displayed in a new window. If the file cannot be displayed inside of Internet Explorer, then the window will open only long enough for Internet Explorer to download the resource; it will close immediately afterwards.
When you create new windows using Open or OpenNew, it causes the HTML Document Object Model to open a new instance of Internet Explorer. If you do not call Close on all of the windows you have created, this instance of Internet Explorer will remain running even after your application has quit.
If you want to load a document into a previously opened window, see the Open method.
