Cicode Programming Reference > Cicode Function Categories > Menu Functions > MenuNodeSetProperty

MenuNodeSetProperty

Set the item value of the specified menu node.

Be reminded that changes made to the menu tree will not be persisted back to the menu configuration database.

Syntax

MenuNodeSetProperty(hNode, iField, sValue)

hNode:

Handle to the current node in the menu tree.

iField:

Field for which you want to set the value:

0 - Name of menu item.

1 - Icon symbol to be associated with the menu item.

2 - Privilege level required to run the command, otherwise the menu item is disabled.

3 - Area level required to run the command, otherwise the menu item is disabled.

4 - Disabled Style. Allows different display style for a disabled menu item.

5 - Checked setting. Whether the menu item will display a check box next to the label.

6 - Width. Specifies the menu item width in pixels.

7 - Comment.

8 - Cluster.

9 - Equipment.

10 - Expansion state value.

13 - Target page for the menu item.

101 to108 - Custom 1 to Custom 8.

Note: The Cluster and Equipment fields are not validated at runtime.

sValue:

The item value to set for the Menu node.

Return Value

Zero (0) if successful. -1 if hNode or iField is invalid. An error code for others.

Related Functions

MenuGetChild, MenuGetFirstChild, MenuGetGenericNode, MenuGetNextChild, MenuGetPageNode, MenuGetParent, MenuGetPrevChild, MenuGetWindowNode, MenuNodeAddChild, MenuNodeGetCurr, MenuNodeGetDepth, MenuNodeGetExpanded, MenuNodeGetProperty, MenuNodeGetTargetPage, MenuNodeHasCommand, MenuNodeIsDisabled, MenuNodeIsHidden, MenuNodeRemove, MenuNodeRunCommand, MenuNodeSetDisabledWhen, MenuNodeSetHiddenWhen, MenuReload

See Also

Menu Functions

Published June 2018