Compartir a través de


SearchPane.TrySetQueryText(String) Método

Definición

Intenta establecer el texto en el cuadro de búsqueda del panel de búsqueda.

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

Parámetros

query
String

Platform::String

winrt::hstring

Texto de consulta que se va a mostrar en el cuadro de búsqueda del panel de búsqueda.

Devoluciones

Boolean

bool

true si el texto del cuadro de búsqueda se estableció correctamente; de lo contrario, false.

Atributos

Comentarios

Importante

Para implementar la búsqueda en una aplicación para Windows 10 o posterior, use AutoSuggestBox. Consulte el cuadro Sugerencias automáticas para obtener más información.

No debe usar las API Windows.ApplicationModel.Search (SearchPane, SearchContract) ni SearchBox API en aplicaciones para Windows 10 o posterior.

Nota:

Una aplicación no puede usar el cuadro de búsqueda (Windows.UI.Xaml.Controls.SearchBox/WinJS.UI.SearchBox) y searchPane. El uso del cuadro de búsqueda y el panel de búsqueda en la misma aplicación hace que la aplicación produzca una excepción con este mensaje: "No se puede crear una instancia de tipo 'Windows.UI.Xaml.Controls.SearchBox'".

Si tiene un cuadro de búsqueda en la aplicación, use este método para mantener la coherencia entre el panel de búsqueda y el cuadro de búsqueda. La mayoría de las aplicaciones deben responder en el panel de búsqueda en lugar de usar la interfaz de usuario de búsqueda en la aplicación.

Se aplica a