Partager via


FileOpenPickerUI Classe

Définition

Permet d’interagir avec le sélecteur de fichiers si votre application fournit des fichiers avec le contrat Du sélecteur d’ouverture de fichier.

public ref class FileOpenPickerUI sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class FileOpenPickerUI final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class FileOpenPickerUI
Public NotInheritable Class FileOpenPickerUI
Héritage
Object Platform::Object IInspectable FileOpenPickerUI
Attributs

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

L’exemple de fournisseur du sélecteur de fichiers montre comment répondre à un événement activé 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 contient un objet FileOpenPickerActivatedEventArgs . En outre, se OnFileOpenPickerActivated trouve dans le fichier App.xaml.cs et la Activate méthode se trouve dans le fichier FileOpenPickerPage.xaml.cs de l’exemple de fournisseur du sélecteur de fichiers.

Remarques

Si votre application participe au contrat Sélecteur d’ouverture de fichiers, vous pouvez récupérer cet objet à l’aide d’une propriété FileOpenPickerUI pendant que vous gérez un événement activé FileOpenPicker .

Utilisez la propriété Windows.ApplicationModel.Activation.FileOpenPickerActivatedEventArgs.FileOpenPickerUI pour accéder à un FileOpenPickerUI.

Découvrez comment créer une bonne expérience pour les utilisateurs lorsqu’ils accèdent à vos fichiers via le sélecteur de fichiers en lisant les instructions d’expérience utilisateur pour fournir des fichiers dans Ouvrir des fichiers et des dossiers avec un sélecteur.

Propriétés

AllowedFileTypes

Obtient une liste des types de fichiers (extensions) que l’utilisateur peut choisir.

SelectionMode

Obtient une valeur d’énumération qui indique si le sélecteur de fichiers limite actuellement la sélection aux fichiers uniques ou si plusieurs fichiers peuvent être sélectionnés.

SettingsIdentifier

Obtient un identificateur pour le contexte actuel du sélecteur de fichiers.

Title

Obtient ou définit un titre à afficher dans l’interface utilisateur du sélecteur de fichiers qui identifie l’emplacement que le sélecteur de fichiers affiche à l’utilisateur.

Méthodes

AddFile(String, IStorageFile)

Ajoute le fichier spécifié à la liste des fichiers que l’utilisateur a choisi.

CanAddFile(IStorageFile)

Indique si le fichier spécifié peut être ajouté à la liste des fichiers que l’utilisateur a choisi.

ContainsFile(String)

Détermine si le fichier spécifié figure dans la liste des fichiers que l’utilisateur a choisi.

RemoveFile(String)

Supprime le fichier spécifié de la liste des fichiers que l’utilisateur a choisis.

Événements

Closing

Se déclenche lorsque l’utilisateur ferme le sélecteur de fichiers.

FileRemoved

Notes

L’événement FileRemoved est déconseillé et ne doit pas être utilisé.

Se déclenche lorsque l’utilisateur supprime un fichier de la liste des fichiers que l’utilisateur a choisi si ce fichier a été ajouté par l’application qui fournit les fichiers.

S’applique à

Voir aussi