Difference between revisions of "Skinning HowTo/XUI Selection Widgets"

From Second Life Wiki
Jump to: navigation, search
(scroll_container parameters)
(scroll_list: added documentation about <row>)
 
(19 intermediate revisions by 3 users not shown)
Line 1: Line 1:
This page describes the XML attributes for the XUI selection widgets.  These are some of the XML elements and parameters used within the floaters, panels, and so forth, that make up the viewer user interface.  They are used by the [[Skinning How To/The XML files and what they do | XUI files]] in the '''\skins\default\xui''' folders.  You can find attributes for other XUI elements at:
+
{{XUI Nav}}
*[[Skinning HowTo/XUI Containers]]
+
{{TOClimit}}
*[[Skinning HowTo/XUI Menus]]
+
== Overview ==
*[[Skinning HowTo/XUI Buttons, Sliders, and Spinners]]
+
This page describes the XML attributes for the XUI selection widgets.  These are some of the XML elements and attributes used within the floaters, panels, and so forth, that make up the viewer user interface.  They are used by the [[Skinning How To/The XML files and what they do | XUI files]] in the '''\skins\default\xui''' folders.   
*[[Skinning HowTo/XUI Text Entry Widgets]]
+
*[[Skinning HowTo/XUI Other Widgets]]
+
and you can find more general information at [[Skinning HowTo/Basics]]
+
  
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 XML parameters]].
+
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]].
 +
 
 +
== check_box  ==
  
=== check_box parameters ===
 
----
 
 
*Class LLCheckBoxCtrl : LLUICtrl : LLView
 
*Class LLCheckBoxCtrl : LLUICtrl : LLView
 
*In source file llui/llcheckboxctrl.cpp
 
*In source file llui/llcheckboxctrl.cpp
 
*Used by floater, panel, and layout_panel.
 
*Used by floater, panel, and layout_panel.
  
====Common parameters====
+
<xml><?xml version="1.0" encoding="utf-8" standalone="yes" ?>
*'''[[Skinning HowTo/Common XUI XML parameters#Used by all XUI elements|General]]:'''  name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group
+
<floater bottom="400" can_close="true" can_drag_on_left="false" can_minimize="true"
*'''[[Skinning HowTo/Common XUI XML parameters#Positioning|Positioning]]:'''  width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control
+
    can_resize="true" can_tear_off="false" enabled="true" follows="left|top"
*'''[[Skinning HowTo/Common XUI XML parameters#Text|Text]]:'''  label, font, font_size, font_style, halign
+
    height="70" left="582" min_height="70" min_width="150" mouse_opaque="true"
*'''Others:''' [[Skinning HowTo/Common XUI XML parameters#tab_group|tab_group]]
+
    name="example_check_box" tab_stop="false" title="check_box" width="150">
 +
    <check_box bottom="-52" enabled="true" follows="left|bottom" font="SansSerif" height="10"
 +
        initial_value="false" label="check_box label" left="15" mouse_opaque="true"
 +
        name="checkbox" radio_style="false" tab_stop="true" width="455" />
 +
</floater></xml>
 +
 
 +
===Common attributes===
 +
*'''[[Skinning HowTo/Common XUI attributes#Used by all XUI elements|General]]:'''  name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group
 +
*'''[[Skinning HowTo/Common XUI attributes#Positioning|Positioning]]:'''  width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control
 +
*'''[[Skinning HowTo/Common XUI attributes#Text|Text]]:'''  label, font, font_size, font_style, halign
 +
*'''Others:''' [[Skinning HowTo/Common XUI attributes#tab_group|tab_group]]
  
====Specific parameters====
+
===Special attributes===
  
 
===== initial_value =====
 
===== initial_value =====
Line 36: Line 43:
 
''Optional.''
 
''Optional.''
  
=== color_swatch parameters ===
+
== color_swatch ==
----
+
 
 
*Class LLColorSwatchCtrl : LLUICtrl : LLView
 
*Class LLColorSwatchCtrl : LLUICtrl : LLView
 
*In source file newview/llcolorswatch.cpp
 
*In source file newview/llcolorswatch.cpp
 
*Used by floater and panel.
 
*Used by floater and panel.
  
====Common parameters====
+
<xml><?xml version="1.0" encoding="utf-8" standalone="yes" ?>
*'''[[Skinning HowTo/Common XUI XML parameters#Used by all XUI elements|General]]:'''  name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group
+
<floater bottom="400" can_close="true" can_drag_on_left="false" can_minimize="true"
*'''[[Skinning HowTo/Common XUI XML parameters#Positioning|Positioning]]:'''  width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control
+
    can_resize="true" can_tear_off="false" enabled="true" follows="left|top"
*'''[[Skinning HowTo/Common XUI XML parameters#Text|Text]]:''' label
+
    height="100" left="559" min_height="100" min_width="200" mouse_opaque="true"
 +
    name="example_color_swatch" tab_stop="false" title="color_swatch" width="200">
 +
    <color_swatch border_color="0.5 0.5 0.5 1" bottom="-74"
 +
        can_apply_immediately="true" color="1 0 0 1" enabled="true" height="50"
 +
        label="color_swatch label" left="10" mouse_opaque="true" name="colorswatch" tab_stop="true"
 +
        width="150" />
 +
  </floater></xml>
  
====Specific parameters====
+
===Common attributes===
 +
*'''[[Skinning HowTo/Common XUI attributes#Used by all XUI elements|General]]:'''  name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group
 +
*'''[[Skinning HowTo/Common XUI attributes#Positioning|Positioning]]:'''  width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control
 +
*'''[[Skinning HowTo/Common XUI attributes#Text|Text]]:'''  label
  
===== border_color =====
+
===Special attributes===
 +
 
 +
==== border_color ====
 
''Optional.''
 
''Optional.''
===== can_apply_immediately =====
+
==== can_apply_immediately ====
===== color =====
+
==== color ====
 
''Optional.''
 
''Optional.''
  
=== combo_box parameters ===
+
== combo_box ==
----
+
 
 
*Class LLComboBox : LLUICtrl : LLView
 
*Class LLComboBox : LLUICtrl : LLView
 
*In source file llui/llcombobox.cpp
 
*In source file llui/llcombobox.cpp
Line 62: Line 80:
 
*Can contain combo_item.
 
*Can contain combo_item.
  
====Common parameters====
+
<xml><?xml version="1.0" encoding="utf-8" standalone="yes" ?>
*'''[[Skinning HowTo/Common XUI XML parameters#Used by all XUI elements|General]]:'''  name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group
+
<floater bottom="400" can_close="true" can_drag_on_left="false" can_minimize="true"
*'''[[Skinning HowTo/Common XUI XML parameters#Positioning|Positioning]]:'''  width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control
+
    can_resize="true" can_tear_off="false" enabled="true" follows="left|top"
*'''[[Skinning HowTo/Common XUI XML parameters#Text|Text]]:'''  label, font, font_size, font_style, halign
+
    height="80" left="550" min_height="80" min_width="250" mouse_opaque="true"
*'''Others:'''  [[Skinning HowTo/Common XUI XML parameters#tab_group|tab_group]]
+
    name="example_combo_box" tab_stop="false" title="combo_box" width="250">
 +
    <combo_box allow_text_entry="false" bottom="20" enabled="true" follows="left|bottom"
 +
        height="20" left="20" max_chars="20" mouse_opaque="true" name="combo_box"
 +
        tab_stop="true" width="200">
 +
        <combo_item type="string" length="1" enabled="true" value="combo_item 1">Item 1</combo_item>
 +
        <combo_item type="string" length="1" enabled="true" value="combo_item 2">Item 2</combo_item>
 +
    </combo_box>
 +
</floater></xml>
 +
 
 +
===Common attributes===
 +
*'''[[Skinning HowTo/Common XUI attributes#Used by all XUI elements|General]]:'''  name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group
 +
*'''[[Skinning HowTo/Common XUI attributes#Positioning|Positioning]]:'''  width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control
 +
*'''[[Skinning HowTo/Common XUI attributes#Text|Text]]:'''  label, font, font_size, font_style, halign
 +
*'''Others:'''  [[Skinning HowTo/Common XUI attributes#tab_group|tab_group]]
  
====Specific parameters====
+
===Special attributes===
  
===== allow_text_entry =====
+
==== allow_text_entry ====
 
''Optional.''
 
''Optional.''
===== length =====
+
==== length ====
 
''Optional.''
 
''Optional.''
===== max_chars =====
+
==== max_chars ====
 
''Optional.''
 
''Optional.''
===== initial_value =====
+
==== initial_value ====
 
''Optional.''
 
''Optional.''
===== max_length =====
+
==== max_length ====
 
''Optional.''
 
''Optional.''
===== bg_readonly_color =====
+
==== bg_readonly_color ====
 
''Optional.''
 
''Optional.''
===== text_readonly_color =====
+
==== text_readonly_color ====
 
''Optional.''
 
''Optional.''
  
=== combo_item parameters ===
+
== combo_item ==
----
+
 
 
*member of LLComboBox : LLUICtrl : LLView
 
*member of LLComboBox : LLUICtrl : LLView
 
*In source file llui/llcombobox.cpp
 
*In source file llui/llcombobox.cpp
 
*Used by combo_box.
 
*Used by combo_box.
  
===== name =====
+
===Common attributes===
===== value =====
+
 
 +
==== name ====
 +
==== value ====
 
''Optional.''
 
''Optional.''
===== type =====
+
==== type ====
 
''Optional.''
 
''Optional.''
===== length =====
+
==== length ====
 
''Optional.''
 
''Optional.''
===== enabled =====
+
==== enabled ====
 
''Optional.''
 
''Optional.''
  
=== name_list parameters ===
+
== name_list ==
----
+
 
 
*Class LLNameListCtrl : LLScrollListCtrl : LLUICtrl : LLView
 
*Class LLNameListCtrl : LLScrollListCtrl : LLUICtrl : LLView
 
*In source file newview/llnamelistctrl.cpp
 
*In source file newview/llnamelistctrl.cpp
 
*Used by floater and panel.
 
*Used by floater and panel.
 
*Can contain column.
 
*Can contain column.
 +
*Can contain row.
  
====Common parameters====
+
<xml><?xml version="1.0" encoding="utf-8" standalone="yes" ?>
*'''[[Skinning HowTo/Common XUI XML parameters#Used by all XUI elements|General]]:'''  name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group
+
<floater bottom="400" can_close="true" can_drag_on_left="false" can_minimize="true"
*'''[[Skinning HowTo/Common XUI XML parameters#Positioning|Positioning]]:'''  width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control
+
    can_resize="true" can_tear_off="false" enabled="true" follows="left|top"
 +
    height="160" left="550" min_height="160" min_width="250" mouse_opaque="true"
 +
    name="example_name_list" tab_stop="false" title="name_list" width="250">
 +
    <name_list allow_calling_card_drop="false" background_visible="true" bottom="20"
 +
        column_padding="5" draw_border="true" draw_heading="true"
 +
        draw_stripes="true" enabled="true" follows="left|top" height="100"
 +
        left="20" mouse_opaque="true" multi_select="false" name="name_list"
 +
        tab_stop="true" width="210">
 +
        <column label="column label 1" name="column1" width="100" />
 +
        <column label="column label 2" name="column2" width="100" />
 +
        <row
 +
            name="action_something_1"
 +
            value="Something 1" />
 +
        <row
 +
            name="action_something_2"
 +
            value="Something 2" />
 +
        <row>
 +
            <column column="column1">Text 1</column>
 +
            <column column="column2">Text 2</column>
 +
        </row>
 +
    </name_list>
 +
</floater></xml>
  
====Specific parameters====
+
===Common attributes===
 +
*'''[[Skinning HowTo/Common XUI attributes#Used by all XUI elements|General]]:'''  name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group
 +
*'''[[Skinning HowTo/Common XUI attributes#Positioning|Positioning]]:'''  width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control
  
===== allow_calling_card_drop =====
+
===Special attributes===
 +
 
 +
==== allow_calling_card_drop ====
 
''Optional.''
 
''Optional.''
===== background_visible =====
+
==== background_visible ====
 
''Optional.''
 
''Optional.''
===== column_padding =====
+
==== column_padding ====
 
''Optional.''
 
''Optional.''
===== draw_border =====
+
==== draw_border ====
 
''Optional.''
 
''Optional.''
===== draw_heading =====
+
==== draw_heading ====
 
''Optional.''
 
''Optional.''
===== draw_stripes =====
+
==== draw_stripes ====
 
''Optional.''
 
''Optional.''
===== multi_select =====  
+
==== multi_select ====  
===== name_column_index =====
+
==== name_column_index ====
 
''Optional.''
 
''Optional.''
===== heading_font =====
+
==== heading_font ====
 
''Optional.''
 
''Optional.''
===== heading_height =====
+
==== heading_height ====
 
''Optional.''
 
''Optional.''
===== bg_selected_color =====
+
==== bg_selected_color ====
 
''Optional.''
 
''Optional.''
===== fg_selected_color =====
+
==== fg_selected_color ====
 
''Optional.''
 
''Optional.''
===== fg_disable_color =====
+
==== fg_disable_color ====
 
''Optional.''
 
''Optional.''
===== fg_unselected_color =====
+
==== fg_unselected_color ====
 
''Optional.''
 
''Optional.''
===== background_opaque =====
+
==== background_opaque ====
 
''Optional.''
 
''Optional.''
===== bg_alpha_color =====
+
==== bg_alpha_color ====
 
''Optional.''
 
''Optional.''
===== bg_opaque_color =====
+
==== bg_opaque_color ====
 
''Optional.''
 
''Optional.''
  
=== column parameters ===
+
== radio_group ==
----
+
*member of LLScrollListCtrl : LLUICtrl : LLView
+
*In source file newview/llnamelistctrl.cpp
+
*Used by name_list and scroll_list.
+
 
+
===== name =====
+
===== label =====
+
''Optional.''
+
===== sort =====
+
''Optional.''
+
===== width =====
+
''Optional.''
+
===== dynamicwidth =====
+
''Optional.''
+
===== relwidth =====
+
''Optional.''
+
===== image =====
+
''Optional.''
+
===== tool_tip =====
+
''Optional.''
+
===== user_resize =====
+
''Optional.''
+
  
=== radio_group parameters ===
 
----
 
 
*Class LLRadioGroup : LLUICtrl : LLView
 
*Class LLRadioGroup : LLUICtrl : LLView
 
*In source file llui/llradiogroup.cpp
 
*In source file llui/llradiogroup.cpp
Line 179: Line 214:
 
*Can contain radio_item.
 
*Can contain radio_item.
  
====Common parameters====
+
<xml><?xml version="1.0" encoding="utf-8" standalone="yes" ?>
*'''[[Skinning HowTo/Common XUI XML parameters#Used by all XUI elements|General]]:'''  name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group
+
<floater bottom="400" can_close="true" can_drag_on_left="false" can_minimize="true"
*'''[[Skinning HowTo/Common XUI XML parameters#Positioning|Positioning]]:'''  width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control
+
    can_resize="true" can_tear_off="false" enabled="true" follows="left|top"
*'''[[Skinning HowTo/Common XUI XML parameters#Text|Text]]:''' label
+
    height="160" left="550" min_height="160" min_width="250" mouse_opaque="true"
 +
    name="example_radio_group" tab_stop="false" title="radio_group" width="250">
 +
    <radio_group bottom="20" draw_border="true" enabled="true" follows="left|bottom"
 +
        height="100" left="20" mouse_opaque="true" name="radio_group"
 +
        tab_stop="true" width="200">
 +
        <radio_item type="string" length="1" bottom="10" enabled="true" font="SansSerif" height="20"
 +
            initial_value="false" label="radio_item label 1" left="20" mouse_opaque="true" name="radio"
 +
            radio_style="true" tab_stop="false" width="200">
 +
            radio_item 1
 +
        </radio_item>
 +
        <radio_item type="string" length="1" bottom="40" enabled="true" font="SansSerif" height="20"
 +
            initial_value="false" label="radio_item label 2" left="20" mouse_opaque="true" name="radio"
 +
            radio_style="true" tab_stop="false" width="200">
 +
            radio_item 2
 +
        </radio_item>
 +
        <radio_item type="string" length="1" bottom="70" enabled="true" font="SansSerif" height="20"
 +
            initial_value="false" label="radio_item label 3" left="20" mouse_opaque="true" name="radio"
 +
            radio_style="true" tab_stop="false" width="200">
 +
            radio_item 3
 +
        </radio_item>
 +
    </radio_group>
 +
  </floater></xml>
  
====Specific parameters====
+
===Common attributes===
 +
*'''[[Skinning HowTo/Common XUI attributes#Used by all XUI elements|General]]:'''  name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group
 +
*'''[[Skinning HowTo/Common XUI attributes#Positioning|Positioning]]:'''  width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control
 +
*'''[[Skinning HowTo/Common XUI attributes#Text|Text]]:'''  label
  
===== draw_border =====
+
===Special attributes===
 +
 
 +
==== draw_border ====
 
''Optional.''
 
''Optional.''
===== text_disabled_color =====
+
==== text_disabled_color ====
 
''Optional.''
 
''Optional.''
  
=== radio_item parameters ===
+
== radio_item ==
----
+
 
 
*Class LLRadioItem : LLCheckBoxCtrl : LLUICtrl : LLView
 
*Class LLRadioItem : LLCheckBoxCtrl : LLUICtrl : LLView
 
*In source file llui/llradiogroup.cpp
 
*In source file llui/llradiogroup.cpp
 
*Used by radio_group.
 
*Used by radio_group.
  
====Common parameters====
+
===Common attributes===
*'''[[Skinning HowTo/Common XUI XML parameters#Used by all XUI elements|General]]:'''  name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group
+
*'''[[Skinning HowTo/Common XUI attributes#Used by all XUI elements|General]]:'''  name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group
*'''[[Skinning HowTo/Common XUI XML parameters#Positioning|Positioning]]:'''  width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control
+
*'''[[Skinning HowTo/Common XUI attributes#Positioning|Positioning]]:'''  width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control
  
====Specific parameters====
+
===Special attributes===
  
===== type =====
+
==== type ====
 
''Optional.''
 
''Optional.''
===== length =====
+
==== length ====
 
''Optional.''
 
''Optional.''
  
=== scroll_container parameters ===
+
== scroll_list  ==
----
+
*Class LLScrollableContainerView : LLUICtrl : LLView
+
*in source file llui/llscrollcontainer.cpp
+
*Used by floater.
+
  
====Common parameters====
 
*'''[[Skinning HowTo/Common XUI XML parameters#Used by all XUI elements|General]]:'''  name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group
 
*'''[[Skinning HowTo/Common XUI XML parameters#Positioning|Positioning]]:'''  width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control
 
 
====Specific parameters====
 
 
===== opaque =====
 
 
=== scroll_list parameters ===
 
----
 
 
*Class LLScrollListCtrl : LLUICtrl : LLView
 
*Class LLScrollListCtrl : LLUICtrl : LLView
 
*In source file llui/llscrolllist.cpp
 
*In source file llui/llscrolllist.cpp
 
*Used by floater, panel, layout_stack, and layout_panel.
 
*Used by floater, panel, layout_stack, and layout_panel.
 
*Can contain column.
 
*Can contain column.
 +
*Can contain row.
  
===== bottom =====
+
<xml><?xml version="1.0" encoding="utf-8" standalone="yes" ?>
''Optional.''
+
<floater bottom="400" can_close="true" can_drag_on_left="false" can_minimize="true"
===== bottom_delta =====
+
    can_resize="true" can_tear_off="false" enabled="true" follows="left|top"
''Optional.''
+
    height="160" left="550" min_height="160" min_width="250" mouse_opaque="true"
===== top =====
+
    name="example_scroll_list" tab_stop="false" title="scroll_list" width="250">
''Optional.''
+
    <scroll_list allow_calling_card_drop="false" background_visible="true" bottom="20"
===== left =====
+
        column_padding="5" draw_border="true" draw_heading="true"
===== right =====
+
        draw_stripes="true" enabled="true" follows="left|top" height="100"
''Optional.''
+
        left="20" mouse_opaque="true" multi_select="false" name="scroll_list"
===== can_resize =====
+
        tab_stop="true" width="210">
 +
        <column label="column label 1" name="column1" width="100" />
 +
        <column label="column label 2" name="column2" width="100" />
 +
        <row
 +
            name="action_something_1"
 +
            value="Something 1" />
 +
        <row
 +
            name="action_something_2"
 +
            value="Something 2" />
 +
        <row>
 +
            <column column="column1">Text 1</column>
 +
            <column column="column2">Text 2</column>
 +
        </row>
 +
    </scroll_list>
 +
</floater></xml>
 +
 
 +
===Common attributes===
 +
*'''[[Skinning HowTo/Common XUI attributes#Used by all XUI elements|General]]:'''  name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group
 +
*'''[[Skinning HowTo/Common XUI attributes#Positioning|Positioning]]:'''  width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control
 +
*'''[[Skinning HowTo/Common XUI attributes#Text|Text]]:'''  font, font_size, font_style
 +
*'''Others:''' [[Skinning HowTo/Common XUI attributes#tab_group|tab_group]]
 +
 
 +
===Special attributes===
 +
 
 +
==== can_resize ====
 
''Optional.''
 
''Optional.''
===== column_padding =====
+
==== column_padding ====
 
''Optional.''
 
''Optional.''
===== column_widths =====
+
==== column_widths ====
 
''Optional.''  
 
''Optional.''  
===== draw_heading =====
+
==== draw_heading ====
 
''Optional.''
 
''Optional.''
===== draw_stripes =====
+
==== draw_stripes ====
 
''Optional.''
 
''Optional.''
===== draw_border =====
+
==== draw_border ====
 
''Optional.''
 
''Optional.''
===== follows =====
+
==== multi_select ====
 
''Optional.''
 
''Optional.''
===== multi_select =====
+
==== search_column ====
 
''Optional.''
 
''Optional.''
===== name =====
+
==== sort_column ====
===== search_column =====
+
 
''Optional.''
 
''Optional.''
===== sort_column =====
+
==== background_visible ====
 
''Optional.''
 
''Optional.''
===== background_visible =====
+
==== bg_selected_color ====
 
''Optional.''
 
''Optional.''
===== height =====
+
==== fg_disable_color ====
 
''Optional.''
 
''Optional.''
===== width =====
+
==== fg_selected_color ====
 
''Optional.''
 
''Optional.''
===== mouse_opaque =====
+
==== fg_unselected_color ====
 
''Optional.''
 
''Optional.''
===== enabled =====
+
==== heading_font ====
 
''Optional.''
 
''Optional.''
===== tab_group =====
+
==== heading_height ====
 
''Optional.''
 
''Optional.''
===== bg_selected_color =====
+
==== allow_calling_card_drop ====
 
''Optional.''
 
''Optional.''
===== fg_disable_color =====
+
==== tab_stop ====
 
''Optional.''
 
''Optional.''
===== fg_selected_color =====
+
==== user_resize ====
 
''Optional.''
 
''Optional.''
===== fg_unselected_color =====
+
==== sort_ascending ====
''Optional.''
+
===== tool_tip =====
+
''Optional.''
+
===== font =====
+
''Optional.''
+
===== heading_font =====
+
''Optional.''
+
===== heading_height =====
+
''Optional.''
+
===== allow_calling_card_drop =====
+
''Optional.''
+
===== tab_stop =====
+
''Optional.''
+
===== user_resize =====
+
''Optional.''
+
===== sort_ascending =====
+
 
''Optional.''
 
''Optional.''
  
=== column parameters ===
+
== column ==
----
+
 
 
*member of LLNameListCtrl : LLScrollListCtrl : LLUICtrl : LLView
 
*member of LLNameListCtrl : LLScrollListCtrl : LLUICtrl : LLView
 
*In source file newview/llnamelistctrl.cpp
 
*In source file newview/llnamelistctrl.cpp
 
*Used by name_list and scroll_list.
 
*Used by name_list and scroll_list.
  
===== name =====
+
=== Attributes ===
===== label =====
+
 
 +
==== name ====
 +
==== label ====
 
''Optional.''
 
''Optional.''
===== sort =====
+
==== sort ====
 
''Optional.''
 
''Optional.''
===== width =====
+
==== width ====
 
''Optional.''
 
''Optional.''
===== dynamicwidth =====
+
==== dynamicwidth ====
 
''Optional.''
 
''Optional.''
===== relwidth =====
+
==== relwidth ====
 
''Optional.''
 
''Optional.''
===== image =====
+
==== image ====
 
''Optional.''
 
''Optional.''
===== tool_tip =====
+
==== tool_tip ====
 
''Optional.''
 
''Optional.''
===== user_resize =====
+
==== user_resize ====
 
''Optional.''
 
''Optional.''
  
=== texture_picker parameters ===
+
== texture_picker ==
----
+
 
 
*Class LLTextureCtrl : LLUICtrl : LLView
 
*Class LLTextureCtrl : LLUICtrl : LLView
 
*In source file newview/lltexturectrl.cpp
 
*In source file newview/lltexturectrl.cpp
 
*Used by floater and panel.
 
*Used by floater and panel.
  
===== allow_no_texture =====
+
<xml><?xml version="1.0" encoding="utf-8" standalone="yes" ?>
''Optional.''
+
<floater bottom="400" can_close="true" can_drag_on_left="false" can_minimize="true"
===== bottom =====
+
    can_resize="true" can_tear_off="false" enabled="true" follows="left|top"
''Optional.''
+
    height="200" left="550" min_height="200" min_width="200" mouse_opaque="true"
===== bottom_delta =====
+
    name="example_texture_picker" tab_stop="false" title="texture_picker"
''Optional.''
+
    width="250">
===== left =====
+
    <texture_picker allow_no_texture="false" bottom="20" can_apply_immediately="false"
''Optional.''
+
        default_image_name="Default" enabled="true" height="130"
===== left_delta =====
+
        label="texture_picker label" left="20" mouse_opaque="true"
''Optional.''
+
        name="texture_picker" tab_stop="true" width="130" />
===== right =====
+
</floater></xml>
''Optional.''
+
 
===== can_apply_immediately =====
+
===Common attributes===
''Optional.''
+
*'''[[Skinning HowTo/Common XUI attributes#Used by all XUI elements|General]]:''' name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group
===== default_image_name =====
+
*'''[[Skinning HowTo/Common XUI attributes#Positioning|Positioning]]:'''  width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control
''Optional.''
+
*'''[[Skinning HowTo/Common XUI attributes#Text|Text]]:'''  label
===== enabled =====
+
 
''Optional.''
+
===Special attributes===
===== follows =====
+
 
''Optional.''
+
==== allow_no_texture ====
===== height =====
+
===== width =====
+
===== label =====
+
''Optional.''
+
===== mouse_opaque =====
+
 
''Optional.''
 
''Optional.''
===== name =====
+
==== can_apply_immediately ====
===== tool_tip =====
+
 
''Optional.''
 
''Optional.''
===== visible =====
+
==== default_image_name ====
 
''Optional.''
 
''Optional.''

Latest revision as of 16:21, 11 February 2011

Contents

Overview

This page describes the XML attributes for the XUI selection widgets. These are some of the XML elements and attributes used within the floaters, panels, and so forth, that make up the viewer user interface. They are used by the XUI files in the \skins\default\xui folders.

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.

check_box

  • Class LLCheckBoxCtrl : LLUICtrl : LLView
  • In source file llui/llcheckboxctrl.cpp
  • Used by floater, panel, and layout_panel.

<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="70" left="582" min_height="70" min_width="150" mouse_opaque="true"
    name="example_check_box" tab_stop="false" title="check_box" width="150">
   <check_box bottom="-52" enabled="true" follows="left|bottom" font="SansSerif" height="10"
        initial_value="false" label="check_box label" left="15" mouse_opaque="true"
        name="checkbox" radio_style="false" tab_stop="true" width="455" />
</floater></xml>

Common attributes

  • General: name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group
  • Positioning: width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control
  • Text: label, font, font_size, font_style, halign
  • Others: tab_group

Special attributes

initial_value

Optional.

radio_style

Optional.

tab_stop

Optional.

border_drop_shadow_visible

Optional.

hidden

Optional.

max_length

Optional.

color_swatch

  • Class LLColorSwatchCtrl : LLUICtrl : LLView
  • In source file newview/llcolorswatch.cpp
  • Used by floater and panel.

<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="559" min_height="100" min_width="200" mouse_opaque="true"
    name="example_color_swatch" tab_stop="false" title="color_swatch" width="200">
   <color_swatch border_color="0.5 0.5 0.5 1" bottom="-74"
        can_apply_immediately="true" color="1 0 0 1" enabled="true" height="50"
        label="color_swatch label" left="10" mouse_opaque="true" name="colorswatch" tab_stop="true"
        width="150" />
</floater></xml>

Common attributes

  • General: name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group
  • Positioning: width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control
  • Text: label

Special attributes

border_color

Optional.

can_apply_immediately

color

Optional.

combo_box

  • Class LLComboBox : LLUICtrl : LLView
  • In source file llui/llcombobox.cpp
  • Used by floater, panel, and layout_panel.
  • Can contain combo_item.

<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="80" left="550" min_height="80" min_width="250" mouse_opaque="true"
    name="example_combo_box" tab_stop="false" title="combo_box" width="250">
   <combo_box allow_text_entry="false" bottom="20" enabled="true" follows="left|bottom"
        height="20" left="20" max_chars="20" mouse_opaque="true" name="combo_box"
        tab_stop="true" width="200">
       <combo_item type="string" length="1" enabled="true" value="combo_item 1">Item 1</combo_item>
       <combo_item type="string" length="1" enabled="true" value="combo_item 2">Item 2</combo_item>
   </combo_box>
</floater></xml>

Common attributes

  • General: name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group
  • Positioning: width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control
  • Text: label, font, font_size, font_style, halign
  • Others: tab_group

Special attributes

allow_text_entry

Optional.

length

Optional.

max_chars

Optional.

initial_value

Optional.

max_length

Optional.

bg_readonly_color

Optional.

text_readonly_color

Optional.

combo_item

  • member of LLComboBox : LLUICtrl : LLView
  • In source file llui/llcombobox.cpp
  • Used by combo_box.

Common attributes

name

value

Optional.

type

Optional.

length

Optional.

enabled

Optional.

name_list

  • Class LLNameListCtrl : LLScrollListCtrl : LLUICtrl : LLView
  • In source file newview/llnamelistctrl.cpp
  • Used by floater and panel.
  • Can contain column.
  • Can contain row.

<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="160" left="550" min_height="160" min_width="250" mouse_opaque="true"
    name="example_name_list" tab_stop="false" title="name_list" width="250">
   <name_list allow_calling_card_drop="false" background_visible="true" bottom="20"
        column_padding="5" draw_border="true" draw_heading="true"
        draw_stripes="true" enabled="true" follows="left|top" height="100"
        left="20" mouse_opaque="true" multi_select="false" name="name_list"
        tab_stop="true" width="210">
       <column label="column label 1" name="column1" width="100" />
       <column label="column label 2" name="column2" width="100" />
       <row
           name="action_something_1"
           value="Something 1" />
       <row
           name="action_something_2"
           value="Something 2" />
       <row>
           <column column="column1">Text 1</column>
           <column column="column2">Text 2</column>
       </row>
   </name_list>
</floater></xml>

Common attributes

  • General: name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group
  • Positioning: width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control

Special attributes

allow_calling_card_drop

Optional.

background_visible

Optional.

column_padding

Optional.

draw_border

Optional.

draw_heading

Optional.

draw_stripes

Optional.

multi_select

name_column_index

Optional.

heading_font

Optional.

heading_height

Optional.

bg_selected_color

Optional.

fg_selected_color

Optional.

fg_disable_color

Optional.

fg_unselected_color

Optional.

background_opaque

Optional.

bg_alpha_color

Optional.

bg_opaque_color

Optional.

radio_group

  • Class LLRadioGroup : LLUICtrl : LLView
  • In source file llui/llradiogroup.cpp
  • Used by floater and panel.
  • Can contain radio_item.

<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="160" left="550" min_height="160" min_width="250" mouse_opaque="true"
    name="example_radio_group" tab_stop="false" title="radio_group" width="250">
   <radio_group bottom="20" draw_border="true" enabled="true" follows="left|bottom"
        height="100" left="20" mouse_opaque="true" name="radio_group"
        tab_stop="true" width="200">
       <radio_item type="string" length="1" bottom="10" enabled="true" font="SansSerif" height="20"
            initial_value="false" label="radio_item label 1" left="20" mouse_opaque="true" name="radio"
            radio_style="true" tab_stop="false" width="200">
           radio_item 1
       </radio_item>
       <radio_item type="string" length="1" bottom="40" enabled="true" font="SansSerif" height="20"
            initial_value="false" label="radio_item label 2" left="20" mouse_opaque="true" name="radio"
            radio_style="true" tab_stop="false" width="200">
           radio_item 2
       </radio_item>
       <radio_item type="string" length="1" bottom="70" enabled="true" font="SansSerif" height="20"
            initial_value="false" label="radio_item label 3" left="20" mouse_opaque="true" name="radio"
            radio_style="true" tab_stop="false" width="200">
           radio_item 3
       </radio_item>
   </radio_group>
</floater></xml>

Common attributes

  • General: name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group
  • Positioning: width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control
  • Text: label

Special attributes

draw_border

Optional.

text_disabled_color

Optional.

radio_item

  • Class LLRadioItem : LLCheckBoxCtrl : LLUICtrl : LLView
  • In source file llui/llradiogroup.cpp
  • Used by radio_group.

Common attributes

  • General: name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group
  • Positioning: width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control

Special attributes

type

Optional.

length

Optional.

scroll_list

  • Class LLScrollListCtrl : LLUICtrl : LLView
  • In source file llui/llscrolllist.cpp
  • Used by floater, panel, layout_stack, and layout_panel.
  • Can contain column.
  • Can contain row.

<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="160" left="550" min_height="160" min_width="250" mouse_opaque="true"
    name="example_scroll_list" tab_stop="false" title="scroll_list" width="250">
   <scroll_list allow_calling_card_drop="false" background_visible="true" bottom="20"
        column_padding="5" draw_border="true" draw_heading="true"
        draw_stripes="true" enabled="true" follows="left|top" height="100"
        left="20" mouse_opaque="true" multi_select="false" name="scroll_list"
        tab_stop="true" width="210">
       <column label="column label 1" name="column1" width="100" />
       <column label="column label 2" name="column2" width="100" />
       <row
           name="action_something_1"
           value="Something 1" />
       <row
           name="action_something_2"
           value="Something 2" />
       <row>
           <column column="column1">Text 1</column>
           <column column="column2">Text 2</column>
       </row>
   </scroll_list>
</floater></xml>

Common attributes

  • General: name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group
  • Positioning: width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control
  • Text: font, font_size, font_style
  • Others: tab_group

Special attributes

can_resize

Optional.

column_padding

Optional.

column_widths

Optional.

draw_heading

Optional.

draw_stripes

Optional.

draw_border

Optional.

multi_select

Optional.

search_column

Optional.

sort_column

Optional.

background_visible

Optional.

bg_selected_color

Optional.

fg_disable_color

Optional.

fg_selected_color

Optional.

fg_unselected_color

Optional.

heading_font

Optional.

heading_height

Optional.

allow_calling_card_drop

Optional.

tab_stop

Optional.

user_resize

Optional.

sort_ascending

Optional.

column

  • member of LLNameListCtrl : LLScrollListCtrl : LLUICtrl : LLView
  • In source file newview/llnamelistctrl.cpp
  • Used by name_list and scroll_list.

Attributes

name

label

Optional.

sort

Optional.

width

Optional.

dynamicwidth

Optional.

relwidth

Optional.

image

Optional.

tool_tip

Optional.

user_resize

Optional.

texture_picker

  • Class LLTextureCtrl : LLUICtrl : LLView
  • In source file newview/lltexturectrl.cpp
  • Used by floater and panel.

<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="200" mouse_opaque="true"
    name="example_texture_picker" tab_stop="false" title="texture_picker"
    width="250">
   <texture_picker allow_no_texture="false" bottom="20" can_apply_immediately="false"
        default_image_name="Default" enabled="true" height="130"
        label="texture_picker label" left="20" mouse_opaque="true"
        name="texture_picker" tab_stop="true" width="130" />
</floater></xml>

Common attributes

  • General: name, mouse_opaque, tool_tip, control_name, enabled, visible, use_bounding_rect, default_tab_group
  • Positioning: width, height, left, right, left_delta, bottom, top, bottom_delta, follows, rect_control
  • Text: label

Special attributes

allow_no_texture

Optional.

can_apply_immediately

Optional.

default_image_name

Optional.