eXept Software AG Logo

Smalltalk/X Webserver

Documentation of class 'DropSource':

Home

Documentation
www.exept.de
Everywhere
for:
[back]

Class: DropSource


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:

instance creation
o  receiver: aReceiver

o  receiver: aReceiver argument: anArgument

o  receiver: aReceiver argument: anArgument dropObjectSelector: aSelector

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

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


Instance protocol:

accessing
o  argument
returns the user defined argument

o  argument: anArgument
set the user defined argument

o  displayObjects
returns a collection of display objects or nil

o  dropObjects
returns a collection of objects to drop

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

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

accessing-selectors
o  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)

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

o  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

o  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

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

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

o  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

o  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

actions
o  dropFeedBackFrom: aDropContext
drop feedback to receiver

o  startDragIn: aView at: aPoint
start drag operation for a widget

instance creation
o  receiver: aReceiver argument: anArgument dropObjectSelector: s1 displayObjectSelector: s2 dropFeedBackSelector: s3

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

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



ST/X 7.1.0.0; WebServer 1.663 at exept.de:8081; Wed, 19 Sep 2018 13:30:30 GMT