Paket | flash.net |
Sınıf | public class FileReferenceList |
Miras Alma | FileReferenceList EventDispatcher Object |
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9 |
FileReferenceList sınıfıyla birlikte çalışmak için:
- Şu sınıfı başlatın:
var myFileRef = new FileReferenceList();
-
FileReferenceList.browse()
yöntemini çağırın. Böylece kullanıcının yükleme işlemi için bir veya daha fazla dosya seçmesini sağlayan bir iletişim kutusu açılır:myFileRef.browse();
-
browse()
yöntemi başarılı bir şekilde çağrıldıktan sonra, FileReferenceList nesnesininfileList
özelliği FileReference nesnelerinin bir dizisiyle doldurulur. -
fileList
dizisindeki her öğe üzerindeFileReference.upload()
öğesini çağırın.
FileReferenceList sınıfı birden fazla dosyayla çalışmak için bir browse()
yöntemi ve bir fileList
özelliği içerir. FileReferenceList.browse()
çağrısı yürütülüyorken, Linux ve Mac OS X 10.1 ve daha öncesi için tek başına ve harici Flash Player ve AIR sürümlerinde SWF dosyası yürütmesi duraklar.
İlgili API Öğeleri
Özellik | Tanımlayan: | ||
---|---|---|---|
constructor : Object
Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru. | Object | ||
fileList : Array [salt okunur]
FileReference nesnelerinden oluşan bir dizi. | FileReferenceList |
Yöntem | Tanımlayan: | ||
---|---|---|---|
Yeni FileReferenceList nesnesi oluşturur. | FileReferenceList | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
EventDispatcher nesnesi olan bir olay dinleyici nesnesini, dinleyicinin bir olayın bildirimini alması için kaydeder. | EventDispatcher | ||
Kullanıcının yüklenecek bir veya daha fazla yerel dosyayı seçmesini sağlayan bir dosya gözatma iletişim kutusu görüntüler. | FileReferenceList | ||
Olay akışına bir olay gönderir. | EventDispatcher | ||
EventDispatcher nesnesinin belirli bir olay türü için kayıtlı dinleyicisi olup olmadığını kontrol eder. | EventDispatcher | ||
Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir. | Object | ||
Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir. | Object | ||
Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir. | Object | ||
EventDispatcher nesnesinden bir dinleyiciyi kaldırır. | EventDispatcher | ||
Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar. | Object | ||
Bu nesnenin, yerel ayara özel kurallara göre biçimlendirilmiş dize temsilini döndürür. | Object | ||
Belirtilen nesnenin dize olarak temsil edilen halini döndürür. | Object | ||
Belirtilen nesnenin temel değerini döndürür. | Object | ||
Bir olay dinleyicisinin bu EventDispatcher nesnesiyle mi, yoksa onun belirtilen olay türüne yönelik üst öğelerinden biriyle mi kayıtlı olduğunu kontrol eder. | EventDispatcher |
Olay | Özet | Tanımlayan: | ||
---|---|---|---|---|
[broadcast olayı] Flash Player veya AIR uygulaması işletim sistemi odağına gelip etkin olduğunda gönderilir. | EventDispatcher | |||
Kullanıcı, dosyaya gözatma iletişim kutusundan çıktığında gönderilir. | FileReferenceList | |||
[broadcast olayı] Çalışan Flash Player veya AIR uygulaması sistem odağını kaybettiğinde ve etkin olmayan duruma geldiğinde gönderilir. | EventDispatcher | |||
Kullanıcı sunucuya yüklemek için, dosyaya gözatma iletişim kutusundan bir veya birden çok dosya seçtiğinde gönderilir. | FileReferenceList |
fileList | özellik |
fileList:Array
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9 |
FileReference
nesnelerinden oluşan bir dizi.
FileReferenceList.browse()
yöntemi çağrıldığında ve kullanıcı, browse()
yönteminin açtığı iletişim kutusundan bir veya daha fazla dosya seçtiğinde, bu özellik, her biri kullanıcının seçtiği bir dosyayı temsil eden FileReference nesnelerini içeren bir diziyle doldurulur. Daha sonra, her dosyayı FileReference.upload()
yöntemini kullanarak yüklemek için bu diziyi kullanabilirsiniz. Bir seferde bir dosya yüklemelisiniz.
fileList
özelliği, browse() öğesi o FileReferenceList nesnesi üzerinde her çağrıldığında yeniden doldurulur.
FileReference
nesnelerinin özellikleri, FileReference sınıfı belgelerinde açıklanmıştır.
Uygulama
public function get fileList():Array
İlgili API Öğeleri
FileReferenceList | () | Yapıcı |
public function FileReferenceList()
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9 |
Yeni FileReferenceList nesnesi oluşturur. Bir FileReferenceList nesnesi, browse()
yöntemi çağrılana ve kullanıcı bir veya daha fazla dosya seçene kadar hiçbir öğe içermez. FileReference nesnesi üzerinde browse()
yöntemini çağırırsanız, nesnenin fileList
özelliği FileReference
nesnelerini içeren bir diziyle doldurulur.
İlgili API Öğeleri
browse | () | yöntem |
public function browse(typeFilter:Array = null):Boolean
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9 |
Kullanıcının yüklenecek bir veya daha fazla yerel dosyayı seçmesini sağlayan bir dosya gözatma iletişim kutusu görüntüler. İletişim kutusu, kullanıcının işletim sistemi için yereldir.
Flash Player 10 ve sonrasında, yalnızca bir kullanıcı olayına (örneğin, fare tıklatması veya tuş basışı olayı için bir olay işleyicisinde) yanıt olarak bu yöntemi başarıyla çağırabilirsiniz. Aksi takdirde, bu yöntemin çağrılması Flash Player'ın bir Error atmasına neden olur.
Bu yöntemi çağırdığınızda ve kullanıcı başarılı bir şekilde dosyaları seçtiğinde bu FileReferenceList nesnesinin fileList
özelliği, her biri kullanıcının seçtiği bir dosya için olan FileReference nesnelerinden oluşan bir diziyle doldurulur. FileReference.browse() yöntemi daha sonra her çağrıldığında, FileReferenceList.fileList
özelliği, kullanıcının iletişim kutusunda seçtiği dosyanın (dosyaların) özelliklerine sıfırlanır.
typeFilter
parametresini kullanarak iletişim kutusunda hangi dosyaların görüntüleneceğini belirleyebilirsiniz.
FileReferenceList nesnesi üzerinde bir seferde yalnızca bir FileReference.browse()
, FileReference.download()
veya FileReferenceList.browse()
oturumu gerçekleştirilebilir (bir seferde yalnızca bir iletişim kutusu açılabildiği için).
Parametreler
typeFilter:Array (default = null ) — İletişim kutusunda görüntülenen dosyaları filtrelemek için kullanılan bir FileFilter örnekleri dizisi. Bu parametreyi atlarsanız, tüm dosyalar görüntülenir. Daha fazla bilgi için FileFilter sınıfına bakın.
|
Boolean — Parametreler geçerliyse ve dosya gözatma iletişim kutusu açılırsa true değerini döndürür.
|
Olaylar
select: — Kullanıcı, iletişim kutusunu kullanarak başarılı bir şekilde yüklenecek bir öğe seçtiğinde çağrılır.
| |
cancel: — Kullanıcı İptal'i tıklatarak veya kapatarak iletişim kutusunu atladığında çağrılır.
|
Atar
IllegalOperationError — Şu nedenlerden ötürü verilir: 1) Başka bir FileReference veya FileReferenceList gözatma oturumu devam ederken; bir seferde yalnızca bir dosya gözatma oturumu gerçekleştirilebilir. 2) Kullanıcının mms.cfg dosyasındaki bir ayar bu işlemi yasakladığında.
| |
ArgumentError — typeFilter dizisi, düzgün biçimde biçimlendirilmiş FileFilter nesneleri içermiyorsa bir istisna atılır. Doğru dosya biçimlendirmesi hakkındaki ayrıntılar için FileFilter belgelerine bakın.
| |
Error — Fare olayı veya tuş basışı olayı gibi bir kullanıcı eylemine yanıt olarak yöntem çağrılmazsa.
|
İlgili API Öğeleri
cancel | Olay |
flash.events.Event
özellik Event.type =
flash.events.Event.CANCEL
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9 |
Kullanıcı, dosyaya gözatma iletişim kutusundan çıktığında gönderilir. (Bu iletişim kutusu FileReferenceList.browse()
, FileReference.browse()
veya FileReference.download()
yöntemlerini çağırdığınızda açılır.)
Event.CANCEL
sabiti, cancel
olay nesnesinin type
özelliği değerini tanımlar.
Bu olay şu özelliklere sahiptir:
Özellik | Değer |
---|---|
bubbles | false |
cancelable | false ; iptal edilecek varsayılan davranış yoktur. |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
target | Üzerindeki işlem iptal edilen nesnenin başvurusu. |
İlgili API Öğeleri
select | Olay |
flash.events.Event
özellik Event.type =
flash.events.Event.SELECT
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9 |
Kullanıcı, sunucuya yüklemek için, dosyaya gözatma iletişim kutusundan bir veya birden çok dosya seçtiğinde gönderilir. (Bu iletişim kutusu FileReferenceList.browse()
, FileReference.browse()
veya FileReference.download()
yöntemlerini çağırdığınızda açılır.) Kullanıcı bir dosya seçtiğinde ve işlemi doğruladığında (örneğin Kaydet'i tıklatarak), FileReferenceList
nesnesi, kullanıcının seçtiği dosyaları temsil eden FileReference nesneleriyle doldurulur.
Event.SELECT
sabiti, select
olay nesnesinin type
özelliği değerini tanımlar.
Bu olay şu özelliklere sahiptir:
Özellik | Değer |
---|---|
bubbles | false |
cancelable | false ; iptal edilecek varsayılan davranış yoktur. |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
target | Üzerinde bir öğenin seçildiği nesne. |
İlgili API Öğeleri
complete
olayı içerir. FileReferenceListExample sınıfındaki LIST_COMPLETE
olayı, FileReferenceList nesnesindeki tüm olaylar yüklendiğinde gönderilir.
Bu örneği çalıştırmak için http://www.[yourDomain].com/yourUploadHandlerScript.cfm yoluna yapılan bir dosya yüklemesini kabul etmek içinyazılmış bir komut dosyası yerleştirin. SWF dosyanızın konumuna ve dosyaları yüklediğiniz konuma göre, ayrıca SWF dosyasını Yerel Oynatma Güvenliği özelliği Yalnızca Ağa Erişim şeklinde ayarlanmış biçimde derlemeniz veya ® Player güvenlik ayarlarını bu dosya ağa erişecek şekilde güncellemeniz gerekebilir. Yükleme sunucunuz uzaksa ve bu uygulamayı masaüstü bilgisayarınızdan çalıştırıyorsanız sunucunuzda bir crossdomain.xml dosyası olmalıdır.
package { import flash.display.Sprite; import flash.events.*; import flash.net.FileReference; import flash.net.FileReferenceList; public class FileReferenceListExample extends Sprite { public static var LIST_COMPLETE:String = "listComplete"; public function FileReferenceListExample() { initiateFileUpload(); } private function initiateFileUpload():void { var fileRef:CustomFileReferenceList = new CustomFileReferenceList(); fileRef.addEventListener(FileReferenceListExample.LIST_COMPLETE, listCompleteHandler); fileRef.browse(fileRef.getTypes()); } private function listCompleteHandler(event:Event):void { trace("listCompleteHandler"); } } } import flash.events.*; import flash.net.FileReference; import flash.net.FileReferenceList; import flash.net.FileFilter; import flash.net.URLRequest; class CustomFileReferenceList extends FileReferenceList { private var uploadURL:URLRequest; private var pendingFiles:Array; public function CustomFileReferenceList() { uploadURL = new URLRequest(); uploadURL.url = "http://www.[yourDomain].com/yourUploadHandlerScript.cfm"; initializeListListeners(); } private function initializeListListeners():void { addEventListener(Event.SELECT, selectHandler); addEventListener(Event.CANCEL, cancelHandler); } public function getTypes():Array { var allTypes:Array = new Array(); allTypes.push(getImageTypeFilter()); allTypes.push(getTextTypeFilter()); return allTypes; } private function getImageTypeFilter():FileFilter { return new FileFilter("Images (*.jpg, *.jpeg, *.gif, *.png)", "*.jpg;*.jpeg;*.gif;*.png"); } private function getTextTypeFilter():FileFilter { return new FileFilter("Text Files (*.txt, *.rtf)", "*.txt;*.rtf"); } private function doOnComplete():void { var event:Event = new Event(FileReferenceListExample.LIST_COMPLETE); dispatchEvent(event); } private function addPendingFile(file:FileReference):void { trace("addPendingFile: name=" + file.name); pendingFiles.push(file); file.addEventListener(Event.OPEN, openHandler); file.addEventListener(Event.COMPLETE, completeHandler); file.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler); file.addEventListener(ProgressEvent.PROGRESS, progressHandler); file.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler); file.upload(uploadURL); } private function removePendingFile(file:FileReference):void { for (var i:uint; i < pendingFiles.length; i++) { if (pendingFiles[i].name == file.name) { pendingFiles.splice(i, 1); if (pendingFiles.length == 0) { doOnComplete(); } return; } } } private function selectHandler(event:Event):void { trace("selectHandler: " + fileList.length + " files"); pendingFiles = new Array(); var file:FileReference; for (var i:uint = 0; i < fileList.length; i++) { file = FileReference(fileList[i]); addPendingFile(file); } } private function cancelHandler(event:Event):void { var file:FileReference = FileReference(event.target); trace("cancelHandler: name=" + file.name); } private function openHandler(event:Event):void { var file:FileReference = FileReference(event.target); trace("openHandler: name=" + file.name); } private function progressHandler(event:ProgressEvent):void { var file:FileReference = FileReference(event.target); trace("progressHandler: name=" + file.name + " bytesLoaded=" + event.bytesLoaded + " bytesTotal=" + event.bytesTotal); } private function completeHandler(event:Event):void { var file:FileReference = FileReference(event.target); trace("completeHandler: name=" + file.name); removePendingFile(file); } private function httpErrorHandler(event:Event):void { var file:FileReference = FileReference(event.target); trace("httpErrorHandler: name=" + file.name); } private function ioErrorHandler(event:Event):void { var file:FileReference = FileReference(event.target); trace("ioErrorHandler: name=" + file.name); } private function securityErrorHandler(event:Event):void { var file:FileReference = FileReference(event.target); trace("securityErrorHandler: name=" + file.name + " event=" + event.toString()); } }
Tue Jun 12 2018, 01:09 PM Z