llfloater.cpp
上传用户:king477883
上传日期:2021-03-01
资源大小:9553k
文件大小:69k
源码类别:

游戏引擎

开发平台:

C++ Builder

  1. /** 
  2.  * @file llfloater.cpp
  3.  * @brief LLFloater base class
  4.  *
  5.  * $LicenseInfo:firstyear=2002&license=viewergpl$
  6.  * 
  7.  * Copyright (c) 2002-2010, Linden Research, Inc.
  8.  * 
  9.  * Second Life Viewer Source Code
  10.  * The source code in this file ("Source Code") is provided by Linden Lab
  11.  * to you under the terms of the GNU General Public License, version 2.0
  12.  * ("GPL"), unless you have obtained a separate licensing agreement
  13.  * ("Other License"), formally executed by you and Linden Lab.  Terms of
  14.  * the GPL can be found in doc/GPL-license.txt in this distribution, or
  15.  * online at http://secondlifegrid.net/programs/open_source/licensing/gplv2
  16.  * 
  17.  * There are special exceptions to the terms and conditions of the GPL as
  18.  * it is applied to this Source Code. View the full text of the exception
  19.  * in the file doc/FLOSS-exception.txt in this software distribution, or
  20.  * online at
  21.  * http://secondlifegrid.net/programs/open_source/licensing/flossexception
  22.  * 
  23.  * By copying, modifying or distributing this software, you acknowledge
  24.  * that you have read and understood your obligations described above,
  25.  * and agree to abide by those obligations.
  26.  * 
  27.  * ALL LINDEN LAB SOURCE CODE IS PROVIDED "AS IS." LINDEN LAB MAKES NO
  28.  * WARRANTIES, EXPRESS, IMPLIED OR OTHERWISE, REGARDING ITS ACCURACY,
  29.  * COMPLETENESS OR PERFORMANCE.
  30.  * $/LicenseInfo$
  31.  */
  32. // Floating "windows" within the GL display, like the inventory floater,
  33. // mini-map floater, etc.
  34. #include "linden_common.h"
  35. #include "llfloater.h"
  36. #include "llfocusmgr.h"
  37. #include "lluictrlfactory.h"
  38. #include "llbutton.h"
  39. #include "llcheckboxctrl.h"
  40. #include "lldraghandle.h"
  41. #include "llfloaterreg.h"
  42. #include "llfocusmgr.h"
  43. #include "llresizebar.h"
  44. #include "llresizehandle.h"
  45. #include "llkeyboard.h"
  46. #include "llmenugl.h" // MENU_BAR_HEIGHT
  47. #include "llmodaldialog.h"
  48. #include "lltextbox.h"
  49. #include "llresmgr.h"
  50. #include "llui.h"
  51. #include "llwindow.h"
  52. #include "llstl.h"
  53. #include "llcontrol.h"
  54. #include "lltabcontainer.h"
  55. #include "v2math.h"
  56. #include "lltrans.h"
  57. #include "llhelp.h"
  58. #include "llmultifloater.h"
  59. #include "llsdutil.h"
  60. // use this to control "jumping" behavior when Ctrl-Tabbing
  61. const S32 TABBED_FLOATER_OFFSET = 0;
  62. std::string LLFloater::sButtonNames[BUTTON_COUNT] = 
  63. {
  64. "llfloater_close_btn", //BUTTON_CLOSE
  65. "llfloater_restore_btn", //BUTTON_RESTORE
  66. "llfloater_minimize_btn", //BUTTON_MINIMIZE
  67. "llfloater_tear_off_btn", //BUTTON_TEAR_OFF
  68. "llfloater_dock_btn", //BUTTON_DOCK
  69. "llfloater_help_btn" //BUTTON_HELP
  70. };
  71. std::string LLFloater::sButtonToolTips[BUTTON_COUNT];
  72. std::string LLFloater::sButtonToolTipsIndex[BUTTON_COUNT]=
  73. {
  74. #ifdef LL_DARWIN
  75. "BUTTON_CLOSE_DARWIN", //"Close (Cmd-W)", //BUTTON_CLOSE
  76. #else
  77. "BUTTON_CLOSE_WIN", //"Close (Ctrl-W)", //BUTTON_CLOSE
  78. #endif
  79. "BUTTON_RESTORE", //"Restore", //BUTTON_RESTORE
  80. "BUTTON_MINIMIZE", //"Minimize", //BUTTON_MINIMIZE
  81. "BUTTON_TEAR_OFF", //"Tear Off", //BUTTON_TEAR_OFF
  82. "BUTTON_DOCK",
  83. "BUTTON_HELP"
  84. };
  85. LLFloater::click_callback LLFloater::sButtonCallbacks[BUTTON_COUNT] =
  86. {
  87. LLFloater::onClickClose, //BUTTON_CLOSE
  88. LLFloater::onClickMinimize, //BUTTON_RESTORE
  89. LLFloater::onClickMinimize, //BUTTON_MINIMIZE
  90. LLFloater::onClickTearOff, //BUTTON_TEAR_OFF
  91. LLFloater::onClickDock, //BUTTON_DOCK
  92. LLFloater::onClickHelp //BUTTON_HELP
  93. };
  94. LLMultiFloater* LLFloater::sHostp = NULL;
  95. BOOL LLFloater::sQuitting = FALSE; // Flag to prevent storing visibility controls while quitting
  96. LLFloater::handle_map_t LLFloater::sFloaterMap;
  97. LLFloaterView* gFloaterView = NULL;
  98. /*==========================================================================*|
  99. // DEV-38598: The fundamental problem with this operation is that it can only
  100. // support a subset of LLSD values. While it's plausible to compare two arrays
  101. // lexicographically, what strict ordering can you impose on maps?
  102. // (LLFloaterTOS's current key is an LLSD map.)
  103. // Of course something like this is necessary if you want to build a std::set
  104. // or std::map with LLSD keys. Fortunately we're getting by with other
  105. // container types for now.
  106. //static
  107. bool LLFloater::KeyCompare::compare(const LLSD& a, const LLSD& b)
  108. {
  109. if (a.type() != b.type())
  110. {
  111. //llerrs << "Mismatched LLSD types: (" << a << ") mismatches (" << b << ")" << llendl;
  112. return false;
  113. }
  114. else if (a.isUndefined())
  115. return false;
  116. else if (a.isInteger())
  117. return a.asInteger() < b.asInteger();
  118. else if (a.isReal())
  119. return a.asReal() < b.asReal();
  120. else if (a.isString())
  121. return a.asString() < b.asString();
  122. else if (a.isUUID())
  123. return a.asUUID() < b.asUUID();
  124. else if (a.isDate())
  125. return a.asDate() < b.asDate();
  126. else if (a.isURI())
  127. return a.asString() < b.asString(); // compare URIs as strings
  128. else if (a.isBoolean())
  129. return a.asBoolean() < b.asBoolean();
  130. else
  131. return false; // no valid operation for Binary
  132. }
  133. |*==========================================================================*/
  134. bool LLFloater::KeyCompare::equate(const LLSD& a, const LLSD& b)
  135. {
  136. return llsd_equals(a, b);
  137. }
  138. //************************************
  139. LLFloater::Params::Params()
  140. : title("title"),
  141. short_title("short_title"),
  142. single_instance("single_instance", false),
  143. auto_tile("auto_tile", false),
  144. can_resize("can_resize", false),
  145. can_minimize("can_minimize", true),
  146. can_close("can_close", true),
  147. can_drag_on_left("can_drag_on_left", false),
  148. can_tear_off("can_tear_off", true),
  149. save_dock_state("save_dock_state", false),
  150. save_rect("save_rect", false),
  151. save_visibility("save_visibility", false),
  152. can_dock("can_dock", false),
  153. header_height("header_height", 0),
  154. legacy_header_height("legacy_header_height", 0),
  155. close_image("close_image"),
  156. restore_image("restore_image"),
  157. minimize_image("minimize_image"),
  158. tear_off_image("tear_off_image"),
  159. dock_image("dock_image"),
  160. help_image("help_image"),
  161. close_pressed_image("close_pressed_image"),
  162. restore_pressed_image("restore_pressed_image"),
  163. minimize_pressed_image("minimize_pressed_image"),
  164. tear_off_pressed_image("tear_off_pressed_image"),
  165. dock_pressed_image("dock_pressed_image"),
  166. help_pressed_image("help_pressed_image"),
  167. open_callback("open_callback"),
  168. close_callback("close_callback")
  169. {
  170. visible = false;
  171. }
  172. //static 
  173. const LLFloater::Params& LLFloater::getDefaultParams()
  174. {
  175. return LLUICtrlFactory::getDefaultParams<LLFloater>();
  176. }
  177. //static
  178. void LLFloater::initClass()
  179. {
  180. // translate tooltips for floater buttons
  181. for (S32 i = 0; i < BUTTON_COUNT; i++)
  182. {
  183. sButtonToolTips[i] = LLTrans::getString( sButtonToolTipsIndex[i] );
  184. }
  185. }
  186. // defaults for floater param block pulled from widgets/floater.xml
  187. static LLWidgetNameRegistry::StaticRegistrar sRegisterFloaterParams(&typeid(LLFloater::Params), "floater");
  188. LLFloater::LLFloater(const LLSD& key, const LLFloater::Params& p)
  189. : LLPanel(), // intentionally do not pass params here, see initFromParams
  190. mDragHandle(NULL),
  191. mTitle(p.title),
  192. mShortTitle(p.short_title),
  193. mSingleInstance(p.single_instance),
  194. mKey(key),
  195. mAutoTile(p.auto_tile),
  196. mCanTearOff(p.can_tear_off),
  197. mCanMinimize(p.can_minimize),
  198. mCanClose(p.can_close),
  199. mDragOnLeft(p.can_drag_on_left),
  200. mResizable(p.can_resize),
  201. mMinWidth(p.min_width),
  202. mMinHeight(p.min_height),
  203. mHeaderHeight(p.header_height),
  204. mLegacyHeaderHeight(p.legacy_header_height),
  205. mMinimized(FALSE),
  206. mForeground(FALSE),
  207. mFirstLook(TRUE),
  208. mButtonScale(1.0f),
  209. mAutoFocus(TRUE), // automatically take focus when opened
  210. mCanDock(false),
  211. mDocked(false),
  212. mTornOff(false),
  213. mHasBeenDraggedWhileMinimized(FALSE),
  214. mPreviousMinimizedBottom(0),
  215. mPreviousMinimizedLeft(0)
  216. // mNotificationContext(NULL)
  217. {
  218. mHandle.bind(this);
  219. // mNotificationContext = new LLFloaterNotificationContext(getHandle());
  220. // Clicks stop here.
  221. setMouseOpaque(TRUE);
  222. // Floaters always draw their background, unlike every other panel.
  223. setBackgroundVisible(TRUE);
  224. // Floaters start not minimized.  When minimized, they save their
  225. // prior rectangle to be used on restore.
  226. mExpandedRect.set(0,0,0,0);
  227. memset(mButtonsEnabled, 0, BUTTON_COUNT * sizeof(bool));
  228. memset(mButtons, 0, BUTTON_COUNT * sizeof(LLButton*));
  229. addDragHandle();
  230. addResizeCtrls();
  231. initFromParams(p);
  232. // chrome floaters don't take focus at all
  233. setFocusRoot(!getIsChrome());
  234. initFloater(p);
  235. }
  236. // Note: Floaters constructed from XML call init() twice!
  237. void LLFloater::initFloater(const Params& p)
  238. {
  239. // Close button.
  240. if (mCanClose)
  241. {
  242. mButtonsEnabled[BUTTON_CLOSE] = TRUE;
  243. }
  244. // Help button: '?'
  245. if ( !mHelpTopic.empty() )
  246. {
  247. mButtonsEnabled[BUTTON_HELP] = TRUE;
  248. }
  249. // Minimize button only for top draggers
  250. if ( !mDragOnLeft && mCanMinimize )
  251. {
  252. mButtonsEnabled[BUTTON_MINIMIZE] = TRUE;
  253. }
  254. if(mCanDock)
  255. {
  256. mButtonsEnabled[BUTTON_DOCK] = TRUE;
  257. }
  258. buildButtons(p);
  259. // Floaters are created in the invisible state
  260. setVisible(FALSE);
  261. // add self to handle->floater map
  262. sFloaterMap[mHandle] = this;
  263. if (!getParent())
  264. {
  265. gFloaterView->addChild(this);
  266. }
  267. }
  268. void LLFloater::addDragHandle()
  269. {
  270. if (!mDragHandle)
  271. {
  272. if (mDragOnLeft)
  273. {
  274. LLDragHandleLeft::Params p;
  275. p.name("drag");
  276. p.follows.flags(FOLLOWS_ALL);
  277. p.label(mTitle);
  278. mDragHandle = LLUICtrlFactory::create<LLDragHandleLeft>(p);
  279. }
  280. else // drag on top
  281. {
  282. LLDragHandleTop::Params p;
  283. p.name("Drag Handle");
  284. p.follows.flags(FOLLOWS_ALL);
  285. p.label(mTitle);
  286. mDragHandle = LLUICtrlFactory::create<LLDragHandleTop>(p);
  287. }
  288. addChild(mDragHandle);
  289. }
  290. layoutDragHandle();
  291. }
  292. void LLFloater::layoutDragHandle()
  293. {
  294. static LLUICachedControl<S32> floater_close_box_size ("UIFloaterCloseBoxSize", 0);
  295. S32 close_box_size = mCanClose ? floater_close_box_size : 0;
  296. LLRect rect;
  297. if (mDragOnLeft)
  298. {
  299. rect.setLeftTopAndSize(0, 0, DRAG_HANDLE_WIDTH, getRect().getHeight() - LLPANEL_BORDER_WIDTH - close_box_size);
  300. }
  301. else // drag on top
  302. {
  303. rect = getLocalRect();
  304. }
  305. mDragHandle->setRect(rect);
  306. updateButtons();
  307. applyTitle();
  308. }
  309. void LLFloater::addResizeCtrls()
  310. {
  311. // Resize bars (sides)
  312. LLResizeBar::Params p;
  313. p.name("resizebar_left");
  314. p.resizing_view(this);
  315. p.min_size(mMinWidth);
  316. p.side(LLResizeBar::LEFT);
  317. mResizeBar[LLResizeBar::LEFT] = LLUICtrlFactory::create<LLResizeBar>(p);
  318. addChild( mResizeBar[LLResizeBar::LEFT] );
  319. p.name("resizebar_top");
  320. p.min_size(mMinHeight);
  321. p.side(LLResizeBar::TOP);
  322. mResizeBar[LLResizeBar::TOP] = LLUICtrlFactory::create<LLResizeBar>(p);
  323. addChild( mResizeBar[LLResizeBar::TOP] );
  324. p.name("resizebar_right");
  325. p.min_size(mMinWidth);
  326. p.side(LLResizeBar::RIGHT);
  327. mResizeBar[LLResizeBar::RIGHT] = LLUICtrlFactory::create<LLResizeBar>(p);
  328. addChild( mResizeBar[LLResizeBar::RIGHT] );
  329. p.name("resizebar_bottom");
  330. p.min_size(mMinHeight);
  331. p.side(LLResizeBar::BOTTOM);
  332. mResizeBar[LLResizeBar::BOTTOM] = LLUICtrlFactory::create<LLResizeBar>(p);
  333. addChild( mResizeBar[LLResizeBar::BOTTOM] );
  334. // Resize handles (corners)
  335. LLResizeHandle::Params handle_p;
  336. // handles must not be mouse-opaque, otherwise they block hover events
  337. // to other buttons like the close box. JC
  338. handle_p.mouse_opaque(false);
  339. handle_p.min_width(mMinWidth);
  340. handle_p.min_height(mMinHeight);
  341. handle_p.corner(LLResizeHandle::RIGHT_BOTTOM);
  342. mResizeHandle[0] = LLUICtrlFactory::create<LLResizeHandle>(handle_p);
  343. addChild(mResizeHandle[0]);
  344. handle_p.corner(LLResizeHandle::RIGHT_TOP);
  345. mResizeHandle[1] = LLUICtrlFactory::create<LLResizeHandle>(handle_p);
  346. addChild(mResizeHandle[1]);
  347. handle_p.corner(LLResizeHandle::LEFT_BOTTOM);
  348. mResizeHandle[2] = LLUICtrlFactory::create<LLResizeHandle>(handle_p);
  349. addChild(mResizeHandle[2]);
  350. handle_p.corner(LLResizeHandle::LEFT_TOP);
  351. mResizeHandle[3] = LLUICtrlFactory::create<LLResizeHandle>(handle_p);
  352. addChild(mResizeHandle[3]);
  353. layoutResizeCtrls();
  354. }
  355. void LLFloater::layoutResizeCtrls()
  356. {
  357. LLRect rect;
  358. // Resize bars (sides)
  359. const S32 RESIZE_BAR_THICKNESS = 3;
  360. rect = LLRect( 0, getRect().getHeight(), RESIZE_BAR_THICKNESS, 0);
  361. mResizeBar[LLResizeBar::LEFT]->setRect(rect);
  362. rect = LLRect( 0, getRect().getHeight(), getRect().getWidth(), getRect().getHeight() - RESIZE_BAR_THICKNESS);
  363. mResizeBar[LLResizeBar::TOP]->setRect(rect);
  364. rect = LLRect(getRect().getWidth() - RESIZE_BAR_THICKNESS, getRect().getHeight(), getRect().getWidth(), 0);
  365. mResizeBar[LLResizeBar::RIGHT]->setRect(rect);
  366. rect = LLRect(0, RESIZE_BAR_THICKNESS, getRect().getWidth(), 0);
  367. mResizeBar[LLResizeBar::BOTTOM]->setRect(rect);
  368. // Resize handles (corners)
  369. rect = LLRect( getRect().getWidth() - RESIZE_HANDLE_WIDTH, RESIZE_HANDLE_HEIGHT, getRect().getWidth(), 0);
  370. mResizeHandle[0]->setRect(rect);
  371. rect = LLRect( getRect().getWidth() - RESIZE_HANDLE_WIDTH, getRect().getHeight(), getRect().getWidth(), getRect().getHeight() - RESIZE_HANDLE_HEIGHT);
  372. mResizeHandle[1]->setRect(rect);
  373. rect = LLRect( 0, RESIZE_HANDLE_HEIGHT, RESIZE_HANDLE_WIDTH, 0 );
  374. mResizeHandle[2]->setRect(rect);
  375. rect = LLRect( 0, getRect().getHeight(), RESIZE_HANDLE_WIDTH, getRect().getHeight() - RESIZE_HANDLE_HEIGHT );
  376. mResizeHandle[3]->setRect(rect);
  377. }
  378. void LLFloater::enableResizeCtrls(bool enable)
  379. {
  380. for (S32 i = 0; i < 4; ++i)
  381. {
  382. mResizeBar[i]->setVisible(enable);
  383. mResizeBar[i]->setEnabled(enable);
  384. mResizeHandle[i]->setVisible(enable);
  385. mResizeHandle[i]->setEnabled(enable);
  386. }
  387. }
  388. // virtual
  389. LLFloater::~LLFloater()
  390. {
  391. LLFloaterReg::removeInstance(mInstanceName, mKey);
  392. // delete mNotificationContext;
  393. // mNotificationContext = NULL;
  394. //// am I not hosted by another floater?
  395. //if (mHostHandle.isDead())
  396. //{
  397. // LLFloaterView* parent = (LLFloaterView*) getParent();
  398. // if( parent )
  399. // {
  400. // parent->removeChild( this );
  401. // }
  402. //}
  403. // Just in case we might still have focus here, release it.
  404. releaseFocus();
  405. // This is important so that floaters with persistent rects (i.e., those
  406. // created with rect control rather than an LLRect) are restored in their
  407. // correct, non-minimized positions.
  408. setMinimized( FALSE );
  409. sFloaterMap.erase(mHandle);
  410. delete mDragHandle;
  411. for (S32 i = 0; i < 4; i++) 
  412. {
  413. delete mResizeBar[i];
  414. delete mResizeHandle[i];
  415. }
  416. storeRectControl();
  417. setVisible(false); // We're not visible if we're destroyed
  418. storeVisibilityControl();
  419. storeDockStateControl();
  420. }
  421. void LLFloater::storeRectControl()
  422. {
  423. if( mRectControl.size() > 1 )
  424. {
  425. LLUI::sSettingGroups["floater"]->setRect( mRectControl, getRect() );
  426. }
  427. }
  428. void LLFloater::storeVisibilityControl()
  429. {
  430. if( !sQuitting && mVisibilityControl.size() > 1 )
  431. {
  432. LLUI::sSettingGroups["floater"]->setBOOL( mVisibilityControl, getVisible() );
  433. }
  434. }
  435. void LLFloater::storeDockStateControl()
  436. {
  437. if( !sQuitting && mDocStateControl.size() > 1 )
  438. {
  439. LLUI::sSettingGroups["floater"]->setBOOL( mDocStateControl, isDocked() );
  440. }
  441. }
  442. void LLFloater::setVisible( BOOL visible )
  443. {
  444. LLPanel::setVisible(visible); // calls handleVisibilityChange()
  445. if( visible && mFirstLook )
  446. {
  447. mFirstLook = FALSE;
  448. }
  449. if( !visible )
  450. {
  451. if( gFocusMgr.childIsTopCtrl( this ) )
  452. {
  453. gFocusMgr.setTopCtrl(NULL);
  454. }
  455. if( gFocusMgr.childHasMouseCapture( this ) )
  456. {
  457. gFocusMgr.setMouseCapture(NULL);
  458. }
  459. }
  460. for(handle_set_iter_t dependent_it = mDependents.begin();
  461. dependent_it != mDependents.end(); )
  462. {
  463. LLFloater* floaterp = dependent_it->get();
  464. if (floaterp)
  465. {
  466. floaterp->setVisible(visible);
  467. }
  468. ++dependent_it;
  469. }
  470. storeVisibilityControl();
  471. }
  472. // virtual
  473. void LLFloater::handleVisibilityChange ( BOOL new_visibility )
  474. {
  475. if (new_visibility)
  476. {
  477. if (getHost())
  478. getHost()->setFloaterFlashing(this, FALSE);
  479. }
  480. LLPanel::handleVisibilityChange ( new_visibility );
  481. }
  482. void LLFloater::openFloater(const LLSD& key)
  483. {
  484. mKey = key; // in case we need to open ourselves again
  485. if (getSoundFlags() != SILENT 
  486. // don't play open sound for hosted (tabbed) windows
  487. && !getHost() 
  488. && !getFloaterHost()
  489. && (!getVisible() || isMinimized()))
  490. {
  491. make_ui_sound("UISndWindowOpen");
  492. }
  493. //RN: for now, we don't allow rehosting from one multifloater to another
  494. // just need to fix the bugs
  495. if (getFloaterHost() != NULL && getHost() == NULL)
  496. {
  497. // needs a host
  498. // only select tabs if window they are hosted in is visible
  499. getFloaterHost()->addFloater(this, getFloaterHost()->getVisible());
  500. }
  501. if (getHost() != NULL)
  502. {
  503. getHost()->setMinimized(FALSE);
  504. getHost()->setVisibleAndFrontmost(mAutoFocus);
  505. getHost()->showFloater(this);
  506. }
  507. else
  508. {
  509. setMinimized(FALSE);
  510. setVisibleAndFrontmost(mAutoFocus);
  511. }
  512. mOpenSignal(this, key);
  513. onOpen(key);
  514. dirtyRect();
  515. }
  516. void LLFloater::closeFloater(bool app_quitting)
  517. {
  518. if (app_quitting)
  519. {
  520. LLFloater::sQuitting = true;
  521. }
  522. // Always unminimize before trying to close.
  523. // Most of the time the user will never see this state.
  524. setMinimized(FALSE);
  525. if (canClose())
  526. {
  527. if (getHost())
  528. {
  529. ((LLMultiFloater*)getHost())->removeFloater(this);
  530. gFloaterView->addChild(this);
  531. }
  532. if (getSoundFlags() != SILENT
  533. && getVisible()
  534. && !getHost()
  535. && !app_quitting)
  536. {
  537. make_ui_sound("UISndWindowClose");
  538. }
  539. // now close dependent floater
  540. for(handle_set_iter_t dependent_it = mDependents.begin();
  541. dependent_it != mDependents.end(); )
  542. {
  543. LLFloater* floaterp = dependent_it->get();
  544. if (floaterp)
  545. {
  546. ++dependent_it;
  547. floaterp->closeFloater(app_quitting);
  548. }
  549. else
  550. {
  551. mDependents.erase(dependent_it++);
  552. }
  553. }
  554. cleanupHandles();
  555. gFocusMgr.clearLastFocusForGroup(this);
  556. if (hasFocus())
  557. {
  558. // Do this early, so UI controls will commit before the
  559. // window is taken down.
  560. releaseFocus();
  561. // give focus to dependee floater if it exists, and we had focus first
  562. if (isDependent())
  563. {
  564. LLFloater* dependee = mDependeeHandle.get();
  565. if (dependee && !dependee->isDead())
  566. {
  567. dependee->setFocus(TRUE);
  568. }
  569. }
  570. }
  571. dirtyRect();
  572. // Close callbacks
  573. onClose(app_quitting);
  574. mCloseSignal(this, LLSD(app_quitting));
  575. // Hide or Destroy
  576. if (mSingleInstance)
  577. {
  578. // Hide the instance
  579. if (getHost())
  580. {
  581. getHost()->setVisible(FALSE);
  582. }
  583. else
  584. {
  585. setVisible(FALSE);
  586. }
  587. }
  588. else
  589. {
  590. setVisible(FALSE); // hide before destroying (so handleVisibilityChange() gets called)
  591. destroy();
  592. }
  593. }
  594. }
  595. /*virtual*/
  596. void LLFloater::reshape(S32 width, S32 height, BOOL called_from_parent)
  597. {
  598. LLPanel::reshape(width, height, called_from_parent);
  599. storeRectControl();
  600. }
  601. void LLFloater::releaseFocus()
  602. {
  603. if( gFocusMgr.childIsTopCtrl( this ) )
  604. {
  605. gFocusMgr.setTopCtrl(NULL);
  606. }
  607. setFocus(FALSE);
  608. if( gFocusMgr.childHasMouseCapture( this ) )
  609. {
  610. gFocusMgr.setMouseCapture(NULL);
  611. }
  612. }
  613. void LLFloater::setResizeLimits( S32 min_width, S32 min_height )
  614. {
  615. mMinWidth = min_width;
  616. mMinHeight = min_height;
  617. for( S32 i = 0; i < 4; i++ )
  618. {
  619. if( mResizeBar[i] )
  620. {
  621. if (i == LLResizeBar::LEFT || i == LLResizeBar::RIGHT)
  622. {
  623. mResizeBar[i]->setResizeLimits( min_width, S32_MAX );
  624. }
  625. else
  626. {
  627. mResizeBar[i]->setResizeLimits( min_height, S32_MAX );
  628. }
  629. }
  630. if( mResizeHandle[i] )
  631. {
  632. mResizeHandle[i]->setResizeLimits( min_width, min_height );
  633. }
  634. }
  635. }
  636. void LLFloater::center()
  637. {
  638. if(getHost())
  639. {
  640. // hosted floaters can't move
  641. return;
  642. }
  643. centerWithin(gFloaterView->getRect());
  644. }
  645. LLMultiFloater* LLFloater::getHost()
  646. return (LLMultiFloater*)mHostHandle.get(); 
  647. }
  648. void    LLFloater::applySavedVariables()
  649. {
  650. applyRectControl();
  651. applyDockState();
  652. }
  653. void LLFloater::applyRectControl()
  654. {
  655. if (mRectControl.size() > 1)
  656. {
  657. const LLRect& rect = LLUI::sSettingGroups["floater"]->getRect(mRectControl);
  658. if (rect.getWidth() > 0 && rect.getHeight() > 0)
  659. {
  660. translate( rect.mLeft - getRect().mLeft, rect.mBottom - getRect().mBottom);
  661. if (mResizable)
  662. {
  663. reshape(llmax(mMinWidth, rect.getWidth()), llmax(mMinHeight, rect.getHeight()));
  664. }
  665. }
  666. }
  667. }
  668. void LLFloater::applyDockState()
  669. {
  670. if (mDocStateControl.size() > 1)
  671. {
  672. bool dockState = LLUI::sSettingGroups["floater"]->getBOOL(mDocStateControl);
  673. setDocked(dockState);
  674. }
  675. }
  676. void LLFloater::applyTitle()
  677. {
  678. if (!mDragHandle)
  679. {
  680. return;
  681. }
  682. if (isMinimized() && !mShortTitle.empty())
  683. {
  684. mDragHandle->setTitle( mShortTitle );
  685. }
  686. else
  687. {
  688. mDragHandle->setTitle ( mTitle );
  689. }
  690. }
  691. std::string LLFloater::getCurrentTitle() const
  692. {
  693. return mDragHandle ? mDragHandle->getTitle() : LLStringUtil::null;
  694. }
  695. void LLFloater::setTitle( const std::string& title )
  696. {
  697. mTitle = title;
  698. applyTitle();
  699. }
  700. std::string LLFloater::getTitle() const
  701. {
  702. if (mTitle.empty())
  703. {
  704. return mDragHandle ? mDragHandle->getTitle() : LLStringUtil::null;
  705. }
  706. else
  707. {
  708. return mTitle;
  709. }
  710. }
  711. void LLFloater::setShortTitle( const std::string& short_title )
  712. {
  713. mShortTitle = short_title;
  714. applyTitle();
  715. }
  716. std::string LLFloater::getShortTitle() const
  717. {
  718. if (mShortTitle.empty())
  719. {
  720. return mDragHandle ? mDragHandle->getTitle() : LLStringUtil::null;
  721. }
  722. else
  723. {
  724. return mShortTitle;
  725. }
  726. }
  727. BOOL LLFloater::canSnapTo(const LLView* other_view)
  728. {
  729. if (NULL == other_view)
  730. {
  731. llwarns << "other_view is NULL" << llendl;
  732. return FALSE;
  733. }
  734. if (other_view != getParent())
  735. {
  736. const LLFloater* other_floaterp = dynamic_cast<const LLFloater*>(other_view);
  737. if (other_floaterp && other_floaterp->getSnapTarget() == getHandle() && mDependents.find(other_floaterp->getHandle()) != mDependents.end())
  738. {
  739. // this is a dependent that is already snapped to us, so don't snap back to it
  740. return FALSE;
  741. }
  742. }
  743. return LLPanel::canSnapTo(other_view);
  744. }
  745. void LLFloater::setSnappedTo(const LLView* snap_view)
  746. {
  747. if (!snap_view || snap_view == getParent())
  748. {
  749. clearSnapTarget();
  750. }
  751. else
  752. {
  753. //RN: assume it's a floater as it must be a sibling to our parent floater
  754. const LLFloater* floaterp = dynamic_cast<const LLFloater*>(snap_view);
  755. if (floaterp)
  756. {
  757. setSnapTarget(floaterp->getHandle());
  758. }
  759. }
  760. }
  761. void LLFloater::handleReshape(const LLRect& new_rect, bool by_user)
  762. {
  763. const LLRect old_rect = getRect();
  764. LLView::handleReshape(new_rect, by_user);
  765. // if not minimized, adjust all snapped dependents to new shape
  766. if (!isMinimized())
  767. {
  768. // gather all snapped dependents
  769. for(handle_set_iter_t dependent_it = mDependents.begin();
  770. dependent_it != mDependents.end(); ++dependent_it)
  771. {
  772. LLFloater* floaterp = dependent_it->get();
  773. // is a dependent snapped to us?
  774. if (floaterp && floaterp->getSnapTarget() == getHandle())
  775. {
  776. S32 delta_x = 0;
  777. S32 delta_y = 0;
  778. // check to see if it snapped to right or top, and move if dependee floater is resizing
  779. LLRect dependent_rect = floaterp->getRect();
  780. if (dependent_rect.mLeft - getRect().mLeft >= old_rect.getWidth() || // dependent on my right?
  781. dependent_rect.mRight == getRect().mLeft + old_rect.getWidth()) // dependent aligned with my right
  782. {
  783. // was snapped directly onto right side or aligned with it
  784. delta_x += new_rect.getWidth() - old_rect.getWidth();
  785. }
  786. if (dependent_rect.mBottom - getRect().mBottom >= old_rect.getHeight() ||
  787. dependent_rect.mTop == getRect().mBottom + old_rect.getHeight())
  788. {
  789. // was snapped directly onto top side or aligned with it
  790. delta_y += new_rect.getHeight() - old_rect.getHeight();
  791. }
  792. // take translation of dependee floater into account as well
  793. delta_x += new_rect.mLeft - old_rect.mLeft;
  794. delta_y += new_rect.mBottom - old_rect.mBottom;
  795. dependent_rect.translate(delta_x, delta_y);
  796. floaterp->setShape(dependent_rect, by_user);
  797. }
  798. }
  799. }
  800. else
  801. {
  802. // If minimized, and origin has changed, set
  803. // mHasBeenDraggedWhileMinimized to TRUE
  804. if ((new_rect.mLeft != old_rect.mLeft) ||
  805. (new_rect.mBottom != old_rect.mBottom))
  806. {
  807. mHasBeenDraggedWhileMinimized = TRUE;
  808. }
  809. }
  810. }
  811. void LLFloater::setMinimized(BOOL minimize)
  812. {
  813. const LLFloater::Params& default_params = LLFloater::getDefaultParams();
  814. S32 floater_header_size = default_params.header_height;
  815. static LLUICachedControl<S32> minimized_width ("UIMinimizedWidth", 0);
  816. if (minimize == mMinimized) return;
  817. if (minimize)
  818. {
  819. // minimized flag should be turned on before release focus
  820. mMinimized = TRUE;
  821. mExpandedRect = getRect();
  822. // If the floater has been dragged while minimized in the
  823. // past, then locate it at its previous minimized location.
  824. // Otherwise, ask the view for a minimize position.
  825. if (mHasBeenDraggedWhileMinimized)
  826. {
  827. setOrigin(mPreviousMinimizedLeft, mPreviousMinimizedBottom);
  828. }
  829. else
  830. {
  831. S32 left, bottom;
  832. gFloaterView->getMinimizePosition(&left, &bottom);
  833. setOrigin( left, bottom );
  834. }
  835. if (mButtonsEnabled[BUTTON_MINIMIZE])
  836. {
  837. mButtonsEnabled[BUTTON_MINIMIZE] = FALSE;
  838. mButtonsEnabled[BUTTON_RESTORE] = TRUE;
  839. }
  840. if (mDragHandle)
  841. {
  842. mDragHandle->setVisible(TRUE);
  843. }
  844. setBorderVisible(TRUE);
  845. for(handle_set_iter_t dependent_it = mDependents.begin();
  846. dependent_it != mDependents.end();
  847. ++dependent_it)
  848. {
  849. LLFloater* floaterp = dependent_it->get();
  850. if (floaterp)
  851. {
  852. if (floaterp->isMinimizeable())
  853. {
  854. floaterp->setMinimized(TRUE);
  855. }
  856. else if (!floaterp->isMinimized())
  857. {
  858. floaterp->setVisible(FALSE);
  859. }
  860. }
  861. }
  862. // Lose keyboard focus when minimized
  863. releaseFocus();
  864. for (S32 i = 0; i < 4; i++)
  865. {
  866. if (mResizeBar[i] != NULL)
  867. {
  868. mResizeBar[i]->setEnabled(FALSE);
  869. }
  870. if (mResizeHandle[i] != NULL)
  871. {
  872. mResizeHandle[i]->setEnabled(FALSE);
  873. }
  874. }
  875. // Reshape *after* setting mMinimized
  876. reshape( minimized_width, floater_header_size, TRUE);
  877. }
  878. else
  879. {
  880. // If this window has been dragged while minimized (at any time),
  881. // remember its position for the next time it's minimized.
  882. if (mHasBeenDraggedWhileMinimized)
  883. {
  884. const LLRect& currentRect = getRect();
  885. mPreviousMinimizedLeft = currentRect.mLeft;
  886. mPreviousMinimizedBottom = currentRect.mBottom;
  887. }
  888. setOrigin( mExpandedRect.mLeft, mExpandedRect.mBottom );
  889. if (mButtonsEnabled[BUTTON_RESTORE])
  890. {
  891. mButtonsEnabled[BUTTON_MINIMIZE] = TRUE;
  892. mButtonsEnabled[BUTTON_RESTORE] = FALSE;
  893. }
  894. // show dependent floater
  895. for(handle_set_iter_t dependent_it = mDependents.begin();
  896. dependent_it != mDependents.end();
  897. ++dependent_it)
  898. {
  899. LLFloater* floaterp = dependent_it->get();
  900. if (floaterp)
  901. {
  902. floaterp->setMinimized(FALSE);
  903. floaterp->setVisible(TRUE);
  904. }
  905. }
  906. for (S32 i = 0; i < 4; i++)
  907. {
  908. if (mResizeBar[i] != NULL)
  909. {
  910. mResizeBar[i]->setEnabled(isResizable());
  911. }
  912. if (mResizeHandle[i] != NULL)
  913. {
  914. mResizeHandle[i]->setEnabled(isResizable());
  915. }
  916. }
  917. mMinimized = FALSE;
  918. // Reshape *after* setting mMinimized
  919. reshape( mExpandedRect.getWidth(), mExpandedRect.getHeight(), TRUE );
  920. }
  921. applyTitle ();
  922. make_ui_sound("UISndWindowClose");
  923. updateButtons();
  924. }
  925. void LLFloater::setFocus( BOOL b )
  926. {
  927. if (b && getIsChrome())
  928. {
  929. return;
  930. }
  931. LLUICtrl* last_focus = gFocusMgr.getLastFocusForGroup(this);
  932. // a descendent already has focus
  933. BOOL child_had_focus = hasFocus();
  934. // give focus to first valid descendent
  935. LLPanel::setFocus(b);
  936. if (b)
  937. {
  938. // only push focused floaters to front of stack if not in midst of ctrl-tab cycle
  939. if (!getHost() && !((LLFloaterView*)getParent())->getCycleMode())
  940. {
  941. if (!isFrontmost())
  942. {
  943. setFrontmost();
  944. }
  945. }
  946. // when getting focus, delegate to last descendent which had focus
  947. if (last_focus && !child_had_focus && 
  948. last_focus->isInEnabledChain() &&
  949. last_focus->isInVisibleChain())
  950. {
  951. // *FIX: should handle case where focus doesn't stick
  952. last_focus->setFocus(TRUE);
  953. }
  954. }
  955. }
  956. // virtual
  957. void LLFloater::setRect(const LLRect &rect)
  958. {
  959. LLPanel::setRect(rect);
  960. layoutDragHandle();
  961. layoutResizeCtrls();
  962. }
  963. // virtual
  964. void LLFloater::setIsChrome(BOOL is_chrome)
  965. {
  966. // chrome floaters don't take focus at all
  967. if (is_chrome)
  968. {
  969. // remove focus if we're changing to chrome
  970. setFocus(FALSE);
  971. // can't Ctrl-Tab to "chrome" floaters
  972. setFocusRoot(FALSE);
  973. }
  974. // no titles displayed on "chrome" floaters
  975. if (mDragHandle)
  976. mDragHandle->setTitleVisible(!is_chrome);
  977. LLPanel::setIsChrome(is_chrome);
  978. }
  979. void LLFloater::setTitleVisible(bool visible)
  980. {
  981. if (mDragHandle)
  982. mDragHandle->setTitleVisible(visible);
  983. }
  984. // Change the draw style to account for the foreground state.
  985. void LLFloater::setForeground(BOOL front)
  986. {
  987. if (front != mForeground)
  988. {
  989. mForeground = front;
  990. if (mDragHandle)
  991. mDragHandle->setForeground( front );
  992. if (!front)
  993. {
  994. releaseFocus();
  995. }
  996. setBackgroundOpaque( front ); 
  997. }
  998. }
  999. void LLFloater::cleanupHandles()
  1000. {
  1001. // remove handles to non-existent dependents
  1002. for(handle_set_iter_t dependent_it = mDependents.begin();
  1003. dependent_it != mDependents.end(); )
  1004. {
  1005. LLFloater* floaterp = dependent_it->get();
  1006. if (!floaterp)
  1007. {
  1008. mDependents.erase(dependent_it++);
  1009. }
  1010. else
  1011. {
  1012. ++dependent_it;
  1013. }
  1014. }
  1015. }
  1016. void LLFloater::setHost(LLMultiFloater* host)
  1017. {
  1018. if (mHostHandle.isDead() && host)
  1019. {
  1020. // make buttons smaller for hosted windows to differentiate from parent
  1021. mButtonScale = 0.9f;
  1022. // add tear off button
  1023. if (mCanTearOff)
  1024. {
  1025. mButtonsEnabled[BUTTON_TEAR_OFF] = TRUE;
  1026. }
  1027. }
  1028. else if (!mHostHandle.isDead() && !host)
  1029. {
  1030. mButtonScale = 1.f;
  1031. //mButtonsEnabled[BUTTON_TEAR_OFF] = FALSE;
  1032. }
  1033. updateButtons();
  1034. if (host)
  1035. {
  1036. mHostHandle = host->getHandle();
  1037. mLastHostHandle = host->getHandle();
  1038. }
  1039. else
  1040. {
  1041. mHostHandle.markDead();
  1042. }
  1043. }
  1044. void LLFloater::moveResizeHandlesToFront()
  1045. {
  1046. for( S32 i = 0; i < 4; i++ )
  1047. {
  1048. if( mResizeBar[i] )
  1049. {
  1050. sendChildToFront(mResizeBar[i]);
  1051. }
  1052. }
  1053. for( S32 i = 0; i < 4; i++ )
  1054. {
  1055. if( mResizeHandle[i] )
  1056. {
  1057. sendChildToFront(mResizeHandle[i]);
  1058. }
  1059. }
  1060. }
  1061. BOOL LLFloater::isFrontmost()
  1062. {
  1063. return gFloaterView && gFloaterView->getFrontmost() == this && getVisible();
  1064. }
  1065. void LLFloater::addDependentFloater(LLFloater* floaterp, BOOL reposition)
  1066. {
  1067. mDependents.insert(floaterp->getHandle());
  1068. floaterp->mDependeeHandle = getHandle();
  1069. if (reposition)
  1070. {
  1071. floaterp->setRect(gFloaterView->findNeighboringPosition(this, floaterp));
  1072. floaterp->setSnapTarget(getHandle());
  1073. }
  1074. gFloaterView->adjustToFitScreen(floaterp, FALSE);
  1075. if (floaterp->isFrontmost())
  1076. {
  1077. // make sure to bring self and sibling floaters to front
  1078. gFloaterView->bringToFront(floaterp);
  1079. }
  1080. }
  1081. void LLFloater::addDependentFloater(LLHandle<LLFloater> dependent, BOOL reposition)
  1082. {
  1083. LLFloater* dependent_floaterp = dependent.get();
  1084. if(dependent_floaterp)
  1085. {
  1086. addDependentFloater(dependent_floaterp, reposition);
  1087. }
  1088. }
  1089. void LLFloater::removeDependentFloater(LLFloater* floaterp)
  1090. {
  1091. mDependents.erase(floaterp->getHandle());
  1092. floaterp->mDependeeHandle = LLHandle<LLFloater>();
  1093. }
  1094. BOOL LLFloater::offerClickToButton(S32 x, S32 y, MASK mask, EFloaterButton index)
  1095. {
  1096. if( mButtonsEnabled[index] )
  1097. {
  1098. LLButton* my_butt = mButtons[index];
  1099. S32 local_x = x - my_butt->getRect().mLeft;
  1100. S32 local_y = y - my_butt->getRect().mBottom;
  1101. if (
  1102. my_butt->pointInView(local_x, local_y) &&
  1103. my_butt->handleMouseDown(local_x, local_y, mask))
  1104. {
  1105. // the button handled it
  1106. return TRUE;
  1107. }
  1108. }
  1109. return FALSE;
  1110. }
  1111. BOOL LLFloater::handleScrollWheel(S32 x, S32 y, S32 clicks)
  1112. {
  1113. LLPanel::handleScrollWheel(x,y,clicks);
  1114. return TRUE;//always
  1115. }
  1116. // virtual
  1117. BOOL LLFloater::handleMouseDown(S32 x, S32 y, MASK mask)
  1118. {
  1119. if( mMinimized )
  1120. {
  1121. // Offer the click to titlebar buttons.
  1122. // Note: this block and the offerClickToButton helper method can be removed
  1123. // because the parent container will handle it for us but we'll keep it here
  1124. // for safety until after reworking the panel code to manage hidden children.
  1125. if(offerClickToButton(x, y, mask, BUTTON_CLOSE)) return TRUE;
  1126. if(offerClickToButton(x, y, mask, BUTTON_RESTORE)) return TRUE;
  1127. if(offerClickToButton(x, y, mask, BUTTON_TEAR_OFF)) return TRUE;
  1128. // Otherwise pass to drag handle for movement
  1129. return mDragHandle->handleMouseDown(x, y, mask);
  1130. }
  1131. else
  1132. {
  1133. bringToFront( x, y );
  1134. return LLPanel::handleMouseDown( x, y, mask );
  1135. }
  1136. }
  1137. // virtual
  1138. BOOL LLFloater::handleRightMouseDown(S32 x, S32 y, MASK mask)
  1139. {
  1140. BOOL was_minimized = mMinimized;
  1141. bringToFront( x, y );
  1142. return was_minimized || LLPanel::handleRightMouseDown( x, y, mask );
  1143. }
  1144. BOOL LLFloater::handleMiddleMouseDown(S32 x, S32 y, MASK mask)
  1145. {
  1146. bringToFront( x, y );
  1147. return LLPanel::handleMiddleMouseDown( x, y, mask );
  1148. }
  1149. // virtual
  1150. BOOL LLFloater::handleDoubleClick(S32 x, S32 y, MASK mask)
  1151. {
  1152. BOOL was_minimized = mMinimized;
  1153. setMinimized(FALSE);
  1154. return was_minimized || LLPanel::handleDoubleClick(x, y, mask);
  1155. }
  1156. void LLFloater::bringToFront( S32 x, S32 y )
  1157. {
  1158. if (getVisible() && pointInView(x, y))
  1159. {
  1160. LLMultiFloater* hostp = getHost();
  1161. if (hostp)
  1162. {
  1163. hostp->showFloater(this);
  1164. }
  1165. else
  1166. {
  1167. LLFloaterView* parent = (LLFloaterView*) getParent();
  1168. if (parent)
  1169. {
  1170. parent->bringToFront( this );
  1171. }
  1172. }
  1173. }
  1174. }
  1175. // virtual
  1176. void LLFloater::setVisibleAndFrontmost(BOOL take_focus)
  1177. {
  1178. gFocusMgr.setTopCtrl(NULL);
  1179. setVisible(TRUE);
  1180. setFrontmost(take_focus);
  1181. }
  1182. void LLFloater::setFrontmost(BOOL take_focus)
  1183. {
  1184. LLMultiFloater* hostp = getHost();
  1185. if (hostp)
  1186. {
  1187. // this will bring the host floater to the front and select
  1188. // the appropriate panel
  1189. hostp->showFloater(this);
  1190. }
  1191. else
  1192. {
  1193. // there are more than one floater view
  1194. // so we need to query our parent directly
  1195. ((LLFloaterView*)getParent())->bringToFront(this, take_focus);
  1196. }
  1197. }
  1198. void LLFloater::setCanDock(bool b)
  1199. {
  1200. if(b != mCanDock)
  1201. {
  1202. mCanDock = b;
  1203. if(mCanDock)
  1204. {
  1205. mButtonsEnabled[BUTTON_DOCK] = !mDocked;
  1206. }
  1207. else
  1208. {
  1209. mButtonsEnabled[BUTTON_DOCK] = FALSE;
  1210. }
  1211. }
  1212. updateButtons();
  1213. }
  1214. void LLFloater::setDocked(bool docked, bool pop_on_undock)
  1215. {
  1216. if(docked != mDocked && mCanDock)
  1217. {
  1218. mDocked = docked;
  1219. mButtonsEnabled[BUTTON_DOCK] = !mDocked;
  1220. updateButtons();
  1221. storeDockStateControl();
  1222. }
  1223. }
  1224. // static
  1225. void LLFloater::onClickMinimize(LLFloater* self)
  1226. {
  1227. if (!self)
  1228. return;
  1229. self->setMinimized( !self->isMinimized() );
  1230. }
  1231. void LLFloater::onClickTearOff(LLFloater* self)
  1232. {
  1233. if (!self)
  1234. return;
  1235. S32 floater_header_size = self->mHeaderHeight;
  1236. LLMultiFloater* host_floater = self->getHost();
  1237. if (host_floater) //Tear off
  1238. {
  1239. LLRect new_rect;
  1240. host_floater->removeFloater(self);
  1241. // reparent to floater view
  1242. gFloaterView->addChild(self);
  1243. self->openFloater(self->getKey());
  1244. // only force position for floaters that don't have that data saved
  1245. if (self->mRectControl.size() <= 1)
  1246. {
  1247. new_rect.setLeftTopAndSize(host_floater->getRect().mLeft + 5, host_floater->getRect().mTop - floater_header_size - 5, self->getRect().getWidth(), self->getRect().getHeight());
  1248. self->setRect(new_rect);
  1249. }
  1250. gFloaterView->adjustToFitScreen(self, FALSE);
  1251. // give focus to new window to keep continuity for the user
  1252. self->setFocus(TRUE);
  1253. self->setTornOff(true);
  1254. }
  1255. else  //Attach to parent.
  1256. {
  1257. LLMultiFloater* new_host = (LLMultiFloater*)self->mLastHostHandle.get();
  1258. if (new_host)
  1259. {
  1260. self->setMinimized(FALSE); // to reenable minimize button if it was minimized
  1261. new_host->showFloater(self);
  1262. // make sure host is visible
  1263. new_host->openFloater(new_host->getKey());
  1264. }
  1265. self->setTornOff(false);
  1266. }
  1267. self->updateButtons();
  1268. }
  1269. // static
  1270. void LLFloater::onClickDock(LLFloater* self)
  1271. {
  1272. if(self && self->mCanDock)
  1273. {
  1274. self->setDocked(!self->mDocked, true);
  1275. }
  1276. }
  1277. // static
  1278. void LLFloater::onClickHelp( LLFloater* self )
  1279. {
  1280. if (self && LLUI::sHelpImpl)
  1281. {
  1282. // find the current help context for this floater
  1283. std::string help_topic;
  1284. if (self->findHelpTopic(help_topic))
  1285. {
  1286. LLUI::sHelpImpl->showTopic(help_topic);
  1287. }
  1288. }
  1289. }
  1290. // static 
  1291. LLFloater* LLFloater::getClosableFloaterFromFocus()
  1292. {
  1293. LLFloater* focused_floater = NULL;
  1294. handle_map_iter_t iter;
  1295. for(iter = sFloaterMap.begin(); iter != sFloaterMap.end(); ++iter)
  1296. {
  1297. focused_floater = iter->second;
  1298. if (focused_floater->hasFocus())
  1299. {
  1300. break;
  1301. }
  1302. }
  1303. if (iter == sFloaterMap.end())
  1304. {
  1305. // nothing found, return
  1306. return NULL;
  1307. }
  1308. // The focused floater may not be closable,
  1309. // Find and close a parental floater that is closeable, if any.
  1310. LLFloater* prev_floater = NULL;
  1311. for(LLFloater* floater_to_close = focused_floater;
  1312. NULL != floater_to_close; 
  1313. floater_to_close = gFloaterView->getParentFloater(floater_to_close))
  1314. {
  1315. if(floater_to_close->isCloseable())
  1316. {
  1317. return floater_to_close;
  1318. }
  1319. // If floater has as parent root view
  1320. // gFloaterView->getParentFloater(floater_to_close) returns
  1321. // the same floater_to_close, so we need to check this.
  1322. if (prev_floater == floater_to_close) {
  1323. break;
  1324. }
  1325. prev_floater = floater_to_close;
  1326. }
  1327. return NULL;
  1328. }
  1329. // static
  1330. void LLFloater::closeFocusedFloater()
  1331. {
  1332. LLFloater* floater_to_close = LLFloater::getClosableFloaterFromFocus();
  1333. if(floater_to_close)
  1334. {
  1335. floater_to_close->closeFloater();
  1336. }
  1337. // if nothing took focus after closing focused floater
  1338. // give it to next floater (to allow closing multiple windows via keyboard in rapid succession)
  1339. if (gFocusMgr.getKeyboardFocus() == NULL)
  1340. {
  1341. // HACK: use gFloaterView directly in case we are using Ctrl-W to close snapshot window
  1342. // which sits in gSnapshotFloaterView, and needs to pass focus on to normal floater view
  1343. gFloaterView->focusFrontFloater();
  1344. }
  1345. }
  1346. // static
  1347. void LLFloater::onClickClose( LLFloater* self )
  1348. {
  1349. if (!self)
  1350. return;
  1351. self->closeFloater(false);
  1352. }
  1353. // virtual
  1354. void LLFloater::draw()
  1355. {
  1356. F32 alpha = getDrawContext().mAlpha;
  1357. // draw background
  1358. if( isBackgroundVisible() )
  1359. {
  1360. drawShadow(this);
  1361. S32 left = LLPANEL_BORDER_WIDTH;
  1362. S32 top = getRect().getHeight() - LLPANEL_BORDER_WIDTH;
  1363. S32 right = getRect().getWidth() - LLPANEL_BORDER_WIDTH;
  1364. S32 bottom = LLPANEL_BORDER_WIDTH;
  1365. LLUIImage* image = NULL;
  1366. LLColor4 color;
  1367. if (isBackgroundOpaque())
  1368. {
  1369. // NOTE: image may not be set
  1370. image = getBackgroundImage();
  1371. color = getBackgroundColor();
  1372. }
  1373. else
  1374. {
  1375. image = getTransparentImage();
  1376. color = getTransparentColor();
  1377. }
  1378. if (image)
  1379. {
  1380. // We're using images for this floater's backgrounds
  1381. image->draw(getLocalRect(), UI_VERTEX_COLOR % alpha);
  1382. }
  1383. else
  1384. {
  1385. // We're not using images, use old-school flat colors
  1386. gl_rect_2d( left, top, right, bottom, color % alpha );
  1387. // draw highlight on title bar to indicate focus.  RDW
  1388. if(hasFocus() 
  1389. && !getIsChrome() 
  1390. && !getCurrentTitle().empty())
  1391. {
  1392. static LLUIColor titlebar_focus_color = LLUIColorTable::instance().getColor("TitleBarFocusColor");
  1393. const LLFontGL* font = LLFontGL::getFontSansSerif();
  1394. LLRect r = getRect();
  1395. gl_rect_2d_offset_local(0, r.getHeight(), r.getWidth(), r.getHeight() - (S32)font->getLineHeight() - 1, 
  1396. titlebar_focus_color % alpha, 0, TRUE);
  1397. }
  1398. }
  1399. }
  1400. LLPanel::updateDefaultBtn();
  1401. if( getDefaultButton() )
  1402. {
  1403. if (hasFocus() && getDefaultButton()->getEnabled())
  1404. {
  1405. LLFocusableElement* focus_ctrl = gFocusMgr.getKeyboardFocus();
  1406. // is this button a direct descendent and not a nested widget (e.g. checkbox)?
  1407. BOOL focus_is_child_button = dynamic_cast<LLButton*>(focus_ctrl) != NULL && dynamic_cast<LLButton*>(focus_ctrl)->getParent() == this;
  1408. // only enable default button when current focus is not a button
  1409. getDefaultButton()->setBorderEnabled(!focus_is_child_button);
  1410. }
  1411. else
  1412. {
  1413. getDefaultButton()->setBorderEnabled(FALSE);
  1414. }
  1415. }
  1416. if (isMinimized())
  1417. {
  1418. for (S32 i = 0; i < BUTTON_COUNT; i++)
  1419. {
  1420. drawChild(mButtons[i]);
  1421. }
  1422. drawChild(mDragHandle);
  1423. }
  1424. else
  1425. {
  1426. // don't call LLPanel::draw() since we've implemented custom background rendering
  1427. LLView::draw();
  1428. }
  1429. // update tearoff button for torn off floaters
  1430. // when last host goes away
  1431. if (mCanTearOff && !getHost())
  1432. {
  1433. LLFloater* old_host = mLastHostHandle.get();
  1434. if (!old_host)
  1435. {
  1436. setCanTearOff(FALSE);
  1437. }
  1438. }
  1439. }
  1440. void LLFloater::drawShadow(LLPanel* panel)
  1441. {
  1442. F32 alpha = panel->getDrawContext().mAlpha;
  1443. S32 left = LLPANEL_BORDER_WIDTH;
  1444. S32 top = panel->getRect().getHeight() - LLPANEL_BORDER_WIDTH;
  1445. S32 right = panel->getRect().getWidth() - LLPANEL_BORDER_WIDTH;
  1446. S32 bottom = LLPANEL_BORDER_WIDTH;
  1447. static LLUICachedControl<S32> shadow_offset_S32 ("DropShadowFloater", 0);
  1448. static LLUIColor shadow_color_cached = LLUIColorTable::instance().getColor("ColorDropShadow");
  1449. LLColor4 shadow_color = shadow_color_cached;
  1450. F32 shadow_offset = (F32)shadow_offset_S32;
  1451. if (!panel->isBackgroundOpaque())
  1452. {
  1453. shadow_offset *= 0.2f;
  1454. shadow_color.mV[VALPHA] *= 0.5f;
  1455. }
  1456. gl_drop_shadow(left, top, right, bottom, 
  1457. shadow_color % alpha, 
  1458. llround(shadow_offset));
  1459. }
  1460. void LLFloater::setCanMinimize(BOOL can_minimize)
  1461. {
  1462. // if removing minimize/restore button programmatically,
  1463. // go ahead and unminimize floater
  1464. mCanMinimize = can_minimize;
  1465. if (!can_minimize)
  1466. {
  1467. setMinimized(FALSE);
  1468. }
  1469. mButtonsEnabled[BUTTON_MINIMIZE] = can_minimize && !isMinimized();
  1470. mButtonsEnabled[BUTTON_RESTORE]  = can_minimize &&  isMinimized();
  1471. updateButtons();
  1472. }
  1473. void LLFloater::setCanClose(BOOL can_close)
  1474. {
  1475. mCanClose = can_close;
  1476. mButtonsEnabled[BUTTON_CLOSE] = can_close;
  1477. updateButtons();
  1478. }
  1479. void LLFloater::setCanTearOff(BOOL can_tear_off)
  1480. {
  1481. mCanTearOff = can_tear_off;
  1482. mButtonsEnabled[BUTTON_TEAR_OFF] = mCanTearOff && !mHostHandle.isDead();
  1483. updateButtons();
  1484. }
  1485. void LLFloater::setCanResize(BOOL can_resize)
  1486. {
  1487. mResizable = can_resize;
  1488. enableResizeCtrls(can_resize);
  1489. }
  1490. void LLFloater::setCanDrag(BOOL can_drag)
  1491. {
  1492. // if we delete drag handle, we no longer have access to the floater's title
  1493. // so just enable/disable it
  1494. if (!can_drag && mDragHandle->getEnabled())
  1495. {
  1496. mDragHandle->setEnabled(FALSE);
  1497. }
  1498. else if (can_drag && !mDragHandle->getEnabled())
  1499. {
  1500. mDragHandle->setEnabled(TRUE);
  1501. }
  1502. }
  1503. void LLFloater::updateButtons()
  1504. {
  1505. static LLUICachedControl<S32> floater_close_box_size ("UIFloaterCloseBoxSize", 0);
  1506. static LLUICachedControl<S32> close_box_from_top ("UICloseBoxFromTop", 0);
  1507. S32 button_count = 0;
  1508. for (S32 i = 0; i < BUTTON_COUNT; i++)
  1509. {
  1510. if (!mButtons[i])
  1511. {
  1512. continue;
  1513. }
  1514. bool enabled = mButtonsEnabled[i];
  1515. if (i == BUTTON_HELP)
  1516. {
  1517. // don't show the help button if the floater is minimized
  1518. // or if it is a docked tear-off floater
  1519. if (isMinimized() || (mButtonsEnabled[BUTTON_TEAR_OFF] && ! mTornOff))
  1520. {
  1521. enabled = false;
  1522. }
  1523. }
  1524. if (i == BUTTON_CLOSE && mButtonScale != 1.f)
  1525. {
  1526. //*HACK: always render close button for hosted floaters so
  1527. //that users don't accidentally hit the button when
  1528. //closing multiple windows in the chatterbox
  1529. enabled = true;
  1530. }
  1531. mButtons[i]->setEnabled(enabled);
  1532. if (enabled)
  1533. {
  1534. button_count++;
  1535. LLRect btn_rect;
  1536. if (mDragOnLeft)
  1537. {
  1538. btn_rect.setLeftTopAndSize(
  1539. LLPANEL_BORDER_WIDTH,
  1540. getRect().getHeight() - close_box_from_top - (floater_close_box_size + 1) * button_count,
  1541. llround((F32)floater_close_box_size * mButtonScale),
  1542. llround((F32)floater_close_box_size * mButtonScale));
  1543. }
  1544. else
  1545. {
  1546. btn_rect.setLeftTopAndSize(
  1547. getRect().getWidth() - LLPANEL_BORDER_WIDTH - (floater_close_box_size + 1) * button_count,
  1548. getRect().getHeight() - close_box_from_top,
  1549. llround((F32)floater_close_box_size * mButtonScale),
  1550. llround((F32)floater_close_box_size * mButtonScale));
  1551. }
  1552. mButtons[i]->setRect(btn_rect);
  1553. mButtons[i]->setVisible(TRUE);
  1554. // the restore button should have a tab stop so that it takes action when you Ctrl-Tab to a minimized floater
  1555. mButtons[i]->setTabStop(i == BUTTON_RESTORE);
  1556. }
  1557. else
  1558. {
  1559. mButtons[i]->setVisible(FALSE);
  1560. }
  1561. }
  1562. if (mDragHandle)
  1563. mDragHandle->setMaxTitleWidth(getRect().getWidth() - (button_count * (floater_close_box_size + 1)));
  1564. }
  1565. void LLFloater::buildButtons(const Params& floater_params)
  1566. {
  1567. static LLUICachedControl<S32> floater_close_box_size ("UIFloaterCloseBoxSize", 0);
  1568. static LLUICachedControl<S32> close_box_from_top ("UICloseBoxFromTop", 0);
  1569. for (S32 i = 0; i < BUTTON_COUNT; i++)
  1570. {
  1571. if (mButtons[i])
  1572. {
  1573. removeChild(mButtons[i]);
  1574. delete mButtons[i];
  1575. mButtons[i] = NULL;
  1576. }
  1577. LLRect btn_rect;
  1578. if (mDragOnLeft)
  1579. {
  1580. btn_rect.setLeftTopAndSize(
  1581. LLPANEL_BORDER_WIDTH,
  1582. getRect().getHeight() - close_box_from_top - (floater_close_box_size + 1) * (i + 1),
  1583. llround(floater_close_box_size * mButtonScale),
  1584. llround(floater_close_box_size * mButtonScale));
  1585. }
  1586. else
  1587. {
  1588. btn_rect.setLeftTopAndSize(
  1589. getRect().getWidth() - LLPANEL_BORDER_WIDTH - (floater_close_box_size + 1) * (i + 1),
  1590. getRect().getHeight() - close_box_from_top,
  1591. llround(floater_close_box_size * mButtonScale),
  1592. llround(floater_close_box_size * mButtonScale));
  1593. }
  1594. LLButton::Params p;
  1595. p.name(sButtonNames[i]);
  1596. p.rect(btn_rect);
  1597. p.image_unselected = getButtonImage(floater_params, (EFloaterButton)i);
  1598. // Selected, no matter if hovered or not, is "pressed"
  1599. LLUIImage* pressed_image = getButtonPressedImage(floater_params, (EFloaterButton)i);
  1600. p.image_selected = pressed_image;
  1601. p.image_hover_selected = pressed_image;
  1602. // Use a glow effect when the user hovers over the button
  1603. // These icons are really small, need glow amount increased
  1604. p.hover_glow_amount( 0.33f );
  1605. p.click_callback.function(boost::bind(sButtonCallbacks[i], this));
  1606. p.tab_stop(false);
  1607. p.follows.flags(FOLLOWS_TOP|FOLLOWS_RIGHT);
  1608. p.tool_tip = getButtonTooltip(floater_params, (EFloaterButton)i);
  1609. p.scale_image(true);
  1610. p.chrome(true);
  1611. LLButton* buttonp = LLUICtrlFactory::create<LLButton>(p);
  1612. addChild(buttonp);
  1613. mButtons[i] = buttonp;
  1614. }
  1615. updateButtons();
  1616. }
  1617. // static
  1618. LLUIImage* LLFloater::getButtonImage(const Params& p, EFloaterButton e)
  1619. {
  1620. switch(e)
  1621. {
  1622. default:
  1623. case BUTTON_CLOSE:
  1624. return p.close_image;
  1625. case BUTTON_RESTORE:
  1626. return p.restore_image;
  1627. case BUTTON_MINIMIZE:
  1628. return p.minimize_image;
  1629. case BUTTON_TEAR_OFF:
  1630. return p.tear_off_image;
  1631. case BUTTON_DOCK:
  1632. return p.dock_image;
  1633. case BUTTON_HELP:
  1634. return p.help_image;
  1635. }
  1636. }
  1637. // static
  1638. LLUIImage* LLFloater::getButtonPressedImage(const Params& p, EFloaterButton e)
  1639. {
  1640. switch(e)
  1641. {
  1642. default:
  1643. case BUTTON_CLOSE:
  1644. return p.close_pressed_image;
  1645. case BUTTON_RESTORE:
  1646. return p.restore_pressed_image;
  1647. case BUTTON_MINIMIZE:
  1648. return p.minimize_pressed_image;
  1649. case BUTTON_TEAR_OFF:
  1650. return p.tear_off_pressed_image;
  1651. case BUTTON_DOCK:
  1652. return p.dock_pressed_image;
  1653. case BUTTON_HELP:
  1654. return p.help_pressed_image;
  1655. }
  1656. }
  1657. // static
  1658. std::string LLFloater::getButtonTooltip(const Params& p, EFloaterButton e)
  1659. {
  1660. // TODO: per-floater localizable tooltips set in XML
  1661. return sButtonToolTips[e];
  1662. }
  1663. /////////////////////////////////////////////////////
  1664. // LLFloaterView
  1665. static LLDefaultChildRegistry::Register<LLFloaterView> r("floater_view");
  1666. LLFloaterView::LLFloaterView (const Params& p)
  1667. : LLUICtrl (p),
  1668. mFocusCycleMode(FALSE),
  1669. mSnapOffsetBottom(0),
  1670. mSnapOffsetRight(0)
  1671. {
  1672. }
  1673. // By default, adjust vertical.
  1674. void LLFloaterView::reshape(S32 width, S32 height, BOOL called_from_parent)
  1675. {
  1676. reshapeFloater(width, height, called_from_parent, ADJUST_VERTICAL_YES);
  1677. }
  1678. // When reshaping this view, make the floaters follow their closest edge.
  1679. void LLFloaterView::reshapeFloater(S32 width, S32 height, BOOL called_from_parent, BOOL adjust_vertical)
  1680. {
  1681. S32 old_width = getRect().getWidth();
  1682. S32 old_height = getRect().getHeight();
  1683. for ( child_list_const_iter_t child_it = getChildList()->begin(); child_it != getChildList()->end(); ++child_it)
  1684. {
  1685. LLView* viewp = *child_it;
  1686. LLFloater* floaterp = (LLFloater*)viewp;
  1687. if (floaterp->isDependent())
  1688. {
  1689. // dependents use same follow flags as their "dependee"
  1690. continue;
  1691. }
  1692. // Make if follow the edge it is closest to
  1693. U32 follow_flags = 0x0;
  1694. if (floaterp->isMinimized())
  1695. {
  1696. follow_flags |= (FOLLOWS_LEFT | FOLLOWS_TOP);
  1697. }
  1698. else
  1699. {
  1700. LLRect r = floaterp->getRect();
  1701. // Compute absolute distance from each edge of screen
  1702. S32 left_offset = llabs(r.mLeft - 0);
  1703. S32 right_offset = llabs(old_width - r.mRight);
  1704. S32 top_offset = llabs(old_height - r.mTop);
  1705. S32 bottom_offset = llabs(r.mBottom - 0);
  1706. if (left_offset < right_offset)
  1707. {
  1708. follow_flags |= FOLLOWS_LEFT;
  1709. }
  1710. else
  1711. {
  1712. follow_flags |= FOLLOWS_RIGHT;
  1713. }
  1714. // "No vertical adjustment" usually means that the bottom of the view
  1715. // has been pushed up or down.  Hence we want the floaters to follow
  1716. // the top.
  1717. if (!adjust_vertical)
  1718. {
  1719. follow_flags |= FOLLOWS_TOP;
  1720. }
  1721. else if (top_offset < bottom_offset)
  1722. {
  1723. follow_flags |= FOLLOWS_TOP;
  1724. }
  1725. else
  1726. {
  1727. follow_flags |= FOLLOWS_BOTTOM;
  1728. }
  1729. }
  1730. floaterp->setFollows(follow_flags);
  1731. //RN: all dependent floaters copy follow behavior of "parent"
  1732. for(LLFloater::handle_set_iter_t dependent_it = floaterp->mDependents.begin();
  1733. dependent_it != floaterp->mDependents.end(); ++dependent_it)
  1734. {
  1735. LLFloater* dependent_floaterp = dependent_it->get();
  1736. if (dependent_floaterp)
  1737. {
  1738. dependent_floaterp->setFollows(follow_flags);
  1739. }
  1740. }
  1741. }
  1742. LLView::reshape(width, height, called_from_parent);
  1743. }
  1744. void LLFloaterView::restoreAll()
  1745. {
  1746. // make sure all subwindows aren't minimized
  1747. for ( child_list_const_iter_t child_it = getChildList()->begin(); child_it != getChildList()->end(); ++child_it)
  1748. {
  1749. LLFloater* floaterp = (LLFloater*)*child_it;
  1750. floaterp->setMinimized(FALSE);
  1751. }
  1752. // *FIX: make sure dependents are restored
  1753. // children then deleted by default view constructor
  1754. }
  1755. LLRect LLFloaterView::findNeighboringPosition( LLFloater* reference_floater, LLFloater* neighbor )
  1756. {
  1757. LLRect base_rect = reference_floater->getRect();
  1758. LLRect::tCoordType width = neighbor->getRect().getWidth();
  1759. LLRect::tCoordType height = neighbor->getRect().getHeight();
  1760. LLRect new_rect = neighbor->getRect();
  1761. LLRect expanded_base_rect = base_rect;
  1762. expanded_base_rect.stretch(10);
  1763. for(LLFloater::handle_set_iter_t dependent_it = reference_floater->mDependents.begin();
  1764. dependent_it != reference_floater->mDependents.end(); ++dependent_it)
  1765. {
  1766. LLFloater* sibling = dependent_it->get();
  1767. // check for dependents within 10 pixels of base floater
  1768. if (sibling && 
  1769. sibling != neighbor && 
  1770. sibling->getVisible() && 
  1771. expanded_base_rect.overlaps(sibling->getRect()))
  1772. {
  1773. base_rect.unionWith(sibling->getRect());
  1774. }
  1775. }
  1776. LLRect::tCoordType left_margin = llmax(0, base_rect.mLeft);
  1777. LLRect::tCoordType right_margin = llmax(0, getRect().getWidth() - base_rect.mRight);
  1778. LLRect::tCoordType top_margin = llmax(0, getRect().getHeight() - base_rect.mTop);
  1779. LLRect::tCoordType bottom_margin = llmax(0, base_rect.mBottom);
  1780. // find position for floater in following order
  1781. // right->left->bottom->top
  1782. for (S32 i = 0; i < 5; i++)
  1783. {
  1784. if (right_margin > width)
  1785. {
  1786. new_rect.translate(base_rect.mRight - neighbor->getRect().mLeft, base_rect.mTop - neighbor->getRect().mTop);
  1787. return new_rect;
  1788. }
  1789. else if (left_margin > width)
  1790. {
  1791. new_rect.translate(base_rect.mLeft - neighbor->getRect().mRight, base_rect.mTop - neighbor->getRect().mTop);
  1792. return new_rect;
  1793. }
  1794. else if (bottom_margin > height)
  1795. {
  1796. new_rect.translate(base_rect.mLeft - neighbor->getRect().mLeft, base_rect.mBottom - neighbor->getRect().mTop);
  1797. return new_rect;
  1798. }
  1799. else if (top_margin > height)
  1800. {
  1801. new_rect.translate(base_rect.mLeft - neighbor->getRect().mLeft, base_rect.mTop - neighbor->getRect().mBottom);
  1802. return new_rect;
  1803. }
  1804. // keep growing margins to find "best" fit
  1805. left_margin += 20;
  1806. right_margin += 20;
  1807. top_margin += 20;
  1808. bottom_margin += 20;
  1809. }
  1810. // didn't find anything, return initial rect
  1811. return new_rect;
  1812. }
  1813. void LLFloaterView::bringToFront(LLFloater* child, BOOL give_focus)
  1814. {
  1815. // *TODO: make this respect floater's mAutoFocus value, instead of
  1816. // using parameter
  1817. if (child->getHost())
  1818.   {
  1819. // this floater is hosted elsewhere and hence not one of our children, abort
  1820. return;
  1821. }
  1822. std::vector<LLView*> floaters_to_move;
  1823. // Look at all floaters...tab
  1824. for ( child_list_const_iter_t child_it = getChildList()->begin(); child_it != getChildList()->end(); ++child_it)
  1825. {
  1826. LLView* viewp = *child_it;
  1827. LLFloater *floater = (LLFloater *)viewp;
  1828. // ...but if I'm a dependent floater...
  1829. if (child->isDependent())
  1830. {
  1831. // ...look for floaters that have me as a dependent...
  1832. LLFloater::handle_set_iter_t found_dependent = floater->mDependents.find(child->getHandle());
  1833. if (found_dependent != floater->mDependents.end())
  1834. {
  1835. // ...and make sure all children of that floater (including me) are brought to front...
  1836. for(LLFloater::handle_set_iter_t dependent_it = floater->mDependents.begin();
  1837. dependent_it != floater->mDependents.end(); )
  1838. {
  1839. LLFloater* sibling = dependent_it->get();
  1840. if (sibling)
  1841. {
  1842. floaters_to_move.push_back(sibling);
  1843. }
  1844. ++dependent_it;
  1845. }
  1846. //...before bringing my parent to the front...
  1847. floaters_to_move.push_back(floater);
  1848. }
  1849. }
  1850. }
  1851. std::vector<LLView*>::iterator view_it;
  1852. for(view_it = floaters_to_move.begin(); view_it != floaters_to_move.end(); ++view_it)
  1853. {
  1854. LLFloater* floaterp = (LLFloater*)(*view_it);
  1855. sendChildToFront(floaterp);
  1856. // always unminimize dependee, but allow dependents to stay minimized
  1857. if (!floaterp->isDependent())
  1858. {
  1859. floaterp->setMinimized(FALSE);
  1860. }
  1861. }
  1862. floaters_to_move.clear();
  1863. // ...then bringing my own dependents to the front...
  1864. for(LLFloater::handle_set_iter_t dependent_it = child->mDependents.begin();
  1865. dependent_it != child->mDependents.end(); )
  1866. {
  1867. LLFloater* dependent = dependent_it->get();
  1868. if (dependent)
  1869. {
  1870. sendChildToFront(dependent);
  1871. //don't un-minimize dependent windows automatically
  1872. // respect user's wishes
  1873. //dependent->setMinimized(FALSE);
  1874. }
  1875. ++dependent_it;
  1876. }
  1877. // ...and finally bringing myself to front 
  1878. // (do this last, so that I'm left in front at end of this call)
  1879. if( *getChildList()->begin() != child ) 
  1880. {
  1881. sendChildToFront(child);
  1882. }
  1883. child->setMinimized(FALSE);
  1884. if (give_focus && !gFocusMgr.childHasKeyboardFocus(child))
  1885. {
  1886. child->setFocus(TRUE);
  1887. // floater did not take focus, so relinquish focus to world
  1888. if (!child->hasFocus())
  1889. {
  1890. gFocusMgr.setKeyboardFocus(NULL);
  1891. }
  1892. }
  1893. }
  1894. void LLFloaterView::highlightFocusedFloater()
  1895. {
  1896. for ( child_list_const_iter_t child_it = getChildList()->begin(); child_it != getChildList()->end(); ++child_it)
  1897. {
  1898. LLFloater *floater = (LLFloater *)(*child_it);
  1899. // skip dependent floaters, as we'll handle them in a batch along with their dependee(?)
  1900. if (floater->isDependent())
  1901. {
  1902. continue;
  1903. }
  1904. BOOL floater_or_dependent_has_focus = gFocusMgr.childHasKeyboardFocus(floater);
  1905. for(LLFloater::handle_set_iter_t dependent_it = floater->mDependents.begin();
  1906. dependent_it != floater->mDependents.end(); 
  1907. ++dependent_it)
  1908. {
  1909. LLFloater* dependent_floaterp = dependent_it->get();
  1910. if (dependent_floaterp && gFocusMgr.childHasKeyboardFocus(dependent_floaterp))
  1911. {
  1912. floater_or_dependent_has_focus = TRUE;
  1913. }
  1914. }
  1915. // now set this floater and all its dependents
  1916. floater->setForeground(floater_or_dependent_has_focus);
  1917. for(LLFloater::handle_set_iter_t dependent_it = floater->mDependents.begin();
  1918. dependent_it != floater->mDependents.end(); )
  1919. {
  1920. LLFloater* dependent_floaterp = dependent_it->get();
  1921. if (dependent_floaterp)
  1922. {
  1923. dependent_floaterp->setForeground(floater_or_dependent_has_focus);
  1924. }
  1925. ++dependent_it;
  1926. }
  1927. floater->cleanupHandles();
  1928. }
  1929. }
  1930. void LLFloaterView::unhighlightFocusedFloater()
  1931. {
  1932. for ( child_list_const_iter_t child_it = getChildList()->begin(); child_it != getChildList()->end(); ++child_it)
  1933. {
  1934. LLFloater *floater = (LLFloater *)(*child_it);
  1935. floater->setForeground(FALSE);
  1936. }
  1937. }
  1938. void LLFloaterView::focusFrontFloater()
  1939. {
  1940. LLFloater* floaterp = getFrontmost();
  1941. if (floaterp)
  1942. {
  1943. floaterp->setFocus(TRUE);
  1944. }
  1945. }
  1946. void LLFloaterView::getMinimizePosition(S32 *left, S32 *bottom)
  1947. {
  1948. const LLFloater::Params& default_params = LLFloater::getDefaultParams();
  1949. S32 floater_header_size = default_params.header_height;
  1950. static LLUICachedControl<S32> minimized_width ("UIMinimizedWidth", 0);
  1951. LLRect snap_rect_local = getLocalSnapRect();
  1952. for(S32 col = snap_rect_local.mLeft;
  1953. col < snap_rect_local.getWidth() - minimized_width;
  1954. col += minimized_width)
  1955. {
  1956. for(S32 row = snap_rect_local.mTop - floater_header_size;
  1957. row > floater_header_size;
  1958. row -= floater_header_size ) //loop rows
  1959. {
  1960. bool foundGap = TRUE;
  1961. for(child_list_const_iter_t child_it = getChildList()->begin();
  1962. child_it != getChildList()->end();
  1963. ++child_it) //loop floaters
  1964. {
  1965. // Examine minimized children.
  1966. LLFloater* floater = (LLFloater*)((LLView*)*child_it);
  1967. if(floater->isMinimized()) 
  1968. {
  1969. LLRect r = floater->getRect();
  1970. if((r.mBottom < (row + floater_header_size))
  1971.    && (r.mBottom > (row - floater_header_size))
  1972.    && (r.mLeft < (col + minimized_width))
  1973.    && (r.mLeft > (col - minimized_width)))
  1974. {
  1975. // needs the check for off grid. can't drag,
  1976. // but window resize makes them off
  1977. foundGap = FALSE;
  1978. break;
  1979. }
  1980. }
  1981. } //done floaters
  1982. if(foundGap)
  1983. {
  1984. *left = col;
  1985. *bottom = row;
  1986. return; //done
  1987. }
  1988. } //done this col
  1989. }
  1990. // crude - stack'em all at 0,0 when screen is full of minimized
  1991. // floaters.
  1992. *left = snap_rect_local.mLeft;
  1993. *bottom = snap_rect_local.mBottom;
  1994. }
  1995. void LLFloaterView::destroyAllChildren()
  1996. {
  1997. LLView::deleteAllChildren();
  1998. }
  1999. void LLFloaterView::closeAllChildren(bool app_quitting)
  2000. {
  2001. // iterate over a copy of the list, because closing windows will destroy
  2002. // some windows on the list.
  2003. child_list_t child_list = *(getChildList());
  2004. for (child_list_const_iter_t it = child_list.begin(); it != child_list.end(); ++it)
  2005. {
  2006. LLView* viewp = *it;
  2007. child_list_const_iter_t exists = std::find(getChildList()->begin(), getChildList()->end(), viewp);
  2008. if (exists == getChildList()->end())
  2009. {
  2010. // this floater has already been removed
  2011. continue;
  2012. }
  2013. LLFloater* floaterp = (LLFloater*)viewp;
  2014. // Attempt to close floater.  This will cause the "do you want to save"
  2015. // dialogs to appear.
  2016. if (floaterp->canClose() && !floaterp->isDead())
  2017. {
  2018. floaterp->closeFloater(app_quitting);
  2019. }
  2020. }
  2021. }
  2022. BOOL LLFloaterView::allChildrenClosed()
  2023. {
  2024. // see if there are any visible floaters (some floaters "close"
  2025. // by setting themselves invisible)
  2026. for (child_list_const_iter_t it = getChildList()->begin(); it != getChildList()->end(); ++it)
  2027. {
  2028. LLView* viewp = *it;
  2029. LLFloater* floaterp = (LLFloater*)viewp;
  2030. if (floaterp->getVisible() && !floaterp->isDead() && floaterp->isCloseable())
  2031. {
  2032. return false;
  2033. }
  2034. }
  2035. return true;
  2036. }
  2037. void LLFloaterView::refresh()
  2038. {
  2039. // Constrain children to be entirely on the screen
  2040. for ( child_list_const_iter_t child_it = getChildList()->begin(); child_it != getChildList()->end(); ++child_it)
  2041. {
  2042. LLFloater* floaterp = dynamic_cast<LLFloater*>(*child_it);
  2043. if (floaterp && floaterp->getVisible() )
  2044. {
  2045. // minimized floaters are kept fully onscreen
  2046. adjustToFitScreen(floaterp, !floaterp->isMinimized());
  2047. }
  2048. }
  2049. }
  2050. void LLFloaterView::adjustToFitScreen(LLFloater* floater, BOOL allow_partial_outside)
  2051. {
  2052. if (floater->getParent() != this)
  2053. {
  2054. // floater is hosted elsewhere, so ignore
  2055. return;
  2056. }
  2057. LLRect::tCoordType screen_width = getSnapRect().getWidth();
  2058. LLRect::tCoordType screen_height = getSnapRect().getHeight();
  2059. // only automatically resize non-minimized, resizable floaters
  2060. if( floater->isResizable() && !floater->isMinimized() )
  2061. {
  2062. LLRect view_rect = floater->getRect();
  2063. S32 old_width = view_rect.getWidth();
  2064. S32 old_height = view_rect.getHeight();
  2065. S32 min_width;
  2066. S32 min_height;
  2067. floater->getResizeLimits( &min_width, &min_height );
  2068. // Make sure floater isn't already smaller than its min height/width?
  2069. S32 new_width = llmax( min_width, old_width );
  2070. S32 new_height = llmax( min_height, old_height);
  2071. if((new_width > screen_width) || (new_height > screen_height))
  2072. {
  2073. // We have to make this window able to fit on screen
  2074. new_width = llmin(new_width, screen_width);
  2075. new_height = llmin(new_height, screen_height);
  2076. // ...while respecting minimum width/height
  2077. new_width = llmax(new_width, min_width);
  2078. new_height = llmax(new_height, min_height);
  2079. LLRect new_rect;
  2080. new_rect.setLeftTopAndSize(view_rect.mLeft,view_rect.mTop,new_width, new_height);
  2081. floater->setShape(new_rect);
  2082. if (floater->followsRight())
  2083. {
  2084. floater->translate(old_width - new_width, 0);
  2085. }
  2086. if (floater->followsTop())
  2087. {
  2088. floater->translate(0, old_height - new_height);
  2089. }
  2090. }
  2091. }
  2092. // move window fully onscreen
  2093. if (floater->translateIntoRect( getLocalRect(), allow_partial_outside ))
  2094. {
  2095. floater->clearSnapTarget();
  2096. }
  2097. }
  2098. void LLFloaterView::draw()
  2099. {
  2100. refresh();
  2101. // hide focused floater if in cycle mode, so that it can be drawn on top
  2102. LLFloater* focused_floater = getFocusedFloater();
  2103. if (mFocusCycleMode && focused_floater)
  2104. {
  2105. child_list_const_iter_t child_it = getChildList()->begin();
  2106. for (;child_it != getChildList()->end(); ++child_it)
  2107. {
  2108. if ((*child_it) != focused_floater)
  2109. {
  2110. drawChild(*child_it);
  2111. }
  2112. }
  2113. drawChild(focused_floater, -TABBED_FLOATER_OFFSET, TABBED_FLOATER_OFFSET);
  2114. }
  2115. else
  2116. {
  2117. LLView::draw();
  2118. }
  2119. }
  2120. LLRect LLFloaterView::getSnapRect() const
  2121. {
  2122. LLRect snap_rect = getRect();
  2123. snap_rect.mBottom += mSnapOffsetBottom;
  2124. snap_rect.mRight  -= mSnapOffsetRight;
  2125. return snap_rect;
  2126. }
  2127. LLFloater *LLFloaterView::getFocusedFloater() const
  2128. {
  2129. for ( child_list_const_iter_t child_it = getChildList()->begin(); child_it != getChildList()->end(); ++child_it)
  2130. {
  2131. LLUICtrl* ctrlp = (*child_it)->isCtrl() ? static_cast<LLUICtrl*>(*child_it) : NULL;
  2132. if ( ctrlp && ctrlp->hasFocus() )
  2133. {
  2134. return static_cast<LLFloater *>(ctrlp);
  2135. }
  2136. }
  2137. return NULL;
  2138. }
  2139. LLFloater *LLFloaterView::getFrontmost() const
  2140. {
  2141. for ( child_list_const_iter_t child_it = getChildList()->begin(); child_it != getChildList()->end(); ++child_it)
  2142. {
  2143. LLView* viewp = *child_it;
  2144. if ( viewp->getVisible() && !viewp->isDead())
  2145. {
  2146. return (LLFloater *)viewp;
  2147. }
  2148. }
  2149. return NULL;
  2150. }
  2151. LLFloater *LLFloaterView::getBackmost() const
  2152. {
  2153. LLFloater* back_most = NULL;
  2154. for ( child_list_const_iter_t child_it = getChildList()->begin(); child_it != getChildList()->end(); ++child_it)
  2155. {
  2156. LLView* viewp = *child_it;
  2157. if ( viewp->getVisible() )
  2158. {
  2159. back_most = (LLFloater *)viewp;
  2160. }
  2161. }
  2162. return back_most;
  2163. }
  2164. void LLFloaterView::syncFloaterTabOrder()
  2165. {
  2166. // look for a visible modal dialog, starting from first (should be only one)
  2167. LLModalDialog* modal_dialog = NULL;
  2168. for ( child_list_const_iter_t child_it = getChildList()->begin(); child_it != getChildList()->end(); ++child_it)
  2169. {
  2170. LLModalDialog* dialog = dynamic_cast<LLModalDialog*>(*child_it);
  2171. if (dialog && dialog->isModal() && dialog->getVisible())
  2172. {
  2173. modal_dialog = dialog;
  2174. break;
  2175. }
  2176. }
  2177. if (modal_dialog)
  2178. {
  2179. // If we have a visible modal dialog, make sure that it has focus
  2180. if( gFocusMgr.getTopCtrl() != modal_dialog )
  2181. {
  2182. gFocusMgr.setTopCtrl( modal_dialog );
  2183. }
  2184. if( !gFocusMgr.childHasKeyboardFocus( modal_dialog ) )
  2185. {
  2186. modal_dialog->setFocus(TRUE);
  2187. }
  2188. if( !gFocusMgr.childHasMouseCapture( modal_dialog ) )
  2189. {
  2190. gFocusMgr.setMouseCapture( modal_dialog );
  2191. }
  2192. }
  2193. else
  2194. {
  2195. // otherwise, make sure the focused floater is in the front of the child list
  2196. for ( child_list_const_reverse_iter_t child_it = getChildList()->rbegin(); child_it != getChildList()->rend(); ++child_it)
  2197. {
  2198. LLFloater* floaterp = (LLFloater*)*child_it;
  2199. if (gFocusMgr.childHasKeyboardFocus(floaterp))
  2200. {
  2201. bringToFront(floaterp, FALSE);
  2202. break;
  2203. }
  2204. }
  2205. }
  2206. // sync draw order to tab order
  2207. for ( child_list_const_reverse_iter_t child_it = getChildList()->rbegin(); child_it != getChildList()->rend(); ++child_it)
  2208. {
  2209. LLFloater* floaterp = (LLFloater*)*child_it;
  2210. moveChildToFrontOfTabGroup(floaterp);
  2211. }
  2212. }
  2213. LLFloater* LLFloaterView::getParentFloater(LLView* viewp) const
  2214. {
  2215. LLView* parentp = viewp->getParent();
  2216. while(parentp && parentp != this)
  2217. {
  2218. viewp = parentp;
  2219. parentp = parentp->getParent();
  2220. }
  2221. if (parentp == this)
  2222. {
  2223. return (LLFloater*)viewp;
  2224. }
  2225. return NULL;
  2226. }
  2227. S32 LLFloaterView::getZOrder(LLFloater* child)
  2228. {
  2229. S32 rv = 0;
  2230. for ( child_list_const_iter_t child_it = getChildList()->begin(); child_it != getChildList()->end(); ++child_it)
  2231. {
  2232. LLView* viewp = *child_it;
  2233. if(viewp == child)
  2234. {
  2235. break;
  2236. }
  2237. ++rv;
  2238. }
  2239. return rv;
  2240. }
  2241. void LLFloaterView::pushVisibleAll(BOOL visible, const skip_list_t& skip_list)
  2242. {
  2243. for (child_list_const_iter_t child_iter = getChildList()->begin();
  2244.  child_iter != getChildList()->end(); ++child_iter)
  2245. {
  2246. LLView *view = *child_iter;
  2247. if (skip_list.find(view) == skip_list.end())
  2248. {
  2249. view->pushVisible(visible);
  2250. }
  2251. }
  2252. LLFloaterReg::blockShowFloaters(true);
  2253. }
  2254. void LLFloaterView::popVisibleAll(const skip_list_t& skip_list)
  2255. {
  2256. // make a copy of the list since some floaters change their
  2257. // order in the childList when changing visibility.
  2258. child_list_t child_list_copy = *getChildList();
  2259. for (child_list_const_iter_t child_iter = child_list_copy.begin();
  2260.  child_iter != child_list_copy.end(); ++child_iter)
  2261. {
  2262. LLView *view = *child_iter;
  2263. if (skip_list.find(view) == skip_list.end())
  2264. {
  2265. view->popVisible();
  2266. }
  2267. }
  2268. LLFloaterReg::blockShowFloaters(false);
  2269. }
  2270. void LLFloater::setInstanceName(const std::string& name)
  2271. {
  2272. if (name == mInstanceName)
  2273. return;
  2274. llassert_always(mInstanceName.empty());
  2275. mInstanceName = name;
  2276. if (!mInstanceName.empty())
  2277. {
  2278. // save_rect and save_visibility only apply to registered floaters
  2279. if (!mRectControl.empty())
  2280. {
  2281. mRectControl = LLFloaterReg::declareRectControl(mInstanceName);
  2282. }
  2283. if (!mVisibilityControl.empty())
  2284. {
  2285. mVisibilityControl = LLFloaterReg::declareVisibilityControl(mInstanceName);
  2286. }
  2287. if(!mDocStateControl.empty())
  2288. {
  2289. mDocStateControl = LLFloaterReg::declareDockStateControl(mInstanceName);
  2290. }
  2291. }
  2292. }
  2293. void LLFloater::setKey(const LLSD& newkey)
  2294. {
  2295. // Note: We don't have to do anything special with registration when we change keys
  2296. mKey = newkey;
  2297. }
  2298. //static
  2299. void LLFloater::setupParamsForExport(Params& p, LLView* parent)
  2300. {
  2301. // Do rectangle munging to topleft layout first
  2302. LLPanel::setupParamsForExport(p, parent);
  2303. // Copy the rectangle out to apply layout constraints
  2304. LLRect rect = p.rect;
  2305. // Null out other settings
  2306. p.rect.left.setProvided(false);
  2307. p.rect.top.setProvided(false);
  2308. p.rect.right.setProvided(false);
  2309. p.rect.bottom.setProvided(false);
  2310. // Explicitly set width/height
  2311. p.rect.width.set( rect.getWidth(), true );
  2312. p.rect.height.set( rect.getHeight(), true );
  2313. // If you can't resize this floater, don't export min_height
  2314. // and min_width
  2315. bool can_resize = p.can_resize;
  2316. if (!can_resize)
  2317. {
  2318. p.min_height.setProvided(false);
  2319. p.min_width.setProvided(false);
  2320. }
  2321. }
  2322. void LLFloater::initFromParams(const LLFloater::Params& p)
  2323. {
  2324. // *NOTE: We have too many classes derived from LLFloater to retrofit them 
  2325. // all to pass in params via constructors.  So we use this method.
  2326.  // control_name, tab_stop, focus_lost_callback, initial_value, rect, enabled, visible
  2327. LLPanel::initFromParams(p);
  2328. mTitle = p.title;
  2329. mShortTitle = p.short_title;
  2330. applyTitle();
  2331. setCanTearOff(p.can_tear_off);
  2332. setCanMinimize(p.can_minimize);
  2333. setCanClose(p.can_close);
  2334. setCanDock(p.can_dock);
  2335. setCanResize(p.can_resize);
  2336. setResizeLimits(p.min_width, p.min_height);
  2337. mDragOnLeft = p.can_drag_on_left;
  2338. mHeaderHeight = p.header_height;
  2339. mLegacyHeaderHeight = p.legacy_header_height;
  2340. mSingleInstance = p.single_instance;
  2341. mAutoTile = p.auto_tile;
  2342. if (p.save_rect)
  2343. {
  2344. mRectControl = "t"; // flag to build mRectControl name once mInstanceName is set
  2345. }
  2346. if (p.save_visibility)
  2347. {
  2348. mVisibilityControl = "t"; // flag to build mVisibilityControl name once mInstanceName is set
  2349. }
  2350. if(p.save_dock_state)
  2351. {
  2352. mDocStateControl = "t"; // flag to build mDocStateControl name once mInstanceName is set
  2353. }
  2354. // open callback 
  2355. if (p.open_callback.isProvided())
  2356. {
  2357. mOpenSignal.connect(initCommitCallback(p.open_callback));
  2358. }
  2359. // close callback 
  2360. if (p.close_callback.isProvided())
  2361. {
  2362. mCloseSignal.connect(initCommitCallback(p.close_callback));
  2363. }
  2364. }
  2365. LLFastTimer::DeclareTimer POST_BUILD("Floater Post Build");
  2366. bool LLFloater::initFloaterXML(LLXMLNodePtr node, LLView *parent, LLXMLNodePtr output_node)
  2367. {
  2368. Params params(LLUICtrlFactory::getDefaultParams<LLFloater>());
  2369. LLXUIParser::instance().readXUI(node, params); // *TODO: Error checking
  2370. if (output_node)
  2371. {
  2372. Params output_params(params);
  2373. setupParamsForExport(output_params, parent);
  2374.         Params default_params(LLUICtrlFactory::getDefaultParams<LLFloater>());
  2375. output_node->setName(node->getName()->mString);
  2376. LLXUIParser::instance().writeXUI(
  2377. output_node, output_params, &default_params);
  2378. }
  2379. // Default floater position to top-left corner of screen
  2380. // However, some legacy floaters have explicit top or bottom
  2381. // coordinates set, so respect their wishes.
  2382. if (!params.rect.top.isProvided() && !params.rect.bottom.isProvided())
  2383. {
  2384. params.rect.top.set(0);
  2385. }
  2386. if (!params.rect.left.isProvided() && !params.rect.right.isProvided())
  2387. {
  2388. params.rect.left.set(0);
  2389. }
  2390. params.from_xui = true;
  2391. applyXUILayout(params, parent);
  2392.   initFromParams(params);
  2393. initFloater(params);
  2394. LLMultiFloater* last_host = LLFloater::getFloaterHost();
  2395. if (node->hasName("multi_floater"))
  2396. {
  2397. LLFloater::setFloaterHost((LLMultiFloater*) this);
  2398. }
  2399. LLUICtrlFactory::createChildren(this, node, child_registry_t::instance(), output_node);
  2400. if (node->hasName("multi_floater"))
  2401. {
  2402. LLFloater::setFloaterHost(last_host);
  2403. }
  2404. // HACK: When we changed the header height to 25 pixels in Viewer 2, rather
  2405. // than re-layout all the floaters we use this value in pixels to make the
  2406. // whole floater bigger and change the top-left coordinate for widgets.
  2407. // The goal is to eventually set mLegacyHeaderHeight to zero, which would
  2408. // make the top-left corner for widget layout the same as the top-left
  2409. // corner of the window's content area.  James
  2410. S32 header_stretch = (mHeaderHeight - mLegacyHeaderHeight);
  2411. if (header_stretch > 0)
  2412. {
  2413. // Stretch the floater vertically, don't move widgets
  2414. LLRect rect = getRect();
  2415. rect.mTop += header_stretch;
  2416. // This will also update drag handle, title bar, close box, etc.
  2417. setRect(rect);
  2418. }
  2419. BOOL result;
  2420. {
  2421. LLFastTimer ft(POST_BUILD);
  2422. result = postBuild();
  2423. }
  2424. if (!result)
  2425. {
  2426. llerrs << "Failed to construct floater " << getName() << llendl;
  2427. }
  2428. applyRectControl(); // If we have a saved rect control, apply it
  2429. gFloaterView->adjustToFitScreen(this, FALSE); // Floaters loaded from XML should all fit on screen
  2430. moveResizeHandlesToFront();
  2431. applyDockState();
  2432. return true; // *TODO: Error checking
  2433. }
  2434. bool LLFloater::isShown() const
  2435. {
  2436.     return ! isMinimized() && isInVisibleChain();
  2437. }
  2438. /* static */
  2439. bool LLFloater::isShown(const LLFloater* floater)
  2440. {
  2441.     return floater && floater->isShown();
  2442. }