SearchSuggestionCollection Class
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Represents a collection of search suggestions to be displayed in the search pane in response to a suggestionsrequested event.
public ref class SearchSuggestionCollection sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class SearchSuggestionCollection final[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class SearchSuggestionCollectionPublic NotInheritable Class SearchSuggestionCollection- Inheritance
- Attributes
Windows requirements
| Device family |
Windows 10 (introduced in 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduced in v1.0)
|
Remarks
Important
To implement search in an app for Windows 10 or later, use AutoSuggestBox. See Auto-suggest box for more info.
You should not use Windows.ApplicationModel.Search APIs (SearchPane, SearchContract) or SearchBox APIs in apps for Windows 10 or later.
The search pane can display 5 suggestions, at most. Additionally, each separator you use takes the place of a suggestion and lowers the number of suggestions that you can display.
An app retrieves this object through the SearchPaneSuggestionsRequest.searchSuggestionCollection property while handling a SuggestionsRequested event.
Properties
| Size |
The number of suggestions in the collection. |
Methods
| AppendQuerySuggestion(String) |
Appends a query suggestion to the list of search suggestions for the search pane. |
| AppendQuerySuggestions(IIterable<String>) |
Appends a list of query suggestions to the list of search suggestions for the search pane. |
| AppendResultSuggestion(String, String, String, IRandomAccessStreamReference, String) |
Appends a suggested search result to the list of suggestions to display in the search pane. |
| AppendSearchSeparator(String) |
Appends a text label that is used to separate groups of suggestions in the search pane. |