FileOpenPicker Class

Représente un élément d'interface qui permet à l'utilisateur de choisir et d'ouvrir des fichiers.

Syntaxe


var fileOpenPicker = new Windows.Storage.Pickers.FileOpenPicker();

Attributs

[Muse()]
[Version(0x06020000)]

Membres

FileOpenPickerClasse possède ces types de membres :

Constructeurs

FileOpenPickerClasse possède ces constructeurs.

ConstructeurDescription
FileOpenPicker Creates a new instance of a FileOpenPicker.

 

Méthodes

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

MéthodeDescription
PickMultipleFilesAsync Shows the file picker so that the user can pick multiple files.
PickSingleFileAsync Shows the file picker so that the user can pick one file.

 

Propriétés

Le FileOpenPickerClasse a les propriétés suivantes.

PropriétéType d'accèsDescription

CommitButtonText

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

FileTypeFilter

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

SettingsIdentifier

Lecture/écritureGets or sets the settings identifier associated with the state of the file open picker.

SuggestedStartLocation

Lecture/écritureGets or sets the initial location where the file open picker looks for files to present to the user.

ViewMode

Lecture/écritureGets or sets the view mode that the file open 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.

Important  Dans Windows 8, si vous essayez d'afficher le sélecteur de fichiers pendant que votre application est ancrée, le sélecteur de fichiers n'est pas affiché et une exception est levée. Vous pouvez éviter ceci en vérifiant que votre application n'est pas ancrée ou en annulant l'ancrage 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. Notez que Windows 8.1 ne définit pas de taille de fenêtre alignée spécifique. À la place, les utilisateurs peuvent redimensionner les applications à n'importe quelle largeur, jusqu'au minimum. Par conséquent, si votre application est déployée uniquement sur Windows 8.1, ignorez la fonction EnsureUnsnapped et les appels concernés dans l'exemple de code de cette rubrique.

Windows Phone 8

Cette API est prise en charge dans les applications natives uniquement.

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 sélectionner un fichier.


// 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 openPicker = new Windows.Storage.Pickers.FileOpenPicker();
openPicker.viewMode = Windows.Storage.Pickers.PickerViewMode.thumbnail;
openPicker.suggestedStartLocation = Windows.Storage.Pickers.PickerLocationId.picturesLibrary;
// 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.
openPicker.fileTypeFilter.replaceAll([".png", ".jpg", ".jpeg"]);

// Open the picker for the user to pick a file
openPicker.pickSingleFileAsync().then(function (file) {
    if (file) {
        // Application now has read/write access to the picked file
        WinJS.log && WinJS.log("Picked photo: " + file.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;
}


L'Exemple de sélecteur de fichier montre également comment afficher un sélecteur de fichier pour permettre à l'utilisateur de sélectionner plusieurs fichiers.

Remarque  Vous devez toujours vérifier que votre application n'est pas alignée (ou que l'alignement peut être annulé) et définir les propriétés du sélecteur de fichiers que l'utilisateur choisisse un seul fichier ou plusieurs fichiers.


openPicker.pickMultipleFilesAsync().then(function (files) {
    if (files.size > 0) {
        // Application now has read/write access to the picked file(s)
        var outputString = "Picked files:\n";
        for (var i = 0; i < files.size; i++) {
            outputString = outputString + files[i].name + "\n";
        }
        WinJS.log && WinJS.log(outputString, "sample", "status");
    } else {
        // The picker was dismissed with no selected file
        WinJS.log && WinJS.log("Operation cancelled.", "sample", "status");
    }
});


Vous pouvez également utiliser le sélecteur de fichier sur Windows Phone. Voici un exemple en C++. Sous Windows Phone, FileOpenPicker est pris en charge dans les applications natives uniquement.


FileOpenPicker^ openPicker = ref new FileOpenPicker(); 
openPicker->ViewMode = PickerViewMode::Thumbnail; 
openPicker->SuggestedStartLocation = PickerLocationId::PicturesLibrary; 
openPicker->FileTypeFilter->Append("*"); 
   
create_task(openPicker->PickSingleFileAsync()).then([this](StorageFile^ file) 
{
    if (file) 
    { 
        m_PickedFileName = file->Name; 
    } 
    else 
    { 
        // Operation cancelled.
    } 
});


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]

Téléphone minimal pris en charge

Windows Phone 8

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:
© 2014 Microsoft