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

From Second Life Wiki
Jump to: navigation, search
(Widget Parameters)
(Widget Parameters)
Line 80: Line 80:
 
----
 
----
 
===== can_close =====
 
===== can_close =====
 +
''Optional.''
 
===== can_drag_on_left =====
 
===== can_drag_on_left =====
 +
''Optional.''
 
===== can_minimize =====
 
===== can_minimize =====
 +
''Optional.''
 
===== can_resize =====
 
===== can_resize =====
''Required.''
 
 
===== height =====
 
===== height =====
 +
''Optional.''
 
===== width =====
 
===== width =====
 +
''Optional.''
 
===== max_height =====
 
===== max_height =====
 +
''Optional.''
 
===== min_height =====
 
===== min_height =====
 +
''Optional.''
 
===== min_width =====
 
===== min_width =====
 +
''Optional.''
 
===== name =====
 
===== name =====
''Required.''
 
 
===== rect_control =====
 
===== rect_control =====
 +
''Optional.''
 
===== title =====
 
===== title =====
 +
''Optional.''
 
===== bottom =====
 
===== bottom =====
 +
''Optional.''
 
===== left =====
 
===== left =====
 +
''Optional.''
 
===== can_tear_off =====
 
===== can_tear_off =====
 +
''Optional.''
 
===== enabled =====
 
===== enabled =====
 +
''Optional.''
 
===== mouse_opaque =====
 
===== mouse_opaque =====
 +
''Optional.''
 
===== control_name =====
 
===== control_name =====
 +
''Optional.''
 
===== follows =====
 
===== follows =====
 +
''Optional.''
 
===== border =====
 
===== border =====
 +
''Optional.''
 
===== default_tab_group =====
 
===== default_tab_group =====
 +
''Optional.''
 
===== label =====
 
===== label =====
 +
''Optional.''
 
===== border_drop_shadow_visible =====
 
===== border_drop_shadow_visible =====
 +
''Optional.''
 
===== border_visible =====
 
===== border_visible =====
 +
''Optional.''
 
===== border_style =====
 
===== border_style =====
 +
''Optional.''
 
===== border_thickness =====
 
===== border_thickness =====
 +
''Optional.''
 
===== border_bevel =====
 
===== border_bevel =====
 +
''Optional.''
 
===== bevel_style =====
 
===== bevel_style =====
 +
''Optional.''
 
===== short_title =====
 
===== short_title =====
 +
''Optional.''
 
===== sound_flags =====
 
===== sound_flags =====
 +
''Optional.''
  
 
=== multi_floater parameters ===
 
=== multi_floater parameters ===
 
----
 
----
 
===== can_close =====
 
===== can_close =====
''Required.''
 
 
===== can_drag_on_left =====
 
===== can_drag_on_left =====
''Required.''
 
 
===== can_minimize =====
 
===== can_minimize =====
''Required.''
 
 
===== can_resize =====
 
===== can_resize =====
''Required.''
 
 
===== height =====
 
===== height =====
''Required.''
 
 
===== width =====
 
===== width =====
''Required.''
 
 
===== min_height =====
 
===== min_height =====
 +
''Optional.''
 
===== min_width =====
 
===== min_width =====
 +
''Optional.''
 
===== name =====
 
===== name =====
''Required.''
 
 
===== rect_control =====
 
===== rect_control =====
''Required.''
 
 
===== title =====
 
===== title =====
''Required.''
 
 
===== bottom =====
 
===== bottom =====
 +
''Optional.''
 
===== left =====
 
===== left =====
 +
''Optional.''
 
===== enabled =====
 
===== enabled =====
 +
''Optional.''
 
===== follows =====
 
===== follows =====
 +
''Optional.''
 
===== mouse_opaque =====
 
===== mouse_opaque =====
 +
''Optional.''
 
===== title_bar =====
 
===== title_bar =====
 +
''Optional.''
  
 
=== panel parameters ===
 
=== panel parameters ===
 
----
 
----
 
===== border =====
 
===== border =====
 +
''Optional.''
 
===== bottom =====
 
===== bottom =====
 +
''Optional.''
 
===== bottom_delta =====
 
===== bottom_delta =====
 +
''Optional.''
 
===== top =====
 
===== top =====
 +
''Optional.''
 
===== left =====
 
===== left =====
 +
''Optional.''
 
===== left_delta =====
 
===== left_delta =====
 +
''Optional.''
 
===== right =====
 
===== right =====
 +
''Optional.''
 
===== enabled =====
 
===== enabled =====
 +
''Optional.''
 
===== follows =====
 
===== follows =====
 +
''Optional.''
 
===== height =====
 
===== height =====
 +
''Optional.''
 
===== width =====
 
===== width =====
 +
''Optional.''
 
===== label =====
 
===== label =====
 +
''Optional.''
 
===== mouse_opaque =====
 
===== mouse_opaque =====
 +
''Optional.''
 
===== name =====  
 
===== name =====  
 +
''Optional.''
 
===== background_opaque =====
 
===== background_opaque =====
 +
''Optional.''
 
===== background_visible =====
 
===== background_visible =====
 +
''Optional.''
 
===== bevel_style =====
 
===== bevel_style =====
 +
''Optional.''
 
===== bg_alpha_color =====
 
===== bg_alpha_color =====
 +
''Optional.''
 
===== bg_opaque_color =====
 
===== bg_opaque_color =====
 +
''Optional.''
 
===== can_resize =====
 
===== can_resize =====
 +
''Optional.''
 
===== filename =====
 
===== filename =====
 +
''Optional.''
 
===== tab_group =====
 
===== tab_group =====
 +
''Optional.''
 
===== default_tab_group =====
 
===== default_tab_group =====
 +
''Optional.''
 
===== placeholder =====
 
===== placeholder =====
 +
''Optional.''
 
===== border_drop_shadow_visible =====
 
===== border_drop_shadow_visible =====
 +
''Optional.''
 
===== border_visible =====
 
===== border_visible =====
 +
''Optional.''
 
===== border_style =====
 
===== border_style =====
 +
''Optional.''
 
===== border_thickness =====
 
===== border_thickness =====
 +
''Optional.''
 
===== border_color =====
 
===== border_color =====
 +
''Optional.''
 
===== tool_tip =====
 
===== tool_tip =====
 +
''Optional.''
 
===== title =====
 
===== title =====
 +
''Optional.''
 
===== auto_resize =====
 
===== auto_resize =====
 +
''Optional.''
 
===== user_resize =====
 
===== user_resize =====
 +
''Optional.''
 
===== use_bounding_rect =====
 
===== use_bounding_rect =====
 +
''Optional.''
 
===== bg_visible =====
 
===== bg_visible =====
 +
''Optional.''
 
===== can_close =====
 
===== can_close =====
 +
''Optional.''
 
===== can_minimize =====
 
===== can_minimize =====
 +
''Optional.''
 
===== left_in_finder =====
 
===== left_in_finder =====
 +
''Optional.''
 
===== select =====
 
===== select =====
 +
''Optional.''
 
===== visible =====
 
===== visible =====
 +
''Optional.''
  
 
=== menu parameters ===
 
=== menu parameters ===
 
----
 
----
 
===== bottom_delta =====
 
===== bottom_delta =====
 +
''Optional.''
 
===== bottom =====
 
===== bottom =====
 +
''Optional.''
 
===== left =====
 
===== left =====
 +
''Optional.''
 
===== drop_shadow =====
 
===== drop_shadow =====
 +
''Optional.''
 
===== height =====
 
===== height =====
 +
''Optional.''
 
===== width =====
 
===== width =====
 +
''Optional.''
 
===== label =====
 
===== label =====
 +
''Optional.''
 
===== mouse_opaque =====
 
===== mouse_opaque =====
 
===== opaque =====
 
===== opaque =====
 
===== name =====
 
===== name =====
 
===== tear_off =====
 
===== tear_off =====
 +
''Optional.''
 
===== enabled =====
 
===== enabled =====
 +
''Optional.''
 
===== color =====
 
===== color =====
 +
''Optional.''
 
===== create_jump_keys =====
 
===== create_jump_keys =====
 +
''Optional.''
 
===== visible =====
 
===== visible =====
 +
''Optional.''
 
===== hidden =====
 
===== hidden =====
 +
''Optional.''
  
 
=== menu_bar parameters ===
 
=== menu_bar parameters ===
Line 215: Line 293:
 
===== name =====
 
===== name =====
 
===== enabled =====
 
===== enabled =====
 +
''Optional.''
 
===== tear_off =====
 
===== tear_off =====
 +
''Optional.''
  
  
Line 222: Line 302:
 
===== name =====
 
===== name =====
 
===== label =====
 
===== label =====
 +
''Optional.''
 
===== enabled =====
 
===== enabled =====
 +
''Optional.''
  
 
=== mimetypes parameters ===
 
=== mimetypes parameters ===
Line 236: Line 318:
  
 
===== bottom =====
 
===== bottom =====
 +
''Optional.''
 
===== bottom_delta =====
 
===== bottom_delta =====
 +
''Optional.''
 
===== top =====
 
===== top =====
 +
''Optional.''
 
===== left =====
 
===== left =====
 +
''Optional.''
 
===== left_delta =====
 
===== left_delta =====
 +
''Optional.''
 
===== right =====
 
===== right =====
 +
''Optional.''
 
===== follows =====
 
===== follows =====
 +
''Optional.''
 
===== name =====
 
===== name =====
 +
''Optional.''
 
===== color =====
 
===== color =====
 +
''Optional.''
 
===== enabled =====
 
===== enabled =====
 +
''Optional.''
 
===== height =====
 
===== height =====
 +
''Optional.''
 
===== width =====
 
===== width =====
 +
''Optional.''
 
===== mouse_opaque =====
 
===== mouse_opaque =====
 +
''Optional.''
 
===== bg_alpha_color =====
 
===== bg_alpha_color =====
 +
''Optional.''
 
===== border =====
 
===== border =====
 +
''Optional.''
 
===== scale_image =====
 
===== scale_image =====
 +
''Optional.''
 
===== auto_resize =====
 
===== auto_resize =====
 +
''Optional.''
 
===== visible =====
 
===== visible =====
 +
''Optional.''
 
===== label =====
 
===== label =====
 +
''Optional.''
 
===== tool_tip =====
 
===== tool_tip =====
 +
''Optional.''
  
 
=== button parameters ===
 
=== button parameters ===
Line 337: Line 439:
  
 
===== bottom =====
 
===== bottom =====
 +
''Optional.''
 
===== bottom_delta =====
 
===== bottom_delta =====
 +
''Optional.''
 
===== left =====
 
===== left =====
 +
''Optional.''
 
===== left_delta =====
 
===== left_delta =====
 +
''Optional.''
 
===== right =====
 
===== right =====
 +
''Optional.''
 
===== enabled =====
 
===== enabled =====
 +
''Optional.''
 
===== follows =====
 
===== follows =====
 +
''Optional.''
 
===== height =====
 
===== height =====
 +
''Optional.''
 
===== width =====
 
===== width =====
 +
''Optional.''
 
===== mouse_opaque =====
 
===== mouse_opaque =====
 +
''Optional.''
 
===== name =====
 
===== name =====
 
===== tool_tip =====
 
===== tool_tip =====
 +
''Optional.''
 
===== visible =====
 
===== visible =====
 +
''Optional.''
 
===== tab_group =====
 
===== tab_group =====
 +
''Optional.''
 
===== pad_right =====
 
===== pad_right =====
 +
''Optional.''
 
===== hidden =====
 
===== hidden =====
 +
''Optional.''
 
===== tab_stop =====
 
===== tab_stop =====
 +
''Optional.''
 
===== help_url =====
 
===== help_url =====
 +
''Optional.''
 
===== sound_flags =====
 
===== sound_flags =====
 +
''Optional.''
 
===== auto_resize =====
 
===== auto_resize =====
 +
''Optional.''
 
===== user_resize =====
 
===== user_resize =====
 +
''Optional.''
 
===== valign =====
 
===== valign =====
 +
''Optional.''
 
===== default =====
 
===== default =====
 +
''Optional.''
 
===== index =====
 
===== index =====
 +
''Optional.''
 
===== text =====
 
===== text =====
 +
''Optional.''
 
===== ignore =====
 
===== ignore =====
 +
''Optional.''
 
===== control_name =====
 
===== control_name =====
 +
''Optional.''
 
===== label_width =====
 
===== label_width =====
 +
''Optional.''
 
===== image =====
 
===== image =====
 +
''Optional.''
 
   
 
   
 
=== text_editor parameters ===
 
=== text_editor parameters ===
Line 386: Line 516:
 
<line_editor> creates a single line text box
 
<line_editor> creates a single line text box
 
===== label =====
 
===== label =====
 +
''Optional.''
 
===== max_length =====
 
===== max_length =====
 +
''Optional.''
 
===== font =====
 
===== font =====
 +
''Optional.''
 
===== bevel_style =====
 
===== bevel_style =====
 +
''Optional.''
 
* none
 
* none
 
* in  
 
* in  
Line 396: Line 530:
 
* texture  
 
* texture  
 
===== border_style =====
 
===== border_style =====
 +
''Optional.''
 
===== border_thickness =====
 
===== border_thickness =====
 +
''Optional.''
 
===== select_on_focus =====
 
===== select_on_focus =====
 +
''Optional.''
 
===== select_all_focus_received =====
 
===== select_all_focus_received =====
 +
''Optional.''
 
===== handle_edit_keys_directly =====
 
===== handle_edit_keys_directly =====
 +
''Optional.''
 
===== cursor_color =====
 
===== cursor_color =====
 +
''Optional.''
 
===== text_color =====
 
===== text_color =====
 +
''Optional.''
 
===== text_readonly_color =====
 
===== text_readonly_color =====
 +
''Optional.''
 
===== bg_readonly_color =====
 
===== bg_readonly_color =====
 +
''Optional.''
 
===== bg_writeable_color =====
 
===== bg_writeable_color =====
 +
''Optional.''
 
===== bg_focus_color =====
 
===== bg_focus_color =====
 +
''Optional.''
 
===== bottom =====
 
===== bottom =====
 +
''Optional.''
 
===== left =====
 
===== left =====
 +
''Optional.''
 
===== right =====
 
===== right =====
 +
''Optional.''
 
===== enabled =====
 
===== enabled =====
 +
''Optional.''
 
===== follows =====
 
===== follows =====
 +
''Optional.''
 
===== handle_edit_keys_directly =====
 
===== handle_edit_keys_directly =====
 +
''Optional.''
 
===== height =====
 
===== height =====
 
===== width =====
 
===== width =====
 +
''Optional.''
 
===== mouse_opaque =====
 
===== mouse_opaque =====
 +
''Optional.''
 
===== name =====
 
===== name =====
 
===== bottom_delta =====
 
===== bottom_delta =====
 +
''Optional.''
 
===== tool_tip =====
 
===== tool_tip =====
 +
''Optional.''
 
===== left_delta =====
 
===== left_delta =====
 +
''Optional.''
 
===== tab_group =====
 
===== tab_group =====
 +
''Optional.''
 
===== commit_on_focus_lost =====
 
===== commit_on_focus_lost =====
 +
''Optional.''
 
===== hidden =====
 
===== hidden =====
 +
''Optional.''
 
===== is_unicode =====
 
===== is_unicode =====
 +
''Optional.''
 
===== increment =====
 
===== increment =====
 +
''Optional.''
 
===== initial_val =====
 
===== initial_val =====
 +
''Optional.''
 
===== max_val =====
 
===== max_val =====
 +
''Optional.''
 
===== min_val =====
 
===== min_val =====
 +
''Optional.''
 
===== visible =====
 
===== visible =====
 +
''Optional.''
 
===== bg_visible =====
 
===== bg_visible =====
 +
''Optional.''
 
===== border_drop_shadow_visible =====
 
===== border_drop_shadow_visible =====
 +
''Optional.''
 
===== border_visible =====
 
===== border_visible =====
 +
''Optional.''
 
===== drop_shadow_visible =====
 
===== drop_shadow_visible =====
 +
''Optional.''
 
===== h_pad =====
 
===== h_pad =====
 +
''Optional.''
 
===== halign =====
 
===== halign =====
 +
''Optional.''
 
===== prevalidate =====
 
===== prevalidate =====
 +
''Optional.''
 
===== v_pad =====
 
===== v_pad =====
 +
''Optional.''
 
===== word_wrap =====
 
===== word_wrap =====
 +
''Optional.''
 
===== control_name =====
 
===== control_name =====
 +
''Optional.''
  
 
=== string parameters ===
 
=== string parameters ===
Line 443: Line 618:
 
===== name =====
 
===== name =====
 
===== word_wrap =====
 
===== word_wrap =====
 +
''Optional.''
  
 
=== tab_container parameters ===
 
=== tab_container parameters ===
 
----
 
----
 
===== enabled =====
 
===== enabled =====
 +
''Optional.''
 
===== follows =====
 
===== follows =====
 +
''Optional.''
 
===== height =====
 
===== height =====
 +
''Optional.''
 
===== left =====
 
===== left =====
 
===== right =====
 
===== right =====
 +
''Optional.''
 
===== top =====
 
===== top =====
 +
''Optional.''
 
===== bottom =====
 
===== bottom =====
 +
''Optional.''
 
===== bottom_delta =====
 
===== bottom_delta =====
 +
''Optional.''
 
===== mouse_opaque =====
 
===== mouse_opaque =====
 +
''Optional.''
 
===== name =====
 
===== name =====
 
===== tab_position =====
 
===== tab_position =====
 
===== width =====
 
===== width =====
 +
''Optional.''
 
===== tab_width =====
 
===== tab_width =====
 +
''Optional.''
 
===== tab_min_width =====
 
===== tab_min_width =====
 +
''Optional.''
 
===== tab_max_width =====
 
===== tab_max_width =====
 +
''Optional.''
 
===== border =====  
 
===== border =====  
 +
''Optional.''
 
===== tab_group =====
 
===== tab_group =====
 +
''Optional.''
 
===== hide_tabs =====
 
===== hide_tabs =====
 +
''Optional.''
  
  
Line 471: Line 662:
 
----
 
----
 
===== type =====
 
===== type =====
 +
''Optional.''
 
===== length =====
 
===== length =====
 +
''Optional.''
 
===== width =====
 
===== width =====
 +
''Optional.''
 
===== height =====
 
===== height =====
 +
''Optional.''
 
===== bg_visible =====
 
===== bg_visible =====
 +
''Optional.''
 
===== border_drop_shadow_visible =====
 
===== border_drop_shadow_visible =====
 +
''Optional.''
 
===== drop_shadow_visible =====
 
===== drop_shadow_visible =====
 +
''Optional.''
 
===== border_visible =====
 
===== border_visible =====
 +
''Optional.''
 
===== bottom =====
 
===== bottom =====
 +
''Optional.''
 
===== bottom_delta =====
 
===== bottom_delta =====
 +
''Optional.''
 
===== top =====
 
===== top =====
 +
''Optional.''
 
===== left =====
 
===== left =====
 +
''Optional.''
 
===== left_delta =====
 
===== left_delta =====
 +
''Optional.''
 
===== right =====
 
===== right =====
 +
''Optional.''
 
===== enabled =====
 
===== enabled =====
 +
''Optional.''
 
===== follows =====
 
===== follows =====
 +
''Optional.''
 
===== font =====
 
===== font =====
 +
''Optional.''
 
===== h_pad =====
 
===== h_pad =====
 +
''Optional.''
 
===== halign =====
 
===== halign =====
 +
''Optional.''
 
===== v_pad =====
 
===== v_pad =====
 +
''Optional.''
 
===== valign =====
 
===== valign =====
 +
''Optional.''
 
===== mouse_opaque =====
 
===== mouse_opaque =====
 +
''Optional.''
 
===== name =====
 
===== name =====
 +
''Optional.''
 
===== visible =====
 
===== visible =====
 +
''Optional.''
 
===== hidden =====
 
===== hidden =====
 +
''Optional.''
 
===== tool_tip =====
 
===== tool_tip =====
 +
''Optional.''
 
===== tab_stop =====
 
===== tab_stop =====
 +
''Optional.''
 
===== initial_value =====
 
===== initial_value =====
 +
''Optional.''
 
===== label =====
 
===== label =====
 +
''Optional.''
 
===== radio_style =====
 
===== radio_style =====
 +
''Optional.''
 
===== word_wrap =====
 
===== word_wrap =====
 +
''Optional.''
 
===== control_name =====
 
===== control_name =====
 +
''Optional.''
 
===== font_size =====
 
===== font_size =====
 +
''Optional.''
 
===== font_style =====
 
===== font_style =====
 +
''Optional.''
 
===== font-style =====
 
===== font-style =====
 +
''Optional.''
 
===== bevel_style =====
 
===== bevel_style =====
 +
''Optional.''
 
===== border_style =====
 
===== border_style =====
 +
''Optional.''
 
===== border_thickness =====
 
===== border_thickness =====
 +
''Optional.''
 
===== is_unicode =====
 
===== is_unicode =====
 +
''Optional.''
 
===== max_length =====  
 
===== max_length =====  
 +
''Optional.''
 
===== hover =====
 
===== hover =====
 +
''Optional.''
 
===== hover_cursor =====
 
===== hover_cursor =====
 +
''Optional.''
 
===== hover_color =====
 
===== hover_color =====
 +
''Optional.''
 
===== text_color =====
 
===== text_color =====
 +
''Optional.''
 
===== align =====
 
===== align =====
 +
''Optional.''
 
===== text_wrap =====
 
===== text_wrap =====
 +
''Optional.''
 
===== text_enabled_color =====
 
===== text_enabled_color =====
 +
''Optional.''
 
===== allow_html =====
 
===== allow_html =====
 +
''Optional.''
 
===== bg_readonly_color =====
 
===== bg_readonly_color =====
 +
''Optional.''
 
===== embedded_items =====
 
===== embedded_items =====
 +
''Optional.''
 
===== hide_border =====
 
===== hide_border =====
 +
''Optional.''
 
===== hide_scrollbar =====
 
===== hide_scrollbar =====
 +
''Optional.''
 
===== line_spacing =====
 
===== line_spacing =====
 +
''Optional.''
 
===== disabled_color =====
 
===== disabled_color =====
 +
''Optional.''
  
 
=== message parameters ===
 
=== message parameters ===
Line 590: Line 835:
 
----
 
----
 
===== name =====
 
===== name =====
 +
''Optional.''
  
 
=== url parameters ===
 
=== url parameters ===

Revision as of 13:07, 12 June 2009

These are the XML elements and parameters used to define 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. See Skinning HowTo/Basics for an explanation of how these are used.

Contents

Common parameters

The most common parameters are described here and are just listed under the elements that use them.

name

Required. The XML name of this element. The name must be unique to the floater you are editing.

  • IMPORTANT: As noted above, do not re-name XML elements, even for localization. Many of the element names are looked up by the viewer. If the viewer cannot find an element name it expects, it will crash.

String: name="input_first_name"

width

Required. The width of the element, in pixels.

For text, this defines the visible text as well as the clickable area. If the width of a text element is not sufficient to hold the text, the text will be truncated. This is most likely what you will widen when localizing the viewer.

For most other elements, this describes the dimensions of an element, such as a button, icon, panel, text_area, etc.

  • Tip: See the bounding boxes of all XML elements in the viewer: Advanced menu > UI > Debug Views.

Integer: width="140"

height

Required. The height of the element, in pixels.

For text, this defines the visible text as well as the clickable area. If the height of a text element is not sufficient to hold the text, the text will be truncated. This is most likely what you will lengthen when localizing the viewer.

For most other elements, this describes the dimensions of an element, such as a button, icon, panel, text_area, etc.

Integer: height="24"

left

Optional. Sets the position in the x dimension of the element's left edge relative to the container's left edge. Positive and negative values are accepted. A negative value will set the position relative to the right edge of the container.

Integer: left="6"

right

Optional. Sets the position in the x dimension of the element's right edge relative to the container's left edge. Positive and negative values are accepted. A negative value will set the position relative to the right edge of the container. Best used to align something to the right.

  • For example, given a floater with a width of 500 and a button we wish to right align in the floater, we can set the right to 490 -- this puts the right edge of the button 10 pixels away from the right border of the floater.

Integer: right="6"

left_delta

Optional. (use instead of left) Sets the position in the x dimension of the element's left edge relative to the previous element, or, for the first widget, the left edge of the container. Positive and negative values are accepted. Best used to left-align the current element with the previous element.

  • For example, given Button B with a width of 100, a previous Button A with a width of 50 and a distance between elements of 6, we would set the left_delta to -106, putting the left edge of Button B 106 pixels to the left of Button A. We use a negative number to move left, and a positive number to move right.

Integer: left_delta="-106"

right_delta

Optional. (use instead of right) Sets the position in the x dimension of the element's right edge relative to the previous element, or, for the first widget, the left edge of the container. Positive and negative values are accepted. Best used to right-align the current element with the previous element.

  • For example, given Button B with a width of 100, a previous Button A with a width of 50 and a distance between elements of 6, we would set the right_delta to 106, putting the left edge of Button B 106 pixels to the left of Button A.

Integer: left_delta="106"

bottom

Optional. Sets the position in the y dimension of the element's bottom edge relative to the container. Positive and negative values are accepted. For example, given a floater with a height of 300 and a title 20 pixels tall and we want , we can set the bottom to (NEED TO DO MATH, LOL) -- putting the bottom edge of the title 40 pixels away from the top border of the floater.

Integer: bottom="(NEED TO DO MATH, LOL)"

bottom_delta
follows

Optional. Sets which edge(s) an element follows when the containing element is resized. Specifying all edges results in an element that can dynamically resize itself with its container.

Values: left, top, right, bottom. String multiple values together using pipes.

The following example sets an element to follow both the left and the top, such as a floater's title may be designed: String: follows="left|top"

font

Optional. Sets which size and style of the application font to use. The default is SansSerifSmall for text elements and SansSerif for controls (such as check_box and button.

Values: SansSerifSmall, SansSerif, SansSerifBig, SansSerifBold, Monospace

String: font="SansSerifSmall"

Widget Parameters

floater parameters


can_close

Optional.

can_drag_on_left

Optional.

can_minimize

Optional.

can_resize
height

Optional.

width

Optional.

max_height

Optional.

min_height

Optional.

min_width

Optional.

name
rect_control

Optional.

title

Optional.

bottom

Optional.

left

Optional.

can_tear_off

Optional.

enabled

Optional.

mouse_opaque

Optional.

control_name

Optional.

follows

Optional.

border

Optional.

default_tab_group

Optional.

label

Optional.

border_drop_shadow_visible

Optional.

border_visible

Optional.

border_style

Optional.

border_thickness

Optional.

border_bevel

Optional.

bevel_style

Optional.

short_title

Optional.

sound_flags

Optional.

multi_floater parameters


can_close
can_drag_on_left
can_minimize
can_resize
height
width
min_height

Optional.

min_width

Optional.

name
rect_control
title
bottom

Optional.

left

Optional.

enabled

Optional.

follows

Optional.

mouse_opaque

Optional.

title_bar

Optional.

panel parameters


border

Optional.

bottom

Optional.

bottom_delta

Optional.

top

Optional.

left

Optional.

left_delta

Optional.

right

Optional.

enabled

Optional.

follows

Optional.

height

Optional.

width

Optional.

label

Optional.

mouse_opaque

Optional.

name

Optional.

background_opaque

Optional.

background_visible

Optional.

bevel_style

Optional.

bg_alpha_color

Optional.

bg_opaque_color

Optional.

can_resize

Optional.

filename

Optional.

tab_group

Optional.

default_tab_group

Optional.

placeholder

Optional.

border_drop_shadow_visible

Optional.

border_visible

Optional.

border_style

Optional.

border_thickness

Optional.

border_color

Optional.

tool_tip

Optional.

title

Optional.

auto_resize

Optional.

user_resize

Optional.

use_bounding_rect

Optional.

bg_visible

Optional.

can_close

Optional.

can_minimize

Optional.

left_in_finder

Optional.

select

Optional.

visible

Optional.

menu parameters


bottom_delta

Optional.

bottom

Optional.

left

Optional.

drop_shadow

Optional.

height

Optional.

width

Optional.

label

Optional.

mouse_opaque
opaque
name
tear_off

Optional.

enabled

Optional.

color

Optional.

create_jump_keys

Optional.

visible

Optional.

hidden

Optional.

menu_bar parameters


bottom
left
drop_shadow
follows
height
width
mouse_opaque
opaque
name
enabled

Optional.

tear_off

Optional.


pie_menu parameters


name
label

Optional.

enabled

Optional.

mimetypes parameters


name

icon parameters


image_name

Required. Specifies the name of the image to load for this icon.

String: image_name="myicon.png"

bottom

Optional.

bottom_delta

Optional.

top

Optional.

left

Optional.

left_delta

Optional.

right

Optional.

follows

Optional.

name

Optional.

color

Optional.

enabled

Optional.

height

Optional.

width

Optional.

mouse_opaque

Optional.

bg_alpha_color

Optional.

border

Optional.

scale_image

Optional.

auto_resize

Optional.

visible

Optional.

label

Optional.

tool_tip

Optional.

button parameters


scale_image

Optional. Specifies whether to scale the button art as its container/floater is resized. As of 1.18.x, all button art has this property set to true where the button size is not equal to 32x128.

Boolean: scale_image="true"

label

Optional. Label is the text on the button's face. Without a specified label (and no image_overlay declared), your button will be labeled "Button". String: label="Click Me!"

label_selected

Optional. Label is the text on the button's face when pressed into an 'on' state. Your button will inherit the label if you omit this property. String: label_selected="I've been clicked."

font

(under construction)

font_style

Optional. Styles the text. Allows multiple style selections. As of 1.18.x, the style options are:

  • normal: Apply the default styles of the selected font. (For example, SansSerifBold has a default bold style applied to it.)
  • bold: Bolds the text.
  • italic: Italicizes the text.
  • underline: Underlines the text.
  • drop_shadow: Old-style 1px offset of black under the text.
  • drop_shadow_soft: New-style 3px offset of blurred shadow under the text.

String: font_style="bold|underline|drop_shadow_soft"

halign

Optional. Controls horizontal alignment of label on button face. Options are "left", "center" and "right".

image_unselected

Optional. Overrides the default button art for the unselected/up and enabled button state. Art must be located in the ..\skins\textures directory within the Second Life application folder (on a Mac, this is inside the package at Contents/MacOS/Resources/skins/textures). Art must also be named in textures.xml with an assigned UUID. By default, the button art is stretched to fit the specified button size.

String: image_unselected="btn_square_32x128.tga"

image_selected

Optional. Overrides the default button art for the selected/down button state. Art must be located in the ..\skins\[SKIN]\textures directory within the Second Life application folder (on a Mac, this is inside the package at Contents/MacOS/Resources/skins/textures). By default, the button art is stretched to fit the specified button size.

String: image_selected="btn_square-down_32x128.tga"

image_hover_selected

Optional. Overrides the default button art for the selected/down and mouseover/hover button state. Art must be located in the ..\skins\textures directory within the Second Life application folder (on a Mac, this is inside the package at Contents/MacOS/Resources/skins/[SKIN]/textures). Art must also be named in textures.xml with an assigned UUID. By default, the button art is stretched to fit the specified button size.

String: image_unselected="btn_square-down-hover_32x128.tga"

image_hover_unselected

Optional. Overrides the default button art for the unselected/up and mouseover/hover button state. Art must be located in the ..\skins\[SKIN]\textures directory within the Second Life application folder (on a Mac, this is inside the package at Contents/MacOS/Resources/skins/[SKIN]/textures). Art must also be named in textures.xml with an assigned UUID. By default, the button art is stretched to fit the specified button size.

String: image_unselected="btn_square-up-hover_32x128.tga"

image_disabled

Optional. Overrides the default button art for the disabled button state. Art must be located in the ..\skins\textures directory within the Second Life application folder (on a Mac, this is inside the package at Contents/MacOS/Resources/skins/[SKIN]/textures). Art must also be named in textures.xml with an assigned UUID. By default, the button art is stretched to fit the specified button size.

String: image_unselected="btn_square-disabled_32x128.tga"

image_disabled_selected

Optional. Overrides the default button art for the disabled and selected/down button state. Art must be located in the ..\skins\[SKIN]\textures directory within the Second Life application folder (on a Mac, this is inside the package at Contents/MacOS/Resources/skins/textures). Art must also be named in textures.xml with an assigned UUID. By default, the button art is stretched to fit the specified button size.

String: image_unselected="btn_square-down-disabled_32x128.tga"

image_overlay

Optional. Applies an overlay image to the button. The button art will be sized to fit. As of 1.18.x, these icons should be 16 pixels high at maximum on a standard height 24px button to minimize scaling artifacts. Can be used with or without text. Art must be located in the ..\skins\[SKIN]\textures directory within the Second Life application folder (on a Mac, this is inside the package at Contents/MacOS/Resources/skins/[SKIN]/textures). Art must also be named in textures.xml with an assigned UUID. See image_overlay_alignment for alignment options.

String: image_overlay="icn_media-play_16.tga"

image_overlay_alignment

Optional. Sets the alignment of the image_overlay icon.

Values:

  • left: left-aligns the art on the button. This standard is used for new button art with text in the Dazzle branch.
  • right: right-aligns the the art on the button.
  • center: centers the art on the button. This standard is used for new button art without text in the Dazzle branch.

String: image_overlay_alignment="left"

toggle

Optional. Determines whether the button is a toggle button or not. The Fly/Stop Flying button is a toggle button, for example.

Boolean: toggle="false"

bottom

Optional.

bottom_delta

Optional.

left

Optional.

left_delta

Optional.

right

Optional.

enabled

Optional.

follows

Optional.

height

Optional.

width

Optional.

mouse_opaque

Optional.

name
tool_tip

Optional.

visible

Optional.

tab_group

Optional.

pad_right

Optional.

hidden

Optional.

tab_stop

Optional.

help_url

Optional.

sound_flags

Optional.

auto_resize

Optional.

user_resize

Optional.

valign

Optional.

default

Optional.

index

Optional.

text

Optional.

ignore

Optional.

control_name

Optional.

label_width

Optional.

image

Optional.

text_editor parameters


<text_editor> creates a multi-line text box

max_length
embedded_items
font
word_wrap
hide_scrollbar
cursor_color
text_color
text_readonly_color
bg_readonly_color
bg_writeable_color
bg_focus_color

line_editor parameters


<line_editor> creates a single line text box

label

Optional.

max_length

Optional.

font

Optional.

bevel_style

Optional.

  • none
  • in
  • out
  • bright
  • line
  • texture
border_style

Optional.

border_thickness

Optional.

select_on_focus

Optional.

select_all_focus_received

Optional.

handle_edit_keys_directly

Optional.

cursor_color

Optional.

text_color

Optional.

text_readonly_color

Optional.

bg_readonly_color

Optional.

bg_writeable_color

Optional.

bg_focus_color

Optional.

bottom

Optional.

left

Optional.

right

Optional.

enabled

Optional.

follows

Optional.

handle_edit_keys_directly

Optional.

height
width

Optional.

mouse_opaque

Optional.

name
bottom_delta

Optional.

tool_tip

Optional.

left_delta

Optional.

tab_group

Optional.

commit_on_focus_lost

Optional.

hidden

Optional.

is_unicode

Optional.

increment

Optional.

initial_val

Optional.

max_val

Optional.

min_val

Optional.

visible

Optional.

bg_visible

Optional.

border_drop_shadow_visible

Optional.

border_visible

Optional.

drop_shadow_visible

Optional.

h_pad

Optional.

halign

Optional.

prevalidate

Optional.

v_pad

Optional.

word_wrap

Optional.

control_name

Optional.

string parameters


name
word_wrap

Optional.

tab_container parameters


enabled

Optional.

follows

Optional.

height

Optional.

left
right

Optional.

top

Optional.

bottom

Optional.

bottom_delta

Optional.

mouse_opaque

Optional.

name
tab_position
width

Optional.

tab_width

Optional.

tab_min_width

Optional.

tab_max_width

Optional.

border

Optional.

tab_group

Optional.

hide_tabs

Optional.



text parameters


type

Optional.

length

Optional.

width

Optional.

height

Optional.

bg_visible

Optional.

border_drop_shadow_visible

Optional.

drop_shadow_visible

Optional.

border_visible

Optional.

bottom

Optional.

bottom_delta

Optional.

top

Optional.

left

Optional.

left_delta

Optional.

right

Optional.

enabled

Optional.

follows

Optional.

font

Optional.

h_pad

Optional.

halign

Optional.

v_pad

Optional.

valign

Optional.

mouse_opaque

Optional.

name

Optional.

visible

Optional.

hidden

Optional.

tool_tip

Optional.

tab_stop

Optional.

initial_value

Optional.

label

Optional.

radio_style

Optional.

word_wrap

Optional.

control_name

Optional.

font_size

Optional.

font_style

Optional.

font-style

Optional.

bevel_style

Optional.

border_style

Optional.

border_thickness

Optional.

is_unicode

Optional.

max_length

Optional.

hover

Optional.

hover_cursor

Optional.

hover_color

Optional.

text_color

Optional.

align

Optional.

text_wrap

Optional.

text_enabled_color

Optional.

allow_html

Optional.

bg_readonly_color

Optional.

embedded_items

Optional.

hide_border

Optional.

hide_scrollbar

Optional.

line_spacing

Optional.

disabled_color

Optional.

message parameters


name

message_set parameters


name

action parameters


description
longdescription
name
value

action_set parameters


description
name

progress_bar parameters


name
color
height
bottom
left
right
follows

slider_bar parameters


bottom
enabled
follows
height
width
increment
initial_val
left
max_val
min_val
mouse_opaque
name

locate parameters


bottom_delta
height
left_delta
name
width

context parameters


key

input parameters


name
type

form parameters


name

Optional.

url parameters


option
name

usetemplate parameters


name
yestext
notext
canceltext
ignoretext

notification parameters


functor
icon
name
label
type
priority
sound
duration

ignore parameters


text
name
save_option

template parameters


name

global parameters


name

mimetype parameters


name
menu

scheme parameters


name

playtip parameters


name

tooltip parameters


name

label parameters


name

widgetset parameters


name

on_check parameters


function
userdata
control

on_visible parameters


function

on_enable parameters


function
userdata
name

tearoff_menu parameters


bottom
enabled
height
label
left
mouse_opaque
name
width

font_size parameters


name
comment
size

os parameters


name

font parameters


name
comment
font_style

joystick_turn parameters


bottom
left
enabled
follows
halign
height
width
image_selected
image_unselected
mouse_opaque
name
quadrant
scale_image
tool_tip

joystick_slide parameters


bottom
left
enabled
follows
halign
height
width
image_selected
image_unselected
mouse_opaque
name
quadrant
scale_image
tool_tip

menu_item_check parameters


bottom_delta
bottom
left
control_name
height
width
label
mouse_opaque
name
enabled
shortcut

menu_item_separator parameters


bottom_delta
bottom
left
height
width
label
mouse_opaque
name
enabled

menu_item_call parameters


bottom_delta
bottom
left
height
width
label
mouse_opaque
name
enabled
shortcut
useMacCtrl
visible
hidden

on_click parameters


filter
function
userdata
name

search_editor parameters


bottom
left
follows
height
width
label
mouse_opaque
name
enabled

name_editor parameters


bevel_style
bg_readonly_color
border_style
border_thickness
bottom
left_delta
follows
font
height
width
max_length
mouse_opaque
name
text_readonly_color
enabled
is_unicode

web_browser parameters


bottom
top
left
right
follows
font
name
border_visible
width
height
caret_color
start_url
embedded_items
max_length
mouse_opaque
word_wrap
ignore_ui_scale

view_border parameters


bevel_style
border_thickness
bottom_delta
bottom
left_delta
left
right
follows
height
width
mouse_opaque
name
blevel_style
border

multi_slider parameters


allow_overlap
bottom
left
can_edit_text
control_name
decimal_digits
draw_track
follows
height
width
increment
initial_val
label
max_sliders
max_val
min_val
mouse_opaque
name
show_text
use_triangle
value

scroll_container parameters


bottom
left
follows
height
width
mouse_opaque
opaque
name

color_swatch parameters


border_color
bottom
bottom_delta
left
left_delta
can_apply_immediately
color
height
width
label
mouse_opaque
name
tool_tip
visible
control_name
enabled

radio_item parameters


type
length
height
width
bottom
bottom_delta
left
left_delta
follows
mouse_opaque
name

radio_group parameters


bottom
bottom_delta
left
left_delta
right
control_name
draw_border
follows
height
width
mouse_opaque
name
tool_tip
label
text_disabled_color
enabled
visible
enabled
tool_tip

flyout_button_item parameters


value
name

flyout_button parameters


bottom
bottom_delta
left
left_delta
follows
height
halign
width
label
label_selected
list_position
mouse_opaque
name
tool_tip
font
auto_resize
user_resize
enabled

layout_panel parameters


border
bottom
left
top_delta
default_tab_group
height
min_height
width
min_width
name
auto_resize
can_resize
user_resize
filename
visible
follows
background_visible
mouse_opaque
use_bounding_rect

layout_stack parameters


border
bottom
top
left
right
follows
height
min_height
width
min_width
orientation
name
tab_group
border_size
mouse_opaque
use_bounding_rect

inventory_panel parameters


allow_multi_select
border
bottom
bottom_delta
left
left_delta
follows
height
width
mouse_opaque
name
sort_order
label
enabled

slider parameters


bottom_delta
bottom
left_delta
left
right
follows
height
width
increment
initial_val
label
label_width
max_val
min_val
name
show_text
control_name
decimal_digits
can_edit_text
enabled
mouse_opaque
value
tool_tip
volume
edit_text

pad parameters


height
width
bottom
left

volume_ slider parameters


bottom
bottom_delta
left
left_delta
follows
height
width
increment
initial_val
max_val
min_val
name
mouse_opaque
hidden
enabled
tool_tip
control_name

scroll_list parameters


bottom
bottom_delta
top
left
right
can_resize
column_padding
column_widths
draw_heading
draw_stripes
draw_border
follows
multi_select
name
search_column
sort_column
background_visible
height
width
mouse_opaque
enabled
tab_group
bg_selected_color
fg_disable_color
fg_selected_color
fg_unselected_color
tool_tip
font
heading_font
heading_height
allow_calling_card_drop
tab_stop
user_resize
sort_ascending

spinner parameters


bottom
bottom_delta
left
left_delta
right_delta
decimal_digits
enabled
follows
halign
height
width
increment
initial_val
max_val
min_val
name
tool_tip
label
label_width
mouse_opaque
control_name
can_edit_text
visible
allow_text_entry
text_enabled_color
text_disabled_color
bg_visible
border_drop_shadow_visible
border_visible
drop_shadow_visible
font
h_pad
v_pad

texture_picker parameters


allow_no_texture
bottom
bottom_delta
left
left_delta
right
can_apply_immediately
default_image_name
enabled
follows
height
width
label
mouse_opaque
name
tool_tip
visible

combo_item parameters


name
value
type
length
enabled

combo_box parameters


allow_text_entry
bottom
bottom_delta
left
left_delta
right
enabled
follows
height
width
length
max_chars
mouse_opaque
name
visible
tool_tip
label
tab_group
control_name
font
initial_value
halign
max_length
bg_readonly_color
text_readonly_color

column parameters


name
label
sort
width
dynamicwidth
relwidth
image
tool_tip
user_resize

name_list parameters


allow_calling_card_drop
background_visible
bottom
bottom_delta
left
left_delta
column_padding
draw_border
draw_heading
draw_stripes
enabled
follows
height
width
mouse_opaque
multi_select
name
name_column_index
heading_font
heading_height
tool_tip
bg_selected_color
fg_selected_color
fg_disable_color
fg_unselected_color
background_opaque
bg_alpha_color
bg_opaque_color

check_box parameters


bottom
bottom_delta
left
left_delta
right
enabled
follows
font
height
width
initial_value
label
mouse_opaque
name
radio_style
tool_tip
tab_stop
control_name
visible
tab_group
halign
border_drop_shadow_visible
hidden
max_length