FileActivatedEventArgs Klasse

  • Referenz

Definition

Namespace:
Windows.ApplicationModel.Activation
Bearbeiten

Stellt Daten bereit, wenn eine App aktiviert wird, da es sich um die App handelt, die einer Datei zugeordnet ist.

Javascript Dieser Typ wird als WebUIFileActivatedEventArgs angezeigt.

public ref class FileActivatedEventArgs sealed : IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithCallerPackageFamilyName, IFileActivatedEventArgsWithNeighboringFiles, IViewSwitcherProvider
public ref class FileActivatedEventArgs sealed : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithCallerPackageFamilyName, IFileActivatedEventArgsWithNeighboringFiles, IViewSwitcherProvider
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class FileActivatedEventArgs final : IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithCallerPackageFamilyName, IFileActivatedEventArgsWithNeighboringFiles, IViewSwitcherProvider
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class FileActivatedEventArgs final : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithCallerPackageFamilyName, IFileActivatedEventArgsWithNeighboringFiles, IViewSwitcherProvider
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class FileActivatedEventArgs : IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithCallerPackageFamilyName, IFileActivatedEventArgsWithNeighboringFiles, IViewSwitcherProvider
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class FileActivatedEventArgs : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithCallerPackageFamilyName, IFileActivatedEventArgsWithNeighboringFiles, IViewSwitcherProvider
Public NotInheritable Class FileActivatedEventArgs
Implements IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithCallerPackageFamilyName, IFileActivatedEventArgsWithNeighboringFiles, IViewSwitcherProvider
Public NotInheritable Class FileActivatedEventArgs
Implements IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithCallerPackageFamilyName, IFileActivatedEventArgsWithNeighboringFiles, IViewSwitcherProvider
Vererbung
Object Platform::Object IInspectable FileActivatedEventArgs
Attribute
ContractVersionAttribute MarshalingBehaviorAttribute
Implementiert
IActivatedEventArgs IApplicationViewActivatedEventArgs IFileActivatedEventArgs IFileActivatedEventArgsWithCallerPackageFamilyName IFileActivatedEventArgsWithNeighboringFiles IViewSwitcherProvider IActivatedEventArgsWithUser

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Der OnFileActivated-Ereignishandler für das Application-Objekt empfängt alle Dateiaktivierungsereignisse.

protected override void OnFileActivated(FileActivatedEventArgs args)
{
       // TODO: Handle file activation

       // The number of files received is args.Files.Size
       // The first file is args.Files[0].Name
}

Private Sub OnFileActivated(ByVal args As Windows.ApplicationModel.Activation.FileActivatedEventArgs)
      ' TODO: Handle file activation

      ' The number of files received is args.Files.Size
      ' The first file is args.Files(0).Name
End Sub

void App::OnFileActivated(Windows::ApplicationModel::Activation::FileActivatedEventArgs const& /* args */)
{
    // TODO: Handle file activation.

    // The number of files received is args.Files().Size().
    // The first file is args.Files().GetAt(0).Name().
}

void App::OnFileActivated(Windows::ApplicationModel::Activation::FileActivatedEventArgs^ args)
{
       // TODO: Handle file activation

       // The number of files received is args->Files->Size
       // The first file is args->Files->GetAt(0)->Name
}

Hinweise

Auf dieses Objekt wird zugegriffen, wenn Sie einen Ereignishandler implementieren, um auf aktivierte Ereignisse zu reagieren, wenn ActivationKindDatei ist.

Die UWP-App mit C++, C# oder Visual Basic implementiert in der Regel Aktivierungspunkte, indem Methoden des Application-Objekts überschrieben werden. Die CodeBehind-Dateien der Standardvorlage app.xaml enthalten immer eine Überschreibung für OnLaunched, aber das Definieren von Überschreibungen für andere Aktivierungspunkte wie OnFileActivated liegt bei Ihrem App-Code.

Alle Anwendungsüberschreibungen , die an einem Aktivierungsszenario beteiligt sind, sollten Window.Activate in ihren Implementierungen aufrufen.

Beachten Sie, dass Sie beim Aktivieren Ihrer App für den Dateivertrag auf die Daten mithilfe der StorageFile-Objekte zugreifen müssen, die über die Files-Eigenschaft an Ihre App übergeben werden. Sie sollten nicht versuchen, auf den Pfad der Datei zuzugreifen, da Ihre App möglicherweise keine Berechtigung für den Speicherort der Datei hat.

Versionsverlauf

Windows-Version SDK-Version Wertschöpfung
1607 14393 User

Eigenschaften

CallerPackageFamilyName

Der Paketfamilienname der App, die Ihre App gestartet hat.
CurrentlyShownApplicationViewId

Ruft den Bezeichner für die aktuell angezeigte App-Ansicht ab.
Files

Ruft die Dateien ab, für die die App aktiviert wurde.
Kind

Ruft den Aktivierungstyp ab.
NeighboringFilesQuery

Ruft die benachbarten Dateien der Dateien ab, für die die App aktiviert wurde.
PreviousExecutionState

Ruft den Ausführungsstatus der App ab, bevor sie aktiviert wurde.
SplashScreen

Ruft das Begrüßungsbildschirmobjekt ab, das Informationen zum Übergang vom Begrüßungsbildschirm zur aktivierten App bereitstellt.
User

Ruft den Benutzer ab, für den die App aktiviert wurde.
Verb

Ruft die Aktion ab, die der aktivierten Datei zugeordnet ist.
ViewSwitcher

Stellt das -Objekt bereit, mit dem Sie die Ansicht für die Anwendung festlegen können.

Gilt für:

Weitere Informationen