SearchActivatedEventArgs 클래스

정의

사용자가 검색 참에서 앱을 검색하고 앱이 화면의 기본 앱이 아닐 때 발생하는 활성화된 이벤트에 대한 정보를 제공합니다.

자바 스크립트 이 형식은 webUISearchActivatedEventArgs로 표시됩니다.

public ref class SearchActivatedEventArgs sealed : IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProvider
public 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, IViewSwitcherProvider
Public NotInheritable Class SearchActivatedEventArgs
Implements IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProvider
Public NotInheritable Class SearchActivatedEventArgs
Implements IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProvider
상속
Object Platform::Object IInspectable SearchActivatedEventArgs
특성
구현

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

애플리케이션에 대한 보기를 설정할 수 있는 뷰 전환기 개체를 가져옵니다.

적용 대상

추가 정보