FolderPicker Classe

Définition

Espace de noms:

Windows.Storage.Pickers

Représente un élément d’interface utilisateur qui permet à l’utilisateur de choisir des dossiers.

Dans une application de bureau, avant d’utiliser un instance de cette classe d’une manière qui affiche l’interface utilisateur, vous devez associer l’objet au handle de fenêtre de son propriétaire. Pour plus d’informations et des exemples de code, consultez Afficher des objets d’interface utilisateur WinRT qui dépendent de CoreWindow.

public ref class FolderPicker sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class FolderPicker final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class FolderPicker

function FolderPicker()

Public NotInheritable Class FolderPicker

Héritage

Object Platform::Object IInspectable FolderPicker

Attributs

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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)

Remarques

Pour commencer à accéder aux fichiers et dossiers avec un sélecteur, consultez Ouvrir des fichiers et des dossiers avec un sélecteur.

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1903	18362	CreateForUser
1903	18362	Utilisateur

Constructeurs

FolderPicker()

Crée une instance d’un FolderPicker. Dans une application de bureau, avant d’utiliser un instance de cette classe d’une manière qui affiche l’interface utilisateur, vous devez associer l’objet au handle de fenêtre de son propriétaire. Pour plus d’informations et des exemples de code, consultez Afficher des objets d’interface utilisateur WinRT qui dépendent de CoreWindow.

Propriétés

CommitButtonText	Obtient ou définit le texte d’étiquette du bouton de validation du sélecteur de dossiers.
ContinuationData	Obtient un ensemble de valeurs à remplir par l’application avant une opération PickFolderAndContinue qui désactive l’application afin de fournir un contexte lorsque l’application est activée. (Windows Phone application 8.x)
FileTypeFilter	Obtient la collection de types de fichiers affichés par le sélecteur de dossiers.
SettingsIdentifier	Obtient ou définit l’identificateur de paramètres associé à l’instance FolderPicker actuel.
SuggestedStartLocation	Obtient ou définit l’emplacement initial où le sélecteur de dossiers recherche les dossiers à présenter à l’utilisateur.
User	Obtient des informations sur l’utilisateur pour lequel le FolderPicker a été créé. Utilisez cette propriété pour les applications multi-utilisateurs.
ViewMode	Obtient ou définit le mode d’affichage utilisé par le sélecteur de dossiers pour afficher les éléments.

Méthodes

CreateForUser(User)	Crée un FolderPicker qui est limité au répertoire personnel de l’utilisateur spécifié. Utilisez cette méthode pour les applications multi-utilisateurs.
PickFolderAndContinue()	Obsolète à partir de Windows 10 ; utilisez plutôt PickSingleFolderAsync. Affiche le sélecteur de fichiers afin que l’utilisateur puisse choisir un dossier, en désactivant et l’application et en le réactivant une fois l’opération terminée. (Windows Phone application 8.x)
PickSingleFolderAsync()	Affiche l’objet folderPicker afin que l’utilisateur puisse choisir un dossier. (application UWP) Notes Vous devez spécifier le FileTypeFilter avant d’appeler cette méthode, sinon elle lève une exception. Pour répertorier tous les dossiers, utilisez « * » comme filtre.

Voir aussi

• Exemple de sélecteur de fichiers
• Afficher les objets d’interface utilisateur WinRT qui dépendent de CoreWindow