Condividi tramite


FileActivatedEventArgs Classe

Definizione

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 : 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
Ereditarietà
Object Platform::Object IInspectable FileActivatedEventArgs
Attributi
Implementazioni

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.

Si applica a

Vedi anche