Managing the Component Palette

To use a class as a UI component in JBuilder's designers, it must be installed on the Component Palette. JBuilder comes with several sets of components already installed on the Component Palette. These components are grouped onto different pages. You can add components to the existing pages, or create new pages for them.

You may wish to install new components onto the Component Palette. These might be other JBCL components not already on the Palette, components you created yourself, or ones you obtained from a third party. The following details explain how to install additional components and pages to the Palette, delete unused ones, and reorganize the Palette to suit your working requirements.

Adding a component to the Palette

If your component is a JavaBean, you can place it onto the Component Palette.

For more information on creating components and JavaBeans, see the Component Writers Guide, and "Creating Beans with Beans Express" in the QuickStart.

The class files for components you want to install must be placed in one of the directories named in your classpath. If the component is part of a package, then the class files must be placed in the appropriate subdirectory of any directory in your classpath.

For example, if you have a component named ExampleComponent that is in a package called xxx.yyy (so its full name is xxx.yyy.ExampleComponent), then place the ExampleComponent.class file in an xxx/yyy subdirectory of one of the classpath directories.

To place the component onto the Component Palette,

  1. Choose Tools|Configure Palette from the menu, or right-click the Component Palette and choose Properties. This displays the Palette Properties dialog box.
  2. Select the Pages tab of the dialog box. In the Pages column, select the Palette page on which you want your component to appear, or click the Add... button to create a new page.
  3. Select the class name for the component from either the Add from Archive page or the Add from Package page.
  4. Click the Install button to add the component to the Palette.
  5. When you see the message "Installation complete, then click OK to close the Palette Properties dialog box.

Selecting an image for a Component Palette button

The image on a Component Palette button can be one of three things: To select the image for your Component Palette button,
  1. Choose Tools|Configure Palette from the menu, or right-click the Component Palette and choose Properties. This displays the Palette Properties dialog box.
  2. Select the Pages tab of the dialog box.
  3. Select the appropriate page in the Page column.
  4. Select the particular component in the Components column.
  5. Click the Properties... button to display the Item Properties dialog box.
  6. Do one of the following:
  7. Click OK to close the Item Properties dialog box.
  8. Click OK on the Palette Properties dialog box when you're finished.

Removing a page or component from the Palette

To remove a page or component from the Palette,
  1. Choose Tools|Configure Palette from the menu, or right-click the Component Palette and choose Properties. This displays the Palette Properties dialog box.
  2. Select the Pages tab of the dialog box.
  3. Select the appropriate page in the Page column or the particular component in the Components column.
  4. Click Remove, then click OK.

Reorganizing the Component Palette

To change the order of the pages or components on the Palette,
  1. Choose Tools|Configure Palette from the menu, or right-click the Component Palette and choose Properties. This displays the Palette Properties dialog box.
  2. Select the Pages tab of the dialog box.
  3. Select a page in the Page column or a component in the Components column.
  4. Click either Move Up or Move Down to move the selected item to a new location.
  5. Repeat the previous step for any additional pages or components you want to move.
  6. Click OK when you are finished.


Components delivered on the Palette

Borland's JavaBean Component Library (JBCL) includes several hundred JavaBean components, only some of which are delivered on the Component Palette. You can customize your Palette by adding additional components from the JBCL library, custom components from third parties, or your own components. See Managing the Component Palette in this section for information on adding components and pages to the Palette.

For a list of all the components in each of the JBCL packages, and a brief description of what they do, see the overview of the classes in each of the following JBCL packages in the JBCL Reference documentation: