Icon

Icons can be used to assign symbols to elements and actions. This helps in the differentiation of the displayed types at run time, or for orientation in context menus, table views, tree views, and so forth.

Modeled icons can appear, for example, in the following places at run time:

As an element icon in the Table Results or Application Explorer view.
As an action icon in the context menu of elements.

A function package provider has the possibility to support directly the icons for elements which belong to a linked element type.

Example

The Eclipse function package supports all icons which are used for Eclipse resources (projects, folders, and files), so it is not necessary to create those icons in the AWM model editor.

A function package provider is able to support additional icons which can be used in the AWM model editor. Those icons are typically used to add icons to actions.

Icons are modeled by being defined once and then referenced by a relationship to an Element Type or Action Descriptor.

You can add additional icons to be used in an AWM model. Right-click on the Icons category and select New Child > Custom Icon.

There are three available icon types:

Pre-defined icons

Generic icon type which must have a unique ID and a reference to one of the predefined icon images, which can be selected through the Predefined attribute of the icon. Predefined icons with names starting with Action are displayed in grey if a modelled action cannot be executed due to an action-enabled condition.

Attribute	Type	Description
ID *	ID *	The ID of the icon.
Predefined	Selection	This attribute is used to select an icon. The selected icon image is visible in the model editor, once the attribute value has been set.

Note: Pre-defined icons have been deprecated. They can not be modeled anymore, but they can still exist in AWM models.

Function package icons

Icon defined by a function package. See Extending the AWM Meta Model for more information.

If a function package containing icons is added to a model, desired icons can simply be created by selecting them under Icons > New Child > function package name > optional icon category > icon name .

Function package icons can have separate icon images for disabled actions, which are automatically used by AWM if the icon is associated to an action which is disabled due to an enabled condition.

Custom icons

The model administrator can add customer own icons to the model under Icons > New Child > Custom Icon.

When the new icon entry is selected in the model, you can select an image from the file system by double-clicking the Value field of the Filename attribute in the Eclipse Property view.

Supported image formats are GIF, JPEG, PNG, BMP, and JPG.

The image size must not exceed 64 by 64 pixels. Larger images are refused with an error message.

The binary data of the selected image is serialized to the model XML file when the model is saved.