FileActivatedEventArgs Classe
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit des données lorsqu’une application est activée, car il s’agit de l’application associée à un fichier.
Javascript Ce type apparaît sous la forme 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
- Héritage
- Attributs
- Implémente
Famille d’appareils |
Windows 10 (introduit dans 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (introduit dans v1.0)
|
Le gestionnaire d’événements OnFileActivated sur l’objet Application reçoit tous les événements d’activation de fichier.
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
}
Cet objet est accessible lorsque vous implémentez un gestionnaire d’événements pour répondre aux événements activés lorsque ActivationKind est File.
L’application UWP utilisant C++, C# ou Visual Basic implémente généralement des points d’activation en remplaçant les méthodes de l’objet Application . Les fichiers code-behind de modèle par défaut app.xaml incluent toujours une substitution pour OnLaunched, mais la définition de remplacements pour d’autres points d’activation tels que OnFileActivated dépend du code de votre application.
Toutes les substitutions d’application impliquées dans un scénario d’activation doivent appeler Window.Activate dans leurs implémentations.
Notez que lorsque votre application est activée pour le contrat de fichier, vous devez accéder aux données à l’aide des objets StorageFile transmis à votre application via la propriété Files . Vous ne devez pas tenter d’accéder au chemin du fichier, car votre application n’a peut-être pas l’autorisation d’accéder à l’emplacement du fichier.
Version de Windows | Version du SDK | Valeur ajoutée |
---|---|---|
1607 | 14393 | Utilisateur |
Caller |
Nom de la famille de package de l’application qui a lancé votre application. |
Currently |
Obtient l’identificateur de la vue d’application actuellement affichée. |
Files |
Obtient les fichiers pour lesquels l’application a été activée. |
Kind |
Obtient le type d’activation. |
Neighboring |
Obtient les fichiers voisins des fichiers pour lesquels l’application a été activée. |
Previous |
Obtient l’état d’exécution de l’application avant son activation. |
Splash |
Obtient l’objet d’écran de démarrage qui fournit des informations sur la transition de l’écran de démarrage à l’application activée. |
User |
Obtient l’utilisateur pour lequel l’application a été activée. |
Verb |
Obtient l’action associée au fichier activé. |
View |
Fournit l’objet qui vous permet de définir la vue de l’application. |