<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="file-selection" lang="pt_BR">
  <info>
    <link type="guide" xref="index#dialogs"/>
    <desc>Use a opção <cmd>--file-selection</cmd>.</desc>
    <license xmlns="http://projectmallard.org/1.0/" href="https://www.gnu.org/licenses/old-licenses/fdl-1.1.txt">

  <p>This work is licensed under a
  <link href="https://www.gnu.org/licenses/old-licenses/fdl-1.1.txt">GNU Free
  Documentation License Version 1.1</link> or any later version.</p>

	<p>
	  Permission is granted to copy, distribute and/or modify this
	  document under the terms of the GNU Free Documentation
	  License (GFDL), Version 1.1 or any later version published
	  by the Free Software Foundation with no Invariant Sections,
	  no Front-Cover Texts, and no Back-Cover Texts.  You can find
	  a copy of the GFDL at this
	  <link href="https://www.gnu.org/licenses/old-licenses/fdl-1.1.txt">link</link>.
         </p>
         <p>Este manual é parte da coleção de manuais do GNOME distribuídos sob a GFDL. Se você quiser distribuí-lo separadamente da coleção, você pode fazê-lo adicionando ao manual uma cópia da licença, como descrito na seção 6 da licença.</p>

	<p>Muitos dos nomes usados por empresas para distinguir seus produtos e serviços são reivindicados como marcas registradas. Onde esses nomes aparecem em qualquer documentação do GNOME e os membros do Projeto de Documentação do GNOME estiverem cientes dessas marcas registradas, os nomes aparecerão impressos em letras maiúsculas ou com iniciais em maiúsculas.</p>

	<p>O DOCUMENTO E VERSÕES MODIFICADAS DO DOCUMENTO SÃO FORNECIDOS SOB OS TERMOS DA LICENÇA DE DOCUMENTAÇÃO LIVRE DO GNU COM O ENTENDIMENTO ADICIONAL DE QUE:</p>
	<list>
		<item>
		  <p>O DOCUMENTO É FORNECIDO NA BASE “COMO ESTÁ”, SEM GARANTIAS DE QUALQUER TIPO, TANTO EXPRESSA OU IMPLÍCITA, INCLUINDO, MAS NÃO LIMITADO A, GARANTIAS DE QUE O DOCUMENTO OU VERSÃO MODIFICADA DO DOCUMENTO SEJA COMERCIALIZÁVEL, LIVRE DE DEFEITOS, PRÓPRIO PARA UM PROPÓSITO ESPECÍFICO OU SEM INFRAÇÕES. TODO O RISCO A RESPEITO DA QUALIDADE, EXATIDÃO, E DESEMPENHO DO DOCUMENTO OU VERSÕES MODIFICADAS DO DOCUMENTO É DE SUA RESPONSABILIDADE. SE ALGUM DOCUMENTO OU VERSÃO MODIFICADA SE PROVAR DEFEITUOSO EM QUALQUER ASPECTO, VOCÊ (NÃO O ESCRITOR INICIAL, AUTOR OU QUALQUER CONTRIBUIDOR) ASSUME O CUSTO DE QUALQUER SERVIÇO NECESSÁRIO, REPARO OU CORREÇÃO. ESSA RENÚNCIA DE GARANTIAS CONSTITUI UMA PARTE ESSENCIAL DESTA LICENÇA. NENHUM USO DESTE DOCUMENTO OU VERSÃO MODIFICADA DESTE DOCUMENTO É AUTORIZADO SE NÃO FOR SOB ESSA RENÚNCIA; E</p>
		</item>
		<item>
		  <p>SOB NENHUMA CIRCUNSTÂNCIA E SOB NENHUMA TEORIA LEGAL, TANTO EM DANO (INCLUINDO NEGLIGÊNCIA), CONTRATO, OU OUTROS, DEVEM O AUTOR, ESCRITOR INICIAL, QUALQUER CONTRIBUIDOR, OU QUALQUER DISTRIBUIDOR DO DOCUMENTO OU VERSÃO MODIFICADA DO DOCUMENTO, OU QUALQUER FORNECEDOR DE ALGUMA DESSAS PARTES, SER CONSIDERADOS RESPONSÁVEIS A QUALQUER PESSOA POR QUALQUER DANO, SEJA DIRETO, INDIRETO, ESPECIAL, ACIDENTAL OU CONSEQUENCIAL DE QUALQUER INDIVÍDUO, INCLUINDO, MAS NÃO LIMITADO A, DANOS POR PERDA DE BOA VONTADE, TRABALHO PARADO, FALHA OU MAU FUNCIONAMENTO DO COMPUTADOR, OU QUALQUER E TODOS OS OUTROS DANOS OU PERDAS RESULTANTES OU RELACIONADOS AO USO DO DOCUMENTO E VERSÕES MODIFICADAS, MESMO QUE TAL PARTE TENHA SIDO INFORMADA DA POSSIBILIDADE DE TAIS DANOS.</p>
		</item>
	  </list>
</license>
  <credit type="translator copyright"><name>Rodolfo Ribeiro Gomes</name><email>rodolforg@gmail.com</email><years>2009</years></credit><credit type="translator copyright"><name>Rafael Fontenelle</name><email>rafaelff@gnome.org</email><years>2017-2019</years></credit></info>
  <title>Diálogo de seleção de arquivo</title>
    <p>Use a opção <cmd>--file-selection</cmd> para criar um diálogo de seleção de arquivo. O <app>Zenity</app> retorna os arquivos ou diretórios selecionados para a saída padrão. O modo padrão para o diálogo de seleção de arquivo é aberto.</p>
    <p>O diálogo de seleção de arquivo oferece suporte às seguintes opções:</p>

    <terms>

      <item>
        <title><cmd>--filename</cmd>=<var>arquivo</var></title>
	<p>Especifica o arquivo ou o diretório que começa selecionado no diálogo quando ele é mostrado pela primeira vez.</p>
      </item>

      <item>
	<title><cmd>--multiple</cmd></title>
	<p>Permite a seleção de múltiplos arquivos no diálogo de seleção de arquivos.</p>
      </item>

      <item>
	<title><cmd>--directory</cmd></title>
	<p>Permite apenas a seleção de diretórios no diálogo de seleção de arquivos.</p>
      </item>

      <item>
	<title><cmd>--save</cmd></title>
	<p>Ajusta o diálogo de seleção de arquivos para o modo de salvamento.</p>
      </item>

      <item>
	<title><cmd>--separator</cmd>=<var>separador</var></title>
	<p>Especifica o texto que será usado para dividir a lista de nomes de arquivos retornada.</p>
      </item>

    </terms>

    <p>O script de exemplo a seguir mostra como criar um diálogo de seleção de arquivo:</p>

<code>
#!/bin/sh

ARQUIVO=`zenity --file-selection --title="Selecione um arquivo"`

case $? in
         0)
                echo "\"$ARQUIVO\" selecionado.";;
         1)
                echo "Nenhum arquivo selecionado.";;
        -1)
                echo "Ocorreu um erro inesperado.";;
esac
</code>

    <figure>
      <title>Exemplo de diálogo de seleção de arquivo</title>
      <desc>Exemplo de diálogo de seleção de arquivo do <app>Zenity</app></desc>
      <media type="image" mime="image/png" src="figures/zenity-fileselection-screenshot.png"/>
    </figure>
</page>
