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.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:

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.7.0.0; WebServer 1.702 at 20f6060372b9.unknown:8081; Tue, 10 Dec 2024 21:14:59 GMT