NextGen Consulting

Implement Context Menu in Data Grid

Amdocs Smart Client Framework (ASCF) provides a rich set of functionality to allow flexible and attractive UI.

One very important requirement is to allow the user to perform an optional action on the selected row. More specifically, to allow the user select an option from a context popup menu. The context popup menu should be displayed when the user right clicks the grid.

Unfortunately, as of Amdocs CRM release 7.5.2, this visual requirement is not directly supported.

Luckily, we can add this functionality by adding several Java SWING components on top of our search grid.

In our example I shall use a plain case search grid. This form was created from scratch for simplicity..

The form bellow (X1CaseSearch) was created as a new form:

 

The Original Out of the Box Functionality

The grid contains three columns; the ‘title’ column is editable field. The out of the box functionality provides a special ‘copy paste’ context menu. This menu is displayed for editable grid columns, as shown below:

 

When right clicking on a none-editable column, a single option ‘Copy’ popup menu is displayed:

 

 

New Required Functionality

 We need to display our own customized context menu, without disrupting the above original functionality:

 

We shall override the original ‘Copy’ menu (this option can be later embedded in our new customized context menu) but leave the original ‘Copy Past’ context menu for editable columns:

 

Adding Customized Context Menu

 The following section describes how to add customized context menu to a grid:

Overview

We shall add to our search case form the following code components:

1. Context menu form variables
        
2. Define a Popup Listener object (form inner class).
   This object will be later attached to a native version of our search grid.
   It will intercept mouse events which are directly related with the search grid.
       
3. Define an Action Adapter object (form inner class).
   This object will intercept menu events related with our new customized context menu.
   In other words, it will respond to the user selected context menu item.
         
4. InitContextMenu() method to perform the following steps:
   – Create context popup menu and menu items
   – Add (attach) Action Listener to each of the menu items
   – Create popup mouse listener and attach it to our search grid
        
5. Call InitContextMenu() in your form_Load event handler.

 

 

Code Snippets:

1. Context menu Form variables
     
   
     
    
2. Popup Listener
   Note: this is  a form inner class. It  is defined within the form class.
       
   
     
      
3. Action Adapter
   Note: this is  a form inner class. It  is defined within the form class.
      
   
      
       
   
4. InitContextMenu() Method
       
   
       
   
5. form_Load event handler
       
   
   

 

Run and Test Context Menu

Select option A

 

 

Option-A Yields

 

 

Select option B

 

 

Option-B Yields