다음을 통해 공유


SearchPane 클래스

정의

더 이상 사용되지 않습니다. 대신 Windows.UI.Xaml.Controls.AutoSuggestBox 컨트롤을 사용합니다. 사용자가 검색 참을 활성화할 때 열리는 검색 창을 나타내고 관리합니다.

public ref class SearchPane sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.ApplicationModel.Search.SearchContract, 65536)]
/// [Windows.Foundation.Metadata.Deprecated("SearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, Windows.ApplicationModel.Search.SearchContract)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class SearchPane final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.ApplicationModel.Search.SearchContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Deprecated("SearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")]
class SearchPane final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.ApplicationModel.Search.SearchContract), 65536)]
[Windows.Foundation.Metadata.Deprecated("SearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, typeof(Windows.ApplicationModel.Search.SearchContract))]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class SearchPane
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.ApplicationModel.Search.SearchContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Deprecated("SearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")]
public sealed class SearchPane
Public NotInheritable Class SearchPane
상속
Object Platform::Object IInspectable SearchPane
특성

Windows 요구 사항

디바이스 패밀리
Windows Desktop Extension SDK (10.0.10240.0에서 도입되었습니다.)
Xbox One Extensions for the UWP (10.0.10586.0에서 도입되었습니다.)
API contract
Windows.ApplicationModel.Search.SearchContract (v1.0에서 도입되었습니다.)

설명

중요

앱에서 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' 유형의 인스턴스를 만들 수 없습니다."라는 메시지와 함께 예외가 발생합니다.

이 개체는 검색 계약에 참여하는 앱에서 사용할 수 있습니다. 사용자에게 검색 결과를 제공하려면 앱이 검색을 위해 활성화될 때 응답하는 활성화된 이벤트 처리기에 코드를 추가해야 합니다. Search 활성화 이벤트에 응답하는 방법에 대한 자세한 내용은 webUISearchActivatedEventArgs(JavaScript) 또는 SearchActivatedEventArgs(C#/C++/VB)를 참조하세요.

검색 계약 샘플(Windows 8)에서 검색 이벤트에 응답하고 검색 창을 관리하는 방법을 보여 주는 코드 예제를 볼 수 있습니다.

속성

Language

현재 사용자의 텍스트 입력 디바이스와 연결된 언어를 식별하는 IETF(인터넷 엔지니어링 태스크 포스) 언어 태그(BCP 47 표준)입니다.

PlaceholderText

사용자가 문자를 입력하지 않은 경우 검색 상자의 자리 표시자 텍스트입니다.

QueryText

검색 창의 검색 상자에 있는 현재 텍스트입니다.

SearchHistoryContext

검색 컨텍스트를 식별하고 앱과 함께 사용자의 검색 기록을 저장하는 데 사용되는 문자열입니다.

SearchHistoryEnabled

앱에서 사용자의 이전 검색이 자동으로 추적되고 제안을 제공하는 데 사용되는지 여부를 나타냅니다.

ShowOnKeyboardInput

사용자가 입력하여 검색 창을 열 수 있는지 여부를 가져오거나 설정합니다.

Visible

검색 창이 열려 있는지 여부를 나타냅니다.

메서드

GetForCurrentView()

사용자가 앱 내에서 검색할 수 있는 검색 창의 인스턴스를 검색합니다.

HideThisApplication()

현재 앱의 UI를 숨깁니다.

SetLocalContentSuggestionSettings(LocalContentSuggestionSettings)

로컬 파일을 기반으로 하는 제안이 검색 창에 자동으로 표시되는지 여부를 지정하고 Windows에서 이러한 제안을 찾아 필터링하는 데 사용하는 조건을 정의합니다.

Show()

검색 창을 표시합니다.

Show(String)

지정된 초기 쿼리 문자열이 있는 검색 창을 표시합니다.

TrySetQueryText(String)

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

이벤트

QueryChanged

사용자가 검색 상자에서 텍스트를 변경하면 발생합니다.

QuerySubmitted

사용자가 검색 상자에 텍스트를 제출하고 앱이 검색 결과를 표시해야 할 때 발생합니다.

ResultSuggestionChosen

사용자가 앱에서 제공하고 검색 창에 표시한 제안된 결과 중 하나를 선택하면 발생합니다.

SuggestionsRequested

사용자의 쿼리 텍스트가 변경되고 앱이 검색 창에 표시할 새 제안을 제공해야 할 때 발생합니다.

VisibilityChanged

사용자가 검색 창을 열거나 닫을 때 발생합니다.

적용 대상

추가 정보