FileOpenPickerActivatedEventArgs Classe

Référence

Définition

Espace de noms:: Windows.ApplicationModel.Activation

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.

Modifier

Fournit des informations sur un événement activé qui se déclenche lorsque l’utilisateur tente de sélectionner des fichiers ou des dossiers fournis par l’application.

Javascript Ce type apparaît sous la forme WebUIFileOpenPickerActivatedEventArgs.

public ref class FileOpenPickerActivatedEventArgs sealed : IFileOpenPickerActivatedEventArgs, IFileOpenPickerActivatedEventArgs2

public ref class FileOpenPickerActivatedEventArgs sealed : IActivatedEventArgsWithUser, IFileOpenPickerActivatedEventArgs, IFileOpenPickerActivatedEventArgs2

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class FileOpenPickerActivatedEventArgs final : IFileOpenPickerActivatedEventArgs, IFileOpenPickerActivatedEventArgs2

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class FileOpenPickerActivatedEventArgs final : IActivatedEventArgsWithUser, IFileOpenPickerActivatedEventArgs, IFileOpenPickerActivatedEventArgs2

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class FileOpenPickerActivatedEventArgs : IFileOpenPickerActivatedEventArgs, IFileOpenPickerActivatedEventArgs2

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class FileOpenPickerActivatedEventArgs : IActivatedEventArgsWithUser, IFileOpenPickerActivatedEventArgs, IFileOpenPickerActivatedEventArgs2

Public NotInheritable Class FileOpenPickerActivatedEventArgs
Implements IFileOpenPickerActivatedEventArgs, IFileOpenPickerActivatedEventArgs2

Public NotInheritable Class FileOpenPickerActivatedEventArgs
Implements IActivatedEventArgsWithUser, IFileOpenPickerActivatedEventArgs, IFileOpenPickerActivatedEventArgs2

Héritage: Object Platform::Object IInspectable FileOpenPickerActivatedEventArgs

Attributs: ContractVersionAttribute MarshalingBehaviorAttribute

Implémente: IActivatedEventArgs IFileOpenPickerActivatedEventArgs IFileOpenPickerActivatedEventArgs2 IActivatedEventArgsWithUser

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

L’exemple de contrats du sélecteur de fichiers montre comment répondre à un point d’activation FileOpenPicker.

// File open picker activated event handler
protected override void OnFileOpenPickerActivated(FileOpenPickerActivatedEventArgs args)
{
    var FileOpenPickerPage = new SDKTemplate.FileOpenPickerPage();
    FileOpenPickerPage.Activate(args);
}

// Overloaded method to respond to fileOpenPicker events
public void Activate(FileOpenPickerActivatedEventArgs args)
{
    // Perform tasks to prepare your app to display its file picker page

    // Get file picker UI
    fileOpenPickerUI = args.FileOpenPickerUI;

    Window.Current.Content = this;
    this.OnNavigatedTo(null);
    Window.Current.Activate();
}

Pour C#, args pour un remplacement OnFileOpenPickerActivated fait référence à un objet FileOpenPickerActivatedEventArgs. Le remplacement OnFileOpenPickerActivated se trouve dans le fichier App.xaml.cs et la Activate méthode se trouve dans le fichier FileOpenPickerPage.xaml.cs de l’exemple de contrats du sélecteur de fichiers.

Remarques

Découvrez comment fournir des fichiers que l’utilisateur peut choisir dans votre application dans Démarrage rapide : Fournir des services de fichiers via et dans la référence de l’espace de noms Windows.Storage.Pickers.Provider .

Un objet FileOpenPickerActivatedEventArgs est passé au gestionnaire d’événements activés de l’application lorsque l’utilisateur souhaite sélectionner des fichiers ou des dossiers fournis par l’application. Ce type d’activation est indiqué par la valeur ActivationKind.FileOpenPicker retournée par la propriété Kind .

Les applications écrites en JavaScript doivent écouter et gérer les événements Windows.UI.WebUI.webUIApplication.activated .

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 app.xaml de modèle par défaut incluent toujours un remplacement pour OnLaunched, mais la définition de remplacements pour d’autres points d’activation tels que OnFileOpenPickerActivated dépend du code de votre application.

Tous les remplacements d’application impliqués dans un scénario d’activation doivent appeler Window.Activate dans leurs implémentations.

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1607	14393	Utilisateur

Propriétés

CallerPackageFamilyName	Nom de la famille de packages de l’application qui a lancé votre application.
FileOpenPickerUI	Obtient l’interface utilisateur de la boîte aux lettres du sélecteur de fichiers qui s’affiche lorsque l’utilisateur souhaite sélectionner des fichiers ou des dossiers fournis par l’application.
Kind	Obtient le type d’activation.
PreviousExecutionState	Obtient l’état d’exécution de l’application avant son activation.
SplashScreen	Obtient un objet SplashScreen 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.

S’applique à

Partager via