Class: DropSource

• Inheritance
• Description
• 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.9 date: 2021/01/20 14:36:49

user: cg

file: DropSource.st directory: libview2

module: stx stc-classLibrary: libview2

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.

copyright
COPYRIGHT (c) 1998 by eXept Software AG / Claus Gittinger
             All Rights Reserved

This software is furnished under a license and may be used
only in accordance with the terms of that license and with the
inclusion of the above copyright notice.   This software may not
be provided or otherwise made available to, or used by, any
other person.  No title to or ownership of the software is
hereby transferred.

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) **