Palettes

Go to start of metadata

Several options in USPS-R make use of selection boxes called "palettes". Palettes allow the user to use arrow keys to select from available options. For example, in the user option, you can select roles for the user using a palette. In the role option, you use the palette to select from a list of available permissions to grant to the role.

As shown in the example below, the left side of the palette will contain the available options. The right side of the palette will contain the options selected.

All palettes will have at least a left and right arrow. Select the options on the left list of available options and click on the right arrow to move them to the right side of the palette. When the items are moved to the "Selected" side, they will also be removed from the "Available" side of the palette. The user may also simply double-click the property to move it to the right.

To de-select items, highlight them on the right side and click the left arrow to move them back to the left, or "Available", side of the palette. Double-clicking a selected option will also move it back to the left.

Some palettes may also have an up and down arrow. These arrows can be used by highlighting an option on the "Selected" side of the palette. Then click the up or down arrow to cause the item to be moved up or down in the list of selected items. The up and down arrows will only be available when order of the selected fields matters.

Selecting multiple items

You can select multiple items in one of two ways:

To select multiple items that are together in the list, click the first item. Then hold the shift key down and click on the last item. This will highlight all of the items between the two items clicked. The user may now use the palette arrows to move all of these items together.
To select multiple items that are not together in the list, click the first item. Then hold the Ctrl key down and click on as many additional items as desired. This will cause all of the items clicked on to be highlighted and moved together when the palette arrow is clicked.