Name |
Type |
Description |
Default Value |
type |
String |
Can be one of:
- "standard": an item which can be clicked to trigger an action or
show another menu
- "separator": a separator
Vendor specific types can be added by prefixing them with
"x--".
|
"standard" |
label |
string |
Text of the item, except that:
-# two consecutive underscore characters "__" are displayed as a
single underscore,
-# any remaining underscore characters are not displayed at all,
-# the first of those remaining underscore characters (unless it is
the last character in the string) indicates that the following
character is the access key.
|
"" |
enabled |
boolean |
Whether the item can be activated or not. |
true |
visible |
boolean |
True if the item is visible in the menu. |
true |
icon-name |
string |
Icon name of the item, following the freedesktop.org icon spec. |
"" |
icon-data |
binary |
PNG data of the icon. |
Empty |
shortcut |
array of arrays of strings |
The shortcut of the item. Each array represents the key press
in the list of keypresses. Each list of strings contains a list of
modifiers and then the key that is used. The modifier strings
allowed are: "Control", "Alt", "Shift" and "Super".
- A simple shortcut like Ctrl+S is represented as:
[["Control", "S"]]
- A complex shortcut like Ctrl+Q, Alt+X is represented as:
[["Control", "Q"], ["Alt", "X"]] |
Empty |
toggle-type |
string |
If the item can be toggled, this property should be set to:
- "checkmark": Item is an independent togglable item
- "radio": Item is part of a group where only one item can be
toggled at a time
- "": Item cannot be toggled
|
"" |
toggle-state |
int |
Describe the current state of a "togglable" item. Can be one of:
- 0 = off
- 1 = on
- anything else = indeterminate
Note:
The implementation does not itself handle ensuring that only one
item in a radio group is set to "on", or that a group does not have
"on" and "indeterminate" items simultaneously; maintaining this
policy is up to the toolkit wrappers.
|
-1 |
children-display |
string |
If the menu item has children this property should be set to
"submenu".
|
"" |
Vendor specific properties can be added by prefixing them with
"x--".
]]>