The Palette is divided into several groups that consist of objects grouped by related functionality. For a detailed description of each object on the Palette, refer to Palette Objects .

Manipulating groups and icons

You can add, delete, and rearrange groups, and move Palette collections between groups. You can drag an icon from one group to another, or you can press MB3 over an icon and Edit the icon properties group, name, and pixmap.

Nesting groups

You can nest groups by creating a new group as part of another group. For example, create a "ViewKit' group and move all ViewKit-related groups into the "ViewKit" group. You can then hide all the ViewKit items by closing just the single group.

Hiding/displaying groups

To hide a group, click on the folder icon to the left of the group name. Click again on the icon to restore the view of the group.

Creating a top-level group

To create a new top-level group, select New Group from the Palette Edit menu.

Creating subordinate groups

To create a new group subordinate to an existing group, select New Group from the Palette MB3 Quick Access menu.

Groups common to all Palettes

In addition to the platform- and language-dependent groups, the Palette displays the following groups:

· Project Classes

High-level UI objects you create or for a project when you open a project save file.

· Private Classes

High-level UI objects that are stored in the following directory:

${HOME}/.builderXcessory/classes directory

These objects appear each time you use Builder Xcessory.

· Public Classes

High-level objects that are stored in the following directory:

{BX}/XCESSORY /classes directory.

These objects appear on every Builder Xcessory user's Palette.

Motif Groups

For C, C++, and UIL, the Motif and platform-specific Palette objects are grouped initially as follows:

· Primitives

XmToggleButton, XmPushButton, XmDrawnButton, XmArrowButton, XmLabel, XmSeparator, XmScrollBar, XmTextField, XmText, XmScrolledText, XmList, and XmScrolledList.

· Containers

XmMainWindow, XmScrolledWindow, XmPanedWindow, XmScale, XmForm, XmBulletinBoard, XmDrawingArea, XmRowColumn, XmRadioBox, and XmFrame.

· Menus

XmMenuBar, XmPulldownMenu, XmOptionMenu, and XmPopupMenu.

· Dialogs

XmSelectionBox, XmFileSelector, XmMessageBox, and XmCommand.

See Motif Xm Widgets for more detailed information about the Motif widgets.

ViewKit ObjectPak Groups

The ViewKit ObjectPak Classes are added to the Palette when you select ViewKit as the current language. Initially, ViewKit classes are grouped in the following folders:

· Dialogs

VkGenericDialog, VkFileSelectionDialog, VkPromptDialog, VkQuestionDialog, VkInfoDialog, VkWarningDialog, VkErrorDialog, VkFatalErrorDialog, VkProgressDialog, VkBusyDialog, and VkInterruptDialog.

· Menus

Menu Bar, Sub Menu, Option Menu, Popup Menu, Radio Sub Menu, Help Pane, Menu Action, Menu Confirm First Action, Menu Undo Manager, menu Toggle, Menu Label, and Menu Separator.

· Components

VkSimpleWindow, VkWindow, VkTabbedDeck, VkTabPanel, VkRepeatButton, VkOutline, VkCompletionField, VkGraph, VkPie, VkVuMeter, and VkTickMarks.

See ViewKit ObjectPak Vk Classes for more detailed information about the ViewKit classes.

EnhancementPak Groups

 

Note: Start with EPak Widgets must be set on the Behavior tab of the User Preferences dialog to display the EnhancementPak icons. See Behavior toggle options for more detailed information.

For all languages except Java, the following EnhancementPak widget groups are added to the Palette:

· EPak Primitives

XiColorSelector, XiCombinationBox, XiExtended18List, XiFontSelector, XiIconButton, XiPanner, XiDataField, and XiPixmapEditor.

· EPak Containers

XiTree, XiIconBox, XiOutline, XiPaned, XiPorthole, XiStretch, XiTabStack, XiToolbar, XiButtonBox, and XiColumn.

· EPak Graphs

XiBarPlot, XiCallbackPlot, XiErrorPlot, XiFadePlot, XiHighLowPlot, XiHistoPlot, XiImagePlot, XiLinePlot, XiPiePlot, XiTextPlot, and XiPlotter.

See EnhancementPak Xi Widgets for more detailed information about the EnhancementPak widgets.

Java AWT Groups

 

Note: Only Java objects are available on the Palette when you select Java as the current language.

The following Java groups are displayed on the Palette when you select Java as the current language:

· Java AWT Primitives

Objects which cannot receive children: AwtButton, AwtLabel, AwtCheckbox, AwtChoice, AwtList, AwtScrollBar, AwtTextArea, AwtTextField, AwtCanvas, and AwtFileDialog.

· Java AWT Containers

Objects which can receive children: AwtFrame, AwtPanel, AwtApplet, and AwtScrollPane.

· Java AWT Menus

Objects used to build menus (menus can be contained within the Frame object only): AwtMenuBar, AwtMenu, AwtPopuMenu, AwtMenuItem, AwtCheckboxMenuItem, and AwtMenuSeparator.

See Java Awt Objects for more detailed information about the Java objects.

Reference Count

Styles, constants, identifiers, procedures, and types are associated with reference counts on their respective editors. The number of references contained in the Palette collections is reported (Palette = N) on the editor. Palette references are included in the overall reference count.

Maintaining reference counts when deleting collections

Cutting a collection does not affect the reference count. To decrement the reference counts of styles, constants, and so forth contained in a collection, you must delete the collection from the Palette.

Adding and Moving Palette Collections

You can drop a widget, class, or Browser instance name onto a Palette group to add the widget and all of its descendants to that group as a new collection.

Using drag and drop to add and move collections

Use the following methods to add or move collections:

· Dropping onto a Palette group's name adds the new collection to a closed group.

· Dragging a collection from one Palette group and dropping it onto another group moves the collection to the end of the group. Dropping the collection on an existing collection inserts the dragged collection in the group immediately before the collection onto which it was dropped.

Moving collections to offscreen groups

If you want to move a collection to a group which is currently offscreen, use one of the following methods:

· Resize the Palette window.

· Display the Palette as Labels Only.

· Hide the collections of the other Palette groups.

· Edit the collection and enter a new group in its Group field.

· Use the Cut/Paste items from the Palette MB3 Quick Access Menu.

· Use multiple Palettes and drag/drop to display all required groups.

 

Note: You can also move a Palette collection to a blank space within the same group.

Hiding and Displaying Palette Groups

To hide and display Palette groups, use the following methods:

Displaying

· Click MB1 on a group's closed folder to expand the Palette to display the collections in that group.

Hiding

· Click on a group's open folder to hide the collections of that group.