SearchPane.SearchHistoryEnabled プロパティ

定義

名前空間:

Windows.ApplicationModel.Search

アプリを使用したユーザーの以前の検索が自動的に追跡され、提案を提供するために使用されるかどうかを示します。

public:
 property bool SearchHistoryEnabled { bool get(); void set(bool value); };

/// [get: Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")]
/// [set: Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")]
bool SearchHistoryEnabled();

void SearchHistoryEnabled(bool value);

public bool SearchHistoryEnabled { [Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")] get; [Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")] set; }

var boolean = searchPane.searchHistoryEnabled;
searchPane.searchHistoryEnabled = boolean;

Public Property SearchHistoryEnabled As Boolean

プロパティ値

Boolean

bool

True の 場合は、ユーザーの検索履歴が自動的に追跡され、提案を提供するために使用されます。それ以外の場合は false。 既定値は、true です。

属性

DeprecatedAttribute

注釈

重要

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

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

Note

アプリでは、検索ボックス (Windows.UI.Xaml.Controls.SearchBox/WinJS.UI.SearchBox) と SearchPane の両方を使用することはできません。 同じアプリで検索ボックスと検索ウィンドウの両方を使用すると、"型 'Windows.UI.Xaml.Controls.SearchBox.' のインスタンスを作成できません"というメッセージでアプリが例外をスローします。

このプロパティを false に設定すると、自動提案をオプトアウトできます。アプリは、必要に応じて、ユーザーに独自の提案を提供できます。 アプリで独自の検索履歴を追跡する場合は、履歴をクリアする機能など、[設定] チャームを使用してユーザーに履歴を制御してもらう必要もあります。

検索ウィンドウを開いているときにこのプロパティを設定した場合、ユーザーがクエリの次の文字を入力するまで変更は有効になりません。

こちらもご覧ください

• SearchPane
• SearchHistoryContext