モジュール java.desktop
パッケージ 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に許容される現在のアクションを設定します。

    • メソッドの詳細

      • 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がサポートされているかどうか

      • createTransferableProxy

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