Skinning HowTo/XUI Menus
Overview
This page describes the XML attributes for the XUI menus. They are used by the XUI files in the \skins\default\xui folders. You can find attributes for other XUI elements at:
Many XUI elements share the same attributes. Rather than repeatedly describing them, we just list their names here and describe them at Skinning HowTo/Common XUI attributes.
Example
<xml> <?xml version="1.0" encoding="utf-8" standalone="yes" ?>
<floater bottom="400" can_close="true" can_drag_on_left="false" can_minimize="true" can_resize="true" can_tear_off="false" enabled="true" follows="left|top" height="150" left="643" min_height="150" min_width="250" mouse_opaque="true" name="example_menu" tab_stop="false" title="menu" width="250"> <menu_bar bottom="-50" drop_shadow="true" enabled="true" follows="left|top" height="30" left="20" mouse_opaque="false" name="menu_bar" opaque="false" tear_off="false" width="200"> <menu drop_shadow="false" enabled="true" mouse_opaque="false" name="menu" label="menu label" opaque="false" tear_off="true"> <menu_item_call enabled="true" label="menu_item_call label" mouse_opaque="true" name="menu_item_call" /> <menu_item_separator enabled="true" label="menu_item_separator label" mouse_opaque="true" name="menu_item_separator" /> <tearoff_menu label="tearoff_menu label" /> <menu_item_check enabled="true" label="menu_item_check label" mouse_opaque="true" name="menu_item_check" /> </menu> </menu_bar> </floater></xml>
- Used by floater and panel.
- Can contain menu.
- Class LLMenuBarGL
- In source file llui/llmenugl.cpp
Common attributes
- General: name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group
- Positioning and size: width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control
Special attributes
drop_shadow
opaque
tear_off
Optional.
- Used by menu_bar and recursively by other menus.
- Can contain menu, menu_item_call, menu_item_check, menu_item_separator, and tearoff_menu.
- Class LLMenuGL
- In source file llui/llmenugl.cpp
Common attributes
- General: name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group
- Positioning and size: width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control
- Text attributes: label
Special attributes
drop_shadow
Optional. Boolean value.
opaque
tear_off
Optional.
color
Optional.
create_jump_keys
Optional.
Optional.
- Used by menu.
- Can contain on_check, on_click, and on_enable.
- Class MenuItemCheckGL
Common attributes
- General: name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group
- Positioning and size: width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control
- Text attributes: label
Special attributes
shortcut
Optional.
Used by menu and pie_menu.
Common attributes
- General: name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group
- Positioning and size: width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control
- Text attributes: label
- Used by menu and pie_menu.
- Can contain on_click, on_enable, and on_visible.
- Class LLMenuItemCallGL
Common attributes
- General: name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group
- Positioning and size: width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control
- Text attributes: label
Special attributes
shortcut
Optional.
useMacCtrl
Optional.
Optional.
on_check
Attributes
Used by menu_item_check.
function
Optional.
userdata
Optional.
control
Optional.
on_click
Attributes
Used by menu_item_call and menu_item_check.
filter
Optional.
function
userdata
name
Optional.
on_visible
Attributes
Used by menu_item_call.
function
on_enable
Attributes
Used by menu_item_call and menu_item_check.
function
userdata
Optional.
name
Optional.
Deprecated elements
These elements are deprecated and not used by Viewer 2.
- Used recursively by other pie_menus.
- Can contain pie_menu.
Common attributes
- General: name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect
- Text attributes: label
Used by menu.
Common attributes
- General: name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group
- Positioning and size: width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control
- Text attributes: label