Pacote | flash.net |
Classe | public final class FileFilter |
Herança | FileFilter Object |
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
FileReference.browse()
, FileReferenceList.browse()
são chamados ou quando um método de pesquisa de um objeto File, FileReference ou FileReferenceList é chamado. As instâncias FileFilter são passadas como valores para o parâmetro opcional typeFilter
para o método. Se você usar uma ocorrência de FileFilter, as extensões e os tipos de arquivo que não forem especificados na ocorrência de FileFilter serão filtrados; ou seja, não estarão disponíveis ao usuário para seleção. Se nenhum objeto FileFilter for transmitido ao método, todos os arquivos serão mostrados na caixa de diálogo.
Você pode usar ocorrências de FileFilter de uma destas duas maneiras:
- Uma descrição somente com as extensões de arquivo
- Uma descrição com extensões de arquivo do e tipos de arquivo do Macintosh
Os dois formatos não são intercambiáveis em uma única chamada do método browse. Você deve usar um ou o outro.
Você pode passar uma ou mais instâncias FileFilter para o método browse, conforme mostrado a seguir:
var imagesFilter:FileFilter = new FileFilter("Images", "*.jpg;*.gif;*.png"); var docFilter:FileFilter = new FileFilter("Documents", "*.pdf;*.doc;*.txt"); var myFileReference:FileReference = new FileReference(); myFileReference.browse([imagesFilter, docFilter]);
Ou em um aplicativo AIR:
var imagesFilter:FileFilter = new FileFilter("Images", "*.jpg;*.gif;*.png"); var docFilter:FileFilter = new FileFilter("Documents", "*.pdf;*.doc;*.txt"); var myFile:File = new File(); myFile.browseForOpen("Open", [imagesFilter, docFilter]);
A lista de extensões na propriedade FileFilter.extension
é usada para filtrar os arquivos mostrados na caixa de diálogo de procura do arquivo. A lista não é exibida, de fato, na caixa de diálogo; para mostrar os tipos de arquivo para os usuários, é necessário listar os tipos de arquivo na string de descrição e também na lista de extensões. A string de descrição é exibida na caixa de diálogo do Windows e do Linux. (Ela não é usada no Macintosh ®.) No Macintosh, se você fornecer uma lista de tipos de arquivo do Macintosh, essa lista será usada para filtrar os arquivos. Caso contrário, a lista de extensões de arquivo será usada.
Propriedade | Definido por | ||
---|---|---|---|
constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | ||
description : String
A string de descrição do filtro. | FileFilter | ||
extension : String
Uma lista de extensões de arquivo. | FileFilter | ||
macType : String
Uma lista de tipos de arquivo do Macintosh. | FileFilter |
Método | Definido por | ||
---|---|---|---|
Cria uma nova ocorrência de FileFilter. | FileFilter | ||
Indica se um objeto tem uma propriedade especificada definida. | Object | ||
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | ||
Indica se a propriedade especificada existe e é enumerável. | Object | ||
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | ||
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | ||
Retorna a representação de string do objeto especificado. | Object | ||
Retorna o valor primitivo do objeto especificado. | Object |
description | propriedade |
description:String
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
A string de descrição do filtro. A descrição é visível ao usuário na caixa de diálogo que é aberta quando FileReference.browse()
ou FileReferenceList.browse()
é chamado. A string de descrição contém uma string, como "Images (*.gif, *.jpg, *.png)"
, que pode ajudar a instruir o usuário sobre quais tipos de arquivo podem ser carregados ou baixados. Observe que os tipos de arquivo reais suportados por este objeto FileReference são armazenados na propriedade extension
.
Implementação
public function get description():String
public function set description(value:String):void
extension | propriedade |
extension:String
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Uma lista de extensões de arquivo. Essa lista indica os tipos de arquivos que você deseja mostrar na caixa de diálogo de navegação de arquivos. (A lista não é visível ao usuário, que visualiza apenas o valor da propriedade description
.) A propriedade extension
contém uma lista delimitada por ponto-e-vírgula de extensões de arquivo, com um caractere curinga (*) precedendo cada extensão, como mostra a string a seguir: "*.jpg;*.gif;*.png"
.
Implementação
public function get extension():String
public function set extension(value:String):void
macType | propriedade |
macType:String
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Uma lista de tipos de arquivo do Macintosh. Essa lista indica os tipos de arquivos que você deseja mostrar na caixa de diálogo de navegação de arquivos. (A lista propriamente dita não é visível ao usuário, que visualiza apenas o valor da propriedade description
.) A propriedade macType
contém uma lista delimitada por ponto-e-vírgula de tipos de arquivo do Macintosh, como mostra a string a seguir: "JPEG;jp2_;GIFF"
.
Implementação
public function get macType():String
public function set macType(value:String):void
FileFilter | () | Construtor |
public function FileFilter(description:String, extension:String, macType:String = null)
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Cria uma nova ocorrência de FileFilter.
Parâmetrosdescription:String — A string de descrição visível aos usuários quando eles selecionam arquivos para upload.
| |
extension:String — Uma lista de extensões de arquivos que indicam quais formatos de arquivo estão visíveis aos usuários quando eles selecionam arquivos para upload.
| |
macType:String (default = null ) — Uma lista de tipos de arquivo do Macintosh que indicam quais tipos de arquivo estão visíveis aos usuários quando eles selecionam arquivos para upload. Se nenhum valor for transmitido, esse parâmetro será definido como null .
|
Exemplo ( Como usar este exemplo )
var buttonShape:Shape = new Shape(); buttonShape.graphics.beginFill(0x336699); buttonShape.graphics.drawCircle(50, 50, 25); var button = new SimpleButton(buttonShape, buttonShape, buttonShape, buttonShape); addChild(button); var fileRef:FileReference= new FileReference(); button.addEventListener(MouseEvent.CLICK, onButtonClick); function onButtonClick(e:MouseEvent):void { fileRef.browse([new FileFilter("Images", "*.jpg;*.gif;*.png")]); fileRef.addEventListener(Event.SELECT, onFileSelected); } function onFileSelected(e:Event):void { fileRef.addEventListener(Event.COMPLETE, onFileLoaded); fileRef.load(); } function onFileLoaded(e:Event):void { var loader:Loader = new Loader(); loader.loadBytes(e.target.data); addChild(loader); }
Wed Jun 13 2018, 11:10 AM Z