Configuring Toolbars

Displays the toolbar's unique identifier. This ID is referenced in PeopleCode to manipulate toolbar properties.

Enter sequence numbers to determine the order of the toolbar buttons.

Select the button to place on the toolbar. Buttons that perform custom actions cannot necessarily be shared between components because these actions can be component-specific.

Use the separator image (a vertical line) as needed to group buttons.

Select to allow users to show or hide the button from the toolbar on the Personalize Toolbar page.

You may not want to give users the ability to manipulate the visibility of some basic yet important toolbar functions, such as Save or Add. In this case, clear the check box of these buttons. These buttons become required buttons that users cannot manipulate on the Personalize Toolbar page. They always show up in the toolbar.

Specify the text that is displayed on the button (for primary toolbar buttons) or next to the button (for secondary toolbar buttons) if the toolbar is configured to show both button icon and text.

Enter the text that users can see if they put the mouse over the button.

If you enter an access key, the keyboard shortcut Alt + access key brings the system focus to the associated button.

You must terminate the access key with the enter key to execute the toolbar button function associated with the hotkey. Access key is disabled in toolbar footers.

Enter the ID of the data to appear on the toolbar. The ID and the data that it references come from an array that component PeopleCode populates.

Enter the toolbar row in which the content appears. Row 1 appears under the button bar. If you define display items for additional rows, those rows appear in order under row 1.

Enter the position of the item in the row. Enter 1 for the item that appears in the leftmost position in the row, 2 for the next label to the right, and so forth.

Enter a label for the item.

Enter the width of the display item label and data in pixels or as a percentage of the total toolbar width. If the latter, be sure that the total percentage for all fields on the same row does not exceed 100%. It is recommended that you indicate widths in percentage because the toolbar layout is adjusted automatically. The general guideline is 20% for the display item label, and 30% for the display item data. If pixel is used (for advanced HTML usage), the total width of all display columns on the same row should not equal or exceed the width of the toolbar as defined.

Enter the maximum number of characters of data (not label text) that can appear in this row. The text is truncated with the specified truncation token if it exceeds the length of text value, and is wrapped if it is too long for the width that you specify.

Enter the characters that indicate truncated data. This appears when the data is longer than the value that you entered in the Length of text field.

Select to wrap data if its length exceeds what is specified for the text length.

Select if the display item should start on the next new row.

Select to let the display item span across horizontally to use the other column to display its long item value. This option is enabled only when Start New Row field is selected.

Enter the component and market of the page in which the selected toolbar definition is referenced. The component you enter determines the drop-down values for page names.

Enter the record where the focus field resides and the focus field itself. The record you enter determines the drop-down values for field names.

Multiple fields on the same page can be defined. This is useful when you want to set the cursor on a different field when the user enters the page in a different type of transaction mode. The toolbar always puts the cursor to the first editable, available field on the page.