SearchPane.TrySetQueryText(String) Méthode

Définition

Espace de noms:

Windows.ApplicationModel.Search

Tente de définir le texte dans la zone de recherche du volet de recherche.

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

Paramètres

query

String

Platform::String

winrt::hstring

Texte de requête à afficher dans la zone de recherche du volet de recherche.

Retours

Boolean

bool

true si le texte de la zone de recherche a été correctement défini ; sinon, false.

Attributs

DeprecatedAttribute

Remarques

Important

Pour implémenter la recherche dans une application pour Windows 10 ou une version ultérieure, utilisez AutoSuggestBox. Pour plus d’informations, consultez la zone Suggestion automatique.

Vous ne devez pas utiliser les API Windows.ApplicationModel.Search (SearchPane, SearchContract) ou les API SearchBox dans les applications pour Windows 10 ou une version ultérieure.

Notes

Une application ne peut pas utiliser à la fois la zone de recherche (Windows.UI.Xaml.Controls.SearchBox/WinJS.UI.SearchBox) et le SearchPane. L’utilisation de la zone de recherche et du volet de recherche dans la même application entraîne la levée d’une exception avec ce message : « Impossible de créer une instance de type 'Windows.UI.Xaml.Controls.SearchBox.' »

Si vous avez une zone de recherche dans l’application, utilisez cette méthode pour maintenir la cohérence entre le volet de recherche et votre zone de recherche. La plupart des applications doivent répondre dans le volet de recherche au lieu d’utiliser l’interface utilisateur de recherche dans l’application.