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
Текст запроса, который будет отображаться в поле поиска области поиска.
Возвращаемое значение
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".
Если у вас есть поле поиска в приложении, используйте этот метод для обеспечения согласованности между областью поиска и полем поиска. Большинство приложений должны отвечать в области поиска, а не использовать пользовательский интерфейс поиска в приложении.