SearchActivatedEventArgs Class

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

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

構文


public sealed class SearchActivatedEventArgs : ISearchActivatedEventArgs,
    IActivatedEventArgs,
    IApplicationViewActivatedEventArgs,
    ISearchActivatedEventArgsWithLinguisticDetails

属性

[MarshalingBehavior(Agile)]
[Version(0x06020000)]

メンバー

SearchActivatedEventArgsクラス には次の種類のメンバーがあります。

メソッド

The SearchActivatedEventArgs クラス からメソッドを継承します。Object クラス.

プロパティ

SearchActivatedEventArgsクラス には次のプロパティがあります。

プロパティアクセスの種類説明

CurrentlyShownApplicationViewId

読み取り専用Gets the identifier for the currently shown app view.

Kind

読み取り専用Gets the activation type.

Language

読み取り専用Gets the Internet Engineering Task Force (IETF) language tag (BCP 47 standard) that identifies the language currently associated with the user's text input device.

LinguisticDetails

読み取り専用Gets a SearchPaneQueryLinguisticDetails object that provides info about query text that the user enters through an Input Method Editor (IME).

PreviousExecutionState

読み取り専用Gets the execution state of the app before it was activated.

QueryText

読み取り専用Gets the text that the user wants the app to search for.

SplashScreen

読み取り専用Gets a SplashScreen object that provides information about the transition from the splash screen to the activated app.

 

解説

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

クイック スタート: アプリへの検索の追加」で、アプリケーションで検索する方法について学習します。検索に関連する他のイベントへの応答、Windows.ApplicationModel.Search 名前空間参照の SearchPane クラスを使用した検索ボックスおよび候補のカスタマイズについて学習します。

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

Search contract サンプルは、Search によってアクティブ化したイベントに応答する方法を示します。

メモ  Window.ActivateEnsureMainPageActivatedAsync プライベート メソッド内で呼び出され、表示されません。

()

async protected override void OnSearchActivated(SearchActivatedEventArgs args)
{
    await EnsureMainPageActivatedAsync(args);
    if (args.QueryText == "")
    {
        // Navigate to landing page.
    }
    else
    {
        // Display search results.
        MainPage.Current.ProcessQueryText(args.QueryText);
    }
}

要件

最小限サポートされるクライアント

Windows 8 [Windows ストア アプリのみ]

最小限サポートされるサーバー

Windows Server 2012 [Windows ストア アプリのみ]

最小限サポートされる携帯電話

Windows Phone 8

名前空間

Windows.ApplicationModel.Activation
Windows::ApplicationModel::Activation [C++]

メタデータ

Windows.winmd

参照

クイック スタート: 検索の追加
クイックスタート: 非同期 API の呼び出し
Application
OnSearchActivated
検索コントラクトのサンプル
一般的なリファレンス
ActivationKind enumeration
Windows.ApplicationModel.Search namespace
Windows.ApplicationModel.Search.SearchPane class
JavaScript アプリケーション参照
Windows.UI.WebUI.WebUIApplication.Activated event
C#/C++/VB アプリケーション参照
OnSearchActivated
Windows.UI.Core.CoreApplicationView.Activated event

 

 

表示:
© 2014 Microsoft