//********************************** Banshee Engine (www.banshee3d.com) **************************************************//
//**************** Copyright (c) 2016 Marko Pintera (marko.pintera@gmail.com). All rights reserved. **********************//
using System;
using System.Runtime.CompilerServices;
using bs;
namespace bs.Editor
{
/** @addtogroup GUI-Editor
* @{
*/
///
/// Editor GUI element that displays a list box with elements of an enumeration and an optional label.
///
public sealed class GUIEnumField : GUIElement
{
public delegate void OnSelectionChangedDelegate(UInt64 value);
///
/// Triggered whenever user selects a new element in the list box. Returns the value of the enumeration entry that
/// was selected.
///
public event OnSelectionChangedDelegate OnSelectionChanged;
///
/// Value of the enumeration entry currently selected. This is a combination of all selected values in case a
/// multiselect list is used.
///
public UInt64 Value
{
get { return Internal_GetValue(mCachedPtr); }
set { Internal_SetValue(mCachedPtr, value); }
}
///
/// States of all element in the list box (enabled or disabled).
///
public bool[] States
{
get { return Internal_GetElementStates(mCachedPtr); }
set { Internal_SetElementStates(mCachedPtr, value); }
}
///
/// Creates a new list box with enumeration entries as its elements and a label.
///
/// Type of enum of whose entries to display in the list box.
/// Determines should the listbox allow multiple elements to be selected or just one.
///
/// Content to display on the label.
/// Width of the title label in pixels.
/// Optional style to use for the element. Style controls the look of the element, as well as
/// default layout options. Style will be retrieved from the active GUISkin. If not specified
/// default element style is used.
/// Options that allow you to control how is the element positioned and sized. This will
/// override any similar options set by style.
public GUIEnumField(Type enumType, bool multiselect, GUIContent title, int titleWidth = 100, string style = "", params GUIOption[] options)
{
Internal_CreateInstance(this, Enum.GetNames(enumType), Enum.GetValues(enumType), multiselect,
ref title, titleWidth, style, options, true);
}
///
/// Creates a new list box with enumeration entries as its elements and a label.
///
/// Type of enum of whose entries to display in the list box.
/// Determines should the listbox allow multiple elements to be selected or just one.
///
/// Content to display on the label.
/// Width of the title label in pixels.
/// Options that allow you to control how is the element positioned and sized. This will
/// override any similar options set by style.
public GUIEnumField(Type enumType, bool multiselect, GUIContent title, int titleWidth, params GUIOption[] options)
{
Internal_CreateInstance(this, Enum.GetNames(enumType), Enum.GetValues(enumType), multiselect,
ref title, titleWidth, "", options, true);
}
///
/// Creates a new single selection list box with enumeration entries as its elements and a label.
///
/// Type of enum of whose entries to display in the list box.
/// Content to display on the label.
/// Width of the title label in pixels.
/// Optional style to use for the element. Style controls the look of the element, as well as
/// default layout options. Style will be retrieved from the active GUISkin. If not specified
/// default element style is used.
/// Options that allow you to control how is the element positioned and sized. This will
/// override any similar options set by style.
public GUIEnumField(Type enumType, GUIContent title, int titleWidth = 100, string style = "", params GUIOption[] options)
{
Internal_CreateInstance(this, Enum.GetNames(enumType), Enum.GetValues(enumType), false,
ref title, titleWidth, style, options, true);
}
///
/// Creates a new single selection list box with enumeration entries as its elements and a label.
///
/// Type of enum of whose entries to display in the list box.
/// Content to display on the label.
/// Width of the title label in pixels.
/// Options that allow you to control how is the element positioned and sized. This will
/// override any similar options set by style.
public GUIEnumField(Type enumType, GUIContent title, int titleWidth, params GUIOption[] options)
{
Internal_CreateInstance(this, Enum.GetNames(enumType), Enum.GetValues(enumType), false,
ref title, titleWidth, "", options, true);
}
///
/// Creates a new list box with enumeration entries as its elements and no label.
///
/// Type of enum of whose entries to display in the list box.
/// Determines should the listbox allow multiple elements to be selected or just one.
///
/// Optional style to use for the element. Style controls the look of the element, as well as
/// default layout options. Style will be retrieved from the active GUISkin. If not specified
/// default element style is used.
/// Options that allow you to control how is the element positioned and sized. This will
/// override any similar options set by style.
public GUIEnumField(Type enumType, bool multiselect, string style = "", params GUIOption[] options)
{
GUIContent emptyContent = new GUIContent();
Internal_CreateInstance(this, Enum.GetNames(enumType), Enum.GetValues(enumType), multiselect,
ref emptyContent, 0, style, options, false);
}
///
/// Creates a new list box with enumeration entries as its elements and no label.
///
/// Type of enum of whose entries to display in the list box.
/// Determines should the listbox allow multiple elements to be selected or just one.
///
/// Options that allow you to control how is the element positioned and sized. This will
/// override any similar options set by style.
public GUIEnumField(Type enumType, bool multiselect = false, params GUIOption[] options)
{
GUIContent emptyContent = new GUIContent();
Internal_CreateInstance(this, Enum.GetNames(enumType), Enum.GetValues(enumType), multiselect,
ref emptyContent, 0, "", options, false);
}
///
/// Makes the element with the specified index selected.
///
/// Sequential index in the elements array provided on construction.
public void SelectElement(int idx)
{
Internal_SelectElement(mCachedPtr, idx);
}
///
/// Deselect element the element with the specified index. Only relevant for multi-select list boxes.
///
/// Sequential index in the elements array provided on construction.
public void DeselectElement(int idx)
{
Internal_DeselectElement(mCachedPtr, idx);
}
///
/// Colors the element with a specific tint.
///
/// Tint to apply to the element.
public void SetTint(Color color)
{
Internal_SetTint(mCachedPtr, ref color);
}
///
/// Triggered by the native interop object when a user selects an object in the list.
///
private void DoOnSelectionChanged(UInt64 index)
{
if (OnSelectionChanged != null)
OnSelectionChanged(index);
}
[MethodImpl(MethodImplOptions.InternalCall)]
private static extern void Internal_CreateInstance(GUIEnumField instance, string[] names, Array values,
bool multiselect, ref GUIContent title, int titleWidth, string style, GUIOption[] options, bool withTitle);
[MethodImpl(MethodImplOptions.InternalCall)]
private static extern UInt64 Internal_GetValue(IntPtr nativeInstance);
[MethodImpl(MethodImplOptions.InternalCall)]
private static extern void Internal_SetValue(IntPtr nativeInstance, UInt64 value);
[MethodImpl(MethodImplOptions.InternalCall)]
private static extern bool[] Internal_GetElementStates(IntPtr nativeInstance);
[MethodImpl(MethodImplOptions.InternalCall)]
private static extern void Internal_SetElementStates(IntPtr nativeInstance, bool[] states);
[MethodImpl(MethodImplOptions.InternalCall)]
private static extern void Internal_SelectElement(IntPtr nativeInstance, int idx);
[MethodImpl(MethodImplOptions.InternalCall)]
private static extern void Internal_DeselectElement(IntPtr nativeInstance, int idx);
[MethodImpl(MethodImplOptions.InternalCall)]
private static extern void Internal_SetTint(IntPtr nativeInstance, ref Color color);
}
/** @} */
}