FileOpenPickerUI Classe
Définition
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.
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
- 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. |