Browsers
Identifier:
org.eclipse.ui.browser.browsers
Since:
3.0 (originally added in release 2.0 as org.eclipse.help.ui.browser)
Description:
For providing web browsers capable of displaying html documents at a given URL.
Configuration Markup:
<!ELEMENT extension (
browser)*>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED
>
<!ELEMENT browser (
location)*>
<!ATTLIST browser
id CDATA #REQUIRED
factoryclass CDATA #IMPLIED
name CDATA #REQUIRED
os CDATA #IMPLIED
executable CDATA #IMPLIED
>
An external web browser which will be displayed on the preference page General/Web Browsers providing the os attribute matches and a file is found in at least one of the specified locations.
-
id - the unique ID of the browser.
-
factoryclass - the implementation class for the browser factory. This class must implement the org.eclipse.ui.browser.BrowserFactory interface.
-
name - the name of the browser (translatable).
-
os - comma separated list of operating systems on which to search for this browser at the specified locations. Only browsers with matching OS will be used.
-
executable - the executable filename
<!ELEMENT location (#PCDATA)>
Default install locations. these locations should not contain the initial path, as it will be substituted with all known drives. (e.g. on Windows, a location of "test.exe" would look for "c:\test.exe", "d:\test.exe", etc. for all known drives.
Examples:
The following is a sample usage of the browsers extension point:
<extension point=
"org.eclipse.ui.browser.browsers"
>
<browser
id=
"org.eclipse.ui.browser.firefox"
name=Firefox
os=
"Win32"
executable=
"firefox.exe"
factoryclass=
"org.eclipse.ui.internal.browser.browsers.MozillaFactory"
>
<location>Program Files\mozilla.org\Firefox\firefox.exe</location>
<location>Program Files\Mozilla Firefox\firefox.exe</location>
</browser>
</extension>
Supplied Implementation:
The
org.eclipse.help.base and
org.eclipse.help.ui plug-ins contain implementation of browsers on common platforms.
Other plug-ins can provide different implementations. In the preferences, the user can select the default
browser from among available browsers.
Copyright (c) 2000, 2005 IBM Corporation and others.
All rights reserved. This program and the accompanying materials are made
available under the terms of the Eclipse Public License v1.0 which accompanies
this distribution, and is available at
https://www.eclipse.org/legal/epl-v10.html
