Advanced Browse

This tutorial shows how to create a browse and control it from the AppFrame toolbar. For a tutorial on how to control a browse with a toolbar in the same window as the browse, click here.

You can find the finished application can be found at: Clarion6\3rdParty\Examples\PowerToolbar\AdvancedBrowseTutorial.app

In this example you should use the dictionary named ptbexamples.dct

Create a new application (ABC)

Choose the ptbexample.dct from Clarion6\3rdParty\Examples\PowerToolbar as "Dictionary File".

Add the global PowerToolbar template

See Adding the templates

Select the "Advanced"-tab of the global template

Make sure "Support AppFrame-Toolbar from other threads" is checked.

Click "Ok" twice to get back to the Application Tree.

Add AppFrame

Double-click the Main(Todo) procedure to bring up the "Select Procedure Type" dialog.

Select "Frame - Multiple Document Main Menu"

Create the window

Click the Window button

Select "Application Main MDI Frame" and click OK. This will bring up the window formatter.

Delete the menubar (We do not want a menu for this tutorial)

Select the menu-item "Menu -> Delete Menu"

Create the toolbar

Select the menu-item "Toolbar -> New Toolbar"

Populate PowerToolbar control

Click the "Control Template" toolbutton

Choose the template "POToolbar - Toolbar Control"

Click somewhere inside the Clarion toolbar or Window to place the PowerToolbar-control.

Right-click the PowerToolbar control, and select "Actions"

Select the "Advanced" tab

Notice "ID-Filename". All ID's for this toolbar will be exported to this file. You will need to select this file in the MDI Client template later in this tutorial.

"Object name" must be the same as global template setting.

Add a band

Select the "Bands"-tab

Click the "Insert"-button

As "Name", type "Tutorial"

Add a button to start a browse

Click the "Insert"-button

Type "New Browse" in the Name field.

Set button action

Select the "Actions"-tab

As "Action" select "Call a Procedure"

Enter "TestWindow" as procedure name

Check the "Initiate thread" checkbox

Click "Ok" two times, to get back to "Bands"

Add new band

Click the "Insert"-button

As "Name", type "Browse Control"

Add browse "Insert" button

Click the "Insert"-button

Type "Insert" in the Name field.

Notice the ID generated (ID1_Insert)

Check "Disable" to make the button disabled by default

Click "Ok" to save the new button

Add browse "Change" button

Click the "Insert"-button (below the list)

Type "Change" in the Name field.

Notice the ID generated (ID1_Change)

Check "Disable" to make the button disabled by default

Click "Ok" to save the new button

Add browse "Delete" button

Click the "Insert"-button (below the list)

Type "Delete" in the Name field.

Notice the ID generated (ID1_Delete)

Check "Disable" to make the button disabled by default

Click "Ok" to save the new button

Click "Ok" 2 times to get back to the window formatter

Save and exit the window

Compile the application

We need to compile (or at least generate) the application to generate the ID-file (AdvancedBrowseTutorial1.id)

Compile the application (just quit it right away, we got more work to do :-)

Double click the "TestWindow (Todo)"-procedure and choose "Browse - Browse Fields in a List Box" as template type

Click the "Window" button and select "MDI Child Window" as window type.

You should now be in the window formatter.

Click the "Control template" button ()

Choose the "Browse Box - File-Browsing List Box"-template

Place it somewhere in your window

Choose the "Sample Table" as table, and "SAM:SampleText" as display field.

Click "Ok" in the list box formatter

Now you should add browse update buttons

Click the "Control template" button ()

Choose the "BrowseUpdateButtons - Update records from a Browse Box"-template

Position the buttons over the browse box

Set buttons to "Hide"

On one of the button's action-tab, check the "Use Edit in-Place" option

Add the MDI-template

Click the "Extensions"-button

Click "Insert"

Select "PowerToolbarMDIClient - PowerToolbar MDI Client"

Set up the template

Click the "..." button next to the ID-file prompt.

Select the "AdvancedBrowseTutorial1.id"-file. This is the file generated by the toolbar-control i the AppFrame.

Add button mimic for browse "Insert" button

Click "Insert" to add mimic control

Choose "ID1_Insert" as "Toolbar Button ID"

Choose "?Insert" as Control.

We have now established a link between the toolbar button, and the insert browse update button.

Click "Ok"

Add button mimic for browse "Change" button

Click "Insert" (below the list box) to add mimic control

Choose "ID1_Change" as "Toolbar Button ID"

Choose "?Change" as Control.

Click "Ok"

Add button mimic for browse "Delete" button

Click "Insert" (below the list box) to add mimic control

Choose "ID1_Delete" as "Toolbar Button ID"

Choose "?Delete" as Control.

Click "Ok"

Compile and run

Click "Ok" to get back to the application tree

Compile and run the application

Try opening and closing a browse

Try several browses open and controling them from the toolbar