SearchPane.TrySetQueryText(String) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Tenta di impostare il testo nella casella di ricerca del riquadro di ricerca.
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 BooleanParametri
- query
-
String
Platform::String
winrt::hstring
Testo della query da visualizzare nella casella di ricerca del riquadro di ricerca.
Restituisce
bool
true se il testo della casella di ricerca è stato impostato correttamente; in caso contrario, false.
- Attributi
Commenti
Importante
Per implementare la ricerca in un'app per Windows 10 o versioni successive, usare AutoSuggestBox. Per altre informazioni, vedere Casella di suggerimento automatico .
Non è consigliabile usare API Windows.ApplicationModel.Search (SearchPane, SearchContract) o SearchBox nelle app per Windows 10 o versioni successive.
Nota
Un'app non può usare la casella di ricerca (Windows.UI.Xaml.Controls.SearchBoxWinJS.UI.SearchBox/) e SearchPane. Usando sia la casella di ricerca che il riquadro di ricerca nella stessa app, l'app genera un'eccezione con questo messaggio: "Impossibile creare un'istanza di tipo 'Windows.UI.Xaml.Controls.SearchBox'"
Se si dispone di una casella di ricerca in-app, usare questo metodo per mantenere la coerenza tra il riquadro di ricerca e la casella di ricerca. La maggior parte delle app deve rispondere nel riquadro di ricerca anziché usare l'interfaccia utente di ricerca in-app.