FileActivatedEventArgs Classe

Definizione

Spazio dei nomi:

Windows.ApplicationModel.Activation

Fornisce i dati quando un'app viene attivata perché è l'app associata a un file.

Javascript Questo tipo viene visualizzato come WebUIFileActivatedEventArgs.

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

Public NotInheritable Class FileActivatedEventArgs
Implements IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithCallerPackageFamilyName, IFileActivatedEventArgsWithNeighboringFiles, IViewSwitcherProvider

Ereditarietà

Object Platform::Object IInspectable FileActivatedEventArgs

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute

Implementazioni

IActivatedEventArgs IApplicationViewActivatedEventArgs IFileActivatedEventArgs IFileActivatedEventArgsWithCallerPackageFamilyName IFileActivatedEventArgsWithNeighboringFiles IViewSwitcherProvider IActivatedEventArgsWithUser

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

Il gestore eventi OnFileActivated nell'oggetto Application riceve tutti gli eventi di attivazione dei file.

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
}

Commenti

Questo oggetto viene accessibile quando si implementa un gestore eventi per rispondere agli eventi Attivati quando ActivationKind è File.

L'app UWP usando C++, C#o Visual Basic implementa in genere i punti di attivazione eseguendo l'override dei metodi dell'oggetto Application . I file code-behind modello predefiniti includono sempre un override per OnLaunched, ma la definizione degli overridi per altri punti di attivazione, ad esempio OnFileActivated , è fino al codice dell'app.

Tutti gli overridi dell'applicazione coinvolti in uno scenario di attivazione devono chiamare Window.Activate nelle implementazioni.

Si noti che quando l'app viene attivata per il contratto file è necessario accedere ai dati usando gli oggetti StorageFile passati all'app tramite la proprietà Files . Non è consigliabile tentare di accedere al percorso del file poiché l'app potrebbe non disporre dell'autorizzazione per il percorso del file.

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
1607	14393	Utente

Proprietà

CallerPackageFamilyName	Nome della famiglia di pacchetti dell'app che ha avviato l'app.
CurrentlyShownApplicationViewId	Ottiene l'identificatore per la visualizzazione dell'app attualmente visualizzata.
Files	Ottiene i file per cui è stata attivata l'app.
Kind	Ottiene il tipo di attivazione.
NeighboringFilesQuery	Ottiene i file adiacenti dei file per cui è stata attivata l'app.
PreviousExecutionState	Ottiene lo stato di esecuzione dell'app prima dell'attivazione.
SplashScreen	Ottiene l'oggetto schermata iniziale che fornisce informazioni sulla transizione dalla schermata iniziale all'app attivata.
User	Ottiene l'utente per cui è stata attivata l'app.
Verb	Ottiene l'azione associata al file attivato.
ViewSwitcher	Fornisce l'oggetto che consente di impostare la visualizzazione per l'applicazione.

Vedi anche

• Windows.Storage
• Activated
• OnFileActivated(FileActivatedEventArgs)
• Esempio di avvio di associazione
• Gestire l'attivazione di file
• Linee guida per tipi di file e URI
• Esempio di avvio dell'associazione (Windows 10)