FileSavePicker.FileTypeChoices Propriété

Définition

Espace de noms:

Windows.Storage.Pickers

Obtient la collection de types de fichiers valides que l’utilisateur peut choisir d’affecter à un fichier.

public:
 property IMap<Platform::String ^, IVector<Platform::String ^> ^> ^ FileTypeChoices { IMap<Platform::String ^, IVector<Platform::String ^> ^> ^ get(); };

IMap<winrt::hstring, IVector<winrt::hstring> const&> FileTypeChoices();

public IDictionary<string,IList<string>> FileTypeChoices { get; }

var iMap = fileSavePicker.fileTypeChoices;

Public ReadOnly Property FileTypeChoices As IDictionary(Of String, IList(Of String))

Valeur de propriété

IMap<String,IVector<String>>

IDictionary<String,IList<String>>

IMap<Platform::String,IVector<Platform::String>>

IMap<winrt::hstring,IVector<winrt::hstring>>

Objet FilePickerFileTypesOrderedMap qui contient une collection de types de fichiers valides (extensions) que l’utilisateur peut utiliser pour enregistrer un fichier. Chaque élément de cette collection mappe un nom d’affichage à une collection correspondante d’extensions de nom de fichier. La clé est une chaîne unique, la valeur est une liste/vecteur de chaînes représentant un ou plusieurs choix d’extension.

Exemples

L’exemple de sélecteur de fichiers montre comment ajouter des choix de types de fichiers avec un nom d’affichage.

FileSavePicker savePicker = new FileSavePicker();
savePicker.SuggestedStartLocation = PickerLocationId.DocumentsLibrary;
// Dropdown of file types the user can save the file as
savePicker.FileTypeChoices.Add("Plain Text", new List<string>() { ".txt" });
// Default file name if the user does not type one in or select a file to replace
savePicker.SuggestedFileName = "New Document";

auto plainTextExtensions{ winrt::single_threaded_vector<winrt::hstring>() };
plainTextExtensions.Append(L".txt");

savePicker.FileTypeChoices().Insert(L"Plain Text", plainTextExtensions);
savePicker.SuggestedFileName(L"New Document");

Si vous ajoutez plusieurs FileTypeChoices à FileSavePicker, le premier ajouté est le type de fichier par défaut. Cette valeur par défaut est sélectionnée lorsque l’utilisateur ouvre le sélecteur de fichiers. Le type de fichier par défaut est utilisé si l’utilisateur ne modifie pas le type de fichier dans le sélecteur de fichiers. Dans cet exemple, les entrées FileTypeChoices sont ajoutées en fonction de la case d’option sélectionnée :

if (radioButtonRichText.IsChecked)
{
    savePicker.FileTypeChoices.Add("Rich text", new List<string>() { ".rtf" });
    savePicker.FileTypeChoices.Add("Word document", new List<string>() { ".docx" });
    savePicker.FileTypeChoices.Add("Plain text", new List<string>() { ".txt" });
}
else if (radioButtonWordDoc.IsChecked)
{
    savePicker.FileTypeChoices.Add("Word document", new List<string>() { ".docx" });
    savePicker.FileTypeChoices.Add("Plain text", new List<string>() { ".txt" });
    savePicker.FileTypeChoices.Add("Rich text", new List<string>() { ".rtf" });
}
else // default to plain text file type
{
    savePicker.FileTypeChoices.Add("Plain text", new List<string>() { ".txt" });
    savePicker.FileTypeChoices.Add("Rich text", new List<string>() { ".rtf" });
    savePicker.FileTypeChoices.Add("Word document", new List<string>() { ".docx" });
}

Remarques

Certaines applications n’ont pas besoin de comprendre un format de fichier pour le traiter, par exemple un fournisseur de stockage cloud. Par conséquent, l’utilisation du caractère générique de fichier « * » est prise en charge pour la collection FileOpenPicker.FileTypeFilter . Toutefois, l’écriture d’un fichier nécessite une connaissance de son format. Par conséquent, le caractère générique n’est pas pris en charge pour FileSavePicker.FileTypeChoices.

Un nom d’affichage en tant que classification de types de fichiers peut avoir plusieurs types de fichiers qui le prennent en charge. Par exemple, un nom complet de « page HTML » peut être enregistré avec l’extension « .htm » ou « .html ». C’est pourquoi la valeur de chaque entrée dans un FilePickerFileTypesOrderedMap est une liste ordonnée (vecteur) de chaînes, affichée dans l’interface utilisateur dans l’ordre dans lequel vous placez les extensions dans le vecteur.

Voir aussi

• FileSavePicker
• FilePickerFileTypesOrderedMap
• Exemple de sélecteur de fichiers