Class: DropSource

• Inheritance
• Description
• Related information
• Class protocol
  • instance creation
• Instance protocol
  • accessing
  • accessing-selectors
  • actions
  • instance creation
  • obsolete

Inheritance:

   Object
   |
   +--DropSource

Package:

stx:libview2

Category:

Interface-DragAndDrop

Version:

rev: 1.7 date: 2008/03/20 12:17:56

user: ca

file: DropSource.st directory: libview2

module: stx stc-classLibrary: libview2

Author:

Claus Atzkern

Description:

this class keeps the source from which the drag and drop operation is started.

receiver                <Object>    the receiver of the drop feedBack; a widget or
                                    application or ....

argument                <Object>    user defined argument

startDragSelector       <Symbol>    send to the receiver to start a DragAndDropManager.
                                    If no selector is specified, the default drag & drop
                                    operation is performed. Thus the operator is able
                                    to set the cursor, .... before starting the operation.

feedBackSelector        <Symbol>    send to the receiver to give a feedBack of the
                                    finished drag & drop operation

dropObjectSelector      <Symbol>    used to get to get the list of draggable objects.

displayObjectSelector   <Symbol>    used to get to get the list of display objects.
                                    In case of an empty or undefined list, the draggable
                                    objects are used as display objects.

Related information:

    DragAndDropManager
    DropObject
    DropTarget
    DropContext

Class protocol:

 receiver: aReceiver

 receiver: aReceiver argument: anArgument

 receiver: aReceiver argument: anArgument dropObjectSelector: aSelector

 receiver: aReceiver argument: anArgument dropObjectSelector: s1 displayObjectSelector: s2

 receiver: aReceiver argument: anArgument dropObjectSelector: s1 displayObjectSelector: s2 dropFeedBackSelector: s3

Instance protocol:

 argument

returns the user defined argument

 argument: anArgument

set the user defined argument

 displayObjects

returns a collection of display objects or nil

 dropObjects

returns a collection of objects to drop

 receiver

return the value of the instance variable 'receiver' (automatically generated)

 receiver: something

set the value of the instance variable 'receiver' (automatically generated)

 displayObjectSelector

selector to access the displayObjects; a sequence of String, Text, Icon or Image, LabelAndIcon ...
If the selector is for a one-arg message, the argument will be the dropSource (self)

 displayObjectSelector: aSelectorWithNoneOrOneArgs

selector to access the displayObjects; a sequence of String, Text, Icon or Image, LabelAndIcon ...
If the selector is for a 1-arg message, the argument will be the dropSource (self)

 dropFeedBackSelector

selector of a 1-arg message sent at end of a drop operation (to give a feedback);
the argument to the message is the dropContext

 dropFeedBackSelector: aSelectorWithZeroOrOneArgs

selector of a 1-arg message sent at end of a drop operation (to give a feedback);
the argument to the message is the dropContext

 dropObjectSelector

selector to access the draggable objects; a sequence of DropObjects.
If the selector is for a 1-arg message, the argument will be the dropSource (self)

 dropObjectSelector: aSelectorWithNoneOrOneArgs

selector to access the draggable objects; a sequence of DropObjects.
If the selector is for a 1-arg message, the argument will be the dropSource (self)

 startDragSelector

send to the receiver to start a DragAndDropManager.
If no selector is specified, the default drag & drop operation is performed.
Thus the operator is able to set the cursor, .... before starting the operation.

the (optional) arguments to the message are:
1 dropSource (self)
2 dropSource (self) Widget
3 dropSource (self) Widget Point

 startDragSelector: aTwoOrThreeArgSelector

send to the receiver to start a DragAndDropManager. If no selector is specified,
the default drag & drop operation is performed.
Thus the operator is able to set the cursor, .... before starting the operation.

the (optional) arguments to the message are:
1 dropSource (self)
2 dropSource (self) Widget
3 dropSource (self) Widget Point

 dropFeedBackFrom: aDropContext

drop feedback to receiver

 startDragIn: aView at: aPoint

start drag operation for a widget

 receiver: aReceiver argument: anArgument dropObjectSelector: s1 displayObjectSelector: s2 dropFeedBackSelector: s3

 feedBackSelector

selector called at end of a drop to give a feedback; the argument to
the selector is the dropContext

** This is an obsolete interface - do not use it (it may vanish in future versions) **

 feedBackSelector: aSelectorWithZeroOrOneArgs

selector called at end of a drop to give a feedback; the argument to
the selector is the dropContext

** This is an obsolete interface - do not use it (it may vanish in future versions) **