Creates the new web browser instance. If the user has chosen to use the internal Web browser, the given style bits (see class header for values) will be used to open the browser.
The method will reuse an existing browser instance if the same browserId
value is passed to it. A persisted browser instance restored upon startup can be accessed this way. If null
is passed as a browserId, a unique id will be generated each time method is called.
If the user has chosen not to use the internal browser or it is not available on the current platform, an external browser will be used and all style parameters will be ignored.
@param style the style display constants. Style constants should be bitwise-ORed together.
@param browserId if an instance of a browser with the same id is already opened, it will be returned instead of creating a new one. Passing
null
will create a new instance with a generated id every time.
@param name a name used for the presentation of the internal browser
@param tooltip a tooltip used for the presentation of the internal browser
@return the browser instance that can be used to open the URL. Clientsintending to reuse the instance for all the URLs should cache the instance and call IWebBrowser#openURL() on it. Clients are responsible for closing the browser instance when not needed.
@exception PartInitException if the operation failed for some reason