java.awt.dnd
類別 DragSourceEvent

java.lang.Object
  java.util.EventObject
      java.awt.dnd.DragSourceEvent

所有已實作的介面：

Serializable

直接已知子類別：

DragSourceDragEvent, DragSourceDropEvent

public class DragSourceEvent
extends EventObject

此類別是 DragSourceDragEvent 和 DragSourceDropEvent 的基礎類別。

只要拖動進入、移動或退出放置點、放置操作改變和拖動結束時就會產生 DragSourceEvent。此事件發生時產生 DragSourceEvent 的位置指定了鼠標鼠標在螢幕坐標中的位置。

在沒有虛擬設備的多螢幕環境中，鼠標位置是在初始端 GraphicsConfiguration 的坐標系中指定的。初始端 GraphicsConfiguration 是在其上識別出當前拖動操作的 Component 的 GraphicsConfiguration。如果鼠標的位置位於初始端 GraphicsConfiguration 的邊界之外，則對報告的坐標進行截取，使其處於該 GraphicsConfiguration 邊界內。

在具有虛擬設備的多螢幕環境中，該位置是在相應的虛擬坐標系中指定的。如果鼠標的位置位於虛擬設備的邊界之外，則對報告的坐標進行截取，使其處於虛擬設備的邊界內。

從以下版本開始：

1.2

另請參見：

序列化表格

欄位摘要

從類別 java.util.EventObject 繼承的欄位

source

建構子摘要

DragSourceEvent(DragSourceContext dsc)
根據一個指定的 DragSourceContext 來建構一個 DragSourceEvent。

DragSourceEvent(DragSourceContext dsc, int x, int y)
根據指定的 DragSourceContext 和鼠標位置坐標建構一個 DragSourceEvent。

方法摘要

DragSourceContext	getDragSourceContext() 此方法返回引起事件的 DragSourceContext。
Point	getLocation() 此方法返回一個 Point，指示事件發生時鼠標在螢幕坐標中的位置，如果沒有為此事件指定鼠標位置，則返回 null。
int	getX() 此方法返回事件發生時在螢幕坐標中鼠標位置的水平坐標，如果沒有為此事件指定鼠標位置，則返回零。
int	getY() 此方法返回事件發生時在螢幕坐標中鼠標位置的垂直坐標，如果沒有為此事件指定鼠標位置，則返回零。

從類別 java.util.EventObject 繼承的方法

getSource, toString

從類別 java.lang.Object 繼承的方法

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

建構子詳細資訊

DragSourceEvent

public DragSourceEvent(DragSourceContext dsc)

根據一個指定的 DragSourceContext 來建構一個 DragSourceEvent。未指定此 DragSourceEvent 的坐標，所以 getLocation 將在此事件中返回 null。

參數：

dsc - DragSourceContext

拋出：

IllegalArgumentException - 如果 dsc 為 null。

另請參見：

getLocation()

DragSourceEvent

public DragSourceEvent(DragSourceContext dsc,
                       int x,
                       int y)

根據指定的 DragSourceContext 和鼠標位置坐標建構一個 DragSourceEvent。

參數：

dsc - DragSourceContext

x - 鼠標位置的水平坐標

y - 鼠標位置的垂直坐標

拋出：

IllegalArgumentException - 如果 dsc 為 null。

從以下版本開始：

1.4

方法詳細資訊

getDragSourceContext

public DragSourceContext getDragSourceContext()

此方法返回引起事件的 DragSourceContext。

返回：

引起事件的 DragSourceContext

getLocation

public Point getLocation()

此方法返回一個 Point，指示事件發生時鼠標在螢幕坐標中的位置，如果沒有為此事件指定鼠標位置，則返回 null。

返回：

指示鼠標位置的 Point，如果沒有指定鼠標位置，則返回 null

從以下版本開始：

1.4

getX

public int getX()

此方法返回事件發生時在螢幕坐標中鼠標位置的水平坐標，如果沒有為此事件指定鼠標位置，則返回零。

返回：

一個指示鼠標位置水平坐標的整數值，如果沒有指定鼠標位置，則返回零

從以下版本開始：

1.4

getY

public int getY()

此方法返回事件發生時在螢幕坐標中鼠標位置的垂直坐標，如果沒有為此事件指定鼠標位置，則返回零。

返回：

一個指示鼠標位置垂直坐標的整數值，如果沒有指定鼠標位置，則返回零

從以下版本開始：

1.4