plugins/org.eclipse.sirius.doc/doc/developer/extensions-provide_tabbar_extensions.html - sirius/org.eclipse.sirius - Git at Google

 <?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 <html xmlns="http://www.w3.org/1999/xhtml">
 	<head>
 		<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
 		<title>extensions-provide_tabbar_extensions</title>
 		<link type="text/css" rel="stylesheet" href="../resources/bootstrap.css"/>
 		<link type="text/css" rel="stylesheet" href="../resources/custom.css"/>
 	</head>
 	<body>
 		<h1 id="SiriusProvidetabbarextensions">Sirius &#8211; Provide tab-bar extensions</h1>
 		<h2 id="Goals">Goals</h2>
 		<p>The top area of all Sirius diagram editors is filled with the
 			<em>tab-bar</em>, which provides access to many operations on diagrams and their elements. The content of the tab-bar will depends on whether the current selection is the diagram itself (i.e. no element is selected) or one or several diagram elements.
 		</p>
 		<p>When the diagram itself (and not a specific element) is selected, the tab-bar contains the following buttons:
 			<br/>
 			<img border="0" src="images/tabbar01.png"/>
 		</p>
 		<p>The tab-bar contains a different set of actions when at least one element is selected:
 			<br/>
 			<img border="0" src="images/tabbar02.png"/>
 		</p>
 		<p>Sirius allows to define new operations and to add them at the end of the tab-bar.</p>
 		<h2 id="Addanewtabbaritem">Add a new tab-bar item</h2>
 		<p>Sirius asks the workbench&#8217;s
 			<code>IMenuService</code> service to populate the tab-bar with provided contributions. This service leans on the
 			<code>org.eclipse.ui.menus</code> extension point.
 		</p>
 		<p>Sirius defines the tab-bar as a toolbar with the id
 			<em>org.eclipse.sirius.diagram.ui.tabbar</em>.
 			<br/>Menu contributions to tab-bar must be declared with the
 			<em>toolbar</em> scheme and the Sirius tab-bar id.
 		</p>
 		<p>You can use the insertion point part of the
 			<em>locationUri</em> to organize your contributions. Sirius defines the
 			<em>additions</em> group, this group and all contribution will be placed at the end of the tab-bar.
 		</p>
 		<p>You can choose when to make your contribution visible (see the example) with the
 			<em>visibleWhen</em> element and some property testers: show a menu for diagram selection or only on some diagram with a specific description, ... Sirius defines several property testers like
 			<em>org.eclipse.sirius.diagram.ui.isDDiagram</em> and
 			<em>org.eclipse.sirius.diagram.ui.isDDiagramElement</em>, but you can define your own domain specific testers.
 		</p>
 		<h3 id="Provideyourtabbaritemsusingtheorg.eclipse.ui.menusextensionpoint">Provide your tab-bar items using the
 			<code>org.eclipse.ui.menus</code> extension point
 		</h3>
 		<p>Please refer to this extension point documentation for more details.</p>
 		<h3 id="Provideyouroperationusingtheorg.eclipse.ui.commandsextensionpoint">Provide your operation using the
 			<code>org.eclipse.ui.commands</code> extension point
 		</h3>
 		<p>Please refer to this extension point documentation for more details.</p>
 		<h3 id="Example">Example</h3>
 		<p>The following example defines a new push button for the tab-bar. The contribution will only be visible when an element is selected on diagram which correspond to a specific description.</p>
 		<p>You have to add your menu contribution in the plugin.xml file.</p>
 		<p>
 			<img border="0" src="images/tabbar_extension_plugin_xml.png"/>
 		</p>
 		<p>The first step is to create the menu contribution to reference an existing command:</p>
 		<pre> &lt;extension point="org.eclipse.ui.menus"&gt;
     &lt;menuContribution
           allPopups="false"
           locationURI="toolbar:org.eclipse.sirius.diagram.ui.tabbar?after=additions"&gt;
         &lt;command
               commandId="org.example.myproject.command.id"
               icon="images/action.gif"
               id="org.eclipse.sirius.diagram.tabbar.test.action.on.diagramelement"
               label="Action on DDiagramElement"
               tooltip="Action on DDiagramElement"&gt;
    &lt;!-- [...] a visible when element will be added later to control the visibility --&gt;
         &lt;/command&gt;
     &lt;/menuContribution&gt;
  &lt;/extension&gt;

 </pre>
 		<p>The
 			<em>locationURI</em> references the Sirius tabbar with
 			<code>toolbar:org.eclipse.sirius.diagram.ui.tabbar</code> and and insertion point
 			<code>?after=additions</code>.
 			<br/> The command element references an existing
 			<em>commandID</em>, and defines its own menu id (can be used as insertion/organization point in other contributions
 			<em>locationURI</em>), its label and tooltip. If a key binding exists on the referenced command, the workbench will add it to the tooltip.
 		</p>
 		<p>Then you can control the visibility of your contribution with a visible when element. </p>
 		<pre>   &lt;!-- [...] continued from the example above --&gt;
    &lt;visibleWhen checkEnabled="false"&gt;
       &lt;and&gt;
          &lt;with variable="activeEditorId"&gt;
             &lt;equals value="org.eclipse.sirius.diagram.ui.part.SiriusDiagramEditorID"/&gt;
          &lt;/with&gt;
          &lt;with variable="activeEditor"&gt;
              &lt;test property="org.eclipse.sirius.sample.tabbar.isConcernedEditor"/&gt;
          &lt;/with&gt;
          &lt;with variable="selection"&gt;
             &lt;iterate ifEmpty="false" operator="or"&gt;
                &lt;and&gt;
                   &lt;test property="org.eclipse.sirius.diagram.ui.isDDiagramElement"/&gt;
                   &lt;test property="org.eclipse.sirius.sample.tabbar.shouldActivateTabbarExtension"/&gt;
                &lt;/and&gt;
             &lt;/iterate&gt;
          &lt;/with&gt;
       &lt;/and&gt;
    &lt;/visibleWhen&gt;
 &lt;/command&gt;

 </pre>
 		<p>The sample contribution declares four conditions to enable its visibility:</p>
 		<ul>
 			<li>it checks that the active editor is a Sirius Diagram Editor using the workbench variable
 				<em>activeEditorId</em> and the Sirius Diagram Editor id.
 			</li>
 			<li>it asks a property tester if the active editor should trigger the contribution visibility (see next section for the sample property tester explanation)</li>
 			<li>it iterates over the selection with a &#8220;OR&#8221; operator between elements and a false result for empty selection:
 				<ul>
 					<li>it uses the Sirius predefined property tester to check that a selected element is a diagram element.</li>
 					<li>it asks a property tester if the current element should trigger the contribution visibility (see next section for the sample property tester explanation)</li>
 				</ul>
 			</li>
 		</ul>
 		<p>Property testers are defined in the plug-in.xml file. They define namespace, some properties and the type of elements they can test.</p>
 		<pre>&lt;extension point="org.eclipse.core.expressions.propertyTesters"&gt;
    &lt;propertyTester
          class="org.eclipse.sirius.sample.tabbar.SampleTestTabbarExtensionActivationPropertyTester"
          id="org.eclipse.sirius.sample.tabbar.ActiveExtensionTester"
          namespace="org.eclipse.sirius.sample.tabbar"
          properties="shouldActivateTabbarExtension"
          type="org.eclipse.gmf.runtime.diagram.ui.editparts.IGraphicalEditPart"&gt;
    &lt;/propertyTester&gt;
    &lt;propertyTester
          class="org.eclipse.sirius.sample.tabbar.SampleTestTabbarExtensionActivationPropertyTester"
          id="org.eclipse.sirius.sample.tabbar.ConcernEditorTester"
          namespace="org.eclipse.sirius.sample.tabbar"
          properties="isConcernedEditor"
          type="org.eclipse.ui.IEditorPart"&gt;
    &lt;/propertyTester&gt;
 &lt;/extension&gt;

 </pre>
 		<p>Here is the implementation of the corresponding property tester. The
 			<em>isConcerned</em> property will lead to check the
 			<code>DiagramDescription</code> id of the current editor. The
 			<em>shouldActivateTabbarExtension</em> will lead to check a property of the selected domain object.
 		</p>
 		<pre><code>package org.eclipse.sirius.sample.tabbar;

 import org.eclipse.core.expressions.PropertyTester;
 import org.eclipse.emf.ecore.EClass;
 import org.eclipse.emf.ecore.EObject;

 import org.eclipse.sirius.diagram.DDiagram;
 import org.eclipse.sirius.diagram.DRepresentation;
 import org.eclipse.sirius.diagram.edit.api.part.IDiagramElementEditPart;
 import org.eclipse.sirius.ui.business.api.dialect.DialectEditor;

 /**
  * Sample property tester.
  *
  * @author mporhel
  */
 public class SampleTestTabbarExtensionActivationPropertyTester extends PropertyTester {
     public boolean test(Object receiver, String property, Object[] args, Object expectedValue) {
         if ("isConcernedEditor".equals(property)) {
             // called in a with activeEditor element
             if (receiver instanceof DialectEditor) {
                 DRepresentation activeRepresentation = ((DialectEditor) receiver).getRepresentation();
                 if (activeRepresentation instanceof DDiagram) {
                     // the id property in the VSM editor : name in the meta
                     // model.
                     return "diagram.description.sample.id".equals(((DDiagram) activeRepresentation).getDescription().getName());
                 }
             }
         } else if ("shouldActivateTabbarExtension".equals(property)) {
             if (receiver instanceof IDiagramElementEditPart) {
                 EObject domainElement = ((IDiagramElementEditPart) receiver).resolveTargetSemanticElement();
                 // sample condition
                 return domainElement instanceof EClass &amp;&amp; ((EClass) domainElement).isAbstract();
             }
         }
         return false;
     }
 }


 </code></pre>
 		<p>The a new button is added to the tab-bar only when the selection contains an abstract
 			<code>EClass</code> is selected and the active editor corresponds to the expected description id:
 		</p>
 		<p>
 			<img border="0" src="images/tabbar_extension_result.png"/>
 		</p>
 		<h2 id="contributeFullTabbar">Contribute a full customized tab-bar</h2>
 		<p>Sirius lets the possibility to contribute an entire customized tab-bar. To do so, the developer has to contribute an
 			<code>org.eclipse.sirius.diagram.ui.tools.api.editor.tabbar.ITabbarContributor</code> to the
 			<code>org.eclipse.sirius.diagram.ui.tabbarContributor</code> extension-point. An abstract implementation of
 			<code>ITabbarContributor</code> exists:
 			<code>org.eclipse.sirius.diagram.ui.tools.api.editor.tabbar.AbstractTabbarContributor</code>. This implementation contains protected methods that allows creating one or several contributions of the default Sirius tab-bar. See the
 			<a href="../user/diagrams/Diagrams.html#ref_tabbar">Tab-bar</a> section in user manual for more details about each items.
 		</p>
 		<p>Here is an example of
 			<code>ITabbarContributor</code> implementation. This sample provides two different tab-bar whether the selection is done on a diagram element (a Node or a Container for instance) or on the diagram (no specific selection). If the selection is done on an Edge, the tab-bar will be empty since the sample doesn&#8217;t return any contributionItem.
 		</p>
 		<pre><code>public class TestTabbarExt extends AbstractTabbarContributor {

     private ArrayList&lt;IContributionItem&gt; diagramContributionItems;

     private ArrayList&lt;IContributionItem&gt; diagramElementContributionItems;

     @Override
     public List&lt;IContributionItem&gt; getContributionItems(ISelection selection, IDiagramWorkbenchPart part, ToolBarManager manager) {
         List&lt;IContributionItem&gt; contributionItems = new ArrayList&lt;IContributionItem&gt;();
         if (selection instanceof IStructuredSelection) {
             Object firstElement = ((IStructuredSelection) selection).getFirstElement();
             if (firstElement instanceof AbstractDDiagramEditPart) {
                 contributionItems = getDiagramContributionItem(part, manager);
             } else if (firstElement instanceof IAbstractDiagramNodeEditPart) {
                 contributionItems = getDiagramElementContributionItem(part, manager);
             }
         }
         return contributionItems;
     }

     @Override
     public boolean accept(ISelection selection) {
         boolean accept = false;
         if (selection == null) {
             accept = true;
         } else if (selection instanceof IStructuredSelection) {
             Object firstElement = ((IStructuredSelection) selection).getFirstElement();
             if (firstElement instanceof AbstractDDiagramEditPart || firstElement instanceof IAbstractDiagramNodeEditPart) {
                 accept = true;
             }
         }
         return accept;
     }

     @Override
     public List&lt;IContributionItem&gt; getContributionItems(IDiagramWorkbenchPart part, ToolBarManager manager) {
         return getDiagramContributionItem(part, manager);
     }

     private List&lt;IContributionItem&gt; getDiagramContributionItem(IDiagramWorkbenchPart part, ToolBarManager manager) {
         if (diagramContributionItems == null) {
             diagramContributionItems = new ArrayList&lt;IContributionItem&gt;();
             diagramContributionItems.add(createArrangeMenuManager(part));
             diagramContributionItems.add(createSelectMenuManager());
             diagramContributionItems.add(createLayerContribution(part, manager));
             diagramContributionItems.add(createZoomInContribution(part));
             diagramContributionItems.add(createZoomOutContribution(part));
             diagramContributionItems.add(createZoomContribution(part));
             diagramContributionItems.add(createSelectPinnedElementsContribution(part));
             diagramContributionItems.add(createSelectHiddenElementsContribution(part));
             diagramContributionItems.add(createFilterContribution(part, manager));
             diagramContributionItems.add(createPasteFormatContribution(part));
             diagramContributionItems.add(createRefreshContribution());
             diagramContributionItems.add(createSaveAsImageContributionItem());
             diagramContributionItems.add(createModeMenuManagerContributionItem(part));
             diagramContributionItems.add(createCopyAppearancePropertiesContribution(part));
             diagramContributionItems.add(createCopyFormatContribution(part));
         }
         return diagramContributionItems;
     }

     private List&lt;IContributionItem&gt; getDiagramElementContributionItem(IDiagramWorkbenchPart part, ToolBarManager manager) {
         if (diagramElementContributionItems == null) {
             diagramElementContributionItems = new ArrayList&lt;IContributionItem&gt;();
             diagramElementContributionItems.add(createArrangeMenuManager(part));
             diagramElementContributionItems.add(createAlignMenuManager());
             diagramElementContributionItems.add(createHideElementLabelContribution(part));
             diagramElementContributionItems.add(createHideElementContribution(part));
             diagramElementContributionItems.add(createDeleteFromDiagramContribution(part));
             diagramElementContributionItems.add(createDeleteFromModelContribution(part));
             IContributionItem pinElementContributionItem = createPinElementContribution(part);
             diagramElementContributionItems.add(pinElementContributionItem);
             diagramElementContributionItems.add(createUnPinElementContribution(part, pinElementContributionItem));
             diagramElementContributionItems.add(createFontColorContribution(part));
             diagramElementContributionItems.add(createPasteFormatContribution(part));
             diagramElementContributionItems.add(createBoldFontStyleContribution(part));
             diagramElementContributionItems.add(createItalicFontStyleContribution(part));
             diagramElementContributionItems.add(createFontDialogContribution(part));
             diagramElementContributionItems.add(createFillColorContribution(part));
             diagramElementContributionItems.add(createLineColorPropertyContribution(part));
             diagramElementContributionItems.add(createResetStylePropertyContribution(part));
             diagramElementContributionItems.add(createSetStyleToWorkspaceImageContribution(part));
             diagramElementContributionItems.add(createSaveAsImageContributionItem());
             diagramElementContributionItems.add(createDistributeContribution());
             diagramElementContributionItems.add(createModeMenuManagerContributionItem(part));
             diagramElementContributionItems.add(createRouterContribution());
             diagramElementContributionItems.add(createCopyAppearancePropertiesContribution(part));
             diagramElementContributionItems.add(createCopyFormatContribution(part));
             diagramElementContributionItems.add(createSizeBothContribution(part));
             diagramElementContributionItems.add(createAutoSizeContribution(part));
         }
         return diagramElementContributionItems;
     }
 }

 </code></pre>
 	</body>
 </html>
	<?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
	<html xmlns="http://www.w3.org/1999/xhtml">
	<head>
	<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
	<title>extensions-provide_tabbar_extensions</title>
	<link type="text/css" rel="stylesheet" href="../resources/bootstrap.css"/>
	<link type="text/css" rel="stylesheet" href="../resources/custom.css"/>
	</head>
	<body>
	<h1 id="SiriusProvidetabbarextensions">Sirius – Provide tab-bar extensions</h1>
	<h2 id="Goals">Goals</h2>
	<p>The top area of all Sirius diagram editors is filled with the
	<em>tab-bar</em>, which provides access to many operations on diagrams and their elements. The content of the tab-bar will depends on whether the current selection is the diagram itself (i.e. no element is selected) or one or several diagram elements.
	</p>
	<p>When the diagram itself (and not a specific element) is selected, the tab-bar contains the following buttons:
	<br/>
	<img border="0" src="images/tabbar01.png"/>
	</p>
	<p>The tab-bar contains a different set of actions when at least one element is selected:
	<br/>
	<img border="0" src="images/tabbar02.png"/>
	</p>
	<p>Sirius allows to define new operations and to add them at the end of the tab-bar.</p>
	<h2 id="Addanewtabbaritem">Add a new tab-bar item</h2>
	<p>Sirius asks the workbench’s
	<code>IMenuService</code> service to populate the tab-bar with provided contributions. This service leans on the
	<code>org.eclipse.ui.menus</code> extension point.
	</p>
	<p>Sirius defines the tab-bar as a toolbar with the id
	<em>org.eclipse.sirius.diagram.ui.tabbar</em>.
	<br/>Menu contributions to tab-bar must be declared with the
	<em>toolbar</em> scheme and the Sirius tab-bar id.
	</p>
	<p>You can use the insertion point part of the
	<em>locationUri</em> to organize your contributions. Sirius defines the
	<em>additions</em> group, this group and all contribution will be placed at the end of the tab-bar.
	</p>
	<p>You can choose when to make your contribution visible (see the example) with the
	<em>visibleWhen</em> element and some property testers: show a menu for diagram selection or only on some diagram with a specific description, ... Sirius defines several property testers like
	<em>org.eclipse.sirius.diagram.ui.isDDiagram</em> and
	<em>org.eclipse.sirius.diagram.ui.isDDiagramElement</em>, but you can define your own domain specific testers.
	</p>
	<h3 id="Provideyourtabbaritemsusingtheorg.eclipse.ui.menusextensionpoint">Provide your tab-bar items using the
	<code>org.eclipse.ui.menus</code> extension point
	</h3>
	<p>Please refer to this extension point documentation for more details.</p>
	<h3 id="Provideyouroperationusingtheorg.eclipse.ui.commandsextensionpoint">Provide your operation using the
	<code>org.eclipse.ui.commands</code> extension point
	</h3>
	<p>Please refer to this extension point documentation for more details.</p>
	<h3 id="Example">Example</h3>
	<p>The following example defines a new push button for the tab-bar. The contribution will only be visible when an element is selected on diagram which correspond to a specific description.</p>
	<p>You have to add your menu contribution in the plugin.xml file.</p>
	<p>
	<img border="0" src="images/tabbar_extension_plugin_xml.png"/>
	</p>
	<p>The first step is to create the menu contribution to reference an existing command:</p>
	<pre> <extension point="org.eclipse.ui.menus">
	<menuContribution
	allPopups="false"
	locationURI="toolbar:org.eclipse.sirius.diagram.ui.tabbar?after=additions">
	<command
	commandId="org.example.myproject.command.id"
	icon="images/action.gif"
	id="org.eclipse.sirius.diagram.tabbar.test.action.on.diagramelement"
	label="Action on DDiagramElement"
	tooltip="Action on DDiagramElement">
	<!-- [...] a visible when element will be added later to control the visibility -->
	</command>
	</menuContribution>
	</extension>

	</pre>
	<p>The
	<em>locationURI</em> references the Sirius tabbar with
	<code>toolbar:org.eclipse.sirius.diagram.ui.tabbar</code> and and insertion point
	<code>?after=additions</code>.
	<br/> The command element references an existing
	<em>commandID</em>, and defines its own menu id (can be used as insertion/organization point in other contributions
	<em>locationURI</em>), its label and tooltip. If a key binding exists on the referenced command, the workbench will add it to the tooltip.
	</p>
	<p>Then you can control the visibility of your contribution with a visible when element. </p>
	<pre> <!-- [...] continued from the example above -->
	<visibleWhen checkEnabled="false">
	<and>
	<with variable="activeEditorId">
	<equals value="org.eclipse.sirius.diagram.ui.part.SiriusDiagramEditorID"/>
	</with>
	<with variable="activeEditor">
	<test property="org.eclipse.sirius.sample.tabbar.isConcernedEditor"/>
	</with>
	<with variable="selection">
	<iterate ifEmpty="false" operator="or">
	<and>
	<test property="org.eclipse.sirius.diagram.ui.isDDiagramElement"/>
	<test property="org.eclipse.sirius.sample.tabbar.shouldActivateTabbarExtension"/>
	</and>
	</iterate>
	</with>
	</and>
	</visibleWhen>
	</command>

	</pre>
	<p>The sample contribution declares four conditions to enable its visibility:</p>
	<ul>
	<li>it checks that the active editor is a Sirius Diagram Editor using the workbench variable
	<em>activeEditorId</em> and the Sirius Diagram Editor id.
	</li>
	<li>it asks a property tester if the active editor should trigger the contribution visibility (see next section for the sample property tester explanation)</li>
	<li>it iterates over the selection with a “OR” operator between elements and a false result for empty selection:
	<ul>
	<li>it uses the Sirius predefined property tester to check that a selected element is a diagram element.</li>
	<li>it asks a property tester if the current element should trigger the contribution visibility (see next section for the sample property tester explanation)</li>
	</ul>
	</li>
	</ul>
	<p>Property testers are defined in the plug-in.xml file. They define namespace, some properties and the type of elements they can test.</p>
	<pre><extension point="org.eclipse.core.expressions.propertyTesters">
	<propertyTester
	class="org.eclipse.sirius.sample.tabbar.SampleTestTabbarExtensionActivationPropertyTester"
	id="org.eclipse.sirius.sample.tabbar.ActiveExtensionTester"
	namespace="org.eclipse.sirius.sample.tabbar"
	properties="shouldActivateTabbarExtension"
	type="org.eclipse.gmf.runtime.diagram.ui.editparts.IGraphicalEditPart">
	</propertyTester>
	<propertyTester
	class="org.eclipse.sirius.sample.tabbar.SampleTestTabbarExtensionActivationPropertyTester"
	id="org.eclipse.sirius.sample.tabbar.ConcernEditorTester"
	namespace="org.eclipse.sirius.sample.tabbar"
	properties="isConcernedEditor"
	type="org.eclipse.ui.IEditorPart">
	</propertyTester>
	</extension>

	</pre>
	<p>Here is the implementation of the corresponding property tester. The
	<em>isConcerned</em> property will lead to check the
	<code>DiagramDescription</code> id of the current editor. The
	<em>shouldActivateTabbarExtension</em> will lead to check a property of the selected domain object.
	</p>
	<pre><code>package org.eclipse.sirius.sample.tabbar;

	import org.eclipse.core.expressions.PropertyTester;
	import org.eclipse.emf.ecore.EClass;
	import org.eclipse.emf.ecore.EObject;

	import org.eclipse.sirius.diagram.DDiagram;
	import org.eclipse.sirius.diagram.DRepresentation;
	import org.eclipse.sirius.diagram.edit.api.part.IDiagramElementEditPart;
	import org.eclipse.sirius.ui.business.api.dialect.DialectEditor;

	/**
	* Sample property tester.
	*
	* @author mporhel
	*/
	public class SampleTestTabbarExtensionActivationPropertyTester extends PropertyTester {
	public boolean test(Object receiver, String property, Object[] args, Object expectedValue) {
	if ("isConcernedEditor".equals(property)) {
	// called in a with activeEditor element
	if (receiver instanceof DialectEditor) {
	DRepresentation activeRepresentation = ((DialectEditor) receiver).getRepresentation();
	if (activeRepresentation instanceof DDiagram) {
	// the id property in the VSM editor : name in the meta
	// model.
	return "diagram.description.sample.id".equals(((DDiagram) activeRepresentation).getDescription().getName());
	}
	}
	} else if ("shouldActivateTabbarExtension".equals(property)) {
	if (receiver instanceof IDiagramElementEditPart) {
	EObject domainElement = ((IDiagramElementEditPart) receiver).resolveTargetSemanticElement();
	// sample condition
	return domainElement instanceof EClass && ((EClass) domainElement).isAbstract();
	}
	}
	return false;
	}
	}


	</code></pre>
	<p>The a new button is added to the tab-bar only when the selection contains an abstract
	<code>EClass</code> is selected and the active editor corresponds to the expected description id:
	</p>
	<p>
	<img border="0" src="images/tabbar_extension_result.png"/>
	</p>
	<h2 id="contributeFullTabbar">Contribute a full customized tab-bar</h2>
	<p>Sirius lets the possibility to contribute an entire customized tab-bar. To do so, the developer has to contribute an
	<code>org.eclipse.sirius.diagram.ui.tools.api.editor.tabbar.ITabbarContributor</code> to the
	<code>org.eclipse.sirius.diagram.ui.tabbarContributor</code> extension-point. An abstract implementation of
	<code>ITabbarContributor</code> exists:
	<code>org.eclipse.sirius.diagram.ui.tools.api.editor.tabbar.AbstractTabbarContributor</code>. This implementation contains protected methods that allows creating one or several contributions of the default Sirius tab-bar. See the
	<a href="../user/diagrams/Diagrams.html#ref_tabbar">Tab-bar</a> section in user manual for more details about each items.
	</p>
	<p>Here is an example of
	<code>ITabbarContributor</code> implementation. This sample provides two different tab-bar whether the selection is done on a diagram element (a Node or a Container for instance) or on the diagram (no specific selection). If the selection is done on an Edge, the tab-bar will be empty since the sample doesn’t return any contributionItem.
	</p>
	<pre><code>public class TestTabbarExt extends AbstractTabbarContributor {

	private ArrayList<IContributionItem> diagramContributionItems;

	private ArrayList<IContributionItem> diagramElementContributionItems;

	@Override
	public List<IContributionItem> getContributionItems(ISelection selection, IDiagramWorkbenchPart part, ToolBarManager manager) {
	List<IContributionItem> contributionItems = new ArrayList<IContributionItem>();
	if (selection instanceof IStructuredSelection) {
	Object firstElement = ((IStructuredSelection) selection).getFirstElement();
	if (firstElement instanceof AbstractDDiagramEditPart) {
	contributionItems = getDiagramContributionItem(part, manager);
	} else if (firstElement instanceof IAbstractDiagramNodeEditPart) {
	contributionItems = getDiagramElementContributionItem(part, manager);
	}
	}
	return contributionItems;
	}

	@Override
	public boolean accept(ISelection selection) {
	boolean accept = false;
	if (selection == null) {
	accept = true;
	} else if (selection instanceof IStructuredSelection) {
	Object firstElement = ((IStructuredSelection) selection).getFirstElement();
	if (firstElement instanceof AbstractDDiagramEditPart \|\| firstElement instanceof IAbstractDiagramNodeEditPart) {
	accept = true;
	}
	}
	return accept;
	}

	@Override
	public List<IContributionItem> getContributionItems(IDiagramWorkbenchPart part, ToolBarManager manager) {
	return getDiagramContributionItem(part, manager);
	}

	private List<IContributionItem> getDiagramContributionItem(IDiagramWorkbenchPart part, ToolBarManager manager) {
	if (diagramContributionItems == null) {
	diagramContributionItems = new ArrayList<IContributionItem>();
	diagramContributionItems.add(createArrangeMenuManager(part));
	diagramContributionItems.add(createSelectMenuManager());
	diagramContributionItems.add(createLayerContribution(part, manager));
	diagramContributionItems.add(createZoomInContribution(part));
	diagramContributionItems.add(createZoomOutContribution(part));
	diagramContributionItems.add(createZoomContribution(part));
	diagramContributionItems.add(createSelectPinnedElementsContribution(part));
	diagramContributionItems.add(createSelectHiddenElementsContribution(part));
	diagramContributionItems.add(createFilterContribution(part, manager));
	diagramContributionItems.add(createPasteFormatContribution(part));
	diagramContributionItems.add(createRefreshContribution());
	diagramContributionItems.add(createSaveAsImageContributionItem());
	diagramContributionItems.add(createModeMenuManagerContributionItem(part));
	diagramContributionItems.add(createCopyAppearancePropertiesContribution(part));
	diagramContributionItems.add(createCopyFormatContribution(part));
	}
	return diagramContributionItems;
	}

	private List<IContributionItem> getDiagramElementContributionItem(IDiagramWorkbenchPart part, ToolBarManager manager) {
	if (diagramElementContributionItems == null) {
	diagramElementContributionItems = new ArrayList<IContributionItem>();
	diagramElementContributionItems.add(createArrangeMenuManager(part));
	diagramElementContributionItems.add(createAlignMenuManager());
	diagramElementContributionItems.add(createHideElementLabelContribution(part));
	diagramElementContributionItems.add(createHideElementContribution(part));
	diagramElementContributionItems.add(createDeleteFromDiagramContribution(part));
	diagramElementContributionItems.add(createDeleteFromModelContribution(part));
	IContributionItem pinElementContributionItem = createPinElementContribution(part);
	diagramElementContributionItems.add(pinElementContributionItem);
	diagramElementContributionItems.add(createUnPinElementContribution(part, pinElementContributionItem));
	diagramElementContributionItems.add(createFontColorContribution(part));
	diagramElementContributionItems.add(createPasteFormatContribution(part));
	diagramElementContributionItems.add(createBoldFontStyleContribution(part));
	diagramElementContributionItems.add(createItalicFontStyleContribution(part));
	diagramElementContributionItems.add(createFontDialogContribution(part));
	diagramElementContributionItems.add(createFillColorContribution(part));
	diagramElementContributionItems.add(createLineColorPropertyContribution(part));
	diagramElementContributionItems.add(createResetStylePropertyContribution(part));
	diagramElementContributionItems.add(createSetStyleToWorkspaceImageContribution(part));
	diagramElementContributionItems.add(createSaveAsImageContributionItem());
	diagramElementContributionItems.add(createDistributeContribution());
	diagramElementContributionItems.add(createModeMenuManagerContributionItem(part));
	diagramElementContributionItems.add(createRouterContribution());
	diagramElementContributionItems.add(createCopyAppearancePropertiesContribution(part));
	diagramElementContributionItems.add(createCopyFormatContribution(part));
	diagramElementContributionItems.add(createSizeBothContribution(part));
	diagramElementContributionItems.add(createAutoSizeContribution(part));
	}
	return diagramElementContributionItems;
	}
	}

	</code></pre>
	</body>
	</html>