Developing a User Interface > Customizing the User Interface > Customizing the UI with Templates > Menu attributes |
Every menu attribute specifies a menu shown when the end user clicks one of the query elements editable with a menu. A menu specification is a string encoding menu items separated with double colon “::”, for example:
Example Title |
Copy Code
|
---|---|
<C1QProperty:SortMenu> 0@none@@1::1@ascending@ascending@1::2@descending@descending@1 </C1QProperty:SortMenu> |
A menu item is represented by a string containing four fields separated with “@”:
action_id@menu_text@display_text@enabled
Here are the menu items:
action_id |
Integer number identifying the action. Modifying menu template attributes, use the action ids from the default template file. You can reorder menu items, hide some of them, change item texts, but the action id will always perform the same action as it does in the default template file. For menus that determine the value of an item element (such as the SortMenu above), action_id determines the value of the element when the user selects the item |
menu_text |
The item text as it is shown in the menu. |
display_text |
For menus that determine the value of an item element, the text shown in the element when the user selects the item. |
enabled |
1 means the item is enabled, 0 means it is disabled. |
C1QueryFrame templates have the following menu attributes:
ConditionMenu |
Main menu of a C1QueryFrame control with ContentsType=c1qCondition |
ResfieldMenu |
Main menu of a C1QueryFrame control with ContentsType=c1qResultFields |
ConnMenu |
Connective menu in a complex condition item |
KindMenu |
Left/right field kind menu (two values: function, constant) in an advanced elementary condition item |
SortMenu |
Sort menu in a result field item |
BooleanValues |
Yes/No menu for Boolean constants |
The menus of functions and comparison operators can also be customized, but that is done using the general customization mechanism, see Customizing Functions and Comparison Operators for more information.