Configuring a Toolbar Button

The following procedure is an example of how to create a configurable button:

1. Click the PresentationConfiguration ItemType in the grid, click the TOC Access tab, and add Administrators.

Figure 34.

2. Open the TOC and click Presentation Configuration.

Figure 35.

3. Click Create New Presentation Configuration. The Presentation Configuration form appears.
4. Enter tgv_part in the Name field and select a color such as orange.

Figure 36.

5. Click the New Command Bar in the Command Bar Section relationship tab to add a new related Item.
6. Enter tgv* in the Name cell of the Search grid and add the tgv_part_toolbar and tgv_part_ContextMenu Items:

Figure 37.

7. Make sure to add the Items to the relationship grid.

Figure 38.

8. Add an identity to the For Identity column. The specified Identity determines which users have access to the buttons and menus.
9. Click the button to save the tgv_part Presentation Configuration Item.
10. Right-click tgv_part_toolbar and select Open from the context menu:

Figure 39.

The tgv_part_toolbar presentation configuration item appears. It contains the tgv_view button.

Figure 40.

11. Click the New Command Bar Item button in the Command Bar Item tab. The Select Item Type dialog appears:

Figure 41.

12. Select Button and click OK to add it to the command bar.
13. Right-click the Item to access the context menu and click Open. The tgv_view Presentation Item appears.

Figure 42.

Additional logic can be added to the context menu or toolbar items when they are initialized by adding an Init Method. Users can review the rb_viewItemHandler Method code and develop similar code for their own uses.

You can select an image for the toolbar button you created using the following procedure:

1. Click the Image button and click the Select an image link. The Image Browser dialog appears.

Figure 43.

2. Select the appropriate image and click the button.
3. Click to save the Presentation Configuration.

Once you save the Presentation Configuration you need to link it to a Tree Grid View definition before you can use it. Use the following procedure:

1. Go to Contents --> Administration --> Configuration --> Tree Grid Views and click the Search button. A list of Tree Grid views appears in the search grid.

2. Click Part TGV.

   

   

   Figure 44.

   Note

   Make sure that the Item is locked before continuing.

3. Click the ellipses in the Linked Toolbar/Context Menu field. The Presentation Configuration search dialog appears.

Figure 45.

4. Select tgv_part and click .

Figure 46.

5. Save the Tree Grid View.
6. Load an Item configured for TGV to see the new toolbar button. For example, Figure 47 shows a Part Item.

Figure 47.