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.
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.
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:
- These objects appear each time you use Builder Xcessory.
· Public Classes
- High-level objects that are stored in the following directory:
- These objects appear on every Builder Xcessory user's Palette.
For C, C++, and UIL, the Motif and platform-specific Palette objects are grouped initially as follows:
- XmToggleButton, XmPushButton, XmDrawnButton, XmArrowButton, XmLabel, XmSeparator, XmScrollBar, XmTextField, XmText, XmScrolledText, XmList, and XmScrolledList.
- XmMainWindow, XmScrolledWindow, XmPanedWindow, XmScale, XmForm, XmBulletinBoard, XmDrawingArea, XmRowColumn, XmRadioBox, and XmFrame.
- XmMenuBar, XmPulldownMenu, XmOptionMenu, and XmPopupMenu.
- 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:
- VkGenericDialog, VkFileSelectionDialog, VkPromptDialog, VkQuestionDialog, VkInfoDialog, VkWarningDialog, VkErrorDialog, VkFatalErrorDialog, VkProgressDialog, VkBusyDialog, and VkInterruptDialog.
- 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.
- 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.
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.
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:
· Click MB1 on a group's closed folder to expand the Palette to display the collections in that group.
· Click on a group's open folder to hide the collections of that group.