SearchPaneSuggestionsRequestedEventArgs 類別

定義

命名空間:

Windows.ApplicationModel.Search

提供與SearchPane物件相關聯的SuggestionsRequested事件資料。

public ref class SearchPaneSuggestionsRequestedEventArgs sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.ApplicationModel.Search.SearchContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Deprecated("SearchPaneSuggestionsRequestedEventArgs may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")]
class SearchPaneSuggestionsRequestedEventArgs final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.ApplicationModel.Search.SearchContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Deprecated("SearchPaneSuggestionsRequestedEventArgs may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")]
public sealed class SearchPaneSuggestionsRequestedEventArgs

Public NotInheritable Class SearchPaneSuggestionsRequestedEventArgs

繼承

Object Platform::Object IInspectable SearchPaneSuggestionsRequestedEventArgs

屬性

ContractVersionAttribute DeprecatedAttribute MarshalingBehaviorAttribute

實作

ISearchPaneQueryChangedEventArgs

Windows 需求

裝置系列	Windows Desktop Extension SDK (已於 10.0.10240.0 引進) Xbox One Extensions for the UWP (已於 10.0.10586.0 引進)
API contract	Windows.ApplicationModel.Search.SearchContract (已於 v1.0 引進)

備註

重要

若要在應用程式中實作Windows 10或更新版本的搜尋，請使用AutoSuggestBox。 如需詳細資訊，請參閱 自動建議方塊 。

您不應該在 app 中使用Windows.ApplicationModel.Search API (SearchPane、 SearchContract) 或SearchBox API，以進行Windows 10或更新版本。

這個物件會傳遞至應用程式的 SuggestionsRequested 事件處理常式。

使用您的應用程式來提供建議

有幾種不同的方式可讓您取得應用程式的建議，以提供：

• 從應用程式定義的靜態本機清單
• 從支援 OpenSearch 格式建議的 URL
• 從支援 XML 格式建議的 URL 取得建議之後，您必須將它們附加至建議集合，才能顯示使用者的查詢。 使用 searchPaneSuggestionsRequest.searchSuggestionCollection 屬性存取此集合。

注意

如果您想要提供結果建議，您也必須接聽並處理 ResultSuggestionChosen 事件。

屬性

Language	取得網際網路工程工作組 (IETF) 語言標籤， (BCP 47 標準) ，識別目前與使用者文字輸入裝置相關聯的語言。
LinguisticDetails	取得 物件，提供使用者透過輸入法編輯器輸入之查詢文字的語言資訊， (輸入法) 。
QueryText	取得應用程式應該提供建議的文字，且在發生 SuggestionsRequested 事件時位於搜尋方塊中。
Request	取得 物件，這個物件會儲存要求的建議和資訊。