4D v14.3Select document |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v14.3
Select document
|
Select document ( diretorio ; tipoArquivos ; titulo ; opçoes {; selecionados} ) -> Resultado | ||||||||
Parâmetro | Tipo | Descrição | ||||||
diretorio | Texto, Inteiro longo |
![]() |
Rota de acesso do diretório a exibir na caixa de diálogo de seleção de documentos, ou String vazia para exibir a pasta de usuário padrão ("Meus documentos" em Windows e "Documentos" em Mac OS) ou Número da rota de acesso memorizada. | |||||
tipoArquivos | Texto |
![]() |
Lista de tipos de documentos a filtrar, ou "*" para não filtrar os documentos | |||||
titulo | Texto |
![]() |
Título da caixa de diálogo de seleção | |||||
opçoes | Inteiro longo |
![]() |
Opções de seleção | |||||
selecionados | Array texto |
![]() |
Array que contém a lista de rotas de acesso + nomes dos arquivos selecionados | |||||
Resultado | cadeia |
![]() |
Nome dos arquivos selecionados (primeiro arquivo da lista em caso de seleção múltipla) | |||||
O comando Select document mostra uma caixa de diálogo padrão de abertura de documentos, permitindo ao usuário definir um ou mais arquivos e devolver o nome e/ou rota de acesso completa dos arquivos selecionados.
O parâmetro diretório indica a pasta cujo conteúdo deve ser mostrado inicialmente na caixa de diálogo de abertura de documentos. Pode passar três tipos de valores:
Em Windows, pode também passar um tipo de arquivo clássico Mac OS, 4D realiza a correspondência internamente ou a extensão de arquivos (.txt, .exe, etc.). Note que em Windows, o usuário pode “forçar” a visualização de todos os tipos de arquivos introduzindo *.* na caixa de diálogo. Entretanto, neste caso, 4D efetuará uma verificação adicional dos tipos de arquivos selecionados: se o usuário selecionar um tipo de arquivo não autorizado, o comando retorna um erro.
Se não desejar restringir os arquivos mostrados a um ou mais tipos, passe "*" (asterisco) ou ".*" em tiposArquivos.
Passe no parâmetro título a etiqueta que deve aparecer na caixa de diálogo. Por padrão, se passar uma string vazia, se mostra a etiqueta “Abrir”.
O parâmetro opções permite especificar funções avançadas autorizadas na caixa de diálogo de abertura. 4D oferece as seguintes constantes pré-definidas no tema [#title id="736"/]Documentos do sistema:
Constante | Tipo | Valor | Comentário |
Multiple files | Inteiro longo | 1 | Autoriza a seleção simultânea de vários arquivos utilizando as combinações Shift+clique (seleção adjacente) e Ctrl+clique (Windows) ou Comando+clique (Mac OS). Neste caso, o parâmetro selecionado, se for passado, contém a lista de todos os arquivos selecionados. por padrão, se esta constante não for utilizada, o comando não permitirá a seleção de múltiplos arquivos. |
Package open | Inteiro longo | 2 | (Somente Mac OS): autoriza a apertura de pacotes como pastas e assim a visualização/seleção dos seus conteúdos. Por padrãom e não for utilizada esta constante, o comando não permitirá a abertura de pacotes. |
Package selection | Inteiro longo | 4 | (Somente Mac OS): autoriza a seleção de pacotes como entidades. Por padrão, se não for utilizada esta constante, o comando não permitirá a seleção de pacotes de software como tal. |
Alias selection | Inteiro longo | 8 | Autoriza a seleção de atalhos (Windows) ou de alias (Mac OS) como documentos. Por padrão, se não é utilizada esta constante, quando um alias ou atalho seja selecionado, o comando retornará a rota de acesso do elemento objetivo. Quando passe a constante, o comando retorna a rota do alias ou do atalho. |
Use sheet window | Inteiro longo | 16 | (Somente Mac OS): mostra a caixa de diálogo de seleção na forma de uma janela folha (esta opção é ignorada no Windows). As janelas folha são especificas para o Mac OS X com animação gráfica (para mais informação consulte a seção Tipos de Janelas). Por padrão, se esta constante não é utilizada, o comando mostrará uma caixa de diálogo padrão. |
Nota: em Mac OS, um pacote selecionado se considera como sendo uma pasta. A rota de acesso retornada no array selecionados inclui um caractere final ":" . Por exemplo: Disk:Applications:4D:4D v11.4:US:4D Volume Desktop.app:
O comando retorna o nome (nome + extensão em Windows) do arquivo selecionado. Se forem selecionados vários arquivos, o comando retorna o nome do primeiro arquivo da lista de arquivos selecionados. A lista de arquivos pode ser recuperada no parâmetro selecionados. Se nenhum arquivo for selecionado, o comando retorna uma string vazia.
Este exemplo é utilizado para especificar um arquivo de dados 4D:
C_LONGINT($plataforma)
PLATFORM PROPERTIES($plataforma)
If($plataforma=Windows)
$DocTipo:=".4DD"
Else
$DocTipo:="com.4d.4d.data-file" `UTI type
End if
$Opções:=Alias selection+Package open+Use sheet window
$Doc:=Select document("";$DocTipo;"Selecionar o arquivo de dados";$Opções)
Criação de um documento personalizado pelo usuário:
$doc:=Select document(System folder(Documents folder)+"Report.pdf";"pdf";"Report name:";File name entry)
If(OK=1)
BLOB TO DOCUMENT(Document;$blob) // $blob contém o documento a registrar
End if
Se o comando for executado corretamente e for selecionado um documento válido, a variável sistema OK toma o valor 1 e a variável sistema Document conterá a rota de acesso completa do arquivo selecionado.
Se não for selecionado nenhum arquivo (por exemplo, se o usuário clicar no botão Cancelar na caixa de diálogo de abertura de arquivos), a variável sistema OK toma o valor 0 e a variável Document estará vazia.
Produto: 4D
Tema: Documentos de Sistema
Número
905
Modificado: 4D v11 SQL
Modificado: 4D v13
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v13.5)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)
Inherited from : Select document ( 4D v11 SQL Release 6)