Class SerializedPropertyAdaptor

Reorderable list adaptor for serialized array property.

Inheritance
object
SerializedPropertyAdaptor
Implements
Namespace: Unity.VisualScripting.ReorderableList
Assembly: solution.dll
Syntax
public class SerializedPropertyAdaptor : IReorderableListAdaptor
Remarks

This adaptor can be subclassed to add special logic to item height calculation. You may want to implement a custom adaptor class where specialised functionality is needed.

List elements are not cloned using the System.ICloneable interface when using a SerializedProperty to manipulate lists.

Constructors

SerializedPropertyAdaptor(SerializedProperty)

Initializes a new instance of SerializedPropertyAdaptor.

Declaration
public SerializedPropertyAdaptor(SerializedProperty arrayProperty)
Parameters
Type Name Description
SerializedProperty arrayProperty

Serialized property for entire array.

SerializedPropertyAdaptor(SerializedProperty, float)

Initializes a new instance of SerializedPropertyAdaptor.

Declaration
public SerializedPropertyAdaptor(SerializedProperty arrayProperty, float fixedItemHeight)
Parameters
Type Name Description
SerializedProperty arrayProperty

Serialized property for entire array.
float fixedItemHeight

Non-zero height overrides property drawer height calculation.

Fields

FixedItemHeight

Fixed height of each list item.

Declaration
public float FixedItemHeight
Field Value
Type Description
float
Remarks

Non-zero value overrides property drawer height calculation which is more efficient.

Properties

Count

Gets count of elements in list.

Declaration
public int Count { get; }
Property Value
Type Description
int

this[int]

Gets element from list.

Declaration
public SerializedProperty this[int index] { get; }
Parameters
Type Name Description
int index

Zero-based index of element.
Property Value
Type Description
SerializedProperty

Serialized property wrapper for array element.

arrayProperty

Gets the underlying serialized array property.

Declaration
public SerializedProperty arrayProperty { get; }
Property Value
Type Description
SerializedProperty

Methods

Add()

Add new element at end of list.

Declaration
public void Add()

BeginGUI()

Occurs before any list items are drawn.

Declaration
public virtual void BeginGUI()
Remarks

This method is only used to handle GUI repaint events.

See Also

CanDrag(int)

Determines whether an item can be reordered by dragging mouse.

Declaration
public virtual bool CanDrag(int index)
Parameters
Type Name Description
int index

Zero-based index for list element.
Returns
Type Description
bool

A value of true if item can be dragged; otherwise false.
Remarks

This should be a light-weight method since it will be used to determine whether grab handle should be included for each item in a reorderable list.

Please note that returning a value of false does not prevent movement on list item since other draggable items can be moved around it.

CanRemove(int)

Determines whether an item can be removed from list.

Declaration
public virtual bool CanRemove(int index)
Parameters
Type Name Description
int index

Zero-based index for list element.
Returns
Type Description
bool

A value of true if item can be removed; otherwise false.
Remarks

This should be a light-weight method since it will be used to determine whether remove button should be included for each item in list.

This is redundant when HideRemoveButtons is specified.

Clear()

Clear all elements from list.

Declaration
public void Clear()

DrawItem(Rect, int)

Draws main interface for a list item.

Declaration
public virtual void DrawItem(Rect position, int index)
Parameters
Type Name Description
Rect position

Position in GUI.
int index

Zero-based index of array element.
Remarks

This method is used to handle all GUI events.

DrawItemBackground(Rect, int)

Draws background of a list item.

Declaration
public virtual void DrawItemBackground(Rect position, int index)
Parameters
Type Name Description
Rect position

Total position of list element in GUI.
int index

Zero-based index of array element.
Remarks

This method is only used to handle GUI repaint events.

Background of list item spans a slightly larger area than the main interface that is drawn by DrawItem(Rect, int) since it is drawn behind the grab handle.

Duplicate(int)

Duplicate existing element.

Declaration
public void Duplicate(int index)
Parameters
Type Name Description
int index

Zero-based index of list element.
Remarks

Consider using the System.ICloneable interface to duplicate list elements where appropriate.

EndGUI()

Occurs after all list items have been drawn.

Declaration
public virtual void EndGUI()
Remarks

This method is only used to handle GUI repaint events.

See Also

GetItemHeight(int)

Gets height of list item in pixels.

Declaration
public virtual float GetItemHeight(int index)
Parameters
Type Name Description
int index

Zero-based index of array element.
Returns
Type Description
float

Measurement in pixels.

Insert(int)

Insert new element at specified index.

Declaration
public void Insert(int index)
Parameters
Type Name Description
int index

Zero-based index for list element.

Move(int, int)

Move element from source index to destination index.

Declaration
public void Move(int sourceIndex, int destIndex)
Parameters
Type Name Description
int sourceIndex

Zero-based index of source element.
int destIndex

Zero-based index of destination element.

Remove(int)

Remove element at specified index.

Declaration
public void Remove(int index)
Parameters
Type Name Description
int index

Zero-based index of list element.

Implements

Extension Methods