Class SearchElement

Represents a reusable control for searching and filtering.

Inheritance

Object

CallbackEventHandler

Focusable

VisualElement

SearchElement

Inherited Members

VisualElement.disabledUssClassName

UnityEngine.UIElements.VisualElement.ExecuteDefaultAction(UnityEngine.UIElements.EventBase)

UnityEngine.UIElements.VisualElement.Focus()

VisualElement.SendEvent(EventBase)

UnityEngine.UIElements.VisualElement.SetEnabledFromHierarchy(System.Boolean)

VisualElement.SetEnabled(Boolean)

VisualElement.MarkDirtyRepaint()

UnityEngine.UIElements.VisualElement.ContainsPoint(UnityEngine.Vector2)

UnityEngine.UIElements.VisualElement.Overlaps(UnityEngine.Rect)

UnityEngine.UIElements.VisualElement.DoMeasure(System.Single, UnityEngine.UIElements.VisualElement.MeasureMode, System.Single, UnityEngine.UIElements.VisualElement.MeasureMode)

UnityEngine.UIElements.VisualElement.ToString()

VisualElement.GetClasses()

UnityEngine.UIElements.VisualElement.ClearClassList()

UnityEngine.UIElements.VisualElement.AddToClassList(System.String)

UnityEngine.UIElements.VisualElement.RemoveFromClassList(System.String)

VisualElement.ToggleInClassList(String)

VisualElement.EnableInClassList(String, Boolean)

UnityEngine.UIElements.VisualElement.ClassListContains(System.String)

VisualElement.FindAncestorUserData()

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.Experimental.ITransitionAnimations.Start(System.Single, System.Single, System.Int32, System.Action<UnityEngine.UIElements.VisualElement, System.Single>)

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.Experimental.ITransitionAnimations.Start(UnityEngine.Rect, UnityEngine.Rect, System.Int32, System.Action<UnityEngine.UIElements.VisualElement, UnityEngine.Rect>)

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.Experimental.ITransitionAnimations.Start(UnityEngine.Color, UnityEngine.Color, System.Int32, System.Action<UnityEngine.UIElements.VisualElement, UnityEngine.Color>)

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.Experimental.ITransitionAnimations.Start(UnityEngine.Vector3, UnityEngine.Vector3, System.Int32, System.Action<UnityEngine.UIElements.VisualElement, UnityEngine.Vector3>)

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.Experimental.ITransitionAnimations.Start(UnityEngine.Vector2, UnityEngine.Vector2, System.Int32, System.Action<UnityEngine.UIElements.VisualElement, UnityEngine.Vector2>)

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.Experimental.ITransitionAnimations.Start(UnityEngine.Quaternion, UnityEngine.Quaternion, System.Int32, System.Action<UnityEngine.UIElements.VisualElement, UnityEngine.Quaternion>)

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.Experimental.ITransitionAnimations.Start(UnityEngine.UIElements.Experimental.StyleValues, UnityEngine.UIElements.Experimental.StyleValues, System.Int32)

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.Experimental.ITransitionAnimations.Start(System.Func<UnityEngine.UIElements.VisualElement, System.Single>, System.Single, System.Int32, System.Action<UnityEngine.UIElements.VisualElement, System.Single>)

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.Experimental.ITransitionAnimations.Start(System.Func<UnityEngine.UIElements.VisualElement, UnityEngine.Rect>, UnityEngine.Rect, System.Int32, System.Action<UnityEngine.UIElements.VisualElement, UnityEngine.Rect>)

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.Experimental.ITransitionAnimations.Start(System.Func<UnityEngine.UIElements.VisualElement, UnityEngine.Color>, UnityEngine.Color, System.Int32, System.Action<UnityEngine.UIElements.VisualElement, UnityEngine.Color>)

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.Experimental.ITransitionAnimations.Start(System.Func<UnityEngine.UIElements.VisualElement, UnityEngine.Vector3>, UnityEngine.Vector3, System.Int32, System.Action<UnityEngine.UIElements.VisualElement, UnityEngine.Vector3>)

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.Experimental.ITransitionAnimations.Start(System.Func<UnityEngine.UIElements.VisualElement, UnityEngine.Vector2>, UnityEngine.Vector2, System.Int32, System.Action<UnityEngine.UIElements.VisualElement, UnityEngine.Vector2>)

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.Experimental.ITransitionAnimations.Start(System.Func<UnityEngine.UIElements.VisualElement, UnityEngine.Quaternion>, UnityEngine.Quaternion, System.Int32, System.Action<UnityEngine.UIElements.VisualElement, UnityEngine.Quaternion>)

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.Experimental.ITransitionAnimations.Start(UnityEngine.UIElements.Experimental.StyleValues, System.Int32)

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.Experimental.ITransitionAnimations.Layout(UnityEngine.Rect, System.Int32)

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.Experimental.ITransitionAnimations.TopLeft(UnityEngine.Vector2, System.Int32)

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.Experimental.ITransitionAnimations.Size(UnityEngine.Vector2, System.Int32)

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.Experimental.ITransitionAnimations.Scale(System.Single, System.Int32)

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.Experimental.ITransitionAnimations.Position(UnityEngine.Vector3, System.Int32)

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.Experimental.ITransitionAnimations.Rotation(UnityEngine.Quaternion, System.Int32)

VisualElement.Add(VisualElement)

UnityEngine.UIElements.VisualElement.Insert(System.Int32, UnityEngine.UIElements.VisualElement)

VisualElement.Remove(VisualElement)

VisualElement.RemoveAt(Int32)

VisualElement.Clear()

VisualElement.ElementAt(Int32)

VisualElement.IndexOf(VisualElement)

VisualElement.Children()

UnityEngine.UIElements.VisualElement.Sort(System.Comparison<UnityEngine.UIElements.VisualElement>)

VisualElement.BringToFront()

VisualElement.SendToBack()

VisualElement.PlaceBehind(VisualElement)

VisualElement.PlaceInFront(VisualElement)

VisualElement.RemoveFromHierarchy()

UnityEngine.UIElements.VisualElement.GetFirstOfType<T>()

UnityEngine.UIElements.VisualElement.GetFirstAncestorOfType<T>()

VisualElement.Contains(VisualElement)

VisualElement.FindCommonAncestor(VisualElement)

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IVisualElementScheduler.Execute(System.Action<UnityEngine.UIElements.TimerState>)

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IVisualElementScheduler.Execute(System.Action)

VisualElement.viewDataKey

VisualElement.userData

UnityEngine.UIElements.VisualElement.canGrabFocus

UnityEngine.UIElements.VisualElement.focusController

VisualElement.usageHints

UnityEngine.UIElements.VisualElement.transform

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.ITransform.position

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.ITransform.rotation

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.ITransform.scale

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.ITransform.matrix

UnityEngine.UIElements.VisualElement.layout

UnityEngine.UIElements.VisualElement.contentRect

UnityEngine.UIElements.VisualElement.paddingRect

UnityEngine.UIElements.VisualElement.worldBound

UnityEngine.UIElements.VisualElement.localBound

UnityEngine.UIElements.VisualElement.worldTransform

VisualElement.pickingMode

UnityEngine.UIElements.VisualElement.name

VisualElement.enabledInHierarchy

VisualElement.enabledSelf

UnityEngine.UIElements.VisualElement.visible

VisualElement.generateVisualContent

VisualElement.experimental

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IExperimentalFeatures.animation

VisualElement.hierarchy

UnityEngine.UIElements.VisualElement.cacheAsBitmap

UnityEngine.UIElements.VisualElement.parent

UnityEngine.UIElements.VisualElement.panel

VisualElement.contentContainer

UnityEngine.UIElements.VisualElement.Item[System.Int32]

VisualElement.childCount

VisualElement.schedule

VisualElement.style

VisualElement.customStyle

VisualElement.styleSheets

VisualElement.tooltip

VisualElement.resolvedStyle

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.alignContent

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.alignItems

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.alignSelf

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.backgroundColor

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.backgroundImage

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.borderBottomColor

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.borderBottomLeftRadius

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.borderBottomRightRadius

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.borderBottomWidth

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.borderLeftColor

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.borderLeftWidth

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.borderRightColor

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.borderRightWidth

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.borderTopColor

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.borderTopLeftRadius

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.borderTopRightRadius

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.borderTopWidth

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.bottom

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.color

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.display

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.flexBasis

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.flexDirection

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.flexGrow

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.flexShrink

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.flexWrap

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.fontSize

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.height

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.justifyContent

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.left

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.marginBottom

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.marginLeft

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.marginRight

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.marginTop

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.maxHeight

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.maxWidth

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.minHeight

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.minWidth

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.opacity

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.paddingBottom

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.paddingLeft

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.paddingRight

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.paddingTop

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.position

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.right

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.textOverflow

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.top

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.unityBackgroundImageTintColor

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.unityBackgroundScaleMode

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.unityFont

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.unityFontStyleAndWeight

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.unitySliceBottom

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.unitySliceLeft

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.unitySliceRight

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.unitySliceTop

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.unityTextAlign

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.unityTextOverflowPosition

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.visibility

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.whiteSpace

UnityEngine.UIElements.VisualElement.UnityEngine.UIElements.IResolvedStyle.width

Focusable.Blur()

Focusable.focusable

Focusable.tabIndex

Focusable.delegatesFocus

UnityEngine.UIElements.CallbackEventHandler.RegisterCallback<TEventType>(UnityEngine.UIElements.EventCallback<TEventType>, UnityEngine.UIElements.TrickleDown)

UnityEngine.UIElements.CallbackEventHandler.RegisterCallback<TEventType, TUserArgsType>(UnityEngine.UIElements.EventCallback<TEventType, TUserArgsType>, TUserArgsType, UnityEngine.UIElements.TrickleDown)

UnityEngine.UIElements.CallbackEventHandler.UnregisterCallback<TEventType>(UnityEngine.UIElements.EventCallback<TEventType>, UnityEngine.UIElements.TrickleDown)

UnityEngine.UIElements.CallbackEventHandler.UnregisterCallback<TEventType, TUserArgsType>(UnityEngine.UIElements.EventCallback<TEventType, TUserArgsType>, UnityEngine.UIElements.TrickleDown)

CallbackEventHandler.HandleEvent(EventBase)

CallbackEventHandler.HasTrickleDownHandlers()

CallbackEventHandler.HasBubbleUpHandlers()

UnityEngine.UIElements.CallbackEventHandler.ExecuteDefaultActionAtTarget(UnityEngine.UIElements.EventBase)

Namespace: Unity.Properties.UI

Syntax

[UsedImplicitly]
public sealed class SearchElement : VisualElement, IEventHandler, ITransform, ITransitionAnimations, IExperimentalFeatures, IVisualElementScheduler, IResolvedStyle, INotifyValueChanged<string>

Constructors

SearchElement()

Constructs a new instance of the SearchElement control.

Declaration

public SearchElement()

Properties

FilterPopupWidth

Gets or sets the desired width for the popup element. The default value is 175.

Declaration

public int FilterPopupWidth { get; set; }

Property Value

Type	Description
Int32

SearchDelay

Gets or sets the search delay. This is the number of millisecond after input is receive for the search to be executed. The default value is 200.

Declaration

public long SearchDelay { get; set; }

Property Value

Type	Description
Int64

value

Gets or sets the search string value. This is the string that appears in the text box.

Declaration

public string value { get; set; }

Property Value

Type	Description
String

Implements

UnityEngine.UIElements.INotifyValueChanged<T>.value

Remarks

Setting this value will trigger the search. To update the value without searching use SetValueWithoutNotify(String).

Methods

AddSearchDataCallback<TData>(Func<TData, IEnumerable<String>>)

Adds a callback which returns values that should be compared against the search string.

Declaration

public void AddSearchDataCallback<TData>(Func<TData, IEnumerable<string>> getSearchDataFunc)

Parameters

Type	Name	Description
Func<TData, IEnumerable<String>>	getSearchDataFunc	Callback used to get the data for the search string.

Type Parameters

Name	Description
TData	The search data type.

AddSearchDataProperty(PropertyPath)

Adds a property who's value should be compared against search string.

Declaration

public void AddSearchDataProperty(PropertyPath path)

Parameters

Type	Name	Description
PropertyPath	path	The property path to pull search data from.

AddSearchFilterCallback<TData, TFilter>(String, Func<TData, TFilter>, String[])

Adds a search filter based on a callback function. The given token will resolve to the result of the specified getSearchDataFunc.

Declaration

public void AddSearchFilterCallback<TData, TFilter>(string token, Func<TData, TFilter> getSearchDataFunc, string[] supportedOperatorTypes = null)

Parameters

Type	Name	Description
String	token	The identifier of the filter. Typically what precedes the operator in a filter.
Func<TData, TFilter>	getSearchDataFunc	Callback used to get the object that is used in the filter. Takes an object of type TData and returns an object of type TFilter.
String[]	supportedOperatorTypes	List of supported operator tokens. Null for all operators.

Type Parameters

Name	Description
TData	The data type being searched.
TFilter	The return type for the filter.

AddSearchFilterPopupItem(String, String, String)

Adds a filter to the filter popup menu. This can be used for discoverability and quick way to add filter text.

Declaration

public void AddSearchFilterPopupItem(string token, string filterText, string filterTooltip = "")

Parameters

Type	Name	Description
String	token	The token for the filter. This should NOT include the operator.
String	filterText	The text or name to display to the user.
String	filterTooltip	An optional tooltip.

AddSearchFilterProperty(String, PropertyPath, String[])

Adds a filter based on a binding path. The given token will resolve to a property at the specified path.

Declaration

public void AddSearchFilterProperty(string token, PropertyPath path, string[] supportedOperatorTypes = null)

Parameters

Type	Name	Description
String	token	The identifier of the filter. Typically what precedes the operator in a filter.
PropertyPath	path	The property this token should resolve to.
String[]	supportedOperatorTypes	List of supported operator tokens. Null for all operators.

ClearSearchString()

Clears the search string and immediately invokes the search callback.

Declaration

public void ClearSearchString()

GetUxmlSearchHandler()

Returns the search handler registered through UXML bindings.

Declaration

public ISearchHandler GetUxmlSearchHandler()

Returns

Type	Description
ISearchHandler	The search handler created from UXML bindings.

HideProgress()

Hides the progress bar for the search field.

Declaration

public void HideProgress()

RegisterSearchQueryHandler(PropertyElement, PropertyPath, PropertyPath)

Registers a high level search handler based on the specified bindings. The collection at sourceDataPath will be read from, filtered and written to the filterDataPath.

Declaration

public ISearchHandler RegisterSearchQueryHandler(PropertyElement propertyElement, PropertyPath sourceDataPath, PropertyPath filterDataPath)

Parameters

Type	Name	Description
PropertyElement	propertyElement	The property element to use for the data.
PropertyPath	sourceDataPath	The source data path to read from.
PropertyPath	filterDataPath	The filter data path to write to.

Returns

Type	Description
ISearchHandler	The search handler which can be used to customize the search or unregister the bindings.

Remarks

After the initial setup it is recommended to invoke Search(String) to initialize the filtered data.

RegisterSearchQueryHandler<TData>(Action<ISearchQuery<TData>>)

Adds a search query handler to the element. The specified callback will be invoked whenever a search is performed.

Declaration

public void RegisterSearchQueryHandler<TData>(Action<ISearchQuery<TData>> searchQueryCallback)

Parameters

Type	Name	Description
Action<ISearchQuery<TData>>	searchQueryCallback	The callback to add.

Type Parameters

Name	Description
TData	The search data type.

Exceptions

Type	Condition
Exception	The callback has already been registered.

RegisterSearchQueryHandler<TData>(ISearchQueryHandler<TData>)

Adds a search query handler. The HandleSearchQuery(ISearchQuery<TData>) method will be invoked on the specified whenever a search is performed.

Declaration

public void RegisterSearchQueryHandler<TData>(ISearchQueryHandler<TData> searchQueryHandler)

Parameters

Type	Name	Description
ISearchQueryHandler<TData>	searchQueryHandler	The search handler to add.

Type Parameters

Name	Description
TData	The search data type.

Exceptions

Type	Condition
Exception	The specified search handler has already been registered.

Search()

Executes the search using the current search string.

Declaration

public void Search()

Remarks

This method can be used when the underlying data changes and the search must be explicitly run.

Search(String)

Executes the search using the specified search string.

Declaration

public void Search(string searchString)

Parameters

Type	Name	Description
String	searchString

Remarks

This method can be used when the underlying data changes and the search must be explicitly run.

SetValueWithoutNotify(String)

Updates the search string value without invoking the search.

Declaration

public void SetValueWithoutNotify(string newValue)

Parameters

Type	Name	Description
String	newValue	The search string value to set.

Implements

UnityEngine.UIElements.INotifyValueChanged<T>.SetValueWithoutNotify(T)

ShowProgress(Single)

Shows and updates the progress bar for the search field.

Declaration

public void ShowProgress(float progress)

Parameters

Type	Name	Description
Single	progress	The progress value to show. Range should be 0 to 1.

UnregisterSearchQueryHandler<TData>(Action<ISearchQuery<TData>>)

Removes a search query callback from the element.

Declaration

public void UnregisterSearchQueryHandler<TData>(Action<ISearchQuery<TData>> searchQueryCallback)

Parameters

Type	Name	Description
Action<ISearchQuery<TData>>	searchQueryCallback	The callback to remove.

Type Parameters

Name	Description
TData	The search data type.

Exceptions

Type	Condition
Exception	The callback has not been registered.

UnregisterSearchQueryHandler<TData>(ISearchQueryHandler<TData>)

Removes a search query handler from the element.

Declaration

public void UnregisterSearchQueryHandler<TData>(ISearchQueryHandler<TData> searchQueryHandler)

Parameters

Type	Name	Description
ISearchQueryHandler<TData>	searchQueryHandler	The search handler to remove.

Type Parameters

Name	Description
TData	The search data type.

Exceptions

Type	Condition
Exception	The specified search handler has not been registered.