JavaTM 2
Platform
Std. Ed. v1.4.0

java.awt.dnd
クラス DragGestureEvent

java.lang.Object
  |
  +--java.util.EventObject
        |
        +--java.awt.dnd.DragGestureEvent
すべての実装インタフェース:
Serializable

public class DragGestureEvent
extends EventObject

DragGestureEvent は、DragGestureListener の dragGestureRecognized() メソッドに渡されます。これは、特定の DragGestureRecognizer が、追跡中の Component でプラットフォーム依存のドラッグ開始ジェスチャーを検出したときに行われます。

関連項目:
DragGestureRecognizer, DragGestureListener, DragSource, 直列化された形式

フィールドの概要
 
クラス java.util.EventObject から継承したフィールド
source
 
コンストラクタの概要
DragGestureEvent(DragGestureRecognizer dgr, int act, Point ori, List evs)
          このイベントをトリガする DragGestureRecognizer を指定した DragGestureEvent、ユーザの希望するアクションを表す int、ドラッグの起点を示す Point、ジェスチャーを構成するイベントの List を構築します。
 
メソッドの概要
 Component getComponent()
          DragGestureEvent に関連した Component を返します。
 int getDragAction()
          ユーザが選択したアクションを表す int を返します。
 Point getDragOrigin()
          ドラッグを開始した Component の座標の Point を返します。
 DragSource getDragSource()
          DragSource を返します。
 DragGestureRecognizer getSourceAsDragGestureRecognizer()
          DragGestureRecognizer としてのソースを返します。
 InputEvent getTriggerEvent()
          ジェスチャーをトリガした初期イベントを返します。
 Iterator iterator()
          ジェスチャーを構成するイベントの Iterator を返します。
 void startDrag(Cursor dragCursor, Image dragImage, Point imageOffset, Transferable transferable, DragSourceListener dsl)
          初期 Cursor を表示しドラッグを開始してから、ドラッグ ImageImage のオフセット、Transferable オブジェクトと DragSourceListener を使用します。
 void startDrag(Cursor dragCursor, Transferable transferable)
          このドラッグ操作の Cursor、およびこのドラッグ操作のソースデータを表す Transferable を指定して、ドラッグ操作を開始します。
 void startDrag(Cursor dragCursor, Transferable transferable, DragSourceListener dsl)
          初期 Cursor を表示しドラッグを開始してから、Transferable オブジェクトと DragSourceListener を使用します。
 Object[] toArray()
          ドラッグジェスチャーを構成するイベントの Object の配列を返します。
 Object[] toArray(Object[] array)
          ドラッグジェスチャーを構成するイベントの配列を返します。
 
クラス java.util.EventObject から継承したメソッド
getSource, toString
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

コンストラクタの詳細

DragGestureEvent

public DragGestureEvent(DragGestureRecognizer dgr,
                        int act,
                        Point ori,
                        List evs)
このイベントをトリガする DragGestureRecognizer を指定した DragGestureEvent、ユーザの希望するアクションを表す int、ドラッグの起点を示す Point、ジェスチャーを構成するイベントの List を構築します。

パラメータ:
dgr - このイベントをトリガする DragGestureRecognizer
act - ユーザの希望するアクション
ori - ドラッグの起点
evs - ジェスチャーを構成するイベントの List

例外:
IllegalArgumentException入力パラメータが - null の場合
メソッドの詳細

getSourceAsDragGestureRecognizer

public DragGestureRecognizer getSourceAsDragGestureRecognizer()
DragGestureRecognizer としてのソースを返します。

戻り値:
DragGestureRecognizer としてのソース

getComponent

public Component getComponent()
DragGestureEvent に関連した Component を返します。

戻り値:
コンポーネント

getDragSource

public DragSource getDragSource()
DragSource を返します。

戻り値:
DragSource

getDragOrigin

public Point getDragOrigin()
ドラッグを開始した Component の座標の Point を返します。

戻り値:
Component の座標でドラッグが開始された Point

iterator

public Iterator iterator()
ジェスチャーを構成するイベントの Iterator を返します。

戻り値:
ジェスチャーを構成するイベントの反復子

toArray

public Object[] toArray()
ドラッグジェスチャーを構成するイベントの Object の配列を返します。

戻り値:
ジェスチャーを構成するイベントの配列

toArray

public Object[] toArray(Object[] array)
ドラッグジェスチャーを構成するイベントの配列を返します。

パラメータ:
array - EventObject サブタイプの配列

戻り値:
ジェスチャーを構成するイベントの配列

getDragAction

public int getDragAction()
ユーザが選択したアクションを表す int を返します。

戻り値:
ユーザが選択したアクション

getTriggerEvent

public InputEvent getTriggerEvent()
ジェスチャーをトリガした初期イベントを返します。

戻り値:
ジェスチャーシーケンスでの最初の「トリガ」イベント

startDrag

public void startDrag(Cursor dragCursor,
                      Transferable transferable)
               throws InvalidDnDOperationException
このドラッグ操作の Cursor、およびこのドラッグ操作のソースデータを表す Transferable を指定して、ドラッグ操作を開始します。
nullCursor が指定された場合は、例外はスローされず、代わりにデフォルトのドラッグカーソルが使用されます。
nullTransferable が指定された場合は、NullPointerException がスローされます。

パラメータ:
dragCursor - このドラッグ操作の Cursor
transferable - このドラッグ操作のソースデータを表す Transferable
例外:
InvalidDnDOperationExceptionドラッグ&ドロップシステムがドラッグ操作を開始できない場合、または既存のドラッグ操作を実行中にユーザがドラッグを開始しようとした場合
NullPointerExceptionTransferable - が null の場合
InvalidDnDOperationException
導入されたバージョン:
1.4

startDrag

public void startDrag(Cursor dragCursor,
                      Transferable transferable,
                      DragSourceListener dsl)
               throws InvalidDnDOperationException
初期 Cursor を表示しドラッグを開始してから、Transferable オブジェクトと DragSourceListener を使用します。

パラメータ:
dragCursor - 初期ドラッグカーソル
transferable - ソースの Transferable
dsl - ソースの DragSourceListener

例外:
InvalidDnDOperationExceptionドラッグ&ドロップシステムがドラッグ操作を開始できない場合、または既存のドラッグ操作を実行中にユーザがドラッグを開始しようとした場合
InvalidDnDOperationException

startDrag

public void startDrag(Cursor dragCursor,
                      Image dragImage,
                      Point imageOffset,
                      Transferable transferable,
                      DragSourceListener dsl)
               throws InvalidDnDOperationException
初期 Cursor を表示しドラッグを開始してから、ドラッグ ImageImage のオフセット、Transferable オブジェクトと DragSourceListener を使用します。

パラメータ:
dragCursor - 初期ドラッグカーソル
dragImage - ソースの dragImage
imageOffset - dragImage のオフセット
transferable - ソースの Transferable
dsl - ソースの DragSourceListener

例外:
InvalidDnDOperationExceptionドラッグ&ドロップシステムがドラッグ操作を開始できない場合、または既存のドラッグ操作を実行中にユーザがドラッグを開始しようとした場合
InvalidDnDOperationException

JavaTM 2
Platform
Std. Ed. v1.4.0

バグの報告と機能のリクエスト
これ以外の API リファレンスおよび開発者用ドキュメントについては、 Java 2 SDK SE 開発者用ドキュメントを参照してください。 開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、 およびコード実例が含まれています。

Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.