ro.sync.exml.workspace.api

Interface PluginWorkspace

All Superinterfaces:

ColorThemeUtilities, GlobalOptionsStorage, ReferencesCustomizer, Workspace, WorkspaceUtilities

All Known Subinterfaces:

EclipsePluginWorkspace, StandalonePluginWorkspace, WebappPluginWorkspace

@API(type=NOT_EXTENDABLE,
     src=PUBLIC)
public interface PluginWorkspace
extends Workspace, ReferencesCustomizer, GlobalOptionsStorage

Access the entire workspace of Oxygen.

Since:

11.2

Field Summary

Fields

Modifier and Type	Field and Description
static int	DITA_MAPS_EDITING_AREA The DITA Maps editing area
static int	MAIN_EDITING_AREA The main editing area in Oxygen

Method Summary

Modifier and Type	Method and Description
void	addAuthorCSSAlternativesCustomizer(AuthorCSSAlternativesCustomizer cssAlternativesCustomizer) Add a customizer for the CSS alternatives which the user can choose in the Styles drop-down button when working in the Author visual editing mode.
void	addBatchOperationsListener(BatchOperationsListener listener) Add a batch operations listener, listener notified before and after large modification operations start in Oxygen, for example when the Replace All in Files is started.
void	addEditorChangeListener(WSEditorChangeListener editorListener, int editingArea) Add listener for editor related events(for example editor opened, closed, page changed).
java.net.URL[]	getAllEditorLocations(int editingArea) Get all the editor locations.
WSEditor	getCurrentEditorAccess(int editingArea) Get access to the current selected editor.
WSEditor	getEditorAccess(java.net.URL location, int editingArea) Find an editor access by location
WSEditorChangeListener[]	getEditorChangeListeners(int editingArea) Return a list with all registered editor changed listeners, never null.
WSOptionsStorage	getOptionsStorage() This interface can be used to save and persist in the Oxygen preferences user-defined keys and values.
UtilAccess	getUtilAccess() Get access to utility methods.
XMLUtilAccess	getXMLUtilAccess() Access to XML utilities.
void	removeAuthorCSSAlternativesCustomizer(AuthorCSSAlternativesCustomizer cssAlternativesCustomizer) Remove a customizer for the CSS alternatives which the user can choose in the Styles drop-down button when working in the Author visual editing mode.
void	removeBatchOperationsListener(BatchOperationsListener listener) Remove a batch operations listener.
void	removeEditorChangeListener(WSEditorChangeListener editorListener, int editingArea) Remove listener for editor related events.
void	setDITAKeyDefinitionManager(KeyDefinitionManager keyDefitionManager) By default key definitions are gathered from DITA Maps opened in the DITA Maps Manager.
void	showPreferencesPages(java.lang.String[] pagesToShowKeys, java.lang.String pageToSelectKey, boolean showChildrenOfPages) Show the preferences dialog, with only the desired pages displayed in the table of contents, and select a specific options page. The pages to be shown or selected in the dialog are provided using their keys.

Methods inherited from interface ro.sync.exml.workspace.api.Workspace

close, closeAll, createNewEditor, delete, getPlatform, isStandalone, open, open, open, refreshInProject, saveAll, setParentFrameTitle

Methods inherited from interface ro.sync.exml.workspace.api.WorkspaceUtilities

chooseDirectory, chooseFile, chooseFile, chooseFile, chooseFiles, chooseURL, chooseURL, chooseURLPath, chooseURLPath, clearImageCache, createJavaProcess, getDataSourceAccess, getImageUtilities, getLicenseInformationProvider, getParentFrame, getPreferencesDirectory, getTemplateManager, getUserInterfaceLanguage, getVersion, getVersionBuildID, openInExternalApplication, openInExternalApplication, showConfirmDialog, showConfirmDialog, showErrorMessage, showInformationMessage, showStatusMessage, showWarningMessage, startProcess

Methods inherited from interface ro.sync.exml.workspace.api.util.ColorThemeUtilities

getColorTheme, getImageInverter

Methods inherited from interface ro.sync.exml.workspace.api.standalone.ReferencesCustomizer

addInputURLChooserCustomizer, addRelativeReferencesResolver

Methods inherited from interface ro.sync.exml.workspace.api.options.GlobalOptionsStorage

addGlobalOptionListener, getGlobalObjectProperty, importGlobalOptions, importGlobalOptions, removeGlobalOptionListener, saveGlobalOptions, setGlobalObjectProperty

Field Detail

MAIN_EDITING_AREA

static final int MAIN_EDITING_AREA

The main editing area in Oxygen

See Also:

Constant Field Values

DITA_MAPS_EDITING_AREA

static final int DITA_MAPS_EDITING_AREA

The DITA Maps editing area

See Also:

Constant Field Values

Method Detail

getAllEditorLocations

java.net.URL[] getAllEditorLocations(int editingArea)

Get all the editor locations.

Parameters:

editingArea - One of the constants in this class:
MAIN_EDITING_AREA - for the editors in the main Oxygen workspace area.
DITA_MAPS_EDITING_AREA - for the editors in the DITA Maps Manager view workspace area.

Returns:

All the editor locations or empty array if no editor is opened

getEditorAccess

WSEditor getEditorAccess(java.net.URL location,
                         int editingArea)

Find an editor access by location

Parameters:

location - The editor location

editingArea - One of the constants in this class:
MAIN_EDITING_AREA - for the editors in the main Oxygen workspace area.
DITA_MAPS_EDITING_AREA - for the editors in the DITA Maps Manager view workspace area.

Returns:

access to the found editor or null if no editor found with that location URL.

getCurrentEditorAccess

WSEditor getCurrentEditorAccess(int editingArea)

Get access to the current selected editor.

Parameters:

editingArea - One of the constants in this class:
MAIN_EDITING_AREA - for the editors in the main Oxygen workspace area.
DITA_MAPS_EDITING_AREA - for the editors in the DITA Maps Manager view workspace area.

Returns:

access to the current editor or null if no editor is opened.

getXMLUtilAccess

XMLUtilAccess getXMLUtilAccess()

Access to XML utilities.

Returns:

Access to XML utilities.

getUtilAccess

UtilAccess getUtilAccess()

Get access to utility methods.

Returns:

access to utility methods.

addEditorChangeListener

void addEditorChangeListener(WSEditorChangeListener editorListener,
                             int editingArea)

Add listener for editor related events(for example editor opened, closed, page changed).

Parameters:

editorListener - The listener notified when an editor is added, removed or the editor page is changed.

editingArea - One of the constants in this class:
MAIN_EDITING_AREA - for the editors in the main Oxygen workspace area.
DITA_MAPS_EDITING_AREA - for the editors in the DITA Maps Manager view workspace area.

removeEditorChangeListener

void removeEditorChangeListener(WSEditorChangeListener editorListener,
                                int editingArea)

Remove listener for editor related events.

Parameters:

editingArea - One of the constants in this class:
MAIN_EDITING_AREA - for the editors in the main Oxygen workspace area.
DITA_MAPS_EDITING_AREA - for the editors in the DITA Maps Manager view workspace area.

editorListener - The listener notified when an editor is added, removed or the editor page is changed.

getEditorChangeListeners

WSEditorChangeListener[] getEditorChangeListeners(int editingArea)

Return a list with all registered editor changed listeners, never null.

Parameters:

editingArea - One of the constants in this class:
MAIN_EDITING_AREA - for the editors in the main Oxygen workspace area.
DITA_MAPS_EDITING_AREA - for the editors in the DITA Maps Manager view workspace area.

Returns:

a list with all registered editor changed listeners, never null.

Since:

16

getOptionsStorage

WSOptionsStorage getOptionsStorage()

This interface can be used to save and persist in the Oxygen preferences user-defined keys and values. It is also responsible for adding and removing listeners that are notified about the option changes. These keys are common to all plugin implementations.

Returns:

The object that manages the custom user options stored in the Oxygen preferences from the plugin implementations.

Since:

12.1

setDITAKeyDefinitionManager

void setDITAKeyDefinitionManager(KeyDefinitionManager keyDefitionManager)

By default key definitions are gathered from DITA Maps opened in the DITA Maps Manager. This API can be used by the developer to take control over the key definitions which will be used to resolve keyrefs and conkeyrefs for topics opened in the Author page.

Parameters:

keyDefitionManager - The key definition manager

Since:

14

addAuthorCSSAlternativesCustomizer

void addAuthorCSSAlternativesCustomizer(AuthorCSSAlternativesCustomizer cssAlternativesCustomizer)

Add a customizer for the CSS alternatives which the user can choose in the Styles drop-down button when working in the Author visual editing mode.

Parameters:

cssAlternativesCustomizer - The CSS alternatives customizer.

Since:

17

removeAuthorCSSAlternativesCustomizer

void removeAuthorCSSAlternativesCustomizer(AuthorCSSAlternativesCustomizer cssAlternativesCustomizer)

Remove a customizer for the CSS alternatives which the user can choose in the Styles drop-down button when working in the Author visual editing mode.

Parameters:

cssAlternativesCustomizer - The CSS alternatives customizer.

Since:

17

showPreferencesPages

void showPreferencesPages(java.lang.String[] pagesToShowKeys,
                          java.lang.String pageToSelectKey,
                          boolean showChildrenOfPages)

Show the preferences dialog, with only the desired pages displayed in the table of contents, and select a specific options page.

The pages to be shown or selected in the dialog are provided using their keys. For the stand-alone application each key corresponds to a OptionPagePluginExtension key (returned via the ro.sync.exml.plugin.option.OptionPagePluginExtension.getKey() method). For Eclipse the keys are actually the IDs of the corresponding <page> elements from plugin.xml.

Parameters:

pagesToShowKeys - The keys of the option pages to be shown in the table of contents.

pageToSelectKey - The key of the page to be selected in the table of contents.

showChildrenOfPages - True to also show the children of the option pages in the table of contents, false not to show them.

Since:

17.1

addBatchOperationsListener

void addBatchOperationsListener(BatchOperationsListener listener)

Add a batch operations listener, listener notified before and after large modification operations start in Oxygen, for example when the Replace All in Files is started. Right now the listener is only called for the standalone version of Oxygen.

Parameters:

listener - The batch operations listener.

Since:

18.1

*********************************
EXPERIMENTAL - Subject to change
********************************

Please note that this API is not marked as final and it can change in one of the next versions of the application. If you have suggestions, comments about it, please let us know.

removeBatchOperationsListener

void removeBatchOperationsListener(BatchOperationsListener listener)

Remove a batch operations listener.

Parameters:

listener - The batch operations listener.

Since:

18.1

*********************************
EXPERIMENTAL - Subject to change
********************************

Please note that this API is not marked as final and it can change in one of the next versions of the application. If you have suggestions, comments about it, please let us know.