SearchPane.TrySetQueryText(String) Método

Definição

Namespace:

Windows.ApplicationModel.Search

Tenta definir o texto na caixa de pesquisa do painel de pesquisa.

public:
 virtual bool TrySetQueryText(Platform::String ^ query) = TrySetQueryText;

/// [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 TrySetQueryText(winrt::hstring const& query);

[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")]
public bool TrySetQueryText(string query);

function trySetQueryText(query)

Public Function TrySetQueryText (query As String) As Boolean

Parâmetros

query

String

Platform::String

winrt::hstring

O texto da consulta a ser mostrado na caixa de pesquisa do painel de pesquisa.

Retornos

Boolean

bool

true se o texto da caixa de pesquisa foi definido com êxito; caso contrário, false.

Atributos

DeprecatedAttribute

Comentários

Importante

Para implementar a pesquisa em um aplicativo para Windows 10 ou posterior, use AutoSuggestBox. Consulte 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 posteriores.

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.'"

Se você tiver uma caixa de pesquisa no aplicativo, use esse método para manter a consistência entre o painel de pesquisa e a caixa de pesquisa. A maioria dos aplicativos deve responder no painel de pesquisa em vez de usar a interface do usuário de pesquisa no aplicativo.