Difference between revisions of "Skinning HowTo/XUI Containers"
Rand Linden (talk | contribs) |
Rand Linden (talk | contribs) |
||
Line 3: | Line 3: | ||
This page describes the XML attributes for the XUI containers. They are used by the [[Skinning How To/The XML files and what they do | XUI files]] in the '''\skins\default\xui''' folders. | This page describes the XML attributes for the XUI containers. They are used by the [[Skinning How To/The XML files and what they do | XUI files]] in the '''\skins\default\xui''' folders. | ||
Many XUI elements share the same parameters. Rather than repeatedly describing them, we just list their names here and describe them at [[Skinning HowTo/Common XUI | Many XUI elements share the same parameters. Rather than repeatedly describing them, we just list their names here and describe them at [[Skinning HowTo/Common XUI attributes]]. | ||
== floater | == floater attributes == | ||
*Used by tab_container. | *Used by tab_container. | ||
Line 11: | Line 11: | ||
*In source file llui/llfloater.cpp | *In source file llui/llfloater.cpp | ||
<xml><?xml version="1.0" encoding="utf-8" standalone="yes" ?> | |||
<floater bottom="400" can_close="true" can_drag_on_left="false" can_minimize="true" | <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" | can_resize="true" can_tear_off="false" enabled="true" follows="left|top" | ||
height="200" left="550" min_height="50" min_width="50" mouse_opaque="true" | height="200" left="550" min_height="50" min_width="50" mouse_opaque="true" | ||
name="example_floater" tab_stop="false" title="floater" width="250"> | name="example_floater" tab_stop="false" title="floater" width="250"> | ||
</floater> | </floater></xml> | ||
===Common | ===Common attributes=== | ||
*'''[[Skinning HowTo/ | *'''[[Skinning HowTo/Common_XUI_attributes#General_attributes|General]]:''' name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group | ||
*'''[[Skinning HowTo/Common XUI | *'''[[Skinning HowTo/Common XUI attributes#Positioning and size attributes|Positioning and size attributes]]:''' width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control | ||
*'''[[Skinning HowTo/Common XUI | *'''[[Skinning HowTo/Common XUI attributes#Text attributes|Text attributes]]:''' label | ||
*'''Others:''' [[Skinning HowTo/Common XUI | *'''Others:''' [[Skinning HowTo/Common XUI attributes#border|border]] | ||
=== | ===Special attributes=== | ||
==== can_close ==== | ==== can_close ==== | ||
Line 62: | Line 62: | ||
''Optional.'' | ''Optional.'' | ||
== multi_floater | == multi_floater == | ||
*Can contain icon, string, tab_container, and panel. | *Can contain icon, string, tab_container, and panel. | ||
===Common parameters=== | ===Common parameters=== | ||
*'''[[Skinning HowTo/ | *'''[[Skinning HowTo/Common_XUI_attributes#General_attributes|General]]:''' name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group | ||
*'''[[Skinning HowTo/Common XUI | *'''[[Skinning HowTo/Common XUI attributes#Positioning and size attributes|Positioning and size attributes]]:''' width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control | ||
=== | ===Special attributes=== | ||
==== can_close ==== | ==== can_close ==== | ||
Line 87: | Line 87: | ||
''Optional.'' | ''Optional.'' | ||
== panel | == panel == | ||
*Used by floater, tab_container, layout_panel, multi_floater, and recursively by other panels. | *Used by floater, tab_container, layout_panel, multi_floater, and recursively by other panels. | ||
Line 94: | Line 94: | ||
===Common parameters=== | ===Common parameters=== | ||
*'''[[Skinning HowTo/ | *'''[[Skinning HowTo/Common_XUI_attributes#General_attributes|General]]:''' name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group | ||
*'''[[Skinning HowTo/Common XUI | *'''[[Skinning HowTo/Common XUI attributes#Positioning and size attributes|Positioning and size attributes]]:''' width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control | ||
*'''[[Skinning HowTo/Common XUI | *'''[[Skinning HowTo/Common XUI attributes#Text attributes|Text attributes]]:''' label | ||
*'''Others:''' [[Skinning HowTo/Common XUI | *'''Others:''' [[Skinning HowTo/Common XUI attributes#tab_group|tab_group]], [[Skinning HowTo/Common XUI attributes#border|border]] | ||
=== | ===Special attributes=== | ||
==== background_opaque ==== | ==== background_opaque ==== | ||
Line 144: | Line 144: | ||
''Optional.'' | ''Optional.'' | ||
== layout_stack == | |||
== layout_stack | |||
*Used by floater, panel, and layout_panel. | *Used by floater, panel, and layout_panel. | ||
Line 152: | Line 151: | ||
*In source file llui/llpanel.cpp | *In source file llui/llpanel.cpp | ||
<xml> <?xml version="1.0" encoding="utf-8" standalone="yes" ?> | |||
<floater bottom="400" can_close="true" can_drag_on_left="false" can_minimize="true" | <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" | can_resize="true" can_tear_off="false" enabled="true" follows="left|top" | ||
Line 167: | Line 166: | ||
</layout_panel> | </layout_panel> | ||
</layout_stack> | </layout_stack> | ||
</floater> | </floater></xml> | ||
===Common parameters=== | ===Common parameters=== | ||
*'''[[Skinning HowTo/ | *'''[[Skinning HowTo/Common_XUI_attributes#General_attributes|General]]:''' name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group | ||
*'''[[Skinning HowTo/Common XUI | *'''[[Skinning HowTo/Common XUI attributes#Positioning and size attributes|Positioning and size attributes]]:''' width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control | ||
*'''Others:''' [[Skinning HowTo/Common XUI | *'''Others:''' [[Skinning HowTo/Common XUI attributes#tab_group|tab_group]], [[Skinning HowTo/Common XUI attributes#border|border]] | ||
=== | ===Special attributes=== | ||
==== min_height ==== | ==== min_height ==== | ||
Line 185: | Line 184: | ||
''Optional.'' | ''Optional.'' | ||
== layout_panel | == layout_panel == | ||
*Used by layout_stack. | *Used by layout_stack. | ||
*Can contain button, check_box, combo_box, icon, layout_stack, line_editor, panel, progress_bar, scroll_list, | *Can contain button, check_box, combo_box, icon, layout_stack, line_editor, panel, progress_bar, scroll_list, Text attributes, Text attributes_editor, and web_browser. | ||
* In source file llui/llpanel.cpp | * In source file llui/llpanel.cpp | ||
===Common parameters=== | ===Common parameters=== | ||
*'''[[Skinning HowTo/ | *'''[[Skinning HowTo/Common_XUI_attributes#General_attributes|General]]:''' name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group | ||
*'''[[Skinning HowTo/Common XUI | *'''[[Skinning HowTo/Common XUI attributes#Positioning and size attributes|Positioning and size attributes]]:''' width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control | ||
*'''[[Skinning HowTo/Common XUI | *'''[[Skinning HowTo/Common XUI attributes#Text attributes|Text attributes]]:''' label | ||
*'''Others:''' [[Skinning HowTo/Common XUI | *'''Others:''' [[Skinning HowTo/Common XUI attributes#border|border]] | ||
=== | ===Special attributes=== | ||
==== min_height ==== | ==== min_height ==== | ||
Line 214: | Line 213: | ||
''Optional.'' | ''Optional.'' | ||
== scroll_container | == scroll_container == | ||
*Used by floater. | *Used by floater. | ||
Line 221: | Line 220: | ||
*in source file llui/llscrollcontainer.cpp | *in source file llui/llscrollcontainer.cpp | ||
<xml><?xml version="1.0" encoding="utf-8" standalone="yes" ?> | |||
<floater bottom="400" can_close="true" can_drag_on_left="false" can_minimize="true" | <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" | can_resize="true" can_tear_off="false" enabled="true" follows="left|top" | ||
Line 233: | Line 232: | ||
</panel> | </panel> | ||
</scroll_container> | </scroll_container> | ||
</floater> | </floater></xml> | ||
===Common parameters=== | ===Common parameters=== | ||
*'''[[Skinning HowTo/ | *'''[[Skinning HowTo/Common_XUI_attributes#General_attributes|General]]:''' name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group | ||
*'''[[Skinning HowTo/Common XUI | *'''[[Skinning HowTo/Common XUI attributes#Positioning and size attributes|Positioning and size attributes]]:''' width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control | ||
=== | ===Special attributes=== | ||
==== opaque ==== | ==== opaque ==== | ||
== tab_container | == tab_container == | ||
*Used by floater, panel, and multi_floater. | *Used by floater, panel, and multi_floater. | ||
Line 250: | Line 249: | ||
*In source file llui/lltabcontainer.cpp | *In source file llui/lltabcontainer.cpp | ||
<xml><?xml version="1.0" encoding="utf-8" standalone="yes" ?> | |||
<floater bottom="400" can_close="true" can_drag_on_left="false" can_minimize="true" | <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" | can_resize="true" can_tear_off="false" enabled="true" follows="left|top" | ||
Line 263: | Line 262: | ||
tab_stop="false" width="148" /> | tab_stop="false" width="148" /> | ||
</tab_container> | </tab_container> | ||
</floater> | </floater></xml> | ||
===Common parameters=== | ===Common parameters=== | ||
*'''[[Skinning HowTo/ | *'''[[Skinning HowTo/Common_XUI_attributes#General_attributes|General]]:''' name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group | ||
*'''[[Skinning HowTo/Common XUI | *'''[[Skinning HowTo/Common XUI attributes#Positioning and size attributes|Positioning and size attributes]]:''' width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control | ||
*'''Others:''' [[Skinning HowTo/Common XUI | *'''Others:''' [[Skinning HowTo/Common XUI attributes#tab_group|tab_group]], [[Skinning HowTo/Common XUI attributes#border|border]] | ||
=== | ===Special attributes=== | ||
==== tab_position ==== | ==== tab_position ==== |
Revision as of 17:00, 21 May 2010
Overview
This page describes the XML attributes for the XUI containers. They are used by the XUI files in the \skins\default\xui folders.
Many XUI elements share the same parameters. Rather than repeatedly describing them, we just list their names here and describe them at Skinning HowTo/Common XUI attributes.
floater attributes
- Used by tab_container.
- Class LLFloater
- In source file llui/llfloater.cpp
<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="200" left="550" min_height="50" min_width="50" mouse_opaque="true" name="example_floater" tab_stop="false" title="floater" width="250"> </floater></xml>
Common attributes
- General: name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group
- Positioning and size attributes: width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control
- Text attributes: label
- Others: border
Special attributes
can_close
Optional.
can_drag_on_left
Optional.
can_minimize
Optional.
can_resize
can_tear_off
Optional.
max_height
Optional.
min_height
Optional.
min_width
Optional.
title
Optional.
short_title
Optional.
border_drop_shadow_visible
Optional.
border_visible
Optional.
border_style
Optional.
border_thickness
Optional.
border_bevel
Optional.
bevel_style
Optional.
multi_floater
- Can contain icon, string, tab_container, and panel.
Common parameters
- General: name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group
- Positioning and size attributes: width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control
Special attributes
can_close
can_drag_on_left
can_minimize
can_resize
min_height
Optional.
min_width
Optional.
title
title_bar
Optional.
panel
- Used by floater, tab_container, layout_panel, multi_floater, and recursively by other panels.
- Class LLPanel
- In source file llui/llpanel.cpp
Common parameters
- General: name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group
- Positioning and size attributes: width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control
- Text attributes: label
- Others: tab_group, border
Special attributes
background_opaque
Optional.
background_visible
Optional.
bevel_style
Optional.
bg_visible
Optional.
bg_alpha_color
Optional.
bg_opaque_color
Optional.
can_resize
Optional.
can_close
Optional.
can_minimize
Optional.
filename
Optional.
placeholder
Optional.
border_drop_shadow_visible
Optional.
border_visible
Optional.
border_style
Optional.
border_thickness
Optional.
border_color
Optional.
title
Optional.
auto_resize
Optional.
user_resize
Optional.
left_in_finder
Optional.
select
Optional.
layout_stack
- Used by floater, panel, and layout_panel.
- Can contain button, flyout_button, icon, layout_panel, and scroll_list.
- Class LLLayoutStack
- In source file llui/llpanel.cpp
<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="100" left="621" min_height="100" min_width="250" mouse_opaque="true" name="example_layout_stack" tab_stop="false" title="layout_stack" width="250"> <layout_stack bottom="10" enabled="true" height="50" left="0" mouse_opaque="true" name="stack" orientation="horizontal" width="235" > <layout_panel name="panel1" min_height="10" height="200" width="640"/> <layout_panel name="panel2" min_height="10" height="200" width="640"> <icon bottom="20" color="1 0.5 0 1" enabled="true" height="30" left="10" mouse_opaque="false" name="icon" tab_stop="false" width="223" image_name="icon_day_cycle.tga" /> </layout_panel> </layout_stack> </floater></xml>
Common parameters
- General: name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group
- Positioning and size attributes: width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control
- Others: tab_group, border
Special attributes
min_height
Optional.
min_width
Optional.
orientation
Optional.
border_size
Optional.
layout_panel
- Used by layout_stack.
- Can contain button, check_box, combo_box, icon, layout_stack, line_editor, panel, progress_bar, scroll_list, Text attributes, Text attributes_editor, and web_browser.
- In source file llui/llpanel.cpp
Common parameters
- General: name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group
- Positioning and size attributes: width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control
- Text attributes: label
- Others: border
Special attributes
min_height
Optional.
min_width
Optional.
auto_resize
Optional.
can_resize
Optional.
user_resize
Optional.
filename
Optional.
background_visible
Optional.
scroll_container
- Used by floater.
- Can contain panel.
- Class LLScrollableContainerView : LLUICtrl : LLView
- in source file llui/llscrollcontainer.cpp
<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="200" left="550" min_height="200" min_width="250" mouse_opaque="true" name="example_scroll_container" tab_stop="false" title="scroll_container" width="250"> <scroll_container bottom="20" enabled="true" height="150" left="20" mouse_opaque="false" name="scroll_container" opaque="false" tab_stop="false" width="200"> <panel bottom="149" enabled="true" height="700" left="1" mouse_opaque="true" name="panel" tab_stop="false" width="200"> </panel> </scroll_container> </floater></xml>
Common parameters
- General: name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group
- Positioning and size attributes: width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control
Special attributes
opaque
tab_container
- Used by floater, panel, and multi_floater.
- Can contain inventory_panel, panel, and floater.
- Class LLTabContainer
- In source file llui/lltabcontainer.cpp
<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="600" min_height="150" min_width="200" mouse_opaque="true" name="example_tab_container" tab_stop="false" title="tab_container" width="200"> <tab_container bottom="-80" enabled="true" follows="left|top" height="20" left="20" mouse_opaque="false" name="tab_container" tab_position="top" tab_stop="false" width="150"> <panel border="true" bottom="-19" enabled="true" follows="left|top|right|bottom" height="3" label="panel" left="1" mouse_opaque="false" name="panel" tab_stop="false" width="148" /> </tab_container> </floater></xml>
Common parameters
- General: name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group
- Positioning and size attributes: width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control
- Others: tab_group, border
Special attributes
tab_position
tab_width
Optional.
tab_min_width
Optional.
tab_max_width
Optional.
hide_tabs
Optional.