Documentation

Unity Engine


User Manual

Script Reference

Unity Engine


ShowPicker

Open a search item picker window.
Read time 2 minutesLast updated 12 days ago

Definition

ShowPicker(SearchContext, Action<SearchItem, bool>, Action<SearchItem>, Func<SearchItem, bool>, IEnumerable<SearchItem>, string, float, float, float, SearchFlags)

Open a search item picker window.
public static ISearchView ShowPicker(SearchContext context, Action<SearchItem, bool> selectHandler, Action<SearchItem> trackingHandler = null, Func<SearchItem, bool> filterHandler = null, IEnumerable<SearchItem> subset = null, string title = null, float itemSize = 64, float defaultWidth = 650, float defaultHeight = 539, SearchFlags flags = SearchFlags.None)

Parameters

Search context to start with.

Callback invoked when an item is selected.

trackingHandler

Callback invoked when an item is clicked without it being the final selection.

Callback invoked to filter search item results to display.

Initial set of items to be searched.

title

Topic to search.

itemSize

Initial result view item size.

defaultWidth

Initial width of the window.

defaultHeight

Initial height of the window.

Options defining how the query is performed.

Returns

Type

Description

ISearchViewCreates a new search window.

ShowPicker(SearchViewState)

Open a Search Picker window.
public static ISearchView ShowPicker(SearchViewState viewState)

Parameters

Search view state used to open the Search Picker window.

Returns

Type

Description

ISearchViewCreates a new search window.

Remarks

This example shows how to open a custom search picker to pick a decal material.

Examples

using UnityEditor;using UnityEditor.Search;using UnityEngine;using UnityEngine.Search;static class Example_SearchService_ShowPicker{ [MenuItem("Examples/SearchService/ShowPicker")] public static void Run() { var context = SearchService.CreateContext("asset", "t:material"); var viewState = new SearchViewState(context, SearchViewFlags.GridView | SearchViewFlags.OpenInBuilderMode | SearchViewFlags.DisableSavedSearchQuery) { windowTitle = new GUIContent("Material Selector"), title = "Material", selectHandler = SelectHandler, trackingHandler = TrackingHandler, position = SearchUtils.GetMainWindowCenteredPosition(new Vector2(600, 400)) }; SearchService.ShowPicker(viewState); } static void SelectHandler(SearchItem searchItem, bool canceled) { Debug.Log($"Selected {searchItem} (canceled: {canceled})"); } static void TrackingHandler(SearchItem searchItem) { Debug.Log($"Tracking {searchItem}"); }}