Difference between revisions of "Eclipse4/RCP/Modeled UI/Tags"

Revision as of 09:48, 11 May 2022

Most model elements support additional annotations called "tags". These tags are free-form strings; the model renderer may interpret certain tags to configure how an element is to be rendered. Several of these tags are defined on IPresentationEngine.

{|{{BMTableStyle}}
|-{{BMTHStyle}}
! Tag
! Description
! Applies to
|-
| persistState=(false|true)
|-
| another.example.bundle
| This is another example
|}

MPart

A part can be annotated with a "NoMove" tag to indicate that the drag-and-drop system should not allow the user to move this part. (Defined by IPresentationEngine.NO_MOVE)

MPartStack

Parts within a part stack can be annotated with a "NoClose" tag to indicate that the part should not be closeable. The SWT renderer will configure the corresponding CTabFolder to not display an "X" to close the part. (Defined by IPresentationEngine.NO_CLOSE)

Parts within a part stack can be annotated with a "NoTitle" tag to indicate that the part should not have a rendered title. (Defined by IPresentationEngine.NO_TITLE)

MTrimBar

A TrimBar will replace ToolControls with a "stretch" tag with stretchable space. A ToolControl with "glue" will ensure its siblings are kept together on the same line. The following example will cause the "find" control to be placed flush right:

<menu:TrimBars>
  <menu:ToolControl contributionURI="platform:/plugin/blah/blah">
    <tags>stretch</tags>
  </menu:ToolControl>
  <menu:ToolControl elementId="com.example.find"
      contributionURI="platform:/plugin/com.example.find/com.example.FindTextField"/>
</menu:TrimBars>

(defined by TrimBarLayout)