JavaTM Platform
Standard Ed. 6

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<? extends InputEvent> 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<InputEvent> 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<? extends InputEvent> 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<InputEvent> 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 を指定して、ドラッグ操作を開始します。null の Cursor が指定された場合は、例外はスローされず、代わりにデフォルトのドラッグカーソルが使用されます。
nullTransferable が指定された場合は、NullPointerException がスローされます。

パラメータ:
dragCursor - このドラッグ操作の Cursor
transferable - このドラッグ操作の ソースデータを表す Transferable
例外:
InvalidDnDOperationException - ドラッグ&ドロップシステムが ドラッグ操作を開始できない場合、 または既存のドラッグ操作を実行中に ユーザーがドラッグを開始しようとした場合
NullPointerException - Transferablenull の場合
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 Platform
Standard Ed. 6

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

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。