CA Technologies Prerelease Documentation. Authorized Use Only.

PDM Macro Definitions › menuItem

menuItem

The menubarItem macro defines an item on a menu. The item invokes a JavaScript function in the main CA Service Desk Manager form, even if the menu is in a pop-up form. Use the menuitemLocal macro to invoke a local function. You define a menubar page with the startMenubar, menubarItem, endMenubar, startMenu, menuItem, menuItemLocal, and endMenu macros. For example:

<PDM_MACRO name=startMenubar. . .>
<PDM_MACRO name=menubarItem. . .>
<PDM_MACRO name=menubarItem. . .>
. . .
<PDM_MACRO name=endMenubar>
<PDM_MACRO name=startMenu. . .>
<PDM_MACRO name=menuItem. . .>
<PDM_MACRO name=menuItemLocal. . .>
. . .
<PDM_MACRO name=endMenu>
<PDM_MACRO name=startMenu. . .> 
. . .
<PDM_MACRO name=endMenu>
. . .

This macro has the following properties:

extended=0|1

Specifies whether this item is an extended menu item supporting disabling, hiding, and changing an image.

function=script

(Required) Specifies the JavaScript function invoked when the menu item is selected. This function must be available in the main CA Service Desk Manager form, and not in the pop-up form containing the menu. Menu items invoking functions in the pop-up form should be defined with the menuitemLocal macro.

hotkey=string

Provides a hotkey suggestion for this menubar item. CA Service Desk Manager selects the hotkey for the menubar item from the characters in the string; otherwise, it selects the hotkey from the characters in the label.

icon_name=string

Specifies the name of an image file displayed as an icon on the menu next to the menu item.

id=name

Specifies a JavaScript ID for the menu item.

label=text

(Required) Specifies the text of the menu item.

local=0|1

Specifies whether extended menus use the function in the local frame. This property is not intended for customer use.

tooltip=string

Specifies a tooltip for the icon.