パッケージmx.managers
public class DragManager
継承DragManager Inheritance Object

DragManager クラスは、Flex アプリケーションでデータを移動する際のドラッグ & ドロップ操作を管理します。たとえば、List コントロールや Flex コントロールのアイテム、Image コントロールなどのオブジェクトを選択して他のコンポーネントまでドラッグし、そのコンポーネントに追加することができます。

DragManager のメソッドとプロパティはすべて静的なので、そのインスタンスを作成する必要はありません。

すべての Flex コンポーネントはドラッグ & ドロップ操作をサポートしています。Flex では、List、Tree、および DataGrid の各コントロールへのドラッグ & ドロップ操作もサポートしています。

ユーザーがマウスでアイテムを選択した場合、選択されたコンポーネントをドラッグイニシエータと呼びます。ドラッグ操作中に表示されるイメージをドラッグプロキシと呼びます。

ユーザーがドラッグプロキシを他のコンポーネント上に移動すると、dragEnter イベントがそのコンポーネントに送られます。ドラッグを受け入れたコンポーネントはドロップターゲットとなり、dragOver、dragExit、および dragDrop の各イベントを受け取ります。

ドラッグが完了すると、dragComplete イベントがドラッグイニシエータに送られます。

関連項目

mx.core.DragSource
mx.events.DragEvent
mx.core.UIComponent
ドラッグ & ドロップサポートの手動追加
ドラッグ & ドロップに関するテクニックと注意事項

パブリックプロパティ
 プロパティ定義
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
  isDragging : Boolean
[static][read-only] ドラッグが実行中の場合は true を返す、読み取り専用プロパティです。
DragManager
 Inheritedprototype : Object
[static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
パブリック Methods
 メソッド定義
  
acceptDragDrop(target:IUIComponent):void
[static] ドラッグまたはドロップデータを受け入れる場合、dragEnter イベントハンドラからこのメソッドを呼び出します。
DragManager
  
doDrag(dragInitiator:IUIComponent, dragSource:DragSource, mouseEvent:MouseEvent, dragImage:IFlexDisplayObject = null, xOffset:Number = 0, yOffset:Number = 0, imageAlpha:Number = 0.5, allowMove:Boolean = true):void
[static] ドラッグ & ドロップ操作を開始します。
DragManager
  
getFeedback():String
[static] 現在のドラッグ & ドロップフィードバックを返します。
DragManager
 Inherited
hasOwnProperty(name:String):Boolean
指定されたプロパティがオブジェクトに定義されているかどうかを示します。
Object
 Inherited
isPrototypeOf(theClass:Object):Boolean
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
propertyIsEnumerable(name:String):Boolean
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
  
showFeedback(feedback:String):void
[static] ドラッグ & ドロップ操作のフィードバックインジケータを設定します。
DragManager
 Inherited
toString():String
指定されたオブジェクトのストリング表現を返します。
Object
 Inherited
valueOf():Object
指定されたオブジェクトのプリミティブな値を返します。
Object
スタイル
 スタイル説明定義
  
copyCursor
型: Class   CSS の継承: no
コピー操作中に表示されるカーソル。 デフォルト値mx.skins.cursor.DragCopy.		DragManager
  
defaultDragImageSkin
型: Class   CSS の継承: no
デフォルトドラッグイメージの描画に使用されるスキン。ドラッグプロキシとも呼ばれます。 デフォルト値mx.skins.halo.DefaultDragImage.		DragManager
  
linkCursor
型: Class   CSS の継承: no
リンク操作中に表示されるカーソル。 デフォルト値mx.skins.cursor.DragLink.		DragManager
  
moveCursor
型: Class   CSS の継承: no
移動操作中に表示されるカーソル。 デフォルト値mx.skins.cursor.DragMove.		DragManager
  
rejectCursor
型: Class   CSS の継承: no
拒否操作の場合に表示されるカーソル。 デフォルト値mx.skins.cursor.DragReject.		DragManager
パブリック定数
 定数定義
  COPY : String = "copy"
[static] ドラッグアクションのタイプを "copy" に指定する定数です。
DragManager
  LINK : String = "link"
[static] ドラッグアクションのタイプを "link" に指定する定数です。
DragManager
  MOVE : String = "move"
[static] ドラッグアクションのタイプを "move" に指定する定数です。
DragManager
  NONE : String = "none"
[static] ドラッグアクションのタイプを "none" に指定する定数です。
DragManager
プロパティの詳細
isDraggingプロパティ
isDragging:Boolean  [read-only]

ドラッグが実行中の場合は true を返す、読み取り専用プロパティです。

実装
    public static function get isDragging():Boolean
メソッドの詳細
acceptDragDrop()メソッド
public static function acceptDragDrop(target:IUIComponent):void

ドラッグまたはドロップデータを受け入れる場合、dragEnter イベントハンドラからこのメソッドを呼び出します。たとえば、次のようになります。 

DragManager.acceptDragDrop(event.target);

パラメータ
target:IUIComponent — ドラッグを受け入れるドロップターゲット。
doDrag()メソッド 
public static function doDrag(dragInitiator:IUIComponent, dragSource:DragSource, mouseEvent:MouseEvent, dragImage:IFlexDisplayObject = null, xOffset:Number = 0, yOffset:Number = 0, imageAlpha:Number = 0.5, allowMove:Boolean = true):void

ドラッグ & ドロップ操作を開始します。

パラメータ
dragInitiator:IUIComponent — ドラッグを開始するコンポーネントを指定する IUIComponent です。
 
dragSource:DragSource — ドラッグされているデータを含む DragSource オブジェクトです。
 
mouseEvent:MouseEvent — ドラッグを開始するためのマウス情報を含む MouseEvent です。
 
dragImage:IFlexDisplayObject (default = null) — ドラッグするイメージ。このパラメータは省略可能です。省略した場合、ドラッグ & ドロップ操作時には標準的なドラッグ長方形が使用されます。イメージを指定する場合は、イメージの高さと幅を明示的に設定しないとイメージが表示されません。
 
xOffset:Number (default = 0) — dragImage の x オフセットをピクセル単位で指定する数値です。このパラメータは省略可能です。これを省略すると、ドラッグプロキシはドラッグイニシエータの左上隅に表示されます。このオフセットは、ドラッグプロキシの左端からドラッグイニシエータの左端までのピクセル数として表され、通常は負の数値になります。
 
yOffset:Number (default = 0) — dragImage の y オフセットをピクセル単位で指定する数値です。このパラメータは省略可能です。これを省略すると、ドラッグプロキシはドラッグイニシエータの左上隅に表示されます。このオフセットは、ドラッグプロキシの上端からドラッグイニシエータの上端までのピクセル数として表され、通常は負の数値になります。
 
imageAlpha:Number (default = 0.5) — dragImage に使用されるアルファ値を指定する数値です。このパラメータは省略可能です。省略した場合のデフォルトのアルファ値は 0.5 です。値が 0.0 の場合、イメージは透明であることを示します。値が 1.0 の場合、イメージは完全な不透明であることを示します。
 
allowMove:Boolean (default = true)
getFeedback()メソッド 
public static function getFeedback():String

現在のドラッグ & ドロップフィードバックを返します。

戻り値
String — 有効な戻り値は DragManager.COPY、DragManager.MOVE、DragManager.LINK、または DragManager.NONE です。
showFeedback()メソッド 
public static function showFeedback(feedback:String):void

ドラッグ & ドロップ操作のフィードバックインジケータを設定します。有効な値は DragManager.COPY、DragManager.MOVE、DragManager.LINK、または DragManager.NONE です。

パラメータ
feedback:String — 表示するフィードバックインジケータのタイプ。
定数の詳細
COPY定数
public static const COPY:String = "copy"

ドラッグアクションのタイプを "copy" に指定する定数です。

LINK定数 
public static const LINK:String = "link"

ドラッグアクションのタイプを "link" に指定する定数です。

MOVE定数 
public static const MOVE:String = "move"

ドラッグアクションのタイプを "move" に指定する定数です。

NONE定数 
public static const NONE:String = "none"

ドラッグアクションのタイプを "none" に指定する定数です。




© 2004-2007 Adobe Systems Incorporated. All rights reserved.
2007.04.26, 午前 9:17, GMT-07:00