モジュール java.desktop
パッケージ java.awt.dnd

クラスDropTargetContext

java.lang.Object
java.awt.dnd.DropTargetContext
すべての実装されたインタフェース:
Serializable
public class DropTargetContext
extends Object
implements Serializable
ドラッグ&ドロップ操作に関連付けられた論理カーソルが、DropTargetに関連付けられたComponentの可視幾何学的図形と重なった場合は常に、DropTargetContextが作成されます。 DropTargetContextは、ドロップ操作のレシーバがエンド・ユーザーに適切なドラッグ・アンダー・フィードバックを提供したり、必要に応じて後続のデータ転送を実行したりするメカニズムを提供します。
導入されたバージョン:
1.2
関連項目:
直列化された形式

  • ネストされたクラスのサマリー

    ネストされたクラス 
    修飾子と型 クラス 説明
    protected class  DropTargetContext.TransferableProxy
    TransferableProxyは、Transferableインタフェースを実装するヘルパー内部クラスであり、特定のドラッグ&ドロップ操作のデータ転送を表す別のTransferableオブジェクトのためのプロキシとして機能します。

  • メソッドのサマリー

    修飾子と型 メソッド 説明
    protected void acceptDrag​(int dragOperation)
    ドラッグを受け入れます。
    protected void acceptDrop​(int dropOperation)
    指定された操作を使ってドロップが受け入れられることを知らせるために呼び出されます。
    protected Transferable createTransferableProxy​(Transferable t, boolean local)
    指定されたTransferableのプロキシとしてTransferableProxyを作成します。
    void dropComplete​(boolean success)
    このメソッドは、ドロップが完了したこと、およびそれが成功したかどうかを知らせます。
    Component getComponent()
    このメソッドは、このDropTargetContextに関連付けられたComponentを返します。
    protected DataFlavor[] getCurrentDataFlavors()
    この操作のTransferableオペランドの使用可能なDataFlavorを取得します。
    protected List<DataFlavor> getCurrentDataFlavorsAsList()
    このメソッドは、Transferableオペランドの現在使用可能なDataFlavorをjava.util.Listとして返します。
    DropTarget getDropTarget()
    このメソッドは、このDropTargetContextに関連付けられたDropTargetを返します。
    protected int getTargetActions()
    このメソッドは、このDropTargetが受け入れる現在のアクションを表すintを返します。
    protected Transferable getTransferable()
    この操作のTransferable (プロキシ)オペランドを取得します
    protected boolean isDataFlavorSupported​(DataFlavor df)
    このメソッドは、指定されたDataFlavorがこのDropTargetContextでサポートされているかどうかを示すbooleanを返します。
    protected void rejectDrag()
    ドラッグを拒否します。
    protected void rejectDrop()
    ドロップが受け入れられないことを知らせるために呼び出されます。
    protected void setTargetActions​(int actions)
    このメソッドは、このDropTargetに許容される現在のアクションを設定します。

    クラス java.lang.Objectで宣言されたメソッド

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

  • メソッドの詳細

    • getDropTarget

      public DropTarget getDropTarget()
      このメソッドは、このDropTargetContextに関連付けられたDropTargetを返します。
      戻り値:
      このDropTargetContextに関連付けられたDropTarget

    • getComponent

      public Component getComponent()
      このメソッドは、このDropTargetContextに関連付けられたComponentを返します。
      戻り値:
      このContextに関連したComponent

    • setTargetActions

      protected void setTargetActions​(int actions)
      このメソッドは、このDropTargetに許容される現在のアクションを設定します。
      パラメータ:
      actions - サポートされるアクションを表すint

    • getTargetActions

      protected int getTargetActions()
      このメソッドは、このDropTargetが受け入れる現在のアクションを表すintを返します。
      戻り値:
      このDropTargetで許容される現在のアクション

    • dropComplete

      public void dropComplete​(boolean success) throws InvalidDnDOperationException
      このメソッドは、ドロップが完了したこと、およびそれが成功したかどうかを知らせます。
      パラメータ:
      success - 成功した場合はtrue、そうでない場合はfalse
      例外:
      InvalidDnDOperationException - ドロップが未処理でないか、現存していない場合

    • acceptDrag

      protected void acceptDrag​(int dragOperation)
      ドラッグを受け入れます。
      パラメータ:
      dragOperation - サポートされるアクション

    • rejectDrag

      protected void rejectDrag()
      ドラッグを拒否します。

    • acceptDrop

      protected void acceptDrop​(int dropOperation)
      指定された操作を使ってドロップが受け入れられることを知らせるために呼び出されます。DropTargetListener.dropメソッドの呼出しの間に呼び出される必要があります。
      パラメータ:
      dropOperation - サポートされるアクション

    • rejectDrop

      protected void rejectDrop()
      ドロップが受け入れられないことを知らせるために呼び出されます。DropTargetListener.dropメソッドの呼出しの間に呼び出される必要があります。

    • getCurrentDataFlavors

      protected DataFlavor[] getCurrentDataFlavors()
      この操作のTransferableオペランドの使用可能なDataFlavorを取得します。
      戻り値:
      TransferableオペランドのサポートされるDataFlavorを含むDataFlavor[]。

    • getCurrentDataFlavorsAsList

      protected List<DataFlavor> getCurrentDataFlavorsAsList()
      このメソッドは、Transferableオペランドの現在使用可能なDataFlavorをjava.util.Listとして返します。
      戻り値:
      java.util.Listとしての現在使用可能なDataFlavor

    • isDataFlavorSupported

      protected boolean isDataFlavorSupported​(DataFlavor df)
      このメソッドは、指定されたDataFlavorがこのDropTargetContextでサポートされているかどうかを示すbooleanを返します。
      パラメータ:
      df - DataFlavor
      戻り値:
      指定されたDataFlavorがサポートされているかどうか

    • getTransferable

      protected Transferable getTransferable() throws InvalidDnDOperationException
      この操作のTransferable (プロキシ)オペランドを取得します
      戻り値:
      Transferable
      例外:
      InvalidDnDOperationException - ドラッグが未処理でないか、現存していない場合

    • createTransferableProxy

      protected Transferable createTransferableProxy​(Transferable t, boolean local)
      指定されたTransferableのプロキシとしてTransferableProxyを作成します。
      パラメータ:
      t - プロキシの対象のTransferable
      local - tがローカルのドラッグ&ドロップ操作の結果を表す場合はtrue。
      戻り値:
      新しいTransferableProxyインスタンス。