| メソッド | プロパティ | フレームあり | フレームなし |
DragManager クラスは、Flex アプリケーションでデータを移動する際のドラッグ & ドロップ操作を管理します。たとえば、List コントロールや Flex コントロールのアイテム、Image コントロールなどのオブジェクトを選択して他のコンポーネントまでドラッグし、そのコンポーネントに追加することができます。
DragManager のメソッドとプロパティはすべて静的なので、そのインスタンスを作成する必要はありません。
すべての Flex コンポーネントはドラッグ & ドロップ操作をサポートしています。Flex では、List、Tree、および DataGrid の各コントロールへのドラッグ & ドロップ操作もサポートしています。
ユーザーがマウスでアイテムを選択した場合、選択されたコンポーネントをドラッグイニシエータと呼びます。ドラッグ操作中に表示されるイメージをドラッグプロキシと呼びます。
ユーザーがドラッグプロキシを他のコンポーネント上に移動すると、dragEnter イベントがそのコンポーネントに送られます。ドラッグを受け入れたコンポーネントはドロップターゲットとなり、dragOver、dragExit、および dragDrop の各イベントを受け取ります。
ドラッグが完了すると、dragComplete イベントがドラッグイニシエータに送られます。
関連項目
mx.core.DragSource
mx.core.UIObject
| メソッド | |
static | doDrag( dragInitiator, dragSource:mx.core.DragSource, dragImage:Object, imageInitObj:Object, xOffset:Number, yOffset:Number, imageAlpha:Number)
ドラッグ & ドロップ操作を開始します。 |
| プロパティ | |
static | COPY:Stringドラッグアクションを指定する定数です。 |
static | isDragging:Boolean
[読み取り専用]
ドラッグが実行中の場合は true を返す、読み取り専用プロパティです。 |
static | LINK:Stringドラッグアクションを指定する定数です。 |
static | MOVE:Stringドラッグアクションを指定する定数です。 |
static | NONE:Stringドラッグアクションを指定する定数です。 |
| メソッドの詳細 |
static doDrag( dragInitiator, dragSource:mx.core.DragSource, dragImage:Object, imageInitObj:Object, xOffset:Number, yOffset:Number, imageAlpha:Number)
パラメータ
dragInitiator - ドラッグを開始するコンポーネントを指定する UIObject です。この引数は必須です。
dragSource:mx.core.DragSource - ドラッグされているデータを含む DragSource オブジェクトです。この引数は必須です。
dragImage:Object - ドラッグするイメージを指定するクラスまたはシンボルのリンケージ識別子への参照です。シンボルを指定するには、シンボル名を指定するストリングを使用します。クラスを指定するには、クラスのコンストラクタを渡します。この引数は省略可能です。省略した場合、ドラッグ & ドロップ操作時には標準的なドラッグ長方形が使用されます。
imageInitObj:Object - dragImage の初期化プロパティを指定するオブジェクトです。この引数は省略可能です。
xOffset:Number - dragImage の x オフセットをピクセル単位で指定する数値です。この引数は省略可能です。省略した場合、イニシエータでのマウスの現在のオフセットがこのオフセットになります。
yOffset:Number - dragImage の y オフセットをピクセル座標単位で指定する数値です。この引数は省略可能です。省略した場合、イニシエータでのマウスの現在のオフセットがこのオフセットになります。
imageAlpha:Number - dragImage に使用されるアルファ値を指定する数値です。この引数は省略可能です。省略した場合、デフォルトのアルファ値 50 が使用されます。値が 0 の場合はイメージが透明であることを示し、値が 100 の場合はイメージが完全に不透明であることを示します。
| プロパティの詳細 |
static COPY:String
static isDragging:Boolean [読み取り専用]
true を返す、読み取り専用プロパティです。
static LINK:String
static MOVE:String
static NONE:String