开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 数值算法/人工智能 > 生物技术 > 查看源码
tooltip.cpp
资源名称：ncbi_cxx_win--Jul_08_2004.zip　[点击查看]
上传用户：yhdzpy8989
上传日期：2007-06-13
资源大小：13604k
文件大小：14k
源码类别：

生物技术

开发平台：

C/C++

tooltip.cpp：源码内容
  1. /*
  2.  * ===========================================================================
  3.  * PRODUCTION $Log: tooltip.cpp,v $
  4.  * PRODUCTION Revision 1000.1  2004/06/01 21:09:23  gouriano
  5.  * PRODUCTION PRODUCTION: UPGRADED [GCC34_MSVC7] Dev-tree R1.10
  6.  * PRODUCTION
  7.  * ===========================================================================
  8.  */
  10. /*  $Id: tooltip.cpp,v 1000.1 2004/06/01 21:09:23 gouriano Exp $
  11.  * ===========================================================================
  12.  *
  13.  *                            PUBLIC DOMAIN NOTICE
  14.  *               National Center for Biotechnology Information
  15.  *
  16.  *  This software/database is a "United States Government Work" under the
  17.  *  terms of the United States Copyright Act.  It was written as part of
  18.  *  the author's official duties as a United States Government employee and
  19.  *  thus cannot be copyrighted.  This software/database is freely available
  20.  *  to the public for use. The National Library of Medicine and the U.S.
  21.  *  Government have not placed any restriction on its use or reproduction.
  22.  *
  23.  *  Although all reasonable efforts have been taken to ensure the accuracy
  24.  *  and reliability of the software and data, the NLM and the U.S.
  25.  *  Government do not and cannot warrant the performance or results that
  26.  *  may be obtained by using this software or data. The NLM and the U.S.
  27.  *  Government disclaim all warranties, express or implied, including
  28.  *  warranties of performance, merchantability or fitness for any particular
  29.  *  purpose.
  30.  *
  31.  *  Please cite the author in any work or product based on this material.
  32.  *
  33.  * ===========================================================================
  34.  *
  35.  * Authors:  Andrey Yazhuk
  36.  *
  37.  * File Description:
  38.  */
  40. #include <ncbi_pch.hpp>
  41. #include <gui/widgets/fl/tooltip.hpp>
  42. #include <FL/fl_draw.H>
  43. #include <FL/forms.H>
  45. BEGIN_NCBI_SCOPE
  47. ////////////////////////////////////////////////////////////////////////////////
  48. /// CTooltip
  50. CTooltip::CTooltip()
  51. :   m_bActiveMode(false),
  52.     m_Mode(eHideOnMove),
  53.     m_Delay(0.8f),
  54.     m_bEnabled(true),
  55.     m_Widget(NULL), 
  56.     m_TooltipWidget(NULL),
  57.     m_bRecentTooltip(0),    
  58.     m_bRecursion(0)
  59. {
  60.     m_Color = fl_color_cube(FL_NUM_RED - 1, FL_NUM_GREEN - 1, FL_NUM_BLUE - 2);
  61.     m_TextColor = FL_BLACK;
  62.     m_Font = FL_HELVETICA;
  63.     m_FontSize = FL_SMALL_SIZE;
  65. }
  67. CTooltip::~CTooltip()
  68. {
  69.     Deactivate(true);
  71.     delete m_TooltipWidget;
  72. }
  74. void    CTooltip::SetMode(EMode mode)
  75. {
  76.     m_Mode = mode;
  77. }
  79. CTooltip::EMode   CTooltip::GetMode() const
  80. {
  81.     return m_Mode;
  82. }
  84. float CTooltip::GetDelay()  const   
  85. { 
  86.     return m_Delay; 
  87. }
  89. void  CTooltip::SetDelay(float delay) 
  90. { 
  91.     m_Delay = delay; 
  92. }
  94. int   CTooltip::IsEnabled()   const   
  95. { 
  96.     return m_bEnabled; 
  97. }
  99. void  CTooltip::Enable(bool b_en) 
  100. { 
  101.     m_bEnabled = b_en;
  102. }
  104. void  CTooltip::Disable() 
  105. { 
  106.     m_bEnabled = false; 
  107. }
  109. Fl_Widget* CTooltip::current() 
  110. { 
  111.     return m_Widget;    
  112. }
  114. int   CTooltip::GetFont()   const   
  115. { 
  116.     return m_Font; 
  117. }
  119. void  CTooltip::SetFont(int font) 
  120. { 
  121.     m_Font = font;     
  122. } 
  124. int   CTooltip::GetFontSize()   const   
  125. { 
  126.     return m_FontSize; 
  127. }  
  129. void  CTooltip::SetFontSize(int size) 
  130. { 
  131.     m_FontSize = size; 
  132. }
  134. void  CTooltip::SetColor(Fl_Color color)    
  135. { 
  136.     m_Color = color; 
  137. }
  139. Fl_Color CTooltip::GetColor()  const    
  140. { 
  141.     return m_Color; 
  142. }
  144. void CTooltip::SetTextColor(Fl_Color color) 
  145. { 
  146.     m_TextColor = color; 
  147. }
  149. Fl_Color  CTooltip::GetTextColor()  const 
  150. { 
  151.     return m_TextColor; 
  152. }
  154. const string&   CTooltip::GetText()   const
  155. {
  156.     return m_Text;
  157. }
  159. void    CTooltip::Activate(Fl_Widget* client, const string& text, int x, int y, int w, int h)
  160. {
  161.     _ASSERT(client);
  162.     _ASSERT(! m_bActiveMode);
  163.     
  164.     Fl::belowmouse(client);
  165.     x_Activate(client, x, y, w, h, text.c_str());
  166. }
  168. // hides tooltip
  169. void    CTooltip::Deactivate(bool b_reset)
  170. {
  171.     Fl::remove_timeout(ShowTooltipTimeout);
  173.     if(m_Widget  ||  x_IsTooltipVisible()) {
  174.         /// hide tooltip and remove timer callbacks
  175.         if(x_IsTooltipVisible())     {
  176.             m_TooltipWidget->hide();
  177.         }
  178.     
  179.         if(m_bRecentTooltip) { //needs to be reset
  180.             if(b_reset) {
  181.                 m_bRecentTooltip = 0;  // clear immediately
  182.             } else {
  183.                 Fl::add_timeout(.2f, ClearRecentTimeout, this); // clear after 0.2 sec
  184.             }
  185.         }
  187.         m_Widget = NULL;
  188.     }
  189. }
  191. bool    CTooltip::x_IsTooltipVisible()
  192. {
  193.     return m_TooltipWidget  &&  m_TooltipWidget->visible();
  194. }
  196. void  CTooltip::x_Activate(Fl_Widget* client, int x, int y, int w,int h, const string& text)
  197. {
  198.     _ASSERT(! m_bActiveMode);
  200.     if(IsEnabled()  &&  ! m_bRecursion) {
  201.         bool b_changed = client != m_Widget  ||  text != m_Text 
  202.                         ||  x != m_X  ||  y != m_Y 
  203.                         ||  w != m_W  ||  h != m_H;
  204.         bool b_pos_changed = (m_MouseX != Fl::event_x()  || m_MouseY != Fl::event_y());
  205.         bool b_active = m_TooltipWidget  && m_TooltipWidget->visible();
  207.         ETooltipCmd cmd = eDoNothing;
  209.         if(m_Mode == eHideOnMove)  {
  210.             if(!b_active  || b_changed  ||  b_pos_changed)  {
  211.                 cmd = eShowDelayed;
  212.             }
  213.         } else {
  214.             if(b_active)    {
  215.                 if(b_changed  ||  (m_Mode == eTrackOnMove  &&  b_pos_changed))   {
  216.                     cmd = eUpdateAndMove;
  217.                 }
  218.             } else {
  219.                 cmd = m_bRecentTooltip ? eUpdateAndMove : eShowDelayed;
  220.             }
  221.         }
  222.             
  223.         if(cmd != eDoNothing)   {
  224.             Fl::remove_timeout(ShowTooltipTimeout);
  225.             Fl::remove_timeout(ClearRecentTimeout);
  226.         
  227.             m_Widget = client; 
  228.                     
  229.             m_X = x; 
  230.             m_Y = y; 
  231.             m_W = w; 
  232.             m_H = h; 
  233.             m_MouseX = Fl::event_x();
  234.             m_MouseY = Fl::event_y();
  236.             m_Text = text;
  237.         }
  239.         switch(cmd)  {
  240.         case eUpdateAndMove: {
  241.             x_UpdateTooltipWidget(cmd); // show immediately
  242.         };  break;
  243.         case eShowDelayed: {
  244.             if(m_TooltipWidget  &&  m_TooltipWidget->visible())     {
  245.                 m_TooltipWidget->hide();            
  246.             }
  247.             Fl::add_timeout(m_Delay, ShowTooltipTimeout, this); // show after delay
  248.         }; break;
  249.         default: break;
  250.         }
  251.     }
  252. }
  254. // callback for "recent" timer - after specified delay cleans m_bRecentTooltip 
  255. void CTooltip::ClearRecentTimeout(void* ptr) 
  256. {
  257.     CTooltip* pTooltip = reinterpret_cast<CTooltip*>(ptr);
  258.     _ASSERT(pTooltip);
  260.     pTooltip->m_bRecentTooltip = 0;
  261. }
  263. // callback for "delay" timer
  264. void CTooltip::ShowTooltipTimeout(void* ptr) 
  265. {
  266.     CTooltip* pTooltip = reinterpret_cast<CTooltip*>(ptr);
  267.     _ASSERT(pTooltip);
  269.     if(pTooltip->m_bActiveMode)   { // ask the client and may be show tooltip
  270.         pTooltip->x_AskClientAndUpdate();
  271.     } else { // we know that tootlip must be shown
  272.         pTooltip->x_UpdateTooltipWidget(eShowDelayed);
  273.     }
  274. }
  276. bool    CTooltip::EnableActiveMode(ITooltipClient* client)
  277. {
  278.     if(client)  {
  279.         Deactivate(true);
  281.         m_IClient = client;
  282.         m_bActiveMode = true;
  283.         return true;
  284.     } else return false;
  285. }
  287. void    CTooltip::DisableActiveMode()
  288. {
  289.     if(m_bActiveMode)   {
  290.         Deactivate(true);
  291.         
  292.         m_bActiveMode  = false;
  293.     }
  294. }
  296. const static int    kMouseJump = 4; // max mouse travel between two events
  298. int     CTooltip::Handle(int event)
  299. {
  300.     switch(event)   {
  301.     case FL_MOVE:   {
  302.         if(m_bActiveMode)   {            
  303.             Fl_Widget* wid = dynamic_cast<Fl_Widget*>(m_IClient);
  304.             bool b_client_active = (Fl::belowmouse() == wid);
  305.             
  306.             int d_x = m_MouseX - Fl::event_x();
  307.             int d_y = m_MouseY - Fl::event_y();
  308.             bool jump = (d_x * d_x + d_y * d_y) > (kMouseJump * kMouseJump);
  309.             
  310.             m_MouseX = Fl::event_x();
  311.             m_MouseY = Fl::event_y();
  312.             
  313.             if(m_Mode == eHideOnMove  ||  jump)  { // hide and question client after delay
  314.                 Deactivate(true);
  315.                 if(b_client_active) {
  316.                     Fl::remove_timeout(ShowTooltipTimeout);        
  317.                     Fl::add_timeout(m_Delay, ShowTooltipTimeout, this);
  318.                 }
  319.             } else if(b_client_active)  {
  320.                 if(x_IsTooltipVisible()  ||  m_bRecentTooltip)    {
  321.                     x_AskClientAndUpdate();  // update immediately
  322.                 } else { // question client after delay
  323.                     Fl::add_timeout(m_Delay, ShowTooltipTimeout, this);
  324.                 }
  325.             }
  326.         }
  327.     }; break;
  328.     case FL_PUSH:   case FL_DRAG:   case FL_RELEASE:
  329.     case FL_UNFOCUS:
  330.     case FL_LEAVE:  {
  331.         Deactivate(true); 
  332.     }; break;
  333.     
  334.     }
  335.     return 0;
  336. }
  338. // shows tooltip 
  339. void CTooltip::x_UpdateTooltipWidget(ETooltipCmd cmd)
  340. {
  341.     if(! m_bRecursion)  {
  342.         m_bRecursion = 1;
  344.         if (! m_TooltipWidget) {
  345.             m_TooltipWidget = new CTooltipWidget(this);
  346.         }            
  347.         if(cmd == eShowDelayed  ||  cmd == eUpdateAndMove)  { 
  348.             // this cast bypasses the normal Fl_Window label() code:
  349.             ((Fl_Widget*)m_TooltipWidget)->label(m_Text.c_str());         
  350.             m_TooltipWidget->SetOrigin(Fl::event_x_root(), Fl::event_y_root());            
  351.         }
  352.         if(cmd != eDoNothing)   {
  353.             m_TooltipWidget->layout();
  354.         }
  356.         switch(cmd) {
  357.         case eUpdateAndMove:    {
  358.             if(m_TooltipWidget->visible())  {
  359.                 m_TooltipWidget->damage(1); 
  360.             } else {
  361.                 m_TooltipWidget->show();
  362.             };
  363.         }; break;         
  364.         case eShowDelayed:  {
  365.             m_TooltipWidget->show();
  366.         }; break;
  367.         default: break;
  368.         }
  369.         
  370.         Fl::remove_timeout(ClearRecentTimeout); // remove "recent" timer
  371.         m_bRecentTooltip = 1;
  372.         m_bRecursion = 0;
  373.     }
  374. }
  376. /// This functions queries the Client and shows tooltip if necessary. Funtion never
  377. /// delays showing (if function is called - delay have already elapsed)
  378. void    CTooltip::x_AskClientAndUpdate()
  379. {
  380.     if(m_IClient)   {
  381.         bool b_ok = m_IClient->TC_NeedTooltip(m_MouseX, m_MouseY);
  382.         if(b_ok)   { // show/update tooltip
  383.             int x = m_MouseX, y = m_MouseY, w = 1, h = 1;
  384.             string text = m_IClient->TC_GetTooltip(x, y, w, h);
  386.             bool b_changed = text != m_Text 
  387.                         ||  x != m_X  ||  y != m_Y ||  w != m_W  ||  h != m_H;
  388.                       
  389.             ETooltipCmd cmd = eDoNothing;
  390.             if(! x_IsTooltipVisible())  {
  391.                 cmd = eShowDelayed;
  392.             } else if(b_changed  ||  m_Mode == eTrackOnMove)    {
  393.                 cmd = eUpdateAndMove;
  394.             }
  395.             if(cmd != eDoNothing)   {
  396.                 m_Text = text;
  398.                 m_X = x; 
  399.                 m_Y = y; 
  400.                 m_W = w; 
  401.                 m_H = h;
  403.                 x_UpdateTooltipWidget(cmd);
  404.             }
  405.         } else Deactivate(false); // client doesn't want any tootlips
  406.     }
  407. }
  409. ////////////////////////////////////////////////////////////////////////////////
  410. /// CTooltipWidget
  412. const static int kSpaceX = 4;
  413. const static int kSpaceY = 2;
  415. const static int kOffsetY  = 24;
  417. CTooltipWidget::CTooltipWidget(CTooltip* tooltip)
  418. :   Fl_Menu_Window(0, 0),
  419.     m_Tooltip(tooltip)
  420. {
  421.     set_override();
  422.     end();
  424.     clear_flag(VISIBLE_FOCUS);
  425. }
  427. void    CTooltipWidget::SetOrigin(int x, int y)
  428. {
  429.     m_OrigX = x;
  430.     m_OrigY = y;
  431. }
  433. #define MAX_WIDTH 400
  434.     
  435. void    CTooltipWidget::layout() 
  436. {
  437.     fl_font(m_Tooltip->GetFont(), m_Tooltip->GetFontSize());
  439.     int width = MAX_WIDTH;
  440.     int height = 0;
  441.     fl_measure(m_Tooltip->GetText().c_str(), width, height, 
  442.                 FL_ALIGN_LEFT | FL_ALIGN_WRAP | FL_ALIGN_INSIDE);
  443.     width += 2 * kSpaceX; 
  444.     height += 2 * kSpaceY;
  446.     // horizontal positioning
  447.     int ox = m_OrigX;
  448.     
  449.     if(ox + width > Fl::w()) {
  450.         ox = Fl::w() - width;
  451.     }
  452.     if(ox < 0) 
  453.         ox = 0;
  454.     // vertical positioning
  455.     int oy = m_OrigY + kOffsetY;
  456.     if(oy + height > Fl::h())   {
  457.         oy = Fl::h() - height;
  458.     }
  459.     if(oy < 0 )     {
  460.         oy = 0;
  461.     }
  462.     if (oy < 0) {
  463.         oy = 0;
  464.     }
  465.     resize(ox, oy, width, height);
  466. }
  468. void CTooltipWidget::draw() 
  469. {
  470.   draw_box(FL_BORDER_BOX, 0, 0, w(), h(), m_Tooltip->GetColor());
  472.   fl_color(m_Tooltip->GetTextColor());
  473.   fl_font(m_Tooltip->GetFont(), m_Tooltip->GetFontSize());
  474.   fl_draw(m_Tooltip->GetText().c_str(), kSpaceX, kSpaceY, 
  475.           w() - 2* kSpaceX, h() - 2 * kSpaceY, 
  476.           Fl_Align(FL_ALIGN_LEFT | FL_ALIGN_WRAP | FL_ALIGN_INSIDE));
  477. }
  479. void    CTooltipWidget::show() 
  480. {
  481.     Fl_Menu_Window::show();
  482. }
  484. int     CTooltipWidget::handle(int event)
  485. {
  486.     switch(event)   {
  487.     case FL_FOCUS: return 0;
  488.     default: return Fl_Menu_Window::handle(event);
  489.     }
  490. }
  492. END_NCBI_SCOPE
  494. /*
  495.  * ===========================================================================
  496.  * $Log: tooltip.cpp,v $
  497.  * Revision 1000.1  2004/06/01 21:09:23  gouriano
  498.  * PRODUCTION: UPGRADED [GCC34_MSVC7] Dev-tree R1.10
  499.  *
  500.  * Revision 1.10  2004/05/21 22:27:53  gorelenk
  501.  * Added PCH ncbi_pch.hpp
  502.  *
  503.  * Revision 1.9  2004/05/13 17:20:48  yazhuk
  504.  * clean-up
  505.  *
  506.  * Revision 1.8  2004/05/03 19:49:28  yazhuk
  507.  * Hide tooltip if mouse moves too fast
  508.  *
  509.  * Revision 1.7  2004/04/22 16:59:10  yazhuk
  510.  * Clean-up
  511.  *
  512.  * Revision 1.6  2004/02/11 15:26:24  yazhuk
  513.  * Event handling fix
  514.  *
  515.  * Revision 1.5  2004/02/04 22:26:31  yazhuk
  516.  * Fixed event handling in active mode
  517.  *
  518.  * Revision 1.4  2004/01/27 18:48:23  dicuccio
  519.  * Added call to DisableActiveMode() in destructor.  Make Deactivate() always
  520.  * remove timeouts
  521.  *
  522.  * Revision 1.3  2004/01/21 14:23:20  rsmith
  523.  * Remove debug output statement.
  524.  *
  525.  * Revision 1.2  2004/01/08 19:45:16  yazhuk
  526.  * Implemented "active" tooltips, refactored code, added comments
  527.  *
  528.  * Revision 1.1  2003/12/29 21:12:22  yazhuk
  529.  * Initial revision
  530.  *
  531.  * ===========================================================================
  532.  */