lmgrSetObject
lmgrSetObject(
t_objName
l_attrList
t_iconName
)
=> t / nil
Description
Accepts a list describing the state of the named object. Returns nil if the object does not exist. The format of the attribute list is a variable-length list of tags (strings) paired with matching string or Boolean values.
This SKILL API can be used in Virtuoso and cdsLibMgr.il.
Arguments
|
t_objName
|
Name of a menu or menu item.
|
|
l_attrList
|
List of attribute names and paired values.
Valid values are managed, sensitive, label, mnemonic, font, and state.
The following attributes are recognized but are silently ignored accelerator, parent, and type. Not all attribute values need to be specified in l_attrList. Unspecified values are left unchanged.
Any other attribute specifications are illegal and generate an error.
Examples
("managed" t)
("sensitive" t)
("label" "Copy")
("mnemonic" "C")
("state" t)
("icon" "cut.png")
Sets the file name.
("icon" "custom.png" "iconMaxLabel" n)
Sets the file name and the max label length. Icons are shown in the toolbar in one of the following ways:
-
Specified valid icon
-
Only label because icon is invalid or is not specified.
-
Error image because icon is invalid and the label length is greater than the specified maximum value.
The default value for iconMaxLabel is 0, which means no length is specified. If you specify a positive integer to this attribute and the icon is invalid, then only the label is visible when the length is within the specified range. An error icon is displayed if the length exceeds the specified range. An error message is displayed for invalid icon.
An icon set on any standard menu is not displayed. Only custom menus can display an icon when specified. Icon labels are not displayed in menus located in the menu bar.
|
Value Returned
|
t
|
The function was called correctly.
|
|
nil
|
The named object does not exist, or invalid attributes are specified.
|
Examples
Sets the font of the Design Manager pull-down to a large bold courier font.
lmgrSetObject ( "designCascade" '( ( "font" "-adobe-courier-bold-o-
normal--25-180-100-100-m-150-iso8859-1" ) ) ) => t
Related Topics
lmgrGetObject
Return to top
