Amethyst Help

Back to -Products -Amethyst IDE -Amethyst Help

Amethyst Component Manager

The Amethyst Component Manager is a tool which allows you to configure the Toolbox used with the Amethyst Designer.

The Toolbox shows categorized groups of components which may be dragged and dropped onto the Amethyst Designer workspace. Using the Amethyst Component Manager you may add new components to the Toolbox or change certain configuration details of the components which are already installed.

The Amethyst Component Manager is an advanced tool which should only be used if you are certain you need to make changes to the Amethyst Toolbox defaults. It is intended primarily for the use of the Amethyst developers and for customers who may need to resolve specific issues, in which case they will be given appropriate instructions on its use. The documentation on this page does not provide instructions to all aspects of the Component Manager.

The Component Manager allows you to select a Tab (a ‘group’) for a component and the Name of the Component itself. When a Tab is selected, the components in that tab will be listed in the Name drop-down list.

The Component Properties list shows information relating to the selected control - for example it’s ‘Caption’ (its name on the Toolbox), its height and width (the default sizes that will be applied when the component is dragged into the Designer), whether or not ‘design-time’ borders are shown around the component in the Designer and its default background colour.

- New lets you create a new Component entry.
- Delete removes the current Component entry
- Set Default resets the entire Toolbox to the defaults
- Export allows you to export a manifest of installed Components
- Import allows you to import a manifest of Components
- Save saves changes
- OK confirms and exits the Wizard
- Cancel cancels changes and exist the Wizard

Add New Component

When you click New, the ’Add new component dialog appears. This lets you add a known component (that is, one that exists in an SWC library that has been added to the References section of the Solution Explorer) to the Toolbox. This then allows you to drag and drop the component into the Designer. You must, of course, ensure that the component is a valid user interface control, capable of being used in a design using the selected version of the Flex SDK.

- Component Name - the class name of the component (e.g. Canvas)
- Prefix - the prefix to use in the MXML tag (e.g. mx:)
- Namespace: the fully qualified package (e.g. mx.containers).

Example of use:

By default, a Canvas has no background colour. In order to make a Canvas visible in the Designer, Amethyst normally draws borders around it. But let’s suppose that you would prefer to have no borders but to apply, instead, a default grey background colour to your canvases. This is how you would do this:

- Select Tab: Amethyst layout
- Select Name: Canvas
- In the General Properties group set DrawBorders to false
- In the Advanced Properties group, set BackgroundColor to #CCCCCC
- Click Save, then OK.

After a few moments your Toolbox will be rebuilt. Now when you drop a Canvas into a design, it will have no borders but it will have a grey background colour.

Bookmark and Share   Keywords:  Amethyst  help
© SapphireSteel Software 2014