SearchActivatedEventArgs クラス

定義

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

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

public ref class SearchActivatedEventArgs sealed : IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProvider
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 : 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 : 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 IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProvider
Public NotInheritable Class SearchActivatedEventArgs
Implements IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProvider
継承
Object Platform::Object IInspectable SearchActivatedEventArgs
属性
実装

Windows の要件

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

注釈

重要

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

Windows 10 以降のアプリでは、Windows.ApplicationModel.Search API (SearchPaneSearchContract) または 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

アプリケーションのビューを設定できるビュー スイッチャー オブジェクトを取得します。

適用対象

こちらもご覧ください