The WkValueSet widget provides a means for selecting one item from a set of pictorial choices. It consists of a two-dimensional grid of graphical cells, where only one cell is selected at a time. ValueSets are very popular interface components, used for creating such GUI objects as tool bars, ribbons, paging buttons, and color choosers. Note that valuesets are useful in situations where one item is always selected from a group of choices. For applications where choosing an item will issue a command rather than make a selection, the WkImageButton classes should be used instead.

The user can select a particular item by clicking on it directly with the mouse, or using the arrow keys to move the selection. When an item is selected it notifies the single selection callback.

Each cell may contain a label, an image and/or a color. To set the contents of a cell, the method #cellAt:put: is provided. The object put into a cell can be an renderable object (e.g., an image, a String, or a Color). By default WindowBuilder Pro will use instances of WbLabelledImage which may be composed of an image, a label and specify a background color.

Two methods are provided to retrieve the valueset’s selection: #itemPosition returns the point representing the column and row of the current selection, and #item returns the actual object in the selected cell.

Default: XmSHADOWEDTHREESTATEDRAWPOLICY (Shadowed Three State)

The following example code creates a WkValueSet that has been set up as a two by two grid containing the letters “A” through “D”.

The next example code creates a WkValueSet that has been set up as a two by two grid containing colors red, green, blue and yellow