概觀  軟體套件   類別  使用  階層樹  已過時  索引  說明 
JavaTM 2 Platform
Standard Ed. 6
 上一個類別   下一個類別 框架    無框架    
摘要： 巢狀 | 欄位 | 建構子 | 方法 詳細資訊： 欄位 | 建構子 | 方法

java.awt.dnd
類別 DragSourceDragEvent

java.lang.Object
  繼承者 java.util.EventObject
      繼承者 java.awt.dnd.DragSourceEvent
          繼承者 java.awt.dnd.DragSourceDragEvent
所有已實作的介面：
Serializable
public class DragSourceDragEvent
extends DragSourceEvent

通過 DragSourceContext，將 DragSourceDragEvent 從 DragSourceContextPeer 傳遞給向 DragSourceContext 及其關聯 DragSource 註冊的 DragSourceListener。

DragSourceDragEvent 報告可反映當前拖動操作狀態的目標放置動作 和使用者放置動作。

目標放置動作 是 DnDConstants 之一：如果拖動源支持此放置動作，則為當前放置目標所選擇的放置動作；如果拖動源不支持此放置動作，則為 DnDConstants.ACTION_NONE。

使用者放置動作 則取決於拖動源所支持的放置動作和使用者所選擇的放置動作。使用者可在拖動操作期間按下修改鍵來選擇放置動作： 

 
   Ctrl + Shift -> ACTION_LINK
   Ctrl         -> ACTION_COPY
   Shift        -> ACTION_MOVE
如果使用者選擇了某個放置動作，則使用者放置動作 是 DnDConstants 之一：如果拖動源支持此放置動作，則為所選擇的放置動作；如果拖動源不支持此放置動作，則為 DnDConstants.ACTION_NONE。

如果使用者未選擇某個放置動作，則在 DnDConstants 集合（表示拖動源支持的放置動作集合）中搜尋 DnDConstants.ACTION_MOVE，然後是 DnDConstants.ACTION_COPY，最後是 DnDConstants.ACTION_LINK，找到的第一個常數就是使用者放置動作。 如果未找到常數，則使用者放置動作 為 DnDConstants.ACTION_NONE。

從以下版本開始：
1.2
另請參見：
序列化表格

欄位摘要
 
從類別 java.util.EventObject 繼承的欄位
source
 
建構子摘要
DragSourceDragEvent(DragSourceContext dsc, int dropAction, int action, int modifiers)
          建構一個 DragSourceDragEvent。
DragSourceDragEvent(DragSourceContext dsc, int dropAction, int action, int modifiers, int x, int y)
          建構一個具有指定 DragSourceContext、使用者放置動作、目標放置動作、修改鍵和坐標的 DragSourceDragEvent。
 
方法摘要
 int getDropAction()
          此方法返回目標放置動作與拖動源支持的放置動作集合的邏輯交集。
 int getGestureModifiers()
          此方法返回一個 int 值，表示與使用者動作關聯的輸入設備修飾符的當前狀態。
 int getGestureModifiersEx()
          此方法返回一個 int 值，表示與使用者動作關聯的輸入設備擴展修飾符的當前狀態。
 int getTargetActions()
          此方法返回目標放置動作。
 int getUserAction()
          此方法返回使用者放置動作。
 
從類別 java.awt.dnd.DragSourceEvent 繼承的方法
getDragSourceContext, getLocation, getX, getY
 
從類別 java.util.EventObject 繼承的方法
getSource, toString
 
從類別 java.lang.Object 繼承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

建構子詳細資訊

DragSourceDragEvent

public DragSourceDragEvent(DragSourceContext dsc,
                           int dropAction,
                           int action,
                           int modifiers)
建構一個 DragSourceDragEvent。 此類別通常由 DragSourceContextPeer 實例化，而不是直接由客戶機程式碼實例化。未指定此 DragSourceDragEvent 的坐標，所以 getLocation 將對此事件返回 null。

參數 dropAction 和 action 應該是表示單個動作的 DnDConstants 之一。參數 modifiers 應該是舊 java.awt.event.InputEvent.*_MASK 常數的位遮罩碼，或者是擴展 java.awt.event.InputEvent.*_DOWN_MASK 常數的位遮罩碼。此建構子對無效的 dropAction、action 和 modifiers 不拋出任何異常。

參數：
dsc - 用來管理此事件通知的 DragSourceContext。
dropAction - 使用者放置動作。
action - 目標放置動作。
modifiers - 事件期間按下的修改鍵（shift、ctrl、alt、meta）。應該使用擴展的 _DOWN_MASK 修飾符或舊的 _MASK 修飾符，但是在一個事件中不應混用兩種模型。首選擴展的修飾符。
拋出：
IllegalArgumentException - 如果 dsc 為 null。
另請參見：
InputEvent, DragSourceEvent.getLocation()

DragSourceDragEvent

public DragSourceDragEvent(DragSourceContext dsc,
                           int dropAction,
                           int action,
                           int modifiers,
                           int x,
                           int y)
建構一個具有指定 DragSourceContext、使用者放置動作、目標放置動作、修改鍵和坐標的 DragSourceDragEvent。

參數 dropAction 和 action 應該是表示單個動作的 DnDConstants 之一。參數 modifiers 應該是舊 java.awt.event.InputEvent.*_MASK 常數的位遮罩碼，或者是擴展 java.awt.event.InputEvent.*_DOWN_MASK 常數的位遮罩碼。此建構子對無效的 dropAction、action 和 modifiers 不拋出任何異常。

參數：
dsc - 與此事件關聯的 DragSourceContext
dropAction - 使用者放置動作。
action - 目標放置動作。
modifiers - 事件期間按下的修改鍵（shift、ctrl、alt、meta）。應該使用擴展的 _DOWN_MASK 修飾符或舊的 _MASK 修飾符，但是在一個事件中不應混用兩種模型。首選擴展的修飾符。
x - 鼠標位置的水平坐標
y - 鼠標位置的垂直坐標
拋出：
IllegalArgumentException - 如果 dsc 為 null。
從以下版本開始：
1.4
另請參見：
InputEvent
方法詳細資訊

getTargetActions

public int getTargetActions()
此方法返回目標放置動作。

返回：
目標放置動作。

getGestureModifiers

public int getGestureModifiers()
此方法返回一個 int 值，表示與使用者動作關聯的輸入設備修飾符的當前狀態。通常是鼠標按鍵或鍵盤修飾符。

如果傳遞給建構子的 modifiers 無效，則此方法按原樣返回它們。

返回：
輸入設備修飾符的當前狀態

getGestureModifiersEx

public int getGestureModifiersEx()
此方法返回一個 int 值，表示與使用者動作關聯的輸入設備擴展修飾符的當前狀態。請參閱 InputEvent.getModifiersEx()

如果傳遞給建構子的 modifiers 無效，則此方法按原樣返回它們。

返回：
輸入設備擴展修飾符的當前狀態
從以下版本開始：
1.4

getUserAction

public int getUserAction()
此方法返回使用者放置動作。

返回：
使用者放置動作。

getDropAction

public int getDropAction()
此方法返回目標放置動作與拖動源支持的放置動作集合的邏輯交集。

返回：
目標放置動作與拖動源支持的放置動作集合的邏輯交集。
概觀  軟體套件   類別  使用  階層樹  已過時  索引  說明 
JavaTM 2 Platform
Standard Ed. 6
 上一個類別   下一個類別 框架    無框架    
摘要： 巢狀 | 欄位 | 建構子 | 方法 詳細資訊： 欄位 | 建構子 | 方法
提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only。