ComboBox

Inherits from UIView


Description

Presents a static or dynamic list of items in a drop-down.

View Fields

NameTypeDescription
AlignmentElementAlignmentView alignment.
Used to align the view relative to the layout parent region it resides in.

Enum Values
NameDescription
CenterElement centered horizontally and vertically.
LeftElement aligned to the left horizontally and centered vertically.
TopElement aligned to the top vertically and centered horizontally.
RightElement aligned to the right horizontally and centered vertically.
BottomElement aligned to the bottom vertically and centered horizontally.
TopLeftElement aligned to the top vertically and to the left horizontally.
TopRightElement aligned to the top vertically and to the right horizontally.
BottomLeftElement aligned to the bottom vertically and to the left horizontally.
BottomRightAlement aligned to the bottom vertically and to the right horizontally.
AlphafloatAlpha value.
Can be used to adjust the alpha color of this view and all its children. E.g. used for fade in/out animations. Is separate from and different from the background color of the view as it affects the children as well.
BackgroundColor Color Background color of the view.
Background color of the view.
BackgroundImageSpriteAssetBackground image sprite.
The sprite that will be rendered.
BackgroundImageEventAlphaThreshold floatAlpha threshold for letting through events.
The alpha threshold specifying the minimum alpha a pixel must have for the event to be passed through.
BackgroundImageFillAmount floatBackground image fill amount.
Amount of the Image shown when the Image.type is set to Image.Type.Filled.
BackgroundImageFillCenter boolIndicates if center should be filled.
Boolean indicating whether or not to render the center of a Tiled or Sliced image.
BackgroundImageFillClockwise boolIndicates if the image should be filled clockwise.
Whether the Image should be filled clockwise (true) or counter-clockwise (false).
BackgroundImageFillMethod FillMethod Background image fill method.
Indicates what type of fill method should be used.

Enum Values
NameDescription
Horizontal
Vertical
Radial90
Radial180
Radial360
BackgroundImageFillOrigin intBackground image fill origin.
Controls the origin point of the Fill process. Value means different things with each fill method.
BackgroundImageMaskable boolIndicates if the image is maskable.
Indicates if the background image graphic is to be maskable.
BackgroundImageOverrideSpriteSpriteAssetBackground image override sprite.
Set an override sprite to be used for rendering. If set the override sprite is used instead of the regular image sprite.
BackgroundImagePreserveAspect boolPreserve aspect ratio.
Indicates whether this image should preserve its Sprite aspect ratio.
BackgroundImageType Type Type of background image.
The type of the image sprite that is to be rendered.

Enum Values
NameDescription
Simple
Sliced
Tiled
Filled
BackgroundMaterial Material Background image material.
Background image material.
BaseDirectorystringBase directory.
Specifies the base directory to be used by the view and its children. The base directory is used when loading resources such as sprites, fonts, etc.
BasedOnstringBased on style.
Used in style definition to specify which style it's based on.
ButtonAdjustToText AdjustToTextAdjusts the combo box button to the text.
An enum indiciating how the combo box button should adjust its size to the label text.

Enum Values
NameDescription
NoneNeither width nor height should be adjusted to text.
WidthAdjust width to text.
HeightAdjust height to text.
WidthAndHeightAdjust width and height to text.
ButtonAlignment ElementAlignmentCombo box button alignment.
Specifies the alignment of the combo box button.

Enum Values
NameDescription
CenterElement centered horizontally and vertically.
LeftElement aligned to the left horizontally and centered vertically.
TopElement aligned to the top vertically and centered horizontally.
RightElement aligned to the right horizontally and centered vertically.
BottomElement aligned to the bottom vertically and centered horizontally.
TopLeftElement aligned to the top vertically and to the left horizontally.
TopRightElement aligned to the top vertically and to the right horizontally.
BottomLeftElement aligned to the bottom vertically and to the left horizontally.
BottomRightAlement aligned to the bottom vertically and to the right horizontally.
ButtonColor Color Combo box button image color.
The color of the combo box button image.
ButtonFont Font Combo box button text font.
The font of the combo box button label.
ButtonFontColor Color Combo box button text font color.
The font color of the combo box button label.
ButtonFontSize intCombo box button text font size.
The font size of the combo box button label.
ButtonFontStyle FontStyle Combo box button text font style.
The font style of the combo box button label.

Enum Values
NameDescription
Normal
Bold
Italic
BoldAndItalic
ButtonHeight ElementSizeCombo box button height.
Specifies the height of the combo box button either in pixels or percents.
ButtonImage SpriteAssetCombo box button image sprite.
The sprite that will be rendered as the combo box button.
ButtonImageType Type Combo box button image type.
The type of the image sprite that is to be rendered as the combo box button.

Enum Values
NameDescription
Simple
Sliced
Tiled
Filled
ButtonLineSpacing floatCombo box button text line spacing.
The line spacing of the combo box button label.
ButtonMargin ElementMarginCombo box button margin.
Specifies the margin of the combo box button.
ButtonMaterial Material Combo box button image material.
The material of the combo box button image.
ButtonOffset ElementMarginCombo box button offset.
Specifies the offset of the combo box button.
ButtonOutlineColor Color Combo box button text outline color.
The outline color of the combo box button label.
ButtonOutlineDistance Vector2 Combo box button text outline distance.
The distance of the combo box button label outline.
ButtonShadowColor Color Combo box button text shadow color.
The shadow color of the combo box button label.
ButtonShadowDistance Vector2 Combo box button text shadow distance.
The distance of the combo box button label shadow.
ButtonSupportRichText boolSupports rich text.
Boolean indicating if the combo box button label supports rich text.
ButtonText stringCombo box button text.
The text of the combo box button label.
ButtonTextAlignment ElementAlignmentCombo box button text alignment.
The alignment of the text inside the combo box button label. Can be used with TextMargin and TextOffset to get desired positioning of the text.

Enum Values
NameDescription
CenterElement centered horizontally and vertically.
LeftElement aligned to the left horizontally and centered vertically.
TopElement aligned to the top vertically and centered horizontally.
RightElement aligned to the right horizontally and centered vertically.
BottomElement aligned to the bottom vertically and centered horizontally.
TopLeftElement aligned to the top vertically and to the left horizontally.
TopRightElement aligned to the top vertically and to the right horizontally.
BottomLeftElement aligned to the bottom vertically and to the left horizontally.
BottomRightAlement aligned to the bottom vertically and to the right horizontally.
ButtonTextMargin ElementMarginCombo box button text margin.
The margin of the combo box button label. Can be used to adjust the text positioning.
ButtonTextOffset ElementMarginCombo box button text offset.
The offset of the combo box button label. Can be used with TextMargin and TextAlignment to get desired positioning of the text.
ButtonTextPadding ElementMarginCombo box button text padding.
The combo box button TextPadding is used when AdjustToText is set. It determines the additional padding to be added to the size of the button when it adjusts to the text.
ButtonWidth ElementSizeCombo box button width.
Specifies the width of the combo box button either in pixels or percents.
CanvasOverrideSorting boolOverride combo box list canvas sort order.
Boolean indicating if the sort order should be overriden (not inherited from parent canvas).
CanvasSortingOrder intCombo box list canvas sorting order.
Combo box list canvas draw order within a sorting layer.
DisableInteractionScrollDelta ListScroll delta distance for disabling interaction.
If set any interaction with child views (clicks, etc) is disabled when the specified distance has been scrolled. This is used e.g. to disable clicks while scrolling a selectable list of items.
HeightElementSizeThe height of the view.
Specifies the height of the view either in pixels or percents.
HideFlags HideFlags Hide flags for the game object.
Bit mask that controls object destruction, saving and visibility in editor.

Enum Values
NameDescription
None
HideInHierarchy
HideInInspector
DontSaveInEditor
NotEditable
DontSaveInBuild
DontUnloadUnusedAsset
DontSave
HideAndDontSave
IdstringThe ID of the view.
Specifies a unique ID for the view. Used to map the view to reference fields on the parent view model. Provides a way to reference the view in data bindings. Is used as selectors in styles.
IsActiveboolIndicates if the view is enabled.
Activates/deactivates the view. If set to false in this or in any parent view, all components are disabled, attached renderers are turned off, etc. Any components attached will no longer have Update() called.
IsDestroyedboolIndicates if the view has been destroyed by GameObject.Destroy().
IsDropUpboolIndicates if the combo box is a drop-up list.
Boolean indicating if the combo box should open above instead of below the combo box button.
IsDynamicboolIndicates if the view has been created dynamically.
IsInitializedboolGets or sets bool indicating if the view has been initialized.
IsScrollable boolIndicates if the combo box list is scrollable.
Boolean indicating if the combo box list is scrollable. The height of the scrollable list can be set by the ListHeight field.
IsTemplateboolIndicates if this view is to be used as a template.
A template view is used to create dynamic instances of the view. Used by certain views such as the List and TabPanel.
IsVisibleboolIndicate if the view is visible.
Can be used to adjust the visiblity of the view. If set to false the view is made invisible but unlike when deactivating the view, invisible views are still is active and takes up space.
ItemobjectItem data.
Provides a mechanism to bind to dynamic list data. The item is set, e.g. by the List view on the child views it generates for its dynamic list data. The Item points to the list item data the view is associated with.
Items IObservableListUser-defined list data.
Can be bound to an generic ObservableList to dynamically generate combo box items based on a template.
ItemSelected ViewAction
LayoutRootUserInterfaceGets layout root canvas.
ListAlignment ElementAlignmentCombo box list alignment.
Specifies the alignment of the combo box list.

Enum Values
NameDescription
CenterElement centered horizontally and vertically.
LeftElement aligned to the left horizontally and centered vertically.
TopElement aligned to the top vertically and centered horizontally.
RightElement aligned to the right horizontally and centered vertically.
BottomElement aligned to the bottom vertically and centered horizontally.
TopLeftElement aligned to the top vertically and to the left horizontally.
TopRightElement aligned to the top vertically and to the right horizontally.
BottomLeftElement aligned to the bottom vertically and to the left horizontally.
BottomRightAlement aligned to the bottom vertically and to the right horizontally.
ListColor Color Combo box list image color.
The color of the combo box list image.
ListContentAlignment ElementAlignmentThe alignment of combo box list items.
If the combo box list items varies in size the content alignment specifies how the combo box list items should be arranged in relation to each other.

Enum Values
NameDescription
CenterElement centered horizontally and vertically.
LeftElement aligned to the left horizontally and centered vertically.
TopElement aligned to the top vertically and centered horizontally.
RightElement aligned to the right horizontally and centered vertically.
BottomElement aligned to the bottom vertically and centered horizontally.
TopLeftElement aligned to the top vertically and to the left horizontally.
TopRightElement aligned to the top vertically and to the right horizontally.
BottomLeftElement aligned to the bottom vertically and to the left horizontally.
BottomRightAlement aligned to the bottom vertically and to the right horizontally.
ListContentMargin ListCombo box list content margin.
Sets the margin of the combo box list mask view that contains the contents of the combo box list.
ListHeight ElementSizeCombo box list image height.
Specifies the height of the combo box list image either in pixels or percents. Used when IsScrollable is True to control the height of the scrollable viewport.
ListImage SpriteAssetCombo box list image sprite.
The sprite that will be rendered as the combo box list.
ListImageType Type Combo box list image type.
The type of the image sprite that is to be rendered as the combo box list.

Enum Values
NameDescription
Simple
Sliced
Tiled
Filled
ListMargin ElementMarginCombo box list image offset.
Specifies the offset of the combo box list image.
ListMaskAlignment ListCombo box list mask alignment.
Specifies the alignment of the list mask.
ListMaskColor ListCombo box list mask image color.
The color of the list max image.
ListMaskHeight ListThe height of the list mask image.
Specifies the height of the list mask image either in pixels or percents.
ListMaskImage ListCombo box list mask image sprite.
The sprite that will be rendered as the list max.
ListMaskImageType ListCombo box list mask image type.
The type of the image sprite that is to be rendered as the list max.
ListMaskMaterial ListCombo box list mask image material.
The material of the list max image.
ListMaskOffset ListThe offset of the list mask image.
Specifies the offset of the list mask image.
ListMaskShowGraphic ListIndicates if list mask should be rendered.
Indicates if the list mask, i.e. the list mask background image sprite and color should be rendered.
ListMaskWidth ListThe width of the list mask image.
Specifies the width of the list mask image either in pixels or percents.
ListMaterial Material Combo box list image material.
The material of the combo box list image.
ListOffset ElementMarginCombo box list image offset.
Specifies the offset of the combo box list image.
ListOrientation ElementOrientationCombo box list orientation.
Specifies the orientation of the combo box list.

Enum Values
NameDescription
VerticalVertical element orientation.
HorizontalHorizontal element orientation.
ListSortDirection ElementSortDirectionSort direction.
If combo box list items has SortIndex set they can be sorted in the direction specified.

Enum Values
NameDescription
AscendingAscending element sort direction.
DescendingDescending element sort direction.
ListSpacing ElementSizeSpacing between combo box list items.
The spacing between combo box list items.
ListWidth ElementSizeCombo box list image width.
Specifies the width of the combo box list image either in pixels or percents.
MarginElementMarginView margin
Determines the size of the content region relative the view's width and height. Adding margins to a view does not change its width or height.
OffsetElementMarginView offset.
Determines the offset of the content region relative to the view's position.
OffsetFromParentElementMarginView offset from parent.
Used by parent views to adjust the positioning of its children without affecting the internal offset of the children.
OverrideHeightElementSizeOverride height.
Used to override the layouting logic of inherited views and set the specified height.
OverrideWidthElementSizeOverride width.
Used to override the layouting logic of inherited views and set the specified width.
Pivot Vector2 View pivot position.
The normalized position that the view rect transform rotates around.
Position Vector3 Position of the view.
The local position of the view in relation to the layout parent view transform.
PropagateChildLayoutChangesboolIndicates if the view propagates child layout changes.
Boolean indicating if view propagates child layout changes. Generally set to true whenever a view adjusts its size to child layout changes.
RaycastBlockModeRaycastBlockModeIndicates when raycast should be blocked.
Enum indicating when raycasts should be blocked by the view.

Enum Values
NameDescription
DefaultRaycast is blocked if view is displayed and not transparent.
AlwaysRaycast is always blocked.
NeverRaycast is never blocked.
Rotation Quaternion Rotation of the view.
The local rotation of the view in relation to the layout parent view transform. Stored as a Quaternion but specified in XUML as euler angles.
Scale Vector3 Scale of the view.
The scale of the view in relation to the layout parent view transform.
SelectedItem objectSelected list item.
Set when the selected combo box item changes and points to the user-defined item data.
SelectOnMouseUp boolIndicates if items are selected on mouse up.
Boolean indicating if items are selected on mouse up rather than mouse down (default).
SortIndexintView sort index.
The sort index is used by views such as Group and List to sort its child views.
StatestringView state.
View state name. Determines state values to be applied to the view. All views start out in the "Default" state and when the state changes the values associated with that state are applied to the view.
StylestringThe style of the view.
Used as selector by the styles. Specifies the name of the style that is to be applied to the view and any children that explicitly inherits its style. The style is applied when the view is created (usually in the editor as the XUML is processed).
ThemestringThe theme of the view.
Specifies the name of the theme that is applied to the view and its children. The theme determines which set of styles are to be considered when applying matching styles to the view.
UnitSizeVector3 Unit size.
Specifies the user-defined unit size to be used by the view and its children. Used when element size is specified in user-defined units to convert it into pixels.
UpdateBackgroundboolIndicates if background is updated.
If set to false the background image and color is not updated by the view. Is used when the background updates is done elsewhere.
UpdateRectTransformboolIndicates if rect transform is updated.
If set to false the rect transform is not updated by the layout logic. It is used when layouting is done elsewhere.
UseListMask boolIndicates if a list mask is to be used.
Boolean indicating if a list mask is to be used.
WidthElementSizeThe width of the view.
Specifies the width of the view either in pixels or percents.

View Actions

NameAction DataDescription
CancelnoneCancel view action.
Triggered by the EventSystem when a cancel event occurs.
DeselectnoneDeselect view action.
Triggered by the EventSystem when another view is selected.
DropnoneDrop view action.
Triggered by the EventSystem when the view accepts a drop.
MovenoneMove view action.
Triggered by the EventSystem when a move event occurs.
ClicknoneClick view action.
Triggered by the EventSystem when the user clicks/touches on the view.
BeginDragnoneDrag view action.
Triggered by the EventSystem when the user presses mouse on and starts to drag over the view.
EndDragnoneEnd drag view action.
Triggered by the EventSystem when the user stops dragging mouse over the view.
DragnoneDrag view action.
Triggered by the EventSystem as the user drags the mouse over the view.
InitializePotentialDragnoneInitialize potential drag view action.
Triggered by the EventSystem as the user initiates a potential drag over the view.
MouseDownnoneMouse down view action.
Triggered by the EventSystem when the mouse/touch presses down over the view.
MouseEnternoneMouse enter view action.
Triggered by the EventSystem when the mouse enters the view.
MouseExitnoneMouse exit view action.
Triggered by the EventSystem when the mouse exits the view.
MouseUpnoneMouse up view action.
Triggered by the EventSystem when the mouse/thouch releases over the view.
ScrollnoneScroll view action.
Triggered by the EventSystem when the user scrolls when the view is selected.
SelectnoneSelect view action.
Triggered by the EventSystem when the view is selected.
SubmitnoneSubmit view action.
Triggered by the EventSystem when the user submits while view is selected.
UpdateSelectednoneUpdate selected view action.
Triggered by the EventSystem when the object associated with this EventTrigger is updated.
ActivatednoneActivated view action.
Triggered every time the view is activated. Also triggered once the view is intialized if it starts out activated.
DeactivatednoneDeactivated view action.
Triggered every time the view is deactivated. Also triggered once the view is intialized if it starts out deactivated.





















Join the Announcement List

Be notified when new themes, views, tutorials and updates are available