User's Guide

The uses of the MDE Rich Text Widget is easy and straightforward. The user interface is splitted into two sections. The toolbar and the text area.

Toolbar

The toolbar contains tools which helps for formatting the typed text in the text area. For instances it contains bold tool to turn into bold style the selected text or newly typed characters after activating the tool.

Here, an example of toolbar which contains most used tools

Toolbar

Commonly used Tools (also, called items):

Open in editorOpen in Editor Allows to open an Eclipse editor which contains a MDE Rich Text Widget binded to the current model element
StyleStylesAllows to apply a style on the selected or typed characters
Paragraph formatParagraph FormatAllows to apply a style on the paragraph
Font nameFont NameAllows to apply a font on the selected or typed characters
Font sizeFont SizeAllows to apply a size on the selected or typed characters
ClipboardClipboardAllows to cut, copy selected characters, and past new characters in text area
ToolbarClean contentAllows to remove all content in text area
Basic stylesBaisc StylesAllows to apply a basic style (bold, italic...) on selected or typed characters
ColorsColorsAllows to apply text and background color on selected or typed characters
ParagraphParagraphAllows to add list (numbered or bulleted) and increase or decrease indentation of selected or typed characters. See List Properties section for the customization of list properties
LinksLinksAllows to add links and pictures. See the Link management section for more information

Text area

The text area is used to add text content, links and images. It looks like following picture

Text area

List properties

Numbered List Properties

A default behavior at adding numbered list (Numbered list tool enable) is enumerating items by decimal as shown below in text area:

Numbered List

To access to the properties of the list, right-click on an item of the list and then, choose Numbered List Properties as shown after:

Numbered List Properties Menu

This window will appear.

Numbered List Properties

The available customizations are:

  1. The start index of the list. By default is 1
  2. The type of enumeration. It could be:
    1. Decimal (1, 2, ...)
    2. Lower or upper Roman number(I, II, ...)
    3. Lower or upper alphabetical order (A, B, ...)

For instance, With Upper roman enumeration and start index to 100:

Roman enumeration List starts with index 100

Bulleted List Properties

A default behavior at adding bulleted list (Bulleted list tool enable) is enumerating items by disc as shown below in text area:

Bulleted List

To access to the properties of the list, right-click on an item of the list and then, choose Bulleted List Properties as shown after:

Bulleted List Properties Menu

This window will appear.

Bulleted List Properties

The available customizations are:

  1. Circle, which corresponds to non filled disc
  2. Disc, which corresponds to filled circle
  3. Square, which corresponds to filled square

For instance, With square type:

Square bulleted List

NB: No Set has the same effect as Decimal or Disc type

MDE Rich text provides a tool () for adding links into the contents and in the same way the navigation to the target of the links with the appropriate tool.

The link types allowed are:

URLfor instance: http://www.polarsys.org/kitalpha/
File (Absolute Path)Link to the files on the local disk of the computer. For instance: /home/me/folders/program.c
File (Project Relative Path)Link to the file in the workspace. For instance: /project.name/model.componentsample
Model ElementLink to any model element of the resource set of the element being editing.
Diagram ElementLink to Sirius Diagrams.

Clicking on a Add link item will open this wizard

The first field Add link specifies the type of the link to add (See before)

The second field URL specifies the concrete location (for instance, with URL type, www.polarsys.org). This field shows a Browse button. This button allows to select the link's target of the File (Absolute or Project Relative Path, Model or Diagram element types. For the Model or Diagram Element URL type, this field is in read only mode. The user, must use the Browse button to select the target of the links

The third field URL Display allows to the user to give a humain readable content of the link. This will be appears in the text area of the widget. For instance, the URL: www.polarsys.org, the displayed text will be Polarsys.

Navigation refers to the opening of the target of the links with the appropriate tool.

For example, navigation on the URL type link opens the target with the default browser

To navigate to the target of a link, righ-click on the link and choose the menu Open Link