Modifying a Palette

Note: You cannot modify a system palette. You can copy a system palette and modify the copy.

  1. In the visual builder, choose View > Show Palette Manager...

  2. In the Palette Manager, from the choice menu, choose the palette you want to modify.

  3. Modify the palette as follows:

Adding Classes to a Palette

Before adding a class, refer to Class Requirements and Limitations.

  1. In the Items in Palette area of the Palette Manager, expand the package containing the class you want to add by clicking on the diamond to its left.

  2. Click on the box to the far left of the class.

    This places a checkmark in the box indicating that the class is selected.

    Warning: Clicking on the box next to a package name selects all of the classes in that package. If you choose to do this, be aware that you may adversely affect the visual builder's start up performance. Also, if you include too many classes, not all of them will be visible on the palette.

    Warning: Keep all currently imported classes checked. Unchecking them means that they are removed from the palette when you click Update.

  3. Click Update.

    A dialog opens and displays the progress of importing the selected classes onto the palette. Classes that don't meet the requirements are not imported and a message states that they were omitted.

    Clicking Update also saves your changes.


Removing Classes from a Palette

  1. In the Items in Palette area of the Palette Manager, expand the package containing the class you want to remove by clicking on the diamond to its left.

  2. Click on the box to the far left of the class.

    This removes the checkmark in the box indicating that the class is deselected.

  3. Click Update to remove the clases and save the changes.


Updating Older Palettes

Older (pre 2.2) palettes are not compatible with 2.3 and later releases due to changes in the palette file format. If you attempt to use older palettes, they load without problems but you may not see all of the associated events and methods.

There is a way that can salvage your older palettes.

  1. Launch the visual builder from cosmocode
  2. Go to the palette manager
  3. Select the non-system palette that you want to update (note that the system palettes are already 2.2 compatible).
  4. Go down through the class outline until you see a class.
  5. Uncheck and check one of the classes in your palette. This causes the palette manager to think that something changed and will cause the update button to become sensitve.
  6. Click on the update button.
  7. Repeat steps 3-6

If you are not sure that a palette has been updated, look at the top of a palette file with a text browser (like 'more') and check the header section to see if it was generated from cosmocode 2.2.

See Also

Guide to the Cosmo Code Development Environment
12-96*531