FileSavePicker.FileTypeChoices Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém a coleção de tipos de arquivo válidos que o usuário pode optar por atribuir a um arquivo.
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))Valor da propriedade
Um objeto FilePickerFileTypesOrderedMap que contém uma coleção de tipos de arquivo válidos (extensões) que o usuário pode usar para salvar um arquivo. Cada elemento nesta coleção mapeia um nome de exibição para uma coleção correspondente de extensões de nome de arquivo. A chave é uma única cadeia de caracteres, o valor é uma lista/vetor de cadeias de caracteres que representam uma ou mais opções de extensão.
Exemplos
O exemplo do seletor de arquivos demonstra como adicionar opções de tipo de arquivo com um nome de exibição.
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");
Se você adicionar vários FileTypeChoices ao FileSavePicker, o primeiro adicionado será o tipo de arquivo padrão. Esse padrão será selecionado quando o usuário abrir o seletor de arquivos. O tipo de arquivo padrão será usado se o usuário não alterar o tipo de arquivo no seletor de arquivos. Neste exemplo, as entradas FileTypeChoices são adicionadas com base em qual botão de opção foi selecionado:
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" });
}
Comentários
Alguns aplicativos não precisam entender um formato de arquivo para processá-lo , como um provedor de armazenamento em nuvem. Portanto, o uso do caractere curinga do arquivo - "*" - é compatível com a coleção FileOpenPicker.FileTypeFilter . No entanto, escrever um arquivo requer conhecimento de seu formato. Como resultado, não há suporte para o curinga para FileSavePicker.FileTypeChoices.
Um nome de exibição como uma classificação de tipos de arquivo pode ter vários tipos de arquivo que dão suporte a ele. Por exemplo, um nome de exibição de "página HTML" pode ser salvo com a extensão ".htm" ou ".html". É por isso que o valor de cada entrada em um FilePickerFileTypesOrderedMap é uma lista ordenada (vetor) de cadeias de caracteres, exibida na interface do usuário, na ordem em que você coloca as extensões no vetor.