HelpSource/Classes/DragBoth.schelp

   1 class:: DragBoth
   2 redirect:: implClass
   3 summary:: A simple drag-and-drop source and receiver
   4 categories:: GUI>Views
   5 related:: Classes/DragSink, Classes/DragSource
   6
   7 DESCRIPTION::
   8
   9 link::Classes/DragSource::, link::Classes/DragSink:: and link::Classes/DragBoth:: are a set of view classes intended as simple-to-use drag-and-drop sources and destinations. They are graphically represented as a simple rectangle, and their specialty is that they emphasis::do not require the Cmd/Ctrl key to be held down to initiate dragging::.
  10
  11 Akin to link::Classes/StaticText:: they can store arbitrary content in the link::Classes/StaticText#-object#-object:: variable, and display it using link::Classes/Object#-asString::. You can set the displayed text separately using link::Classes/StaticText#-string#-string::, and keep it independent of the content if you set link::Classes/StaticText#-setBoth#-setBoth:: to code::false::.
  12
  13 strong::DragBoth::, specifically, strong::accepts any:: dropped data and stores it into the strong::-object:: variable, as well as gives that variable as data strong::for dragging::.
  14
  15 See: link::Classes/View#drag_and_drop:: for a general description of the drag and drop mechanism.
  16
  17
  18
  19 CLASSMETHODS::
  20
  21 PRIVATE:: key
  22
  23
  24
  25 INSTANCEMETHODS::
  26
  27 METHOD:: defaultGetDrag
  28         RETURNS:: The link::Classes/StaticText#-object#-object::.
  29
  30 METHOD:: defaultCanReceiveDrag
  31         RETURNS:: Allways True.
  32
  33 METHOD:: defaultReceiveDrag
  34         Sets the link::Classes/StaticText#-object#-object:: to the current drag data.
  35
  36
  37
  38 EXAMPLES::
  39 code::
  40 (
  41 w = Window.new.front;
  42 w.addFlowLayout;
  43 // store various kinds of objects in the drag source
  44
  45 // a string source
  46 a = DragBoth(w, Rect(10, 10, 150, 20)).align_(\center).background_(Color.rand);
  47 a.object = "drag us around";
  48
  49 a = DragBoth(w, Rect(10, 10, 150, 20)).align_(\center).background_(Color.rand);
  50 a.object="SUPERCOLLIDER";
  51
  52 8.do{
  53 a = DragBoth(w, Rect(10, 10, 150, 20)).align_(\center).background_(Color.rand);
  54 a.receiveDragHandler = { arg obj; obj.object = View.currentDrag.scramble };
  55 }
  56 )
  57 ::