SearchPane.TrySetQueryText(String) Метод

Определение

Пытается задать текст в поле поиска области поиска.

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

Параметры

query
String

Platform::String

winrt::hstring

Текст запроса, который будет отображаться в поле поиска области поиска.

Возвращаемое значение

Boolean

bool

true Значение , если текст поля поиска был успешно задан; в противном случае — false.

Атрибуты

Комментарии

Важно!

Чтобы реализовать поиск в приложении для Windows 10 или более поздней версии, используйте AutoSuggestBox. Дополнительные сведения см. в разделе Поле автозаполнения .

Не следует использовать API Windows.ApplicationModel.Search (SearchPane, SearchContract) или API SearchBox в приложениях для Windows 10 или более поздних версий.

Примечание

Приложение не может использовать одновременно поле поиска (Windows.UI.Xaml.Controls.SearchBox/WinJS.UI.SearchBox) и SearchPane. Использование поля поиска и области поиска в одном приложении приводит к тому, что приложение выдает исключение с сообщением "Не удается создать экземпляр типа Windows.UI.Xaml.Controls.SearchBox".

Если у вас есть поле поиска в приложении, используйте этот метод для обеспечения согласованности между областью поиска и полем поиска. Большинство приложений должны отвечать в области поиска, а не использовать пользовательский интерфейс поиска в приложении.

Применяется к