套件 | mx.core |
類別 | public class DragSource |
繼承 | DragSource Object |
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | Flash Player 9, AIR 1.1 |
Each format of data is identified with a string. The
hasFormat()
method is used to determine if the object has
data in that format. The dataForFormat()
method is used
to retrieve the data in the specified format.
Data can be added directly using the addData()
method,
or indirectly using the addHandler()
method. The
addHandler()
method registers a callback that will be called
if the data is requested. This is useful for adding data in a non-native
format that may require large computations or conversions. For example,
if you have raw sound data you can add an MP3 format handler. The MP3
conversion will only be done if the MP3 data is requested.
屬性 | 定義自 | ||
---|---|---|---|
constructor : Object
類別物件的參照或是特定物件實體的建構函數。 | Object | ||
formats : Array [唯讀]
Contains the formats of the drag data, as an Array of Strings. | DragSource |
方法 | 定義自 | ||
---|---|---|---|
Constructor. | DragSource | ||
Adds data and a corresponding format String to the drag source. | DragSource | ||
Adds a handler that is called when data
for the specified format is requested. | DragSource | ||
Retrieves the data for the specified format. | DragSource | ||
Returns true if the data source contains
the requested format; otherwise, it returns false. | DragSource | ||
指出物件是否有已定義的指定屬性。 | Object | ||
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。 | Object | ||
指出指定的屬性是否存在,以及是否可列舉。 | Object | ||
為迴圈作業設定動態屬性的可用性。 | Object | ||
傳回代表此物件的字串,根據地區特定慣例進行格式化。 | Object | ||
會傳回指定之物件的字串形式。 | Object | ||
會傳回指定之物件的基本值。 | Object |
formats | 屬性 |
formats:Array
[唯讀] 語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | Flash Player 9, AIR 1.1 |
Contains the formats of the drag data, as an Array of Strings.
Set this property using the addData()
or addHandler()
methods.
The default value depends on data added to the DragSource object.
實作
public function get formats():Array
DragSource | () | 建構函式 |
public function DragSource()
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | Flash Player 9, AIR 1.1 |
Constructor.
addData | () | 方法 |
public function addData(data:Object, format:String):void
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | Flash Player 9, AIR 1.1 |
Adds data and a corresponding format String to the drag source. This method does not return a value.
參數
data:Object — Object that specifies the drag data.
This can be any object, such as a String, a DataProvider, and so on.
| |
format:String — String that specifies a label that describes
the format for this data.
|
addHandler | () | 方法 |
public function addHandler(handler:Function, format:String):void
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | Flash Player 9, AIR 1.1 |
Adds a handler that is called when data for the specified format is requested. This is useful when dragging large amounts of data. The handler is only called if the data is requested. This method does not return a value.
參數
handler:Function — Function that specifies the handler
called to request the data.
This function must return the data in the specified format.
| |
format:String — String that specifies the format for this data.
|
dataForFormat | () | 方法 |
public function dataForFormat(format:String):Object
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | Flash Player 9, AIR 1.1 |
Retrieves the data for the specified format.
If the data was added with the addData()
method,
it is returned directly.
If the data was added with the addHandler()
method,
the handler function is called to return the data.
參數
format:String — String that specifies a label that describes
the format for the data to return. This string can be a custom value
if you are creating a custom drop target with the addData() method.
List-based controls have predefined values
for the |
Object — An Object
containing the data in the requested format.
If you drag multiple items, the returned value is an Array.
For a List-based control, the returned value is always an Array,
even if it contains a single item.
|
hasFormat | () | 方法 |
public function hasFormat(format:String):Boolean
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | Flash Player 9, AIR 1.1 |
Returns true
if the data source contains
the requested format; otherwise, it returns false
.
參數
format:String — String that specifies a label that describes the format
for the data.
|
Boolean — true if the data source contains
the requested format.
|
Tue Jun 12 2018, 03:47 PM Z