Adobe® Flash® Platform için ActionScript® 3.0 Başvurusu
Ana Sayfa  |  Paket ve Sınıf Listesini Gizle |  Paketler  |  Sınıflar  |  Yenilikler  |  Dizin  |  Ekler  |  Niçin İngilizce?
Filtreler: AIR 30.0 ve öncesi, Flash Player 30.0 ve öncesi, Flash Lite 4
Flex 4.6 ve öncesi, Flash Pro CS6 ve öncesi
Filtreleri Gizle
flash.net 

FileReferenceList  - AS3

Paketflash.net
Sınıfpublic class FileReferenceList
Miras AlmaFileReferenceList Inheritance EventDispatcher Inheritance Object

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0, Flash Player 9

FileReferenceList sınıfı, kullanıcıların yüklemek üzere bir veya daha fazla dosya seçmelerini sağlar. Bir FileReferenceList nesnesi kullanıcının diski üzerindeki bir veya daha fazla yerel dosya grubunu, FileReference nesnelerinin bir dizisi olarak temsil eder. FileReferenceList ile kullandığınız FileReference nesneleri ve FileReference sınıfı hakkında ayrıntılı bilgi FileReference sınıfına bakın.

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 nesnesinin fileList özelliği FileReference nesnelerinin bir dizisiyle doldurulur.
  • fileList dizisindeki her öğe üzerinde FileReference.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.

Örnekleri görüntüle

İlgili API Öğeleri



Genel Özellikler
 ÖzellikTanımlayan:
 Inheritedconstructor : 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
Genel Yöntemler
 YöntemTanımlayan:
  
Yeni FileReferenceList nesnesi oluşturur.
FileReferenceList
 Inherited
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
  
browse(typeFilter:Array = null):Boolean
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
 Inherited
Olay akışına bir olay gönderir.
EventDispatcher
 Inherited
EventDispatcher nesnesinin belirli bir olay türü için kayıtlı dinleyicisi olup olmadığını kontrol eder.
EventDispatcher
 Inherited
Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir.
Object
 Inherited
Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir.
Object
 Inherited
Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher nesnesinden bir dinleyiciyi kaldırır.
EventDispatcher
 Inherited
Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar.
Object
 Inherited
Bu nesnenin, yerel ayara özel kurallara göre biçimlendirilmiş dize temsilini döndürür.
Object
 Inherited
Belirtilen nesnenin dize olarak temsil edilen halini döndürür.
Object
 Inherited
Belirtilen nesnenin temel değerini döndürür.
Object
 Inherited
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
Olaylar
 Olay Özet Tanımlayan:
 Inherited[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
 Inherited[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
Özellik Ayrıntısı

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

Yapıcı Ayrıntı

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

Yöntem Ayrıntısı

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.

Döndürür
Boolean — Parametreler geçerliyse ve dosya gözatma iletişim kutusu açılırsa true değerini döndürür.

Olaylar
select:Event — Kullanıcı, iletişim kutusunu kullanarak başarılı bir şekilde yüklenecek bir öğe seçtiğinde çağrılır.
 
cancel:Event — 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

Olay Ayrıntısı

cancel

Olay
Olay Nesne Türü: 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:

ÖzellikDeğer
bubblesfalse
cancelablefalse; iptal edilecek varsayılan davranış yoktur.
currentTargetBu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
targetÜzerindeki işlem iptal edilen nesnenin başvurusu.

İlgili API Öğeleri

select

Olay  
Olay Nesne Türü: 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:

ÖzellikDeğer
bubblesfalse
cancelablefalse; iptal edilecek varsayılan davranış yoktur.
currentTargetBu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
targetÜzerinde bir öğenin seçildiği nesne.

İlgili API Öğeleri

FileReferenceListExample.as

Şu örnek, birden çok dosyanın yüklenmesini yönetmek için olayları nasıl kullanabileceğinizi gösterir. CustomFileReferenceList sınıfı FileReferenceList öğesini genişletir ve FileReferenceList nesnesindeki her dosya yüklendiğinde gönderilen bir 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());
    }
}




[ X ]Niçin İngilizce?
ActionScript 3.0 Başvurusu'ndaki içerik İngilizce görünür

ActionScript 3.0 Başvurusu'nun tüm bölümleri tüm dillere çevrilmemiştir. Bir dil öğesi çevrilmediğinde İngilizce görünür. Örneğin, ga.controls.HelpBox sınıfı hiçbir dile çevrilmez. Bu nedenle, başvurunun Türkçe versiyonunda ga.controls.HelpBox sınıfı İngilizce görünür.