HtmlWindow.OpenNew Method

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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)

Source:

HtmlWindow.cs

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);

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

HtmlWindow

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.

OpenNew(Uri, String)

Source:

HtmlWindow.cs

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);

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

HtmlWindow

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

• open Method