WebUIFileActivatedEventArgs 類別

定義

命名空間:

Windows.UI.WebUI

在應用程式啟動時提供資料，因為它是與檔案相關聯的應用程式。

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 : 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 : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithNeighboringFiles, IActivatedEventArgsDeferral

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	User

屬性

ActivatedOperation	取得應用程式啟用作業。
CurrentlyShownApplicationViewId	取得目前顯示之應用程式檢視的識別碼。
Files	取得啟動應用程式的檔案。
Kind	取得啟用類型。
NeighboringFilesQuery	取得啟動應用程式之檔案的鄰近檔案。
PreviousExecutionState	取得應用程式啟動前的執行狀態。
SplashScreen	取得啟動顯示畫面物件，提供從啟動顯示畫面轉換至啟動應用程式的相關資訊。
User	取得啟動應用程式的使用者。
Verb	取得與啟動檔案相關聯的動作。

另請參閱

• Windows.Storage
• ActivatedEventHandler
• 關聯啟動範例
• 如何處理檔案啟用
• 檔案類型與 URI 的指導方針
• WinJS.Application.onactivated
• 關聯啟動範例 (Windows 10)