axlGetDataViewHistoryUserMenu

axlGetDataViewHistoryUserMenu( 
t_sessionName 
x_historyHandle
) 
=> l_menuStructItems 

Description

This callback function is called when you right-click a history item in the History tab of the Data View assistant. You can override this function in .cdsinit to add customized menu items in the popup menus of the history items.

Arguments

t_sessionName	Session name
x_historyHandle	Handle to the currently active history entry.

Value Returned

l_menuStructItems

A list of menu items that need to be added to the popup menu of the history. Each item in the list contains any one of the following: A single menu list with three elements: list("menu_name" "menu_callback" {"true","false"}), where true sets the menu as disabled and false sets it as enabled. A list of submenu items: list("submenu_name" list("menu_name" "menu_callback" {"true","false"})), where the second list is a list of submenu items. You can create multiple menu and submenus.

Examples

You can override this callback function to add customized menu items to retrieve details of simulation directories or the results database files. 

The following example shows how you can add a new menu item Simulation Directory Name to print the location of results directory for the given history. It also adds another dummy menu list with two submenus.

define( axlGetDataViewHistoryUserMenu( axlSession historySDB) 
val=strcat("Result DB for '" axlGetHistoryName(historySDB) "' is at "
axlGetHistoryResults(historySDB))
    list(list("Results Database Path" "printf(\"%L\" val)" "false")
  ; 'false' enables the menu item
     list("Second item" list(
         list("first submenu item" "callbackProcedure1" "true")
               ; 'true' disables the menu item
            list("second submenu item" "callbackProcedure2" "false")))
   ))

This code adds new menu commands to the pop-up menu of history items in the Data View pane.

Return to top