FolderPicker, classe

FolderPicker Class

Représente un élément d'interface qui permet à l'utilisateur de sélectionner des dossiers.

Syntaxe


var folderPicker = new Windows.Storage.Pickers.FolderPicker();

Attributs

[Version(0x06020000)]

Membres

FolderPickerClasse possède ces types de membres :

Constructeurs

FolderPickerClasse possède ces constructeurs.

ConstructeurDescription
FolderPicker Creates a new instance of a FolderPicker.

 

Méthodes

The FolderPicker Classe a les méthodes suivantes. Avec C#, Visual Basic et C++, elle hérite également des méthodes de Object Classe.

MéthodeDescription
PickSingleFolderAsync Shows the folderPicker object so that the user can pick a folder.

 

Propriétés

Le FolderPickerClasse a les propriétés suivantes.

PropriétéType d'accèsDescription

CommitButtonText

Lecture/écritureGets or sets the label text of the folder picker's commit button.

FileTypeFilter

En lecture seuleGets the collection of file types that the folder picker displays.

SettingsIdentifier

Lecture/écritureGets or sets the settings identifier associated with the with the current FolderPicker instance.

SuggestedStartLocation

Lecture/écritureGets or sets the initial location where the folder picker looks for folders to present to the user.

ViewMode

Lecture/écritureGets or sets the view mode that the folder picker uses to display items.

 

Remarques

Pour commencer à accéder aux sélecteurs de fichiers et de dossiers, consultez Démarrage rapide : accès aux fichiers à l'aide d'un sélecteur de fichiers.

Avertissement  Si vous essayez d'afficher le sélecteur de fichiers pendant que votre application est alignée, le sélecteur de fichiers ne sera pas affiché et une exception sera levée. Vous pouvez éviter ceci en vérifiant que votre application n'est pas alignée ou en annulant l'alignement avant d'appeler le sélecteur de fichiers. Les exemples de code suivants et l'exemple de sélecteur de fichier vous montrent comment procéder.

Exemples

L'Exemple de sélecteur de fichier montre comment vérifier si l'application est alignée, comment définir les propriétés de sélecteur de fichier, et comment afficher un sélecteur de fichier pour permettre à l'utilisateur de choisir un dossier pour l'application à laquelle accéder.


// Verify that we are currently not snapped, or that we can unsnap to open the picker
var currentState = Windows.UI.ViewManagement.ApplicationView.value;
if (currentState === Windows.UI.ViewManagement.ApplicationViewState.snapped &&
    !Windows.UI.ViewManagement.ApplicationView.tryUnsnap()) {
    // Fail silently if we can't unsnap
    return;
}

// Create the picker object and set options
var folderPicker = new Windows.Storage.Pickers.FolderPicker;
folderPicker.suggestedStartLocation = Windows.Storage.Pickers.PickerLocationId.desktop;
// Users expect to have a filtered view of their folders depending on the scenario.
// For example, when choosing a documents folder, restrict the filetypes to documents for your application.
folderPicker.fileTypeFilter.replaceAll([".docx", ".xlsx", ".pptx"]);

folderPicker.pickSingleFolderAsync().then(function (folder) {
    if (folder) {
        // Application now has read/write access to all contents in the picked folder (including sub-folder contents)
        // Cache folder so the contents can be accessed at a later time
        Windows.Storage.AccessCache.StorageApplicationPermissions.futureAccessList.addOrReplace("PickedFolderToken", folder);
        WinJS.log && WinJS.log("Picked folder: " + folder.name, "sample", "status");
    } else {
        // The picker was dismissed with no selected file
        WinJS.log && WinJS.log("Operation cancelled.", "sample", "status");
    }
});


Pour C#, l'exemple de sélecteur de fichier montre comment vérifier si votre application est alignée dans la méthode EnsureUnsnapped.


internal bool EnsureUnsnapped()
{
    // FilePicker APIs will not work if the application is in a snapped state.
    // If an app wants to show a FilePicker while snapped, it must attempt to unsnap first
    bool unsnapped = ((ApplicationView.Value != ApplicationViewState.Snapped) || ApplicationView.TryUnsnap());
    if (!unsnapped)
    {
        NotifyUser("Cannot unsnap the sample.", NotifyType.StatusMessage);
    }

    return unsnapped;
}


Conditions requises

Client minimal pris en charge

Windows 8 [Applications Windows Store uniquement]

Serveur minimal pris en charge

Windows Server 2012 [Applications Windows Store uniquement]

Espace de noms

Windows.Storage.Pickers
Windows::Storage::Pickers [C++]

Métadonnées

Windows.winmd

Voir aussi

Exemple de sélecteur de fichiers
Démarrage rapide : accès aux fichiers à l'aide des sélecteurs de fichiers

 

 

Afficher:
© 2017 Microsoft