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 を使用します。 詳細については、「 自動提案ボックス 」を参照してください。

Windows 10 以降のアプリでは、Windows.ApplicationModel.Search API (SearchPane、SearchContract) または SearchBox API を使用しないでください。

このオブジェクトは、アプリの SuggestionsRequested イベント ハンドラーに渡されます。

アプリを使用して提案を提供する

アプリで提供する提案を取得するには、いくつかの異なる方法があります。

• アプリ定義の静的なローカル リストから
• OpenSearch 形式の候補をサポートする URL から
• 候補を XML 形式でサポートする URL から候補を取得した後、ユーザーのクエリ用に表示する候補のコレクションに追加する必要があります。 searchPaneSuggestionsRequest.searchSuggestionCollection プロパティを使用して、このコレクションにアクセスします。

注意

結果の候補を提供する場合は、 ResultSuggestionChosen イベントをリッスンして処理する必要もあります。

プロパティ

Language	ユーザーのテキスト入力デバイスに現在関連付けられている言語を識別するインターネット エンジニアリング タスク フォース (IETF) 言語タグ (BCP 47 標準) を取得します。
LinguisticDetails	ユーザーが入力メソッド エディター (IME) を使用して入力するクエリ テキストに関する言語情報を提供する オブジェクトを取得します。
QueryText	SuggestionsRequested イベントが発生したときに検索ボックスに表示された、アプリが提案を提供する必要があるテキストを取得します。
Request	要求に関する提案と情報を格納する オブジェクトを取得します。