SearchActivatedEventArgs クラス

定義

名前空間:

Windows.ApplicationModel.Activation

ユーザーが検索チャームからアプリを検索し、アプリが画面上のメイン アプリではない場合に発生するアクティブ化されたイベントに関する情報を提供します。

Javascript この型は webUISearchActivatedEventArgs として表示されます。

public ref class SearchActivatedEventArgs sealed : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProvider

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class SearchActivatedEventArgs final : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProvider

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class SearchActivatedEventArgs : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProvider

Public NotInheritable Class SearchActivatedEventArgs
Implements IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProvider

継承

Object Platform::Object IInspectable SearchActivatedEventArgs

属性

ContractVersionAttribute MarshalingBehaviorAttribute

実装

IActivatedEventArgs IApplicationViewActivatedEventArgs ISearchActivatedEventArgs ISearchActivatedEventArgsWithLinguisticDetails IViewSwitcherProvider IActivatedEventArgsWithUser

Windows の要件

デバイス ファミリ	Windows 10 (10.0.10240.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v1.0 で導入)

注釈

重要

Windows 10以降の検索をアプリに実装するには、AutoSuggestBox を使用します。 詳細については、「 自動提案ボックス 」を参照してください。

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

アプリが検索コントラクトと統合されている場合、ユーザーが検索チャームからアプリを検索し、アプリが画面上のメイン アプリではない場合、SearchActivatedEventArgs オブジェクトがアプリの OnSearchActivated アクティブ化ポイント ハンドラーに渡されます。 この種類のアクティブ化は、Kind プロパティによって返される ActivationKind.Search 値によって示されます。

アクティブ化シナリオに関連するすべての アプリケーション オーバーライドは、実装で Window.Activate を呼び出す必要があります。

バージョン履歴

Windows のバージョン	SDK バージョン	追加された値
1607	14393	User

プロパティ

CurrentlyShownApplicationViewId	現在表示されているアプリ ビューの識別子を取得します。
Kind	アクティブ化の種類を取得します。
Language	ユーザーのテキスト入力デバイスに現在関連付けられている言語を識別するインターネット エンジニアリング タスク フォース (IETF) 言語タグ (BCP 47 標準) を取得します。
LinguisticDetails	ユーザーが入力メソッド エディター (IME) を使用して入力したクエリ テキストに関する情報を提供する SearchPaneQueryLinguisticDetails オブジェクトを取得します。
PreviousExecutionState	アクティブ化される前のアプリの実行状態を取得します。
QueryText	ユーザーがアプリで検索するテキストを取得します。 ユーザーは、このテキストを検索ウィンドウの検索ボックスに入力しました。
SplashScreen	スプラッシュ スクリーンからアクティブ化されたアプリへの切り替えに関する情報を提供する SplashScreen オブジェクトを取得します。
User	アプリがアクティブ化されたユーザーを取得します。
ViewSwitcher	アプリケーションのビューを設定できるビュー スイッチャー オブジェクトを取得します。

こちらもご覧ください

• Application
• ActivationKind
• Windows.ApplicationModel.Search
• SearchPane
• Activated
• OnSearchActivated(SearchActivatedEventArgs)
• Activated
• C# または Visual Basic での非同期 API の呼び出し
• Search コントラクト サンプル (Windows 8)