Skinning HowTo/XUI Selection Widgets

XUI Reference

• Basics
• Common attributes
• Menus
• Containers
• Buttons, Sliders, and Spinners
• Selection Widgets
• Text Entry Widgets
• Other Widgets

Overview

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 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 XML parameters.

check_box parameters

• 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 parameters

• 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

Specific parameters

initial_value

Optional.

radio_style

Optional.

tab_stop

Optional.

border_drop_shadow_visible

Optional.

hidden

Optional.

max_length

Optional.

color_swatch parameters

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

<?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>

Common parameters

• 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

Specific parameters

border_color

Optional.

color

Optional.

combo_box parameters

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

<?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>

Common parameters

• 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

Specific parameters

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 parameters

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

Common parameters

value

Optional.

type

Optional.

length

Optional.

enabled

Optional.

name_list parameters

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

<?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="column 1" width="100" />
       <column label="column label 2" name="column 2" width="100" />
   </name_list>
</floater>

Common parameters

• 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

Specific parameters

allow_calling_card_drop

Optional.

background_visible

Optional.

column_padding

Optional.

draw_border

Optional.

draw_heading

Optional.

draw_stripes

Optional.

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.

column parameters

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

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
• In source file llui/llradiogroup.cpp
• Used by floater and panel.
• Can contain radio_item.

<?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>

Common parameters

• 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

Specific parameters

draw_border

Optional.

text_disabled_color

Optional.

radio_item parameters

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

Common parameters

• 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

Specific parameters

type

Optional.

length

Optional.

scroll_list parameters

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

<?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="column 1" width="100" />
       <column label="column label 2" name="column 2" width="100" />
   </scroll_list>
</floater>

Common parameters

• 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

Specific parameters

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 parameters

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

label

Optional.

sort

Optional.

width

Optional.

dynamicwidth

Optional.

relwidth

Optional.

image

Optional.

tool_tip

Optional.

user_resize

Optional.

texture_picker parameters

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

<?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>

Common parameters

• 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

Specific parameters

allow_no_texture

Optional.

can_apply_immediately

Optional.

default_image_name

Optional.