SearchPane.SearchHistoryEnabled Propriedade

Definição

Namespace:

Windows.ApplicationModel.Search

Indica se as pesquisas anteriores do usuário com o aplicativo são rastreadas automaticamente e usadas para fornecer sugestões.

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

Valor da propriedade

Boolean

bool

True se o histórico de pesquisa do usuário for rastreado automaticamente e usado para fornecer sugestões; caso contrário, false. O valor padrão é true.

Atributos

DeprecatedAttribute

Comentários

Importante

Para implementar a pesquisa em um aplicativo para Windows 10 ou posterior, use AutoSuggestBox. Confira Caixa de sugestão automática para obter mais informações.

Você não deve usar APIs Windows.ApplicationModel.Search (SearchPane, SearchContract) ou APIs SearchBox em aplicativos para Windows 10 ou posterior.

Observação

Um aplicativo não pode usar a caixa de pesquisa (Windows.UI.Xaml.Controls.SearchBox/WinJS.UI.SearchBox) e o SearchPane. Usar a caixa de pesquisa e o painel de pesquisa no mesmo aplicativo faz com que o aplicativo gere uma exceção com esta mensagem: "Não é possível criar uma instância do tipo 'Windows.UI.Xaml.Controls.SearchBox.'"

Você pode definir essa propriedade como false para recusar sugestões automáticas; opcionalmente, seu aplicativo pode fornecer suas próprias sugestões aos usuários. Se você decidir fazer com que seu aplicativo acompanhe seu próprio histórico de pesquisa, você também deve dar ao usuário algum controle sobre seu histórico por meio do botão Configurações, como a capacidade de limpar o histórico.

Se você definir essa propriedade enquanto o painel de pesquisa estiver aberto, a alteração não entrará em vigor até que o usuário insira o próximo caractere da consulta.

Confira também

• SearchPane
• SearchHistoryContext