com.oxygenxml.editor.editors

Class ActionBarContributorCustomizer

java.lang.Object

com.oxygenxml.editor.editors.ActionBarContributorCustomizer

@API(type=EXTENDABLE,
     src=PUBLIC)
public abstract class ActionBarContributorCustomizer
extends java.lang.Object

Abstract class allowed as an extension point to customize the menu and toolbar buttons added by our editors. In your plugin in the plugin.xml you should reference it like:

 
  <extension point="oxygen.plugin.id.actionBarContributorCustomizer">
     <implementation class="my.package.CustomActionBarContributorCustomizer"/>;
    </extension>

Since:

14.1

Constructor Summary

Constructors

Constructor and Description
ActionBarContributorCustomizer()

Method Summary

Modifier and Type	Method and Description
abstract java.util.List<org.eclipse.jface.action.IAction>	customizeActionsContributedToDocumentMenu(java.util.List<org.eclipse.jface.action.IAction> actions) Customize the actions before they are contributed to the main Document menu (XML or XSL, or XSD, etc).
abstract java.util.List<org.eclipse.jface.action.IAction>	customizeActionsContributedToDocumentToolbar(java.util.List<org.eclipse.jface.action.IAction> actions) Customize the actions before they are contributed to the main Document toolbar.
void	customizeAuthorPageExtensionMenu(org.eclipse.jface.action.IMenuManager extensionMenu, AuthorAccess authorAccess) Customize an extension main menu contributed by the Author page document type configuration.
void	customizeAuthorPageExtensionToolbar(org.eclipse.jface.action.IToolBarManager extensionToolbar, java.lang.String toolbarID, AuthorAccess authorAccess) Customize an extension toolbar contributed by the Author page document type configuration.
abstract void	customizeAuthorPageInternalCoolbar(org.eclipse.swt.widgets.CoolBar coolbar, WSAuthorEditorPage authorEditorPage) Customize an internal coolbar for a cetain author page.
void	customizeAuthorPopUpMenu(org.eclipse.jface.action.IMenuManager popUp, AuthorAccess authorAccess) Customize a pop-up menu in the Author page before showing it.
java.util.List<org.eclipse.jface.action.IAction>	customizeDITAMapsManagerExtendedToolbar(java.util.List<org.eclipse.jface.action.IAction> toolbarActions) Customize the DITA Maps Manager extended toolbar.
java.util.List<org.eclipse.jface.action.IAction>	customizeDITAMapsManagerMainToolbar(java.util.List<org.eclipse.jface.action.IAction> toolbarActions) Customize the DITA Maps Manager main toolbar.
void	customizeTextPopUpMenu(org.eclipse.jface.action.IMenuManager popUp, WSTextEditorPage textPage) Customize a pop-up menu in the Text page before showing it.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ActionBarContributorCustomizer

public ActionBarContributorCustomizer()

Method Detail

customizeActionsContributedToDocumentMenu

public abstract java.util.List<org.eclipse.jface.action.IAction> customizeActionsContributedToDocumentMenu(java.util.List<org.eclipse.jface.action.IAction> actions)

Customize the actions before they are contributed to the main Document menu (XML or XSL, or XSD, etc).

Parameters:

actions - The list of original actions.

Returns:

The list of modified actions.

customizeActionsContributedToDocumentToolbar

public abstract java.util.List<org.eclipse.jface.action.IAction> customizeActionsContributedToDocumentToolbar(java.util.List<org.eclipse.jface.action.IAction> actions)

Customize the actions before they are contributed to the main Document toolbar. Drop down actions implement the interface "com.oxygenxml.editor.editors.IDropDownMenuAction" in order to be able to set a customized for the drop down actions list.

Parameters:

actions - The list of original actions.

Returns:

The list of modified actions.

customizeAuthorPageExtensionMenu

public void customizeAuthorPageExtensionMenu(org.eclipse.jface.action.IMenuManager extensionMenu,
                                             AuthorAccess authorAccess)

Customize an extension main menu contributed by the Author page document type configuration. For example DITA, Docbook, etc...

Parameters:

extensionMenu - The extension menu.

authorAccess - Access class to the author functions.

Since:

17

*********************************
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.

customizeAuthorPageExtensionToolbar

public void customizeAuthorPageExtensionToolbar(org.eclipse.jface.action.IToolBarManager extensionToolbar,
                                                java.lang.String toolbarID,
                                                AuthorAccess authorAccess)

Customize an extension toolbar contributed by the Author page document type configuration. The toolbar will be included in the Author internal coolbar. An extension toolbar contains actions belonging to the specific support the application offers for a certain vocabulary.

Parameters:

extensionToolbar - The extension toolbar.

toolbarID - The toolbar ID.

authorAccess - Access class to the author functions.

Since:

17

*********************************
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.

customizeAuthorPageInternalCoolbar

public abstract void customizeAuthorPageInternalCoolbar(org.eclipse.swt.widgets.CoolBar coolbar,
                                                        WSAuthorEditorPage authorEditorPage)

Customize an internal coolbar for a cetain author page. This callback may be received more than once for the same document so please make sure that you do not add the same action twice. Calling getData("OXYGEN_ID") on each widget in the coolbar should give you more information about the action it was created from.

 CoolItem[] items = coolbar.getItems();
 for (CoolItem coolItem : items) {
   Control control = coolItem.getControl();
   Object oxygenID = control.getData("OXYGEN_ID");
   System.out.println(oxygenID);
   if (control instanceof ToolBar) {
     ToolBar toolBar = (ToolBar) control;
     ToolItem[] tollbarItems = toolBar.getItems();
     for (ToolItem toolItem : tollbarItems) {
       System.out.println("   " + toolItem.getData("OXYGEN_ID"));
     }
   }
 }
 

If you want to remove an item from the coolbar you can use:

 CoolItem[] items = coolbar.getItems();
 CoolItem coolItem = items[1];
 
 coolItem.setControl(new Label(coolbar, SWT.NONE));
 
 coolItem.setMinimumSize(0, 0);
 coolItem.setSize(new Point(0, 0));
 
 coolbar.update();
 

Parameters:

coolbar - The internal coolbar after the fixed actions have been added.

authorEditorPage - The current author editor page.

customizeDITAMapsManagerExtendedToolbar

public java.util.List<org.eclipse.jface.action.IAction> customizeDITAMapsManagerExtendedToolbar(java.util.List<org.eclipse.jface.action.IAction> toolbarActions)

Customize the DITA Maps Manager extended toolbar.

Parameters:

toolbarActions - The current list of actions which will be added.

Returns:

The customized list of actions.

Since:

17

*********************************
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.

customizeDITAMapsManagerMainToolbar

public java.util.List<org.eclipse.jface.action.IAction> customizeDITAMapsManagerMainToolbar(java.util.List<org.eclipse.jface.action.IAction> toolbarActions)

Customize the DITA Maps Manager main toolbar.

Parameters:

toolbarActions - The current list of actions which will be added.

Returns:

The customized list of actions.

Since:

17

*********************************
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.

customizeAuthorPopUpMenu

public void customizeAuthorPopUpMenu(org.eclipse.jface.action.IMenuManager popUp,
                                     AuthorAccess authorAccess)

Customize a pop-up menu in the Author page before showing it. If everything is removed then the menu will not be shown.

Parameters:

popUp - The pop-up Menu.

authorAccess - Access class to the author functions.

Since:

17

*********************************
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.

customizeTextPopUpMenu

public void customizeTextPopUpMenu(org.eclipse.jface.action.IMenuManager popUp,
                                   WSTextEditorPage textPage)

Customize a pop-up menu in the Text page before showing it. If everything is removed then the menu will not be shown.

Parameters:

popUp - The pop-up Menu.

textPage - The page over which the pop-up will be presented.

Since:

17

*********************************
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.