- すべての実装されたインタフェース:
Serializable
- 直系の既知のサブクラス:
MouseDragGestureRecognizer
DragGestureRecognizer
は、プラットフォーム依存のドラッグ開始ジェスチャを識別するために特定のComponent
に関連付けることのできる、プラットフォーム依存のリスナーを指定するための抽象基底クラスです。
適切なDragGestureRecognizer
サブクラス・インスタンスは、特定のComponent
に関連付けられたDragSource
から、またはそのcreateDragGestureRecognizer()
メソッド経由でToolkit
オブジェクトから取得されます。
DragGestureRecognizer
は、特定のComponent
に関連付けられると、Component
に送られる入力イベントを追跡するために、そのComponent
に適切なリスナー・インタフェースを登録します。
DragGestureRecognizer
は、Component
上のイベントのシーケンスをドラッグ開始ジェスチャとして識別すると、gestureRecognized()
メソッドを呼び出すことによってそのユニキャストDragGestureListener
に通知します。
具象DragGestureRecognizer
インスタンスは、関連付けられているComponent
上のドラッグ開始ジェスチャを検出すると、DragGestureListener
イベントのユニキャスト・イベント・ソースに登録されているDragGestureListener
に対してDragGestureEvent
をトリガーします。 このDragGestureListener
は、関連付けられたDragSource
に(必要に応じて)ドラッグ&ドロップ操作の開始を促します。
-
フィールドのサマリー
修飾子と型フィールド説明protected Component
このDragGestureRecognizer
に関連付けられているComponent
。protected DragGestureListener
このDragGestureRecognizer
に関連付けられているDragGestureListener
。protected DragSource
このDragGestureRecognizer
に関連付けられているDragSource
。protected ArrayList<InputEvent>
ドラッグをトリガーする「ジェスチャ」としてDragGestureRecognizer
によって「認識」された(順番に並べられた)イベントのリスト。protected int
このドラッグ・アンド・ドロップ操作で使用されるアクションのタイプを表すint
。 -
コンストラクタのサマリー
修飾子コンストラクタ説明protected
このドラッグ&ドロップ操作で使用されるDragSource
を使用して、新しいDragGestureRecognizer
を構築します。protected
このドラッグ&ドロップ操作で使用される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
新しいDragGestureListener
を登録します。protected void
appendEvent
(InputEvent awtie) このRecognizerによってComponentで登録されたリスナーは、このAPIを介して、ドラッグ&ドロップ開始ジェスチャを構成する一連のイベントの一部として認識されるすべてのイベントを記録します。protected void
fireDragGestureRecognized
(int dragAction, Point p) ドラッグ&ドロップ開始ジェスチャが発生したことをDragGestureListenerに通知します。このメソッドは、DragGestureRecognizer
によってドラッグ開始ジェスチャを「監視」されるComponent
を返します。このメソッドは、このDragGestureRecognizer
がドラッグ&ドロップ操作を処理するために使用するDragSource
を返します。int
このメソッドは、このドラッグ&ドロップ操作がサポートするアクションの形式を表すintを返します。このメソッドは、ドラッグ&ドロップ操作を開始した一連のイベントの最初のイベントを返します。protected abstract void
このDragGestureRecognizerのリスナーをComponentに登録します。サブクラスはこのメソッドをオーバーライドする必要があります。void
現在のDragGestureListenerの登録を解除します。void
Recognizerを取り消します。現在ジェスチャを認識している場合は無視されます。void
DragGestureRecognizerが関連付けられるComponentを設定します。registerListeners()およびunregisterListeners()は、必要に応じて副作用として呼び出されます。void
setSourceActions
(int actions) このメソッドはドラッグ&ドロップ操作に許可されているソース・ドラッグ・アクションを設定します。protected abstract void
このDragGestureRecognizerのリスナーをComponentから登録解除します。サブクラスはこのメソッドをオーバーライドする必要があります。
-
フィールド詳細
-
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
は有効な値ではなく、無視されることに注意。
-