SearchPane.TrySetQueryText(String) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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")]
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, typeof(Windows.ApplicationModel.Search.SearchContract))]
public bool TrySetQueryText(string 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
bool
true
si le texte de la zone de recherche a été correctement défini ; sinon, false
.
- Attributs
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.