java.awt.dnd

クラス DragGestureRecognizer

java.lang.Object

java.awt.dnd.DragGestureRecognizer

すべての実装されたインタフェース:

Serializable

直系の既知のサブクラス:

MouseDragGestureRecognizer

public abstract class DragGestureRecognizer
extends Object
implements Serializable

DragGestureRecognizer は、プラットフォーム依存のドラッグ開始ジェスチャーを識別するために特定の Component に関連付けることのできる、プラットフォーム依存のリスナーを指定するための抽象基底クラスです。

適切な DragGestureRecognizer サブクラスインスタンスは、特定の Component に関連付けられた DragSource から、またはその createDragGestureRecognizer() メソッド経由で Toolkit オブジェクトから取得されます。

DragGestureRecognizer は、特定の Component に関連付けられると、Component に送られる入力イベントを追跡するために、その Component に適切なリスナーインタフェースを登録します。

DragGestureRecognizer は、Component 上のイベントのシーケンスをドラッグ開始ジェスチャーとして識別すると、gestureRecognized() メソッドを呼び出すことによってそのユニキャスト DragGestureListener に通知します。

具象 DragGestureRecognizer インスタンスは、関連付けられている Component 上のドラッグ開始ジェスチャーを検出すると、DragGestureListener イベントのユニキャストイベントソースに登録されている DragGestureListener に対して DragGestureEvent をトリガーします。この DragGestureListener は、関連付けられた DragSource に (必要に応じて) ドラッグ&ドロップ操作の開始を促します。

関連項目:

DragGestureListener、DragGestureEvent、DragSource、直列化された形式

フィールドのサマリー

フィールド

修飾子と型	フィールドと説明
protected Component	component この DragGestureRecognizer に関連付けられている Component。
protected DragGestureListener	dragGestureListener この DragGestureRecognizer に関連付けられている DragGestureListener。
protected DragSource	dragSource この DragGestureRecognizer に関連付けられている DragSource。
protected ArrayList<InputEvent>	events ドラッグをトリガーする「ジェスチャー」として DragGestureRecognizer によって「認識」された (順番に並べられた) イベントのリスト。
protected int	sourceActions このドラッグ&ドロップ操作で使用されるアクションのタイプを表す int。

コンストラクタのサマリー

コンストラクタ

修飾子	コンストラクタと説明
protected	DragGestureRecognizer(DragSource ds) このドラッグ&ドロップ操作で使用される DragSource を使用して、新しい DragGestureRecognizer を構築します。
protected	DragGestureRecognizer(DragSource ds, Component c) このドラッグ&ドロップ操作で使用される DragSource、およびこの DragGestureRecognizer がドラッグ開始ジェスチャーを「監視」すべき Component を使用して、新しい DragGestureRecognizer を構築します。
protected	DragGestureRecognizer(DragSource ds, Component c, int sa) このドラッグ&ドロップ操作で使用される DragSource、この DragGestureRecognizer がドラッグ開始ジェスチャーを「監視」すべき Component、およびこのドラッグ&ドロップ操作でサポートされるアクションを使用して、新しい DragGestureRecognizer を構築します。
protected	DragGestureRecognizer(DragSource ds, Component c, int sa, DragGestureListener dgl) このドラッグ&ドロップ操作で使用される DragSource、この DragGestureRecognizer がドラッグ開始ジェスチャーを「監視」すべき Component、このドラッグ&ドロップ操作でサポートされるアクション、およびドラッグ開始ジェスチャーが検出されたときに通知する DragGestureListener を使用して、新しい DragGestureRecognizer を構築します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
void	addDragGestureListener(DragGestureListener dgl) 新しい DragGestureListener を登録します。
protected void	appendEvent(InputEvent awtie) この Recognizer によって Component で登録されたリスナーは、この API を介して、ドラッグ&ドロップ開始ジェスチャーを構成する一連のイベントの一部として認識されるすべてのイベントを記録します。
protected void	fireDragGestureRecognized(int dragAction, Point p) ドラッグ&ドロップ開始ジェスチャーが発生したことを DragGestureListener に通知します。
Component	getComponent() このメソッドは、DragGestureRecognizer によってドラッグ開始ジェスチャーを「監視」される Component を返します。
DragSource	getDragSource() このメソッドは、この DragGestureRecognizer がドラッグ&ドロップ操作を処理するために使用する DragSource を返します。
int	getSourceActions() このメソッドは、このドラッグ&ドロップ操作がサポートするアクションの形式を表す int を返します。
InputEvent	getTriggerEvent() このメソッドは、ドラッグ&ドロップ操作を開始した一連のイベントの最初のイベントを返します。
protected abstract void	registerListeners() この DragGestureRecognizer のリスナーを Component に登録します。 サブクラスはこのメソッドをオーバーライドする必要があります。
void	removeDragGestureListener(DragGestureListener dgl) 現在の DragGestureListener の登録を解除します。
void	resetRecognizer() Recognizer を取り消します。現在ジェスチャーを認識している場合は無視されます。
void	setComponent(Component c) DragGestureRecognizer が関連付けられる Component を設定します。 registerListeners() および unregisterListeners() は、必要に応じて副作用として呼び出されます。
void	setSourceActions(int actions) このメソッドはドラッグ&ドロップ操作に許可されているソースドラッグアクションを設定します。
protected abstract void	unregisterListeners() この DragGestureRecognizer のリスナーを Component から登録解除します。 サブクラスはこのメソッドをオーバーライドする必要があります。

クラス java.lang.Object から継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

フィールドの詳細

dragSource

protected DragSource dragSource

この DragGestureRecognizer に関連付けられている DragSource。

component

protected Component component

この DragGestureRecognizer に関連付けられている Component。

dragGestureListener

protected transient DragGestureListener dragGestureListener

この DragGestureRecognizer に関連付けられている DragGestureListener。

sourceActions

protected int sourceActions

このドラッグ&ドロップ操作で使用されるアクションのタイプを表す int。

events

protected ArrayList<InputEvent> events

ドラッグをトリガーする「ジェスチャー」として DragGestureRecognizer によって「認識」された (順番に並べられた) イベントのリスト。

コンストラクタの詳細

DragGestureRecognizer

protected DragGestureRecognizer(DragSource ds,
                     Component c,
                     int sa,
                     DragGestureListener dgl)

このドラッグ&ドロップ操作で使用される DragSource、この DragGestureRecognizer がドラッグ開始ジェスチャーを「監視」すべき Component、このドラッグ&ドロップ操作でサポートされるアクション、およびドラッグ開始ジェスチャーが検出されたときに通知する DragGestureListener を使用して、新しい DragGestureRecognizer を構築します。

パラメータ:

ds - この DragGestureRecognizer がドラッグ&ドロップ操作を処理するために使用する DragSource

c - この DragGestureRecognizer がドラッグ開始ジェスチャーを検出するために、イベントストリームの宛先として「監視」する Component。この値が null の場合、DragGestureRecognizer はどの Component にも関連付けられません。

sa - このドラッグ&ドロップ操作がサポートする DnDConstants のセット (論理和)

dgl - ドラッグジェスチャーが検出されたときに通知する DragGestureRecognizer

例外:

IllegalArgumentException - ds が null の場合。

DragGestureRecognizer

protected DragGestureRecognizer(DragSource ds,
                     Component c,
                     int sa)

このドラッグ&ドロップ操作で使用される DragSource、この DragGestureRecognizer がドラッグ開始ジェスチャーを「監視」すべき Component、およびこのドラッグ&ドロップ操作でサポートされるアクションを使用して、新しい DragGestureRecognizer を構築します。

パラメータ:

ds - この DragGestureRecognizer がドラッグ&ドロップ操作を処理するために使用する DragSource

c - この DragGestureRecognizer がドラッグ開始ジェスチャーを検出するために、イベントストリームの宛先として「監視」する Component。この値が null の場合、DragGestureRecognizer はどの Component にも関連付けられません。

sa - このドラッグ&ドロップ操作がサポートする DnDConstants のセット (論理和)

例外:

IllegalArgumentException - ds が null の場合。

DragGestureRecognizer

protected DragGestureRecognizer(DragSource ds,
                     Component c)

このドラッグ&ドロップ操作で使用される DragSource、およびこの DragGestureRecognizer がドラッグ開始ジェスチャーを「監視」すべき Component を使用して、新しい DragGestureRecognizer を構築します。

パラメータ:

ds - この DragGestureRecognizer がドラッグ&ドロップ操作を処理するために使用する DragSource

c - この DragGestureRecognizer がドラッグ開始ジェスチャーを検出するために、イベントストリームの宛先として「監視」する Component。この値が null の場合、DragGestureRecognizer はどの Component にも関連付けられません。

例外:

IllegalArgumentException - ds が null の場合。

DragGestureRecognizer

protected DragGestureRecognizer(DragSource ds)

このドラッグ&ドロップ操作で使用される DragSource を使用して、新しい DragGestureRecognizer を構築します。

パラメータ:

ds - この DragGestureRecognizer がドラッグ&ドロップ操作を処理するために使用する DragSource

例外:

IllegalArgumentException - ds が null の場合。

メソッドの詳細

registerListeners

protected abstract void registerListeners()

この DragGestureRecognizer のリスナーを Component に登録します。 サブクラスはこのメソッドをオーバーライドする必要があります。

unregisterListeners

protected abstract void unregisterListeners()

この DragGestureRecognizer のリスナーを Component から登録解除します。 サブクラスはこのメソッドをオーバーライドする必要があります。

getDragSource

public DragSource getDragSource()

このメソッドは、この DragGestureRecognizer がドラッグ&ドロップ操作を処理するために使用する DragSource を返します。

戻り値:

DragSource

getComponent

public Component getComponent()

このメソッドは、DragGestureRecognizer によってドラッグ開始ジェスチャーを「監視」される Component を返します。

戻り値:

この DragGestureRecognizer が関連付けられている Component

setComponent

public void setComponent(Component c)

DragGestureRecognizer が関連付けられる Component を設定します。 registerListeners() および unregisterListeners() は、必要に応じて副作用として呼び出されます。

パラメータ:

c - Component または null

getSourceActions

public int getSourceActions()

このメソッドは、このドラッグ&ドロップ操作がサポートするアクションの形式を表す int を返します。

戻り値:

現在許可されているソースアクション

setSourceActions

public void setSourceActions(int actions)

このメソッドはドラッグ&ドロップ操作に許可されているソースドラッグアクションを設定します。

パラメータ:

actions - 許可されているソースドラッグアクション

getTriggerEvent

public InputEvent getTriggerEvent()

このメソッドは、ドラッグ&ドロップ操作を開始した一連のイベントの最初のイベントを返します。

戻り値:

ドラッグジェスチャーをトリガーした初期イベント

resetRecognizer

public void resetRecognizer()

Recognizer を取り消します。現在ジェスチャーを認識している場合は無視されます。

addDragGestureListener

public void addDragGestureListener(DragGestureListener dgl)
                            throws TooManyListenersException

新しい DragGestureListener を登録します。

パラメータ:

dgl - この DragGestureRecognizer に登録する DragGestureListener。

例外:

TooManyListenersException - DragGestureListener がすでに追加されている場合。

removeDragGestureListener

public void removeDragGestureListener(DragGestureListener dgl)

現在の DragGestureListener の登録を解除します。

パラメータ:

dgl - この DragGestureRecognizer から登録解除する DragGestureListener

例外:

IllegalArgumentException - dgl が現在登録されている DragGestureListener ではない (異なる) 場合。

fireDragGestureRecognized

protected void fireDragGestureRecognized(int dragAction,
                             Point p)

ドラッグ&ドロップ開始ジェスチャーが発生したことを DragGestureListener に通知します。次に、Recognizer の状態を取り消します。

パラメータ:

dragAction - ユーザージェスチャーによって最初に選択されたアクション

p - ジェスチャーが発生したポイント (Component 座標内)

appendEvent

protected void appendEvent(InputEvent awtie)

この Recognizer によって Component で登録されたリスナーは、この API を介して、ドラッグ&ドロップ開始ジェスチャーを構成する一連のイベントの一部として認識されるすべてのイベントを記録します。

このメソッドは、DragGestureRecognizer 実装が (ドラッグ&ドロップ操作を構成する一連のイベントのうちの 1 つであると見なしている) InputEvent サブクラスを、この DragGestureRecognizer が内部的に保持しているイベントの配列に追加するために使用します。

パラメータ:

awtie - この DragGestureRecognizer の内部のイベント配列に追加する InputEvent。null は有効な値ではなく、無視されることに注意。