guiSliderCtrl.cpp 19 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585
  1. //-----------------------------------------------------------------------------
  2. // Copyright (c) 2012 GarageGames, LLC
  3. //
  4. // Permission is hereby granted, free of charge, to any person obtaining a copy
  5. // of this software and associated documentation files (the "Software"), to
  6. // deal in the Software without restriction, including without limitation the
  7. // rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
  8. // sell copies of the Software, and to permit persons to whom the Software is
  9. // furnished to do so, subject to the following conditions:
  10. //
  11. // The above copyright notice and this permission notice shall be included in
  12. // all copies or substantial portions of the Software.
  13. //
  14. // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  15. // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  16. // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  17. // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  18. // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
  19. // FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
  20. // IN THE SOFTWARE.
  21. //-----------------------------------------------------------------------------
  22. #include "console/console.h"
  23. #include "console/consoleTypes.h"
  24. #include "console/engineAPI.h"
  25. #include "gfx/gfxTextureManager.h"
  26. #include "gui/controls/guiSliderCtrl.h"
  27. #include "gui/core/guiDefaultControlRender.h"
  28. #include "gfx/primBuilder.h"
  29. #include "gfx/gfxDrawUtil.h"
  30. #include "sfx/sfxSystem.h"
  31. #include "sfx/sfxTrack.h"
  32. IMPLEMENT_CONOBJECT( GuiSliderCtrl );
  33. ConsoleDocClass( GuiSliderCtrl,
  34. "@brief A control that displays a value between its minimal and maximal bounds using a slider placed on a vertical "
  35. "or horizontal axis.\n\n"
  36. "A slider displays a value and allows that value to be changed by dragging a thumb control along the axis of the "
  37. "slider. In this way, the value is changed between its allowed minimum and maximum.\n\n"
  38. "To hook up script code to the value changes of a slider, use the #command and #altCommand properties. #command is "
  39. "executed once the thumb is released by the user whereas #altCommand is called any time the slider value changes. "
  40. "When changing the slider value from script, however, trigger of #altCommand is suppressed by default.\n\n"
  41. "The orientation of a slider is automatically determined from the ratio of its width to its height. If a slider is "
  42. "taller than it is wide, it will be rendered with a vertical orientation. If it is wider than it is tall, it will be "
  43. "rendered with a horizontal orientation.\n\n"
  44. "The rendering of a slider depends on the bitmap in the slider's profile. This bitmap must be a bitmap array comprised "
  45. "of at least five bitmap rectangles. The rectangles are used such that:\n\n"
  46. "- Rectangle #1: Left edge of slider\n"
  47. "- Rectangle #2: Center piece of slider; this is stretched between the left and right edge\n"
  48. "- Rectangle #3: Right edge of slider\n"
  49. "- Rectangle #4: Thumb button in normal state\n"
  50. "- Rectangle #5: Thumb button in highlighted (mouse-over) state\n\n"
  51. "@tsexample\n"
  52. "// Create a sound source and a slider that changes the volume of the source.\n"
  53. "\n"
  54. "%source = sfxPlayOnce( \"art/sound/testing\", AudioLoop2D );\n"
  55. "\n"
  56. "new GuiSlider()\n"
  57. "{\n"
  58. " // Update the sound source volume when the slider is being dragged and released.\n"
  59. " command = %source @ \".setVolume( $ThisControl.value );\";\n"
  60. "\n"
  61. " // Limit the range to 0..1 since that is the allowable range for sound volumes.\n"
  62. " range = \"0 1\";\n"
  63. "};\n"
  64. "@endtsexample\n\n"
  65. "@see GuiTextEditSliderCtrl\n"
  66. "@see GuiTextEditSliderBitmapCtrl\n\n"
  67. "@ingroup GuiValues"
  68. );
  69. IMPLEMENT_CALLBACK( GuiSliderCtrl, onMouseDragged, void, (), (),
  70. "Called when the left mouse button is dragged across the slider." );
  71. //----------------------------------------------------------------------------
  72. GuiSliderCtrl::GuiSliderCtrl()
  73. : mRange( 0., 1.f ),
  74. mTicks( 10 ),
  75. mSnap( false ),
  76. mValue( 0.5f ),
  77. mThumbSize( 8, 20 ),
  78. mShiftPoint( 5 ),
  79. mShiftExtent( 10 ),
  80. mIncAmount( 0.f ),
  81. mDisplayValue( false ),
  82. mMouseOver( false ),
  83. mMouseDragged( false ),
  84. mDepressed( false )
  85. {
  86. }
  87. //----------------------------------------------------------------------------
  88. void GuiSliderCtrl::initPersistFields()
  89. {
  90. addGroup( "Slider" );
  91. addField( "range", TypePoint2F, Offset( mRange, GuiSliderCtrl ),
  92. "Min and max values corresponding to left and right slider position." );
  93. addField( "ticks", TypeS32, Offset( mTicks, GuiSliderCtrl ),
  94. "Spacing between tick marks in pixels. 0=off." );
  95. addField( "snap", TypeBool, Offset( mSnap, GuiSliderCtrl ),
  96. "Whether to snap the slider to tick marks." );
  97. addProtectedField( "value", TypeF32, Offset( mValue, GuiSliderCtrl ),
  98. _setValue, defaultProtectedGetFn,
  99. "The value corresponding to the current slider position." );
  100. endGroup( "Slider" );
  101. Parent::initPersistFields();
  102. }
  103. //----------------------------------------------------------------------------
  104. void GuiSliderCtrl::setValue(F32 val, bool doCallback)
  105. {
  106. _updateThumb( val, mSnap, false, doCallback );
  107. }
  108. //----------------------------------------------------------------------------
  109. void GuiSliderCtrl::setActive( bool value )
  110. {
  111. if( !value && mDepressed )
  112. {
  113. // We're in the middle of a drag. Finish it here as once we've
  114. // been deactivated, we are not going to see a mouse-up event.
  115. mDepressed = false;
  116. mouseUnlock();
  117. execConsoleCallback();
  118. }
  119. Parent::setActive( value );
  120. }
  121. //----------------------------------------------------------------------------
  122. bool GuiSliderCtrl::onWake()
  123. {
  124. if( !Parent::onWake() )
  125. return false;
  126. mHasTexture = mProfile->constructBitmapArray() >= NumBitmaps;
  127. if( mHasTexture )
  128. {
  129. mBitmapBounds = mProfile->mBitmapArrayRects.address();
  130. mThumbSize = Point2I( mBitmapBounds[ SliderButtonNormal ].extent.x, mBitmapBounds[ SliderButtonNormal ].extent.y );
  131. }
  132. F32 value;
  133. if( mConsoleVariable[ 0 ] )
  134. value = getFloatVariable();
  135. else
  136. value = mValue;
  137. mValue = mClampF( value, mRange.x, mRange.y );
  138. // mouse scroll increment percentage is 5% of the range
  139. mIncAmount = ( ( mRange.y - mRange.x ) * 0.05 );
  140. if( ( mThumbSize.y + mProfile->mFont->getHeight() - 4 ) <= getExtent().y )
  141. mDisplayValue = true;
  142. else
  143. mDisplayValue = false;
  144. _updateThumb( mValue, mSnap, true );
  145. return true;
  146. }
  147. //----------------------------------------------------------------------------
  148. void GuiSliderCtrl::onMouseDown(const GuiEvent &event)
  149. {
  150. if ( !mActive || !mAwake || !mVisible )
  151. return;
  152. mouseLock();
  153. setFirstResponder();
  154. mDepressed = true;
  155. Point2I curMousePos = globalToLocalCoord( event.mousePoint );
  156. F32 value;
  157. if (getWidth() >= getHeight())
  158. value = F32(curMousePos.x-mShiftPoint) / F32(getWidth()-mShiftExtent)*(mRange.y-mRange.x) + mRange.x;
  159. else
  160. value = F32(curMousePos.y) / F32(getHeight())*(mRange.y-mRange.x) + mRange.x;
  161. _updateThumb( value, mSnap || ( event.modifier & SI_SHIFT ) );
  162. }
  163. //----------------------------------------------------------------------------
  164. void GuiSliderCtrl::onMouseDragged( const GuiEvent &event )
  165. {
  166. if ( !mActive || !mAwake || !mVisible )
  167. return;
  168. mMouseDragged = true;
  169. F32 value = _getThumbValue( event );
  170. _updateThumb( value, mSnap || ( event.modifier & SI_SHIFT ) );
  171. onMouseDragged_callback();
  172. }
  173. //----------------------------------------------------------------------------
  174. void GuiSliderCtrl::onMouseUp( const GuiEvent& event )
  175. {
  176. if ( !mActive || !mAwake || !mVisible )
  177. return;
  178. mouseUnlock();
  179. mDepressed = false;
  180. mMouseDragged = false;
  181. _updateThumb( _getThumbValue( event ), event.modifier & SI_SHIFT );
  182. execConsoleCallback();
  183. }
  184. //----------------------------------------------------------------------------
  185. void GuiSliderCtrl::onMouseEnter(const GuiEvent &event)
  186. {
  187. setUpdate();
  188. if( isMouseLocked() )
  189. {
  190. mDepressed = true;
  191. mMouseOver = true;
  192. }
  193. else
  194. {
  195. if( mActive && mProfile->mSoundButtonOver )
  196. {
  197. //F32 pan = (F32(event.mousePoint.x)/F32(getRoot()->getWidth())*2.0f-1.0f)*0.8f;
  198. SFX->playOnce( mProfile->mSoundButtonOver );
  199. }
  200. mMouseOver = true;
  201. }
  202. }
  203. //----------------------------------------------------------------------------
  204. void GuiSliderCtrl::onMouseLeave(const GuiEvent &)
  205. {
  206. setUpdate();
  207. if( isMouseLocked() )
  208. mDepressed = false;
  209. mMouseOver = false;
  210. }
  211. //----------------------------------------------------------------------------
  212. bool GuiSliderCtrl::onMouseWheelUp(const GuiEvent &event)
  213. {
  214. if ( !mActive || !mAwake || !mVisible )
  215. return Parent::onMouseWheelUp(event);
  216. _updateThumb( mValue + mIncAmount, ( event.modifier & SI_SHIFT ) );
  217. execConsoleCallback();
  218. return true;
  219. }
  220. //----------------------------------------------------------------------------
  221. bool GuiSliderCtrl::onMouseWheelDown(const GuiEvent &event)
  222. {
  223. if ( !mActive || !mAwake || !mVisible )
  224. return Parent::onMouseWheelUp(event);
  225. _updateThumb( mValue - mIncAmount, ( event.modifier & SI_SHIFT ) );
  226. execConsoleCallback();
  227. return true;
  228. }
  229. //----------------------------------------------------------------------------
  230. void GuiSliderCtrl::_updateThumb( F32 _value, bool snap, bool onWake, bool doCallback )
  231. {
  232. if( snap && mTicks > 0 )
  233. {
  234. // If the shift key is held, snap to the nearest tick, if any are being drawn
  235. F32 tickStep = (mRange.y - mRange.x) / F32(mTicks + 1);
  236. F32 tickSteps = (_value - mRange.x) / tickStep;
  237. S32 actualTick = S32(tickSteps + 0.5);
  238. _value = actualTick * tickStep + mRange.x;
  239. }
  240. // Clamp the thumb to legal values.
  241. if( _value < mRange.x )
  242. _value = mRange.x;
  243. if( _value > mRange.y )
  244. _value = mRange.y;
  245. // If value hasn't changed and this isn't the initial update on
  246. // waking, do nothing.
  247. if( mValue == _value && !onWake )
  248. return;
  249. mValue = _value;
  250. Point2I ext = getExtent();
  251. ext.x -= ( mShiftExtent + mThumbSize.x ) / 2;
  252. // update the bounding thumb rect
  253. if (getWidth() >= getHeight())
  254. { // HORZ thumb
  255. S32 mx = (S32)((F32(ext.x) * (mValue-mRange.x) / (mRange.y-mRange.x)));
  256. S32 my = ext.y/2;
  257. if(mDisplayValue)
  258. my = mThumbSize.y/2;
  259. mThumb.point.x = mx - (mThumbSize.x/2);
  260. mThumb.point.y = my - (mThumbSize.y/2);
  261. mThumb.extent = mThumbSize;
  262. }
  263. else
  264. { // VERT thumb
  265. S32 mx = ext.x/2;
  266. S32 my = (S32)((F32(ext.y) * (mValue-mRange.x) / (mRange.y-mRange.x)));
  267. mThumb.point.x = mx - (mThumbSize.y/2);
  268. mThumb.point.y = my - (mThumbSize.x/2);
  269. mThumb.extent.x = mThumbSize.y;
  270. mThumb.extent.y = mThumbSize.x;
  271. }
  272. setFloatVariable(mValue);
  273. setUpdate();
  274. // Use the alt console command if you want to continually update:
  275. if ( !onWake && doCallback )
  276. execAltConsoleCallback();
  277. }
  278. //----------------------------------------------------------------------------
  279. void GuiSliderCtrl::onRender(Point2I offset, const RectI &updateRect)
  280. {
  281. Point2I pos(offset.x+mShiftPoint, offset.y);
  282. Point2I ext(getWidth() - mShiftExtent, getHeight());
  283. RectI thumb = mThumb;
  284. GFXDrawUtil* drawUtil = GFX->getDrawUtil();
  285. if( mHasTexture )
  286. {
  287. if(mTicks > 0)
  288. {
  289. // TODO: tick marks should be positioned based on the bitmap dimensions.
  290. Point2I mid(ext.x, ext.y/2);
  291. Point2I oldpos = pos;
  292. pos += Point2I(1, 0);
  293. PrimBuild::color4f( 0.f, 0.f, 0.f, 1.f );
  294. PrimBuild::begin( GFXLineList, ( mTicks + 2 ) * 2 );
  295. // tick marks
  296. for (U32 t = 0; t <= (mTicks+1); t++)
  297. {
  298. S32 x = (S32)(F32(mid.x+1)/F32(mTicks+1)*F32(t)) + pos.x;
  299. S32 y = pos.y + mid.y;
  300. PrimBuild::vertex2i(x, y + mShiftPoint);
  301. PrimBuild::vertex2i(x, y + mShiftPoint*2 + 2);
  302. }
  303. PrimBuild::end();
  304. // TODO: it would be nice, if the primitive builder were a little smarter,
  305. // so that we could change colors midstream.
  306. PrimBuild::color4f(0.9f, 0.9f, 0.9f, 1.0f);
  307. PrimBuild::begin( GFXLineList, ( mTicks + 2 ) * 2 );
  308. // tick marks
  309. for (U32 t = 0; t <= (mTicks+1); t++)
  310. {
  311. S32 x = (S32)(F32(mid.x+1)/F32(mTicks+1)*F32(t)) + pos.x + 1;
  312. S32 y = pos.y + mid.y + 1;
  313. PrimBuild::vertex2i(x, y + mShiftPoint );
  314. PrimBuild::vertex2i(x, y + mShiftPoint * 2 + 3);
  315. }
  316. PrimBuild::end();
  317. pos = oldpos;
  318. }
  319. S32 index = SliderButtonNormal;
  320. if(mMouseOver)
  321. index = SliderButtonHighlight;
  322. drawUtil->clearBitmapModulation();
  323. //left border
  324. drawUtil->drawBitmapSR(mProfile->mTextureObject, Point2I(offset.x,offset.y), mBitmapBounds[SliderLineLeft]);
  325. //right border
  326. drawUtil->drawBitmapSR(mProfile->mTextureObject, Point2I(offset.x + getWidth() - mBitmapBounds[SliderLineRight].extent.x, offset.y), mBitmapBounds[SliderLineRight]);
  327. //draw our center piece to our slider control's border and stretch it
  328. RectI destRect;
  329. destRect.point.x = offset.x + mBitmapBounds[SliderLineLeft].extent.x;
  330. destRect.extent.x = getWidth() - mBitmapBounds[SliderLineLeft].extent.x - mBitmapBounds[SliderLineRight].extent.x;
  331. destRect.point.y = offset.y;
  332. destRect.extent.y = mBitmapBounds[SliderLineCenter].extent.y;
  333. RectI stretchRect;
  334. stretchRect = mBitmapBounds[SliderLineCenter];
  335. stretchRect.inset(1,0);
  336. drawUtil->drawBitmapStretchSR(mProfile->mTextureObject, destRect, stretchRect);
  337. //draw our control slider button
  338. thumb.point += pos;
  339. drawUtil->drawBitmapSR(mProfile->mTextureObject,Point2I(thumb.point.x,offset.y ),mBitmapBounds[index]);
  340. }
  341. else if (getWidth() >= getHeight())
  342. {
  343. Point2I mid(ext.x, ext.y/2);
  344. if(mDisplayValue)
  345. mid.set(ext.x, mThumbSize.y/2);
  346. PrimBuild::color4f( 0.f, 0.f, 0.f, 1.f );
  347. PrimBuild::begin( GFXLineList, ( mTicks + 2 ) * 2 + 2);
  348. // horz rule
  349. PrimBuild::vertex2i( pos.x, pos.y + mid.y );
  350. PrimBuild::vertex2i( pos.x + mid.x, pos.y + mid.y );
  351. // tick marks
  352. for( U32 t = 0; t <= ( mTicks + 1 ); t++ )
  353. {
  354. S32 x = (S32)( F32( mid.x - 1 ) / F32( mTicks + 1 ) * F32( t ) );
  355. PrimBuild::vertex2i( pos.x + x, pos.y + mid.y - mShiftPoint );
  356. PrimBuild::vertex2i( pos.x + x, pos.y + mid.y + mShiftPoint );
  357. }
  358. PrimBuild::end();
  359. }
  360. else
  361. {
  362. Point2I mid(ext.x/2, ext.y);
  363. PrimBuild::color4f( 0.f, 0.f, 0.f, 1.f );
  364. PrimBuild::begin( GFXLineList, ( mTicks + 2 ) * 2 + 2);
  365. // horz rule
  366. PrimBuild::vertex2i( pos.x + mid.x, pos.y );
  367. PrimBuild::vertex2i( pos.x + mid.x, pos.y + mid.y );
  368. // tick marks
  369. for( U32 t = 0; t <= ( mTicks + 1 ); t++ )
  370. {
  371. S32 y = (S32)( F32( mid.y - 1 ) / F32( mTicks + 1 ) * F32( t ) );
  372. PrimBuild::vertex2i( pos.x + mid.x - mShiftPoint, pos.y + y );
  373. PrimBuild::vertex2i( pos.x + mid.x + mShiftPoint, pos.y + y );
  374. }
  375. PrimBuild::end();
  376. mDisplayValue = false;
  377. }
  378. // draw the thumb
  379. thumb.point += pos;
  380. renderRaisedBox(thumb, mProfile);
  381. if(mDisplayValue)
  382. {
  383. char buf[20];
  384. dSprintf(buf,sizeof(buf),"%0.3f",mValue);
  385. Point2I textStart = thumb.point;
  386. S32 txt_w = mProfile->mFont->getStrWidth((const UTF8 *)buf);
  387. textStart.x += (S32)((thumb.extent.x/2.0f));
  388. textStart.y += thumb.extent.y - 2; //19
  389. textStart.x -= (txt_w/2);
  390. if(textStart.x < offset.x)
  391. textStart.x = offset.x;
  392. else if(textStart.x + txt_w > offset.x+getWidth())
  393. textStart.x -=((textStart.x + txt_w) - (offset.x+getWidth()));
  394. drawUtil->setBitmapModulation(mProfile->mFontColor);
  395. drawUtil->drawText(mProfile->mFont, textStart, buf, mProfile->mFontColors);
  396. }
  397. renderChildControls(offset, updateRect);
  398. }
  399. //----------------------------------------------------------------------------
  400. bool GuiSliderCtrl::resize( const Point2I& newPosition, const Point2I& newSize )
  401. {
  402. if( !Parent::resize( newPosition, newSize ) )
  403. return false;
  404. _updateThumb( mValue, false, true, false );
  405. return true;
  406. }
  407. //----------------------------------------------------------------------------
  408. void GuiSliderCtrl::parentResized( const RectI& oldParentRect, const RectI& newParentRect )
  409. {
  410. Parent::parentResized( oldParentRect, newParentRect );
  411. _updateThumb( mValue, false, true, false );
  412. }
  413. //----------------------------------------------------------------------------
  414. F32 GuiSliderCtrl::_getThumbValue( const GuiEvent& event )
  415. {
  416. Point2I curMousePos = globalToLocalCoord( event.mousePoint );
  417. F32 value;
  418. if( getWidth() >= getHeight() )
  419. value = F32( curMousePos.x - mShiftPoint ) / F32( getWidth() - mShiftExtent ) * ( mRange.y - mRange.x ) + mRange.x;
  420. else
  421. value = F32( curMousePos.y ) / F32( getHeight() ) * ( mRange.y - mRange.x ) + mRange.x;
  422. if(value > mRange.y )
  423. value = mRange.y;
  424. else if( value < mRange.x )
  425. value = mRange.x;
  426. if( mSnap || ( event.modifier & SI_SHIFT && mTicks >= 1 ) )
  427. {
  428. // If the shift key is held, snap to the nearest tick, if any are being drawn
  429. F32 tickStep = ( mRange.y - mRange.x ) / F32( mTicks + 1 );
  430. F32 tickSteps = (value - mRange.x ) / tickStep;
  431. S32 actualTick = S32( tickSteps + 0.5 );
  432. value = actualTick * tickStep + mRange.x;
  433. AssertFatal( value <= mRange.y && value >= mRange.x, "Error, out of bounds value generated from shift-snap of slider" );
  434. }
  435. return value;
  436. }
  437. //=============================================================================
  438. // Console Methods.
  439. //=============================================================================
  440. //-----------------------------------------------------------------------------
  441. DefineEngineMethod( GuiSliderCtrl, getValue, F32, (),,
  442. "Get the current value of the slider based on the position of the thumb.\n"
  443. "@return Slider position (from range.x to range.y)." )
  444. {
  445. return object->getValue();
  446. }
  447. //----------------------------------------------------------------------------
  448. DefineEngineMethod( GuiSliderCtrl, setValue, void, ( F32 pos, bool doCallback ), ( false ),
  449. "Set position of the thumb on the slider.\n"
  450. "@param pos New slider position (from range.x to range.y)\n"
  451. "@param doCallback If true, the altCommand callback will be invoked\n" )
  452. {
  453. object->setValue( pos, doCallback );
  454. }
  455. //----------------------------------------------------------------------------
  456. DefineEngineMethod( GuiSliderCtrl, isThumbBeingDragged, bool, (),,
  457. "Returns true if the thumb is currently being dragged by the user. This method is mainly useful "
  458. "for scrubbing type sliders where the slider position is sync'd to a changing value. When the "
  459. "user is dragging the thumb, however, the sync'ing should pause and not get in the way of the user." )
  460. {
  461. return object->isThumbBeingDragged();
  462. }