Customizing toolbars

You can customize toolbars with PowerBuilder buttons and with buttons that invoke other applications, such as a clock or text processor.

Adding, moving, and deleting buttons

You can add, move, and delete buttons in any toolbar.

StepsTo add a button to a toolbar:

  1. Position the pointer on the toolbar and display the pop-up menu.

  2. Select Customize.

    The Customize dialog box displays. The icons that display in the selected palette and current toolbar panes depend on the palette and toolbar you select.

    The sample shows the Customize dialog box. At top is the a Select palette group box with three radio buttons for Painter Bar, Power Bar, and Custom. Painter Bar is selected. Below this is a box labeled Selected palette that displays all buttons available in the Painter Bar palette. At bottom is an area that displays the buttons in the Current toolbar. At bottom is a Description field with the entry Space evenly horizontally.
  3. Click the palette of buttons you want to use in the Select Palette group box.

  4. Choose a button from the Selected Palette box and drag it to the position you want in the Current Toolbar box.

    The function of the button you selected displays in the Description at the bottom of the dialog box. If you choose a button from the Custom palette, another dialog box displays so you can define the button.

    For more information, see “Adding a custom button”.

StepsTo move a button on a toolbar:

  1. Position the pointer on the toolbar, display the pop-up menu, and select Customize.

  2. In the Current toolbar box, select the button and drag it to its new position.

StepsTo delete a button from a toolbar:

  1. Position the pointer on the toolbar, display the pop-up menu, and select Customize.

  2. In the Current toolbar box, select the button and drag it outside the Current toolbar box.

Resetting a toolbar

You can restore the original setup of buttons on a toolbar at any time.

StepsTo reset a toolbar:

  1. Position the pointer on the toolbar, display the pop-up menu, and select Customize.

  2. Click the Reset button, then Yes to confirm, then OK.

Clearing or deleting a toolbar

Whenever you want, you can remove all buttons from a toolbar. If you do not add new buttons to the empty toolbar, the toolbar is deleted. You can delete both built-in toolbars and toolbars you have created.

NoteTo recreate a toolbar If you delete one of PowerBuilder’s built-in toolbars, you can recreate it easily. For example, to recreate the PowerBar, display the pop-up menu, select New, and then select PowerBar1 in the New Toolbar dialog box.

For information about creating new toolbars and about the meaning of PowerBar1, see “Creating new toolbars”.

Steps To clear or delete a toolbar:

  1. Position the pointer on the toolbar, display the pop-up menu, and select Customize.

  2. Click the Clear button, then Yes to confirm.

    The Current toolbar box in the Customize dialog box is emptied.

  3. If you want to add new buttons, select them.

  4. Click OK to save the toolbar if you added new buttons, or delete the toolbar if you did not.

Adding a custom button

You can add a custom button to a toolbar. A custom button can:

StepsTo add a custom button:

  1. Position the pointer on the toolbar, display the pop-up menu, and select Customize.

  2. Select Custom in the Select Palette group box.

    The custom buttons display in the Selected Palette box.

  3. Select a custom button and drag it to where you want it in the Current Toolbar box.

    The Toolbar Item Command dialog box displays. Different buttons display in the dialog box depending on which toolbar you are customizing:

    The sample shows the Toolbar Item Command dialog box. At top are text boxes for Command Line, Item Text, and Item Microhelp and a check box labeled Run Minimized. At bottom is a Special Command group box with buttons for Query, Report, Format, and Function.
  4. Fill in the Command Line box using Table 2-2.

  5. In the Item Text box, specify the text associated with the button in two parts separated by a comma: the text that displays on the button and text for the button's PowerTip:

    ButtonText, PowerTip
    

    For example:

    Save, Save File
    

    If you specify only one piece of text, it is used for both the button text and the PowerTip.

  6. In the Item MicroHelp box, specify the text to appear as MicroHelp when the pointer is on the button.

Table 2-2: Defining custom buttons

Button action

Toolbar Item Command dialog box entry

Invoke a PowerBuilder menu item

Type

@MenuBarItem.MenuItem

in the Command Line box. For example, to make the button mimic the Open item on the File menu, type

@File.Open

You can also use a number to refer to a menu item. The first item in a drop-down or cascading menu is 1, the second item is 2, and so on. Separator lines in the menu count as items. This example creates a button that pastes a FOR...NEXT statement into a script:

@Edit.Paste Special.Statement.6

Run an executable file outside PowerBuilder

Type the name of the executable file in the Command Line box. Specify the full path name if the executable is not in the current search path.

To search for the file name, click the Browse button.

Run a query

Click the Query button and select the query from the displayed list.

Preview a DataWindow object

Click the Report button and select a DataWindow object from the displayed list. You can then modify the command-line arguments in the Command Line box.

Select a user object for placement in a window or custom user object

(Window and User Object painters only) Click the UserObject button and select the user object from the displayed list.

Assign a display format to a column in a DataWindow object

(DataWindow painter only) Click the Format button to display the Display Formats dialog box. Select a data type, then choose an existing display format from the list or define your own in the Format box.

For more about specifying display formats, see Chapter 22, “Displaying and Validating Data.”

Create a computed field in a DataWindow object

(DataWindow painter only) Click the Function button to display the Function for Toolbar dialog box. Select the function from the list.