List

List

List elements render a fixed list of items in a tabular format.

Note: For example, main menus that navigate between inventory, statistics, and party members. For data-driven lists, use the Templated List instead.

Properties

System

Name	Explanation	Type
Animate Cursor When Unfocused	Whether or not to animate the cursor when the element is unfocused.	Toggle
Background	The image to display as a background in the element.	String
Buzzer Sound Effect	The sound to play when an invalid action occurs.	Sound Effect
Color Mask	The color mask to apply to the cursor on the element.	Color
Confirm Sound Effect	The sound to play when confirmation occurs.	Sound Effect
Cursor Fits Contents	Whether or not the cursor is stretched to fit the currently selected item in the element.	Toggle
Cursor Mask Margin	The margin to apply to the cursor on the element.	Number
Cursor Mask Strategy	The strategy used to compose the masked cursor on the element.	Skin Strategy
Cursor Offset	The amount in pixels to offset the cursor on the element.	Point
Disabled Effects	The visual effects applied when this element is disabled.	User Interface Element Effect
Enable Looping	Whether or not the items in the element loop to the beginning after reaching the end and vice versa.	Toggle
Focus Script	The script to execute when the item gets focus.	Script
Focused Effects	The visual effects applied when this element has focus.	User Interface Element Effect
Hide Cursor When Unfocused	Whether or not to hide the cursor when the element is unfocused.	Toggle
Hide When Unfocused	Whether or not to hide the element when it becomes unfocused.	Toggle
Is Item Relatively Positioned	Whether or not to use relative positioning and sizing for the item in the element.	Toggle
Is Linked to Selected Context	Whether this element's context updates to reflect the currently selected item in the interface.	Toggle
Is Linked to UI Context	Whether this element's context is linked to the parent interface's context.	Toggle
Is Visible	Whether the element is visible when the interface first loads. Can be toggled at runtime via effects or scripts.	Toggle
Item Font	The font to use on the items.	Font
Item Margin	The margin around the item in the element.	Margin
Item Pixel Height	The height in pixels of the item in the element.	Number
Item Pixel Width	The width in pixels of the item in the element.	Number
Item Relative Height	The height relative to the list of the item.	Number
Item Relative Width	The width relative to the list of the item.	Number
Item Sprite Margin	The margin around each item's sprite within the list.	Margin
Item Text Margin	The margin around each item's text within the list.	Margin
Item Use Drop Shadow	Whether to apply a drop shadow to the text on each list item.	Toggle
Items	The items in the list.	List Item
Margin	The margin around the element in pixels.	Margin
Movement Sound Effect	The sound to play when a cursor moves.	Sound Effect
Name	The name of the element.	String
Orientation	The direction of the items composition in the element.	Orientation
Pixel Height	The height in pixels of the element.	Number
Pixel Width	The width in pixels of the element.	Number
Pixel X	The x coordinate in pixels of the element.	Number
Pixel Y	The y coordinate in pixels of the element.	Number
Relative Height	The height relative to the container of the element.	Number
Relative Width	The width relative to the container of the element.	Number
Relative X	The x coordinate relative to the container of the element.	Number
Relative Y	The y coordinate relative to the container of the element.	Number
Renders In Background	Whether or not the cursor renders behind the selected item.	Toggle
Require Active User Interface	Whether or not to require the user interface to be active for the cursor to be visible.	Toggle
Selected Effects	The visual effects applied when this element is selected.	User Interface Element Effect
Sprite	The sprite to use for the cursor on the element.	Sprite or Model
Sprite Horizontal Alignment	The horizontal alignment of the sprite or image in the element.	Alignment
Sprite Vertical Alignment	The vertical alignment of the sprite or image in the element.	Alignment
Strategy	The strategy used to compose the background.	Skin Strategy
Template Type	The data type expected when this element is used with templated data binding.	String
Type	The method of displaying the cursor on the element.	Cursor Type
Unfocus Script	The script to execute when the item loses focus.	Script
Unfocused Effects	The visual effects applied when this element loses focus.	User Interface Element Effect
Use Default Sounds	Whether or not to use the default system sound effects.	Toggle
Use Item Sizing	Whether or not item sizing is defined rather than automatically calculated.	Toggle
Use Relative Positioning	Whether to use screen-relative coordinates (0.0 to 1.0) instead of pixel coordinates for positioning and sizing.	Toggle
Use Word Wrapping	Whether or not to wrap text to fit cleanly on multiple lines.	Toggle

List Item

The List Item supports rendering Text and/or Pictures inside of it.

Properties

System

Name	Explanation	Type
Color Mask	The color mask to apply.	Color
Disabled Effects	The disabled effects of the element.	User Interface Element Effect
Execute Script	The execution script attached to the list item.	Script
Focus Script	The focus script attached to the list item.	Script
Focused Effects	The focused effects of the element.	User Interface Element Effect
Override Styles	Whether or not to use the local values for styling.	Toggle
Selected Effects	The selected effects of the element.	User Interface Element Effect
Sprite	The Sprite to display.	Sprite or Model
Sprite Horizontal Alignment	The horizontal alignment of the Sprite.	Alignment
Sprite Margin	The margin around the Sprite.	Margin
Sprite Vertical Alignment	The vertical alignment of the Sprite.	Alignment
Text	The text to display.	String
Text Margin	The margin around the Text.	Margin
Unfocus Script	The unfocus script attached to the list item.	Script
Unfocused Effects	The unfocused effects of the element.	User Interface Element Effect
Use Space If Hidden	Whether or not to occupy the space necessary, even if hidden.	Toggle
Use Sprite Only	Whether or not to use the sprite only.	Toggle

Alignment

Name	Explanation
Start	Aligns to the start of the area (left or top).
Middle	Aligns to the center of the area.
End	Aligns to the end of the area (right or bottom).

Cursor Type

Name	Explanation
None	No cursor is displayed.
Mask	Highlights the entire item with a color overlay.
Pointer - Left	Displays a pointer sprite to the left of the item.
Pointer - Right	Displays a pointer sprite to the right of the item.
Pointer - Top	Displays a pointer sprite above the item.
Pointer - Bottom	Displays a pointer sprite below the item.

Orientation

Name	Explanation
Horizontal	Items are arranged in a horizontal row.
Vertical	Items are arranged in a vertical column.

Skin Strategy

Name	Explanation
Component	Splits the skin into a 3x3 grid of corners, borders, and a center piece that scale independently.
Stretch	Stretches the entire skin image to fit the element dimensions.