適用於 Adobe® Flash® Platform 的 ActionScript® 3.0 參考
首頁  |  隱藏套件和類別清單 |  套件  |  類別  |  新增內容  |  索引  |  附錄  |  為什麼顯示英文?
篩選: 從伺服器擷取資料...
從伺服器擷取資料...
com.adobe.icomm.assetplacement.data 

XFADataStream  - AS3 Asset Placement

套件com.adobe.icomm.assetplacement.data
類別public class XFADataStream
繼承XFADataStream Inheritance EventDispatcher Inheritance Object

語言版本: ActionScript 3.0
產品版本: Asset Placement Building Block 10
執行階段版本: AIR 1.0, Flash Player 10

XFADataStream is used for asynchronous read/write to the datasets XML packet within the XFA array of a PDF document. The datasets XML is specified in a package definition file by declaring an xml resource with a special reserved id value of "data". This packet represents the data that both the host PDF document and the SWF navigator share. In order to read/write to this packet the application must have initialized the NavigatorHostInstance class by calling
             NavigatorHostInstance.initialize(hostValue);
     
in the handshaking function between the navigator and the host.

檢視範例

相關 API 元素

com.adobe.portfolio.api.INavigator
com.adobe.portfolio.api.INavigatorHost
Otherwise any calls to read or write to the datasets packet will throw an exception.


公用屬性
 屬性定義自
 Inheritedconstructor : Object
類別物件的參照或是特定物件實體的建構函數。
Object
公用方法
 方法定義自
  
Constructor
XFADataStream
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
會在 EventDispatcher 物件註冊事件偵聽程式,以便讓偵聽程式收到事件的通知。
EventDispatcher
 Inherited
會將事件傳送到事件流程。
EventDispatcher
 Inherited
會檢查 EventDispatcher 物件是否有對特定的事件類型註冊偵聽程式。
EventDispatcher
 Inherited
指出物件是否有已定義的指定屬性。
Object
 Inherited
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。
Object
 Inherited
指出指定的屬性是否存在,以及是否可列舉。
Object
  
Asynch call to read the xfadata set xml stream from Acrobat.
XFADataStream
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
會從 EventDispatcher 物件移除偵聽程式。
EventDispatcher
 Inherited
為迴圈作業設定動態屬性的可用性。
Object
 Inherited
傳回代表此物件的字串,根據地區特定慣例進行格式化。
Object
 Inherited
會傳回指定之物件的字串形式。
Object
 Inherited
會傳回指定之物件的基本值。
Object
 Inherited
檢查此 EventDispatcher 物件是否已註冊事件偵聽程式,或者此物件的任何祖系已為特定事件類型註冊事件偵聽程式。
EventDispatcher
  
Asynch call to save the given XML into the xfadata set stream within Acrobat.
XFADataStream
事件
 事件 摘要 定義自
 Inherited[廣播事件] 當 Flash Player 或 AIR 應用程式取得作業系統焦點並成為作用中時傳送。EventDispatcher
 Inherited[廣播事件] 當 Flash Player 或 AIR 應用程式失去作業系統焦點並成為非作用中時傳送。EventDispatcher
  Dispatched when the xfadataset xml fails to loadXFADataStream
  Dispatched when the xfadataset xml is available after calling readXML()XFADataStream
  Dispatched when the xfadataset xml has finished saving after a call to saveData(xml)XFADataStream
  Dispatched when the xfadataset xml has failed to save after a call to saveXML(xml)XFADataStream
建構函式詳細資料

XFADataStream

()建構函式
public function XFADataStream()

語言版本: ActionScript 3.0
產品版本: Asset Placement Building Block 10
執行階段版本: AIR 1.0, Flash Player 9, Flash Player 10

Constructor

方法詳細資訊

readXML

()方法
public function readXML():void

語言版本: ActionScript 3.0
產品版本: Asset Placement Building Block 10
執行階段版本: AIR 1.0, Flash Player 10

Asynch call to read the xfadata set xml stream from Acrobat. Caller should register for xfaDataReady event as well as xfaDataLoadFailed event. Calling this function before setting NavigatorHostInstance.value throws an error.

writeXML

()方法 
public function writeXML(xml:XML):void

語言版本: ActionScript 3.0
產品版本: Asset Placement Building Block 10
執行階段版本: AIR 1.0, Flash Player 10

Asynch call to save the given XML into the xfadata set stream within Acrobat. Caller should register for xfaDataSaved and xfaDataSaveFailed events to determine the outcome. The xml passed in must be non-null, otherwise an Error is thrown. Calling this function before setting NavigatorHostInstance.value throws an error.

參數

xml:XML

事件詳細資訊

xfaDataLoadFailed

事件
事件物件類型: com.adobe.icomm.assetplacement.data.XFADataLoadFailedEvent
屬性 XFADataLoadFailedEvent.type = com.adobe.icomm.assetplacement.data.XFADataLoadedEvent.XFA_DATA_LOADFAILED

語言版本: ActionScript 3.0
產品版本: Asset Placement Building Block 10
執行階段版本: AIR 1.0, Flash Player 10

Dispatched when the xfadataset xml fails to load

xfaDataReady

事件  
事件物件類型: com.adobe.icomm.assetplacement.data.XFADataReadyEvent
屬性 XFADataReadyEvent.type = com.adobe.icomm.assetplacement.data.XFADataLoadedEvent.XFA_DATA_LOADED

語言版本: ActionScript 3.0
產品版本: Asset Placement Building Block 10
執行階段版本: AIR 1.0, Flash Player 10

Dispatched when the xfadataset xml is available after calling readXML()

xfaDataSaved

事件  
事件物件類型: com.adobe.icomm.assetplacement.data.XFADataSavedEvent
屬性 XFADataSavedEvent.type = com.adobe.icomm.assetplacement.data.XFADataSavedEvent.XFA_DATA_SAVED

語言版本: ActionScript 3.0
產品版本: Asset Placement Building Block 10
執行階段版本: AIR 1.0, Flash Player 10

Dispatched when the xfadataset xml has finished saving after a call to saveData(xml)

A value that represents the Event name.

xfaDataSaveFailed

事件  
事件物件類型: com.adobe.icomm.assetplacement.data.XFADataSaveFailedEvent
屬性 XFADataSaveFailedEvent.type = com.adobe.icomm.assetplacement.data.XFADataSaveFailedEvent.XFA_DATA_SAVEFAILED

語言版本: ActionScript 3.0
產品版本: Asset Placement Building Block 10
執行階段版本: AIR 1.0, Flash Player 9, Flash Player 10

Dispatched when the xfadataset xml has failed to save after a call to saveXML(xml)

A value that represents the Event name.
This class can be used in ActionScript as follows:
     
     private xfaStream:XFADataStream = new XFADataStream();
     
     public function set host(value:INavigatorHost):void
     {
             if(value)
             {
             //
             //Initialize the navigator.
             //
                 
             //Set the host instance to allow centralized access
             NavigatorHostInstance.initialize(value);
     
             //Add handlers for read/write                       
             xfaStream.addEventListener(XFADataReadyEvent.XFA_DATA_READY, onXFADataReady);
             xfaStream.addEventListener(XFADataLoadFailedEvent.XFA_DATA_LOADFAILED, onXFADataLoadFailed);                                 
             xfaStream.addEventListener(XFADataSavedEvent.XFA_DATA_SAVED, onXFADataSaved);
             xfaStream.addEventListener(XFADataSaveFailedEvent.XFA_DATA_SAVEFAILED, onXFADataSaveFailed);
         }    
         else
         {
             //
             //Shutdown the navigator
             //
             NavigatorHostInstance.release();
     
                 //other cleanup ...
             }
     }
     
     public function readData() : void
     {
      try
       {
         xfaStream.readXML();                    
          }
      catch(e:Error)
       {
         //UNEXPECTED ERROR
       } 
     }
     
     public function writeData(newXML:XML) : void
     {
         try
         {                    
             xfaStream.writeXML(xml);
         }
         catch(e:Error) 
         {
             //UNEXPECTED ERROR 
         } 
     }
      
     //event handler for when xfa data successfully loaded via XFADataStream
     private function onXFADataReady(event:XFADataReadyEvent) : void
     {
         //The xfa data loaded successfully 
         var info:XML = event.data;
     }
     
     //event handler for when xfa data fails to load via XFADataStream
     private function onXFADataLoadFailed(event:XFADataLoadFailedEvent) : void
     {
             //Failed to load data. See event.error
     }
     
     //event handler for when xfa data successfully saved via XFADataStream
     private function onXFADataSaved(event:XFADataSavedEvent) : void
     {
             //The xfa data was saved successfully");                
     }
     
     //event handler for when xfa data fails to save via XFADataStream
     private function onXFADataSaveFailed(event:XFADataSaveFailedEvent) : void
     {
             //Failure to save data. See event.error
     }
     
     




[ X ]為什麼顯示英文?
「ActionScript 3.0 參考」的內容是以英文顯示

並非所有「ActionScript 3.0 參考」的內容都翻譯為所有語言。當語言元素未翻譯時,就會以英文顯示。例如,ga.controls.HelpBox 類別並沒有翻譯為任何語言。因此在參考的繁體中文版本中,ga.controls.HelpBox 類別就會以英文顯示。