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

Revision as of 15:17, 24 May 2010

XUI Reference

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

check_box

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

<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

Specific 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.

<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

Specific 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.

<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

Specific 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.

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

Specific 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.

column

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

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

<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

Specific 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

Specific 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.

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

Specific 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.

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.

<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

Specific attributes

allow_no_texture

Optional.

can_apply_immediately

Optional.

default_image_name

Optional.