gui.setMenuItemData

Attaches various data to a menu item.

Prototype

bOk = gui.setMenuItemData ( hMenuItem, vValue, kDataRole )

Description

Please check the predefined data role constants for more info.

Parameters

hMenuItem - menu item handle
vValue - data you want to attach (various)
kDataRole - predefined data role constant

Return values

bOk - true on success

Sample

local hItem = gui.appendMenuItem ( hOpenWithMenu, gui.getComponentIdentifier ( hOpenWithMenu )..".openWith."..sViewControllerName ) 
if ( hItem ) then
    gui.setMenuItemData ( hItem, gui.kDataRoleDisplay, sViewControllerName ) 
    gui.setMenuItemData ( hItem, gui.kDataRoleDecoration, gui.getViewControllerIcon ( hViewController ) ) 
    gui.setMenuItemData ( hItem, gui.kDataRoleUser, tOrderedDesktops[ nDesktop ] ) 
    gui.setMenuItemData ( hItem, gui.kDataRoleUser + 1, hFile )
end
-- etc.

Available since ShiVa 2.0