Paket | air.desktop |
Sınıf | public class URLFilePromise |
Miras Alma | URLFilePromise EventDispatcher Object |
Uygular | IFilePromise |
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.0 |
URLFilePromise sınıfı, veri kaynağı olarak URLStream ve URLRequest nesnelerini kullanarak IFilePromise arabirimini uygular. Uygulama, HTTP veya URLStream sınıfının desteklediği diğer protokoller kullanılarak alınabilen dosyalar için sürükleyip bırakma desteği sağlar.
Bir URL dosya izni oluşturmak için:
- Bir veya daha fazla URLFilePromise nesnesi oluşturup başlatın.
- URLFilePromise nesnelerini bir diziye ekleyin.
-
FILE_PROMISE_LIST
ClipboardFormat öğesini kullanarak diziyi yeni bir Clipboard nesnesine ekleyin. - Bir kullanıcı hareketine yanıt olarak, NativeDragManager
startDrag()
yöntemini çağırıp dosya izinleri dizisini içeren Clipboard nesnesini iletin.
Kullanıcı sürükleme işlemini tamamladığında, çalışma zamanı her dosya izni için verileri indirir. URLFilePromise nesnesinin request
özelliği tarafından belirtilen URL'de verilere erişilir ve bu veriler relativePath
özelliğinde belirtilen dosyaya kaydedilir. Dosya, bırakma konumuna göre kaydedilir. Bu nedenle, ilgili yol foo/bar.txt
ise ve dosya izni home
adındaki bir klasöre bırakılırsa, oluşturulan dosyanın konumu home/foo/bar.txt
olur. Bir hata oluşursa, dosya oluşturulmaz.
URLStream sınıfı üzerinden erişilemeyen veri kaynaklarını desteklemek için IFilePromise arabirimini uygulayın.
Not: AIR çalışma zamanı otomatik olarak open()
, close()
ve reportError()
IFilePromise yöntemlerini çağırır. Bu yöntemler hiçbir zaman uygulama mantığınız tarafından çağrılmamalıdır. Aynı şekilde, bu URLFilePromise nesnesi tarafından gönderilen open
, progress
, complete
ve close
olayları da birincil olarak hata ayıklama amaçlarıyla sağlanır. Uygulamanızın bu olaylara yanıt vermesi gerekmez.
Bu sınıf aircore.swc dosyasına dahildir. Adobe® AIR™ için bir proje oluşturduğunuzda, Adobe® Flash™ Builder bu sınıfı otomatik olarak yükler. Adobe® Flex™ SDK, bu aircore.swc dosyasını da içerir. Flex SDK kullanıyorsanız uygulamayı derlerken bu dosyayı dahil etmeniz gerekir.
Adobe® Flash® Professional'da (CS4 veya üstü) air.desktop paketini kullanmak için:
- Dosya > Yayınlama Ayarları komutunu seçin.
- Flash panelinde, ActionScript 3.0 için Ayarlar düğmesini tıklatın. Kütüphane Yolu'nu seçin.
- SWC Dosyasına Git düğmesini tıklatın. Adobe Flash Professional yükleme klasöründeki Adobe Flash CSn/AIKn.n/frameworks/libs/air/aircore.swc dosyasına gidin.
- Tamam düğmesini tıklatın.
- Aşağıdaki
import
ifadesini ActionScript 3.0 kodunuza ekleyin:import air.desktop.*;
İlgili API Öğeleri
Clipboard sınıfı
ClipboardFormats sınıfı
NativeDragManager sınıfı
URLStream sınıfı
URLRequest sınıfı
Ö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 | ||
isAsync : Boolean [salt okunur]
Kaynak verilerinin eşzamansız olarak kullanılıp kullanılamadığını belirtir. | URLFilePromise | ||
relativePath : String
Oluşturulan dosyanın, bırakma hedefine göre yolu ve dosya adı. | URLFilePromise | ||
request : URLRequest
Sürükleyip bırakma işleminin sonucunda kopyalanacak kaynağı tanımlayan URLRequest öğesi. | URLFilePromise |
Yöntem | Tanımlayan: | ||
---|---|---|---|
Bir URLFilePromise nesnesi oluşturur. | URLFilePromise | ||
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 | ||
AIR çalışma zamanının, sürükleyip bırakma işlemi sırasında uygun zamanda veri kaynağını kapatmasına olanak sağlar. | URLFilePromise | ||
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 | ||
AIR çalışma zamanının, sürükleyip bırakma işlemi sırasında uygun zamanda veri kaynağını açmasına olanak sağlar. | URLFilePromise | ||
Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir. | Object | ||
EventDispatcher nesnesinden bir dinleyiciyi kaldırır. | EventDispatcher | ||
AIR çalışma zamanının, sürükleyip bırakma işlemi sırasında oluşan hataları bildirmesine olanak sağlar. | URLFilePromise | ||
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 | |||
Dosya için veriler tamamen indirildiğinde gönderilir. | URLFilePromise | |||
[broadcast olayı] Çalışan Flash Player veya AIR uygulaması sistem odağını kaybettiğinde ve etkin olmayan duruma geldiğinde gönderilir. | EventDispatcher | |||
Yanıt üstbilgilerini bildirmek üzere HTTP istekleri için gönderilir. | URLFilePromise | |||
İstek durum kodunu bildirmek üzere HTTP istekleri için gönderilir. | URLFilePromise | |||
Bir IOError öğesi dosya indirmeyi önlediğinde gönderilir. | URLFilePromise | |||
Temel URLStream bağlantısı açıldığında gönderilir. | URLFilePromise | |||
Bir veri bloğu, temel URLStream öğesinden okunabilir olduğunda gönderilir. | URLFilePromise | |||
Bir güvenlik hatası dosya indirmeyi önlediğinde gönderilir. | URLFilePromise |
isAsync | özellik |
isAsync:Boolean
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.0 |
Kaynak verilerinin eşzamansız olarak kullanılıp kullanılamadığını belirtir.
URL akışları esas olarak eşzamansız olduğundan, URLFilePrmise nesnesinin isAsync özelliği her zaman true
olur.
Uygulama
public function get isAsync():Boolean
relativePath | özellik |
relativePath:String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.0 |
Oluşturulan dosyanın, bırakma hedefine göre yolu ve dosya adı.
Yol, bırakma konumuna göre çözümlenen alt dizinler içerebilir. Gerekirse alt dizinler oluşturulur. Alt dizinleri dahil ederken, geçerli işletim sistemi için uygun yol ayırıcı karakterini eklemek üzere File.separator
sabitini kullanın. Üst dizine gitmek için .. kısayolunun kullanılmasına izin verilmez.
Dosya adının, uzak kaynağın dosya adıyla aynı olması gerekmez.
Uygulama
public function get relativePath():String
public function set relativePath(value:String):void
request | özellik |
request:URLRequest
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.0 |
Sürükleyip bırakma işleminin sonucunda kopyalanacak kaynağı tanımlayan URLRequest öğesi.
Uygulama
public function get request():URLRequest
public function set request(value:URLRequest):void
URLFilePromise | () | Yapıcı |
public function URLFilePromise()
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.0 |
Bir URLFilePromise nesnesi oluşturur.
Bu URLFilePromise nesnesini kullanmadan önce, request
ve relativePath
özelliklerini ayarlamanız gerekir.
close | () | yöntem |
public function close():void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.0 |
AIR çalışma zamanının, sürükleyip bırakma işlemi sırasında uygun zamanda veri kaynağını kapatmasına olanak sağlar.
Uygulama mantığınızda bu işlemi çağırmayın.
open | () | yöntem |
public function open():IDataInput
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.0 |
AIR çalışma zamanının, sürükleyip bırakma işlemi sırasında uygun zamanda veri kaynağını açmasına olanak sağlar.
Uygulama mantığınızda bu işlemi çağırmayın.
DöndürürIDataInput |
reportError | () | yöntem |
public function reportError(e:ErrorEvent):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.0 |
AIR çalışma zamanının, sürükleyip bırakma işlemi sırasında oluşan hataları bildirmesine olanak sağlar.
URLFilePromise nesnesi, bildirilen tüm hata olaylarını yeniden gönderir. Uygulama mantığınızda bu işlemi çağırmayın.
Parametreler
e:ErrorEvent |
complete | Olay |
flash.events.Event
özellik Event.type =
flash.events.Event.COMPLETE
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.0 |
Dosya için veriler tamamen indirildiğinde gönderilir.
Not: AIR çalışma zamanı, eşzamansız veri alma işlemini yönetmek için bu olayı kullanır. Genellikle, uygulamanızın bu olaya yanıt olarak herhangi bir eylem uygulaması gerekmez.
Event.COMPLETE
sabiti, complete
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 | Yüklemesi tamamlanan network nesnesi. |
httpResponseStatus | Olay |
flash.events.HTTPStatusEvent
özellik HTTPStatusEvent.type =
flash.events.HTTPStatusEvent.HTTP_RESPONSE_STATUS
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.0 |
Yanıt üstbilgilerini bildirmek üzere HTTP istekleri için gönderilir.
httpStatus
olayından farklı olarak, httpResponseStatus
olayı herhangi bir yanıt verisinden önce teslim edilir. Ayrıca, httpResponseStatus
olayı, responseHeaders
ve responseURL
özelliklerine yönelik değerleri (httpStatus
olayı için tanımsızdır) içerir. httpResponseStatus
olayının (varsa) herhangi bir complete
veya error
olayından önce (ve buna ek olarak) gönderileceğini unutmayın.
HTTPStatusEvent.HTTP_RESPONSE_STATUS
sabiti, httpResponseStatus
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. |
responseURL | Yanıtın döndürüldüğü URL. |
responseHeaders | URLRequestHeader nesneleri dizisi olarak yanıtın döndürüldüğü yanıt üstbilgileri. |
status | Sunucudan gelen HTTP durum kodu. |
redirected | Yanıtın yeniden yönlendirme sonucu olup olmadığıyla ilgilidir. |
target | HTTP durum kodunu alan network nesnesi. |
httpStatus | Olay |
flash.events.HTTPStatusEvent
özellik HTTPStatusEvent.type =
flash.events.HTTPStatusEvent.HTTP_STATUS
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.0 |
İstek durum kodunu bildirmek üzere HTTP istekleri için gönderilir.
HTTPStatusEvent.HTTP_STATUS
sabiti, httpStatus
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. |
status | Sunucudan gelen HTTP durum kodu. |
target | HTTP durum kodunu alan network nesnesi. |
ioError | Olay |
flash.events.IOErrorEvent
özellik IOErrorEvent.type =
flash.events.IOErrorEvent.IO_ERROR
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.0 |
Bir IOError öğesi dosya indirmeyi önlediğinde gönderilir.
ioError
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. |
errorID | Belirli bir hata mesajıyla ilişkili başvuru numarası (yalnızca AIR). |
target | Girdi/çıktı hatası yaşayan network nesnesi. |
text | Hata mesajı olarak gösterilecek metin. |
open | Olay |
flash.events.Event
özellik Event.type =
flash.events.Event.OPEN
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.0 |
Temel URLStream bağlantısı açıldığında gönderilir.
Not: AIR çalışma zamanı, eşzamansız veri alma işlemini yönetmek için bu olayı kullanır. Genellikle, uygulamanızın bu olaya yanıt olarak herhangi bir eylem uygulaması gerekmez.
Event.OPEN
sabiti, open
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 | Bağlantıyı açan network nesnesi. |
progress | Olay |
flash.events.ProgressEvent
özellik ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.0 |
Bir veri bloğu, temel URLStream öğesinden okunabilir olduğunda gönderilir.
Not: AIR çalışma zamanı, eşzamansız veri alma işlemini yönetmek için bu olayı kullanır. Genellikle, uygulamanızın bu olaya yanıt olarak herhangi bir eylem uygulaması gerekmez.
Birprogress
olay nesnesinin type
özelliği değerini tanımlar.
Bu olay şu özelliklere sahiptir:
Özellik | Değer |
---|---|
bubbles | false |
bytesLoaded | Dinleyici olayı işlerken yüklenen öğe veya bayt sayısı. |
bytesTotal | Yükleme işlemi başarılı olursa yüklenecek toplam öğe veya bayt sayısı. |
cancelable | false ; iptal edilecek varsayılan davranış yoktur. |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
target | İlerlemeyi bildiren nesne. |
securityError | Olay |
flash.events.SecurityErrorEvent
özellik SecurityErrorEvent.type =
flash.events.SecurityErrorEvent.SECURITY_ERROR
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.0 |
Bir güvenlik hatası dosya indirmeyi önlediğinde gönderilir.
SecurityErrorEvent.SECURITY_ERROR
sabiti, securityError
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 | Güvenlik hatasını bildiren network nesnesi. |
text | Hata mesajı olarak gösterilecek metin. |
Tue Jun 12 2018, 01:09 PM Z