DragManager - Adobe ActionScript® 3（AS3 Flex）API リファレンス

パッケージ	mx.managers
クラス	public class DragManager
継承	DragManager Object

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

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

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

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

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

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

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

さらに例を参照

Dragging and dropping in sandboxed applications
Dragging and dropping in multi-versioned applications
The drag-and-drop operation

パブリックプロパティ

継承されるパブリックプロパティを隠す

継承されるパブリックプロパティを表示

	プロパティ		定義元
		constructor : Object 指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。	Object
		isDragging : Boolean [静的] [読み取り専用] ドラッグが実行中の場合は true を返す、読み取り専用プロパティです。	DragManager

パブリックメソッド

継承されるパブリックメソッドを隠す

継承されるパブリックメソッドを表示

	メソッド		定義元
		acceptDragDrop(target:IUIComponent):void [静的] ドラッグまたはドロップデータを受け入れる場合、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 [静的] ドラッグ＆ドロップ操作を開始します。	DragManager
		getFeedback():String [静的] 現在のドラッグ＆ドロップフィードバックを返します。	DragManager
		hasOwnProperty(name:String):Boolean オブジェクトに指定されたプロパティが定義されているかどうかを示します。	Object
		isPrototypeOf(theClass:Object):Boolean Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。	Object
		propertyIsEnumerable(name:String):Boolean 指定されたプロパティが存在し、列挙できるかどうかを示します。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void ループ処理に対するダイナミックプロパティの可用性を設定します。	Object
		showFeedback(feedback:String):void [静的] ドラッグ＆ドロップ操作のフィードバックインジケーターを設定します。	DragManager
		toLocaleString():String ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。	Object
		toString():String 指定されたオブジェクトのストリング表現を返します。	Object
		valueOf():Object 指定されたオブジェクトのプリミティブな値を返します。	Object

スタイル

スタイルには共通スタイルと特定のテーマに関連するスタイルがあります。共通スタイルは、任意のテーマと共に使用できます。特定のテーマに関連するスタイルは、アプリケーションがそのテーマを使用する場合にのみ使用できます。

共通スタイル

スタイルの詳細についてはここをクリックしてください

	説明	定義元
copyCursor	型: Class CSS 継承: いいえ言語バージョン: ActionScript 3.0 製品バージョン: Flex 3 ランタイムバージョン: Flash9, AIR 1.1 コピー操作中に表示されるカーソル。デフォルト値は、Assets.swf ファイル内の "mx.skins.cursor.DragCopy" シンボルです。	DragManager
defaultDragImageSkin	型: Class CSS 継承: いいえ言語バージョン: ActionScript 3.0 製品バージョン: Flex 3 ランタイムバージョン: Flash9, AIR 1.1 デフォルトドラッグイメージの描画に使用されるスキン。ドラッグプロキシとも呼ばれます。デフォルト値： `mx.skins.halo.DefaultDragImage (for both Halo and Spark themes)`。	DragManager
linkCursor	型: Class CSS 継承: いいえ言語バージョン: ActionScript 3.0 製品バージョン: Flex 3 ランタイムバージョン: Flash9, AIR 1.1 リンク操作中に表示されるカーソル。デフォルト値は、Assets.swf ファイル内の "mx.skins.cursor.DragLink" シンボルです。	DragManager
moveCursor	型: Class CSS 継承: いいえ言語バージョン: ActionScript 3.0 製品バージョン: Flex 3 ランタイムバージョン: Flash9, AIR 1.1 移動操作中に表示されるカーソル。デフォルト値は、Assets.swf ファイル内の "mx.skins.cursor.DragMove" シンボルです。	DragManager
rejectCursor	型: Class CSS 継承: いいえ言語バージョン: ActionScript 3.0 製品バージョン: Flex 3 ランタイムバージョン: Flash9, AIR 1.1 拒否操作の場合に表示されるカーソル。デフォルト値は、Assets.swf ファイル内の "mx.skins.cursor.DragReject" シンボルです。	DragManager

パブリック定数

	定数		定義元
		COPY : String = "copy" [静的] ドラッグアクションのタイプを「copy」に指定する定数です。	DragManager
		LINK : String = "link" [静的] ドラッグアクションのタイプを「link」に指定する定数です。	DragManager
		MOVE : String = "move" [静的] ドラッグアクションのタイプを「move」に指定する定数です。	DragManager
		NONE : String = "none" [静的] ドラッグアクションのタイプを「none」に指定する定数です。	DragManager

プロパティの詳細

isDragging

プロパティ

isDragging:Boolean [読み取り専用]

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

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

実装
public static function get isDragging():Boolean

メソッドの詳細

acceptDragDrop

()

メソッド

public static function acceptDragDrop(target:IUIComponent):void

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

ドラッグまたはドロップデータを受け入れる場合、dragEnter イベントハンドラーからこのメソッドを呼び出します。通常は、ドロップターゲットのデータ型に event.target をキャストします。次の例では、ドロップターゲットは MX Canvas コンテナです。

DragManager.acceptDragDrop(Canvas(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

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

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

パラメーター

	`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

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

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

戻り値

String — 有効な戻り値は DragManager.COPY、DragManager.MOVE、DragManager.LINK または DragManager.NONE です。

showFeedback

()

メソッド

public static function showFeedback(feedback:String):void

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

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

パラメーター

feedback:String — 表示するフィードバックインジケーターのタイプ。

定数の詳細

COPY

定数

public static const COPY:String = "copy"

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

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

LINK

定数

public static const LINK:String = "link"

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

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

MOVE

定数

public static const MOVE:String = "move"

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

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

NONE

定数

public static const NONE:String = "none"

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

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

法律上の注意 | プライバシーポリシー

DragManager - AS3 Flex

クラス x

isDragging

acceptDragDrop

doDrag

getFeedback

showFeedback

COPY

LINK

MOVE

NONE