SearchPane.TrySetQueryText(String) 메서드

정의

네임스페이스:

Windows.ApplicationModel.Search

검색 창의 검색 상자에 텍스트를 설정하려고 시도합니다.

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")]
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.

특성

DeprecatedAttribute

설명

중요

앱에서 Windows 10 이상 검색을 구현하려면 AutoSuggestBox를 사용합니다. 자세한 내용은 자동 제안 상자를 참조하세요.

Windows 10 이상 앱에서 Windows.ApplicationModel.Search API(SearchPane, SearchContract) 또는 SearchBox API를 사용하면 안 됩니다.

참고

앱은 검색 상자(Windows.UI.Xaml.Controls.SearchBox/WinJS.UI.SearchBox)와 SearchPane을 모두 사용할 수 없습니다. 동일한 앱에서 검색 상자와 검색 창을 모두 사용하면 앱에서 "'Windows.UI.Xaml.Controls.SearchBox' 유형의 인스턴스를 만들 수 없습니다."라는 메시지와 함께 예외가 발생합니다.

앱 내 검색 상자가 있는 경우 이 메서드를 사용하여 검색 창과 검색 상자 간의 일관성을 유지합니다. 대부분의 앱은 앱 내 검색 UI를 사용하는 대신 검색 창에 회신해야 합니다.