Connection Information

To perform the requested action, WordPress needs to access your web server. Please enter your FTP credentials to proceed. If you do not remember your credentials, you should contact your web host.

Connection Type

Customizing toolbars – PB Docs 126 – PowerBuilder Library

Customizing toolbars – PB Docs 126

  2. Powerbuilder Documentation
  3. Powerbuilder Documentation Older
  4. Powerbuilder Documentation 12.6
  5. Customizing toolbars – PB Docs 126

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.

proc.png To 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.

    wrkg19.gif

  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”.

proc.png To 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.

proc.png To 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.

proc.png To 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.

note.png To 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”.

proc.png 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:

  • Invoke a PowerBuilder
    menu item

  • Run an executable (application) outside PowerBuilder

  • Run a query or preview a DataWindow object

  • Place a user object in a window or in a custom user
    object

  • Assign a display format or create a computed field
    in a DataWindow object

proc.png To 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:

    wrkg20.gif

  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:

    For example:

    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:

If a menu label contains a dot (“.”), you
must include the tilde (“~”) as an escape character
to indicate the dot is part of the label and does not invoke a submenu
item. For example:

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:

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.
Document get from Powerbuilder help
Thank you for watching.
Powerbuilder Documentation 12.6
and Functions Events Objects and Controls PB Docs 126 PowerBuilder .NET Powerbuilder Documentation Powerbuilder Documentation 12.6 Powerbuilder Documentation Older PowerBuilder Extension Reference PowerBuilder New Features 12.6 PowerDesigner Integration System Object Properties Using the ADO.NET Interface
August 13, 2023
Was this article helpful?
9
6
Subscribe
Notify of
guest
0 Comments
Oldest
Newest Most Voted
Inline Feedbacks
View all comments
0
Would love your thoughts, please comment.x
()
x