Project members: Annotation legend
With legend annotations you can add comments and hints to your project. As such the annotations are very useful for foreigner developers to understand what the implementation does. Legend annotation members appear in Composer as text boxes with a chamfered top-right corner:
The annotations have no effect on the application itself. They exist for descriptive purpose only. Annotations can be used everywhere within your project.
Annotations and inheritance
Unlike other members, annotations are not inherited when you derive a new class from a base class containing annotations. The annotations from the base class are simply ignored.
Add new legend annotation
★First switch to the Composer page you want to add the annotation member.
★Then, in the Gallery window, ensure that the folder Chora is opened.
★Look in the folder for the template named Annotation Legend.
★With the mouse, select the template and drag it into the Composer.
★Drop the template within the Composer.
Adding a new annotation member.
Arrange the annotation box
★To move the entire annotation member click it with the mouse and move it.
★To resize the member, click with the mouse on one of its corners and move it.
★Alternatively, you can control the position of the annotation box by modifying its attribute Bounds.
Name the annotation
★Press the key F2 or select the menu item .
★Enter the new name in the Inspector window.
The name of the annotation member has no effect on the function of your application. However, it has to be unique in its particular context.
Edit the text of the annotation legend
The text displayed within the annotation box is determined by its attribute Text. When you intend to enter a longer text, it is convenient to activate the menu option and edit the text directly within the Code Editor window instead of using the small input field in Inspector. In the Code Editor you can also enter multiline text for the annotation.
Duplicate an existing annotation
You can create any number of copies of an already existing annotation member.
★Press the keys CtrlC and CtrlV in succession ...
★... or hold the key Ctrl pressed while you drag and drop the selected annotation member.
★Finally rename the just duplicated annotation member.
Delete an annotation
★Press the key DEL or select the menu item .
Attributes of an annotation legend
The following table shows the complete list of attributes provided by the legend annotation member:
Determines the position and the size of an annotation member box.
Determines the text to display in the box of an annotation member.