Utilizando File Pickers em Windows Apps - André Alves de Lima
Quem desenvolve para Windows Forms com certeza sabe que a maneira para possibilitarmos que o usuário selecione arquivos ou pastas é através da utilização das classes OpenFileDialog e FolderBrowserDialog. No WPF também temos o OpenFileDialog (só que localizado em outro namespace – Microsoft.Win32) e, para selecionarmos pastas, a recomendação é que utilizemos o FolderBrowserDialog do Windows Forms. Porém, como você deve ter percebido, tudo mudou no mundo dos Windows Apps (ou Windows Store Apps, ou Metro Style Apps – caramba, será que a Microsoft vai finalmente decidir como ela chamará esse tipo de aplicativo?). Nesse caso, temos que utilizar File Pickers, ou seja, as classes FileOpenPicker e FolderPicker. E é justamente esse o tema do artigo de hoje.
Vamos começar o nosso exemplo, como sempre, criando um projeto do tipo "Blank App", que se encontra dentro da categoria "Store Apps" / "Windows Apps". Após o Visual Studio ter criado o projeto, vamos até a MainPage adicionar um Button e um TextBlock dentro do Grid:
<Button x:Name="SelecionarArquivoButton"
Content="Selecionar Arquivo"
Click="SelecionarArquivoButton_Click" />
<TextBlock x:Name="ResultadoTextBlock" />
Feito isso, vamos até o code-behind para implementar o código do evento Click do botão (SelecionarArquivoButton_Click):
private async void SelecionarArquivoButton_Click(object sender, RoutedEventArgs e)
ResultadoTextBlock.Text = file.Path;
ResultadoTextBlock.Text = string.Empty;
Veja como é simples selecionar um arquivo em Windows Apps. Primeiro temos que criar uma instância da classe FileOpenPicker. Com ela, chamamos o método PickSingleFileAsync que, como o próprio nome diz, é assíncrono, portanto devemos utilizar a palavra-chave "await" em sua chamada (além disso, repare que tivemos que adicionar a palavra-chave "async" na assinatura do método). O retorno do método PickSingleFileAsync será "null" caso o usuário tenha cancelado a operação, ou um StorageFile caso o usuário tenha de fato selecionado um arquivo. Com o StorageFile em mãos, acessamos o seu caminho (através da propriedade Path) e exibimos o resultado no ResultadoTextBlock.
Simples, não? Pois tente executar a aplicação, clique no botão "Selecionar Arquivo" e veja o resultado:
The FileTypeFilters property must have at least one file type filter specified.
Bang! Exception na cabeça! Mas, por que? Por algum motivo inexplicável, a Microsoft decidiu que você obrigatoriamente tem que especificar um filtro de extensão de arquivo ao exibir FileOpenPickers. Esses filtros devem ser configurados através da propriedade FileTypeFilter.
A propriedade FileTypeFilter serve, como o nome indica, para filtrarmos os tipos de arquivos que serão exibidos no FileOpenPicker. Como mencionei no parágrafo anterior, a Microsoft decidiu que temos que obrigatoriamente especificar um filtro quando exibimos FileOpenPickers. Mas, e se não quisermos filtrar os arquivos a serem exibidos? E se quisermos exibir todos os arquivos no diálogo do FileOpenPicker? Simples! Nesse caso, temos que adicionar um filtro com o tipo de arquivo "*" (asterisco):
fileOpenPicker.FileTypeFilter.Add("*");
Se pensarmos no OpenFileDialog do Windows Forms / WPF, tínhamos a propriedade Filter que servia para o mesmo propósito. Porém, no FileOpenPicker das Windows Apps, não podemos adicionar uma descrição à extensão como fazíamos antigamente, já que o FileOpenPicker nem exibe para o usuário quais são os filtros sendo aplicados. Isso, na minha opinião, acaba deixando o usuário confuso. Imagina você tendo que selecionar um arquivo sem saber quais as extensões de arquivos são suportadas? É por essas e outras que muita gente reclama das Windows Apps – praticamente tudo parece um retrocesso ao que temos disponível no desenvolvimento de aplicações desktop. Mas, enfim, isso é um assunto a parte – desculpe o meu desabafo!
Para adicionarmos um filtro de tipo de arquivo, basta utilizarmos a extensão desejada, incluindo o ponto inicial. Por exemplo, para exibirmos somente arquivos do tipo "docx", basta adicionarmos o filtro ".docx". Você pode adicionar vários filtros no mesmo FileOpenPicker, como ".doc" e ".docx":
Por padrão, o FileOpenPicker exibe as pastas e arquivos em formato de lista, ou seja, com uma minúscula thumbnail e algumas informações sobre o arquivo, como você pode ver no exemplo abaixo:
Porém, em algumas situações, principalmente para selecionarmos arquivos de mídia (como fotos ou vídeos), essa não é a melhor opção. Nesse caso, seria mais interessante exibirmos as pastas e arquivos em um formato que consigamos ver melhor o conteúdo do arquivo. E acredito que foi pensando nessa situação que a propriedade ViewMode do FileOpenPicker foi criada. Com ela, podemos especificar que as pastas e arquivos sejam exibidos em formato thumbnail:
fileOpenPicker.ViewMode = Windows.Storage.Pickers.PickerViewMode.Thumbnail;
Veja a diferença no resultado:
Não consegui entender exatamente qual é a pasta que o FileOpenPicker exibe por padrão, mas, através da propriedade SuggestedStartLocation conseguimos especificar a pasta que deverá ser exibida inicialmente pelo FileOpenPicker. Por exemplo, para que o FileOpenPicker seja iniciado na pasta "desktop", utilize o trecho de código a seguir:
fileOpenPicker.SuggestedStartLocation = Windows.Storage.Pickers.PickerLocationId.Desktop;
Porém, fique atento com essa propriedade, pois, não é possível simplesmente indicar qualquer caminho para a pasta inicial (como conseguíamos fazer anteriormente com o OpenFileDialog). Devido às limitações impostas pelo WinRT e seu modelo de sandbox, só conseguimos selecionar algumas pastas pré-definidas pelo enumerador PickerLocationId:
Selecionando múltiplos arquivos
Para selecionarmos múltiplos arquivos, ao invés de utilizarmos o método PickSingleFileAsync, temos que utilizar o método PickMultipleFilesAsync. Nesse caso, o retorno não será mais um único StorageFile, mas sim, uma lista de StorageFiles. Dessa forma, podemos iterar pelos arquivos e pegar cada um de seus caminhos:
stringBuilder.AppendLine(file.Path);
ResultadoTextBlock.Text = stringBuilder.ToString();
Até agora vimos como selecionar arquivos em Windows Apps. Mas, e se quisermos selecionar uma pasta ao invés de arquivos? No Windows Forms e WPF utilizaríamos o FolderBrowserDialog. E no WinRT? Qual classe temos que utilizar? Nesse caso, utilizamos a classe FolderPicker.
Essa classe possui a praticamente mesma estrutura da classe FileOpenPicker. A diferença é que, ao invés de chamarmos o método PickSingleFileAsync ou PickMultipleFilesAsync, temos que chamar o método PickSingleFolderAsync. Por mais incrível que pareça, apesar de não surtir nenhum resultado, somos obrigados a configurar um FileTypeFilter, senão receberemos a mesma exceção que recebemos anteriormente com o FileOpenPicker. Na minha opinião (e também na opinião de outras pessoas, veja só), essa foi um erro feio de API que o time do WinRT cometeu. O FileTypeFilter não faz nenhuma diferença ao selecionarmos uma pasta (podemos, por exemplo, configurar o FileTypeFilter como ".doc", mas, isso não fará nenhuma diferença nas pastas que serão exibidas), então, por que temos que fornecer um FileTypeFilter? Enfim, para contornar esse problema, vamos configurar o FileTypeFilter como "*" (asterisco).
Vamos adicionar mais um botão no nosso StackPanel para fazermos a seleção da pasta:
<Button x:Name="SelecionarPastaButton"
Content="Selecionar Pasta"
Click="SelecionarPastaButton_Click" />
E então, vamos implementar o código para selecionarmos a pasta. Veja só que simples:
private async void SelecionarPastaButton_Click(object sender, RoutedEventArgs e)
ResultadoTextBlock.Text = folder.Path;
Se você está acostumado a selecionar arquivos e pastas no WPF e Windows Forms, você sabe exatamente quais classes utilizar e como elas funcionam. Porém, no desenvolvimento de Windows Apps com o WinRT, tudo mudou. Nesse artigo você aprendeu como utilizar as classes FileOpenPicker e FolderPicker para selecionar arquivos e pastas no desenvolvimento de Windows Apps.
Por hoje é só. Espero que você tenha gostado. Não se esqueça de assinar a minha newsletter para ficar por dentro das novidades do meu site (para isso, utilize o formulário logo abaixo)!
Implementando uma janela de login com Windows Forms ou WPF Meio ano se passou… E como estão as metas?