HtmlWindow.OpenNew Method

Definition

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.HtmlWindow
Public Function OpenNew (urlString As String, windowOptions As String) As HtmlWindow

Parameters

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.HtmlWindow
Public Function OpenNew (url As Uri, windowOptions As String) As HtmlWindow

Parameters

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.

See also

Applies to