| Pakiet | flash.net |
| Klasa | public final class FileFilter |
| Dziedziczenie | FileFilter  Object |
| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
FileReference.browse(), FileReferenceList.browse() lub metody browse obiektu File, FileReference lub FileReferenceList. Instancje klasy FileFilter są przekazywane do metody jako wartości opcjonalnego parametru typeFilter. Jeśli używana jest instancja FileFilter, rozszerzenia i typy plików, które nie zostały określone w instancji FileFilter, są odfiltrowywane; tzn. nie są dostępne dla użytkownika do wybrania. Jeśli żaden obiekt FileFilter nie został przekazany do metody, w oknie dialogowym zostaną wyświetlone wszystkie pliki.
Instancji FileFilter można używać w następujący sposób:
- Opis tylko z plikiem z rozszerzeniem pliku systemu
- Opis tylko z plikiem z rozszerzeniem pliku systemu i plikiem należącym do typu używanego na komputerach Macintosh
Tych dwóch formatów nie można stosować zamiennie w jednym wywołaniu metody browse. Jednocześnie można używać tylko jednego.
Do metody browse można przekazać jedną lub wiele instancji FileFilter, co ilustruje poniższy przykład:
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]);
Lub w aplikacji 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]);
Pliki wyświetlane w oknie przeglądania w poszukiwaniu plików są filtrowane na podstawie listy rozszerzeń określonej we właściwości FileFilter.extension. Lista nie jest faktycznie wyświetlana w oknie dialogowym. Aby wyświetlić typy plików dla użytkownika, należy wypisać typy plików w ciągu znaków właściwości description, jak również na liście rozszerzeń (właściwość extension). Ciąg znaków właściwości description wyświetlany jest w oknie dialogowym w systemach Windows i Linux. (Nie jest używany w systemie Macintosh®). W systemach Macintosh, jeśli podana zostanie lista typów plików właściwa dla tych systemów, ta lista zostanie użyta do filtrowania plików. W przeciwnym wypadku użyta zostanie lista rozszerzeń nazw plików.
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczne| Właściwość | Zdefiniowane przez | ||
|---|---|---|---|
 | constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | |
| description : String
Opis filtra w postaci ciągu znaków. | FileFilter | ||
| extension : String
Lista rozszerzeń plików. | FileFilter | ||
| macType : String
Lista typów plików obsługiwanych na komputerach Macintosh. | FileFilter | ||
| Metoda | Zdefiniowane przez | ||
|---|---|---|---|
Tworzy nowe wystąpienie klasy FileFilter. | FileFilter | ||
|
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | |
|
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | |
|
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | |
|
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | |
|
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | |
|
Zwraca ciąg reprezentujący określony obiekt. | Object | |
|
Zwraca pierwotną wartość dla określonego obiektu. | Object | |
description | właściwość |
description:String| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Opis filtra w postaci ciągu znaków. Opis jest widoczny dla użytkownika w oknie dialogowym, które zostanie otwarte w momencie wywołania metody FileReference.browse() lub FileReferenceList.browse(). Ciąg znaków właściwości description zawiera ciąg np. "Obrazy (*.gif, *.jpg, *.png)", który informuje użytkownika jakie typy plików mogą być wysyłane i pobierane. Należy zauważyć, że rzeczywiste typy plików obsługiwane przez obiekty FileReference nie są przechowywane we właściwości extension.
Implementacja
public function get description():String public function set description(value:String):voidextension | właściwość |
extension:String| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Lista rozszerzeń plików. Ta lista wskazuje typy plików, które mają być wyświetlane w oknie dialogowym przeglądania plików. (Lista jest niewidoczna dla użytkowników; użytkownicy widzą jedynie wartość właściwości description). Właściwość extension zawiera listę rozszerzeń plików systemu rozdzielonych średnikiem i poprzedzonych znakami wieloznacznymi (*) tak, jak przedstawia to następujący ciąg: "*.jpg;*.gif;*.png".
Implementacja
public function get extension():String public function set extension(value:String):voidmacType | właściwość |
macType:String| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Lista typów plików obsługiwanych na komputerach Macintosh. Ta lista wskazuje typy plików, które mają być wyświetlane w oknie dialogowym przeglądania plików. (Lista jest niewidoczna dla użytkowników; użytkownicy widzą jedynie wartość właściwości description). Właściwość macType zawiera typy plików komputera Macintosh rozdzielone średnikiem tak, jak przedstawia to następujący ciąg: "JPEG;jp2_;GIFF".
Implementacja
public function get macType():String public function set macType(value:String):voidFileFilter | () | Konstruktor |
public function FileFilter(description:String, extension:String, macType:String = null)| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Tworzy nową instancję klasy FileFilter.
Parametrydescription:String — Ciąg znaków właściwości description, który pojawia się po wybraniu przez użytkowników plików do wysyłania.
| |
extension:String — Lista rozszerzeń plików, która wskazuje formaty plików systemu widoczne dla użytkownika po wybraniu plików do wysyłania.
| |
macType:String (default = null)null.
|
Przykład ( Sposób korzystania z tego przykładu )
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);
}
Tue Jun 12 2018, 12:06 PM Z