다음을 통해 공유


SearchPaneSuggestionsRequestedEventArgs 클래스

정의

SearchPane 개체와 연결된 SuggestionsRequested 이벤트에 대한 데이터를 제공합니다.

public ref class SearchPaneSuggestionsRequestedEventArgs sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.ApplicationModel.Search.SearchContract, 65536)]
/// [Windows.Foundation.Metadata.Deprecated("SearchPaneSuggestionsRequestedEventArgs 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.Agile)]
class SearchPaneSuggestionsRequestedEventArgs final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.ApplicationModel.Search.SearchContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Deprecated("SearchPaneSuggestionsRequestedEventArgs may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")]
class SearchPaneSuggestionsRequestedEventArgs final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.ApplicationModel.Search.SearchContract), 65536)]
[Windows.Foundation.Metadata.Deprecated("SearchPaneSuggestionsRequestedEventArgs 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.Agile)]
public sealed class SearchPaneSuggestionsRequestedEventArgs
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.ApplicationModel.Search.SearchContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Deprecated("SearchPaneSuggestionsRequestedEventArgs may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")]
public sealed class SearchPaneSuggestionsRequestedEventArgs
Public NotInheritable Class SearchPaneSuggestionsRequestedEventArgs
상속
Object Platform::Object IInspectable SearchPaneSuggestionsRequestedEventArgs
특성
구현

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를 사용하면 안 됩니다.

이 개체는 앱의 SuggestionsRequested 이벤트 처리기에 전달됩니다.

앱을 사용하여 제안 제공

앱에서 제공할 제안을 받을 수 있는 몇 가지 방법이 있습니다.

  • 앱 정의 정적 로컬 목록에서
  • OpenSearch 형식의 제안을 지원하는 URL에서
  • 제안을 XML 형식으로 지원하는 URL에서 제안을 얻은 후 사용자의 쿼리에 표시할 제안 컬렉션에 추가해야 합니다. searchPaneSuggestionsRequest.searchSuggestionCollection 속성을 사용하여 이 컬렉션에 액세스합니다.

참고

결과 제안을 제공하려면 ResultSuggestionChosen 이벤트도 수신 대기하고 처리해야 합니다.

속성

Language

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

LinguisticDetails

사용자가 IME(입력 방법 편집기)를 통해 입력하는 쿼리 텍스트에 대한 언어 정보를 제공하는 개체를 가져옵니다.

QueryText

앱에서 제안을 제공해야 하고 SuggestionsRequested 이벤트가 발생했을 때 검색 상자에 있던 텍스트를 가져옵니다.

Request

요청에 대한 제안 및 정보를 저장하는 개체를 가져옵니다.

적용 대상