SearchActivatedEventArgs 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
사용자가 검색 참에서 앱을 검색하고 앱이 화면의 기본 앱이 아닐 때 발생하는 활성화된 이벤트에 대한 정보를 제공합니다.
자바 스크립트 이 형식은 webUISearchActivatedEventArgs로 표시됩니다.
public ref class SearchActivatedEventArgs sealed : IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProviderpublic ref class SearchActivatedEventArgs sealed : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProvider/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class SearchActivatedEventArgs final : IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProvider/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class SearchActivatedEventArgs final : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProvider[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class SearchActivatedEventArgs : IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProvider[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class SearchActivatedEventArgs : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProviderPublic NotInheritable Class SearchActivatedEventArgs
Implements IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProviderPublic NotInheritable Class SearchActivatedEventArgs
Implements IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProvider- 상속
- 특성
- 구현
Windows 요구 사항
| 디바이스 패밀리 |
Windows 10 (10.0.10240.0에서 도입되었습니다.)
|
| API contract |
Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)
|
설명
중요
앱에서 Windows 10 이상 검색을 구현하려면 AutoSuggestBox를 사용합니다. 자세한 내용은 자동 제안 상자를 참조하세요.
Windows 10 이상 앱에서 Windows.ApplicationModel.Search API(SearchPane, SearchContract) 또는 SearchBox API를 사용하면 안 됩니다.
앱이 Search 계약과 통합되면 사용자가 검색 참에서 앱을 검색하고 앱이 화면의 기본 앱이 아닌 경우 SearchActivatedEventArgs 개체가 앱의 OnSearchActivated 활성화 지점 처리기에 전달됩니다. 이 유형의 활성화는 Kind 속성에서 반환된 ActivationKind.Search 값으로 표시됩니다.
활성화 시나리오와 관련된 모든 애플리케이션 재정의는 해당 구현에서 Window.Activate 를 호출해야 합니다.
버전 기록
| Windows 버전 | SDK 버전 | 추가된 값 |
|---|---|---|
| 1607 | 14393 | 사용자 |
속성
| CurrentlyShownApplicationViewId |
현재 표시된 앱 보기의 식별자를 가져옵니다. |
| Kind |
활성화 유형을 가져옵니다. |
| Language |
현재 사용자의 텍스트 입력 디바이스와 연결된 언어를 식별하는 IETF(인터넷 엔지니어링 태스크 포스) 언어 태그(BCP 47 표준)를 가져옵니다. |
| LinguisticDetails |
사용자가 IME(입력 방법 편집기)를 통해 입력하는 쿼리 텍스트에 대한 정보를 제공하는 SearchPaneQueryLinguisticDetails 개체를 가져옵니다. |
| PreviousExecutionState |
활성화되기 전에 앱의 실행 상태를 가져옵니다. |
| QueryText |
사용자가 앱을 검색할 텍스트를 가져옵니다. 사용자가 검색 창의 검색 상자에 이 텍스트를 입력했습니다. |
| SplashScreen |
시작 화면에서 활성화된 앱으로의 전환에 대한 정보를 제공하는 SplashScreen 개체를 가져옵니다. |
| User |
앱이 활성화된 사용자를 가져옵니다. |
| ViewSwitcher |
애플리케이션에 대한 보기를 설정할 수 있는 뷰 전환기 개체를 가져옵니다. |