다음을 통해 공유

WebUIFileActivatedEventArgs 클래스

  • 참조

정의

네임스페이스:
Windows.UI.WebUI
편집

앱이 파일과 연결된 앱이므로 활성화될 때 데이터를 제공합니다.

public ref class WebUIFileActivatedEventArgs sealed : IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithNeighboringFiles, IActivatedEventArgsDeferral
public ref class WebUIFileActivatedEventArgs sealed : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithNeighboringFiles, IActivatedEventArgsDeferral
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class WebUIFileActivatedEventArgs final : IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithNeighboringFiles, IActivatedEventArgsDeferral
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class WebUIFileActivatedEventArgs final : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithNeighboringFiles, IActivatedEventArgsDeferral
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class WebUIFileActivatedEventArgs : IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithNeighboringFiles, IActivatedEventArgsDeferral
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class WebUIFileActivatedEventArgs : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithNeighboringFiles, IActivatedEventArgsDeferral
Public NotInheritable Class WebUIFileActivatedEventArgs
Implements IActivatedEventArgsDeferral, IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithNeighboringFiles
Public NotInheritable Class WebUIFileActivatedEventArgs
Implements IActivatedEventArgsDeferral, IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithNeighboringFiles
상속
Object Platform::Object IInspectable WebUIFileActivatedEventArgs
특성
ContractVersionAttribute MarshalingBehaviorAttribute
구현
IActivatedEventArgs IApplicationViewActivatedEventArgs IFileActivatedEventArgs IFileActivatedEventArgsWithNeighboringFiles IActivatedEventArgsDeferral IActivatedEventArgsWithUser

Windows 요구 사항

디바이스 패밀리
Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract
Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

예제

활성화된 이벤트 처리기는 모든 활성화 이벤트를 수신합니다. 속성은 활성화 이벤트의 유형을 나타냅니다. 이 예제는 파일 활성화 이벤트를 처리하도록 설정됩니다.

function onActivatedHandler(eventArgs) {
   if (eventArgs.detail.kind == Windows.ApplicationModel.Activation.ActivationKind.file) 
   {
       // TODO: Handle file activation.

       // The number of files received is eventArgs.detail.files.size
       // The first file is eventArgs.detail.files[0].name
   }
}

설명

이 개체는 ActivationKind가 파일일 때 WinJS.Application.Onactivated 또는 Windows.UI.WebUI.WebUIApplication.activated 이벤트에 대한 이벤트 처리기를 구현할 때 액세스됩니다. 앱이 파일 계약에 대해 활성화되면 Files 속성을 통해 앱에 전달된 StorageFile 개체를 사용하여 데이터에 액세스해야 합니다. 앱에 파일 위치에 대한 권한이 없을 수 있으므로 파일 경로에 액세스하려고 시도해서는 안 됩니다.

참고

이 클래스는 민첩하지 않으므로 스레딩 모델 및 마샬링 동작을 고려해야 합니다. 자세한 내용은 스레딩 및 마샬링(C++/CX)을 참조하세요.

버전 기록

Windows 버전 SDK 버전 추가된 값
1607 14393 사용자

속성

ActivatedOperation

앱 활성화 작업을 가져옵니다.
CurrentlyShownApplicationViewId

현재 표시된 앱 보기의 식별자를 가져옵니다.
Files

앱이 활성화된 파일을 가져옵니다.
Kind

활성화 유형을 가져옵니다.
NeighboringFilesQuery

앱이 활성화된 파일의 인접 파일을 가져옵니다.
PreviousExecutionState

활성화되기 전에 앱의 실행 상태를 가져옵니다.
SplashScreen

시작 화면에서 활성화된 앱으로의 전환에 대한 정보를 제공하는 시작 화면 개체를 가져옵니다.
User

앱이 활성화된 사용자를 가져옵니다.
Verb

활성화된 파일과 연결된 작업을 가져옵니다.

적용 대상

추가 정보