use wx-style header and commets; fix indentation to be 4 spaces; move Doxygen comment...

[wxWidgets.git] / src / mac / carbon / tooltip.cpp

diff --git a/src/mac/carbon/tooltip.cpp b/src/mac/carbon/tooltip.cpp
index 4b00c6f7500684f1761436796ea04c56cd0ca717..957feb0491c6f0194b21f7b18b3ae4b721f0724b 100644 (file)
--- a/src/mac/carbon/tooltip.cpp
+++ b/src/mac/carbon/tooltip.cpp
@@ -1,25 +1,25 @@
 /////////////////////////////////////////////////////////////////////////////
 /////////////////////////////////////////////////////////////////////////////

-// Name:        tooltip.cpp
+// Name:        src/mac/carbon/tooltip.cpp

 // Purpose:     wxToolTip implementation
 // Purpose:     wxToolTip implementation

-// Author:      Robert Roebling
+// Author:      Stefan Csomor

 // Id:          $Id$
 // Id:          $Id$

-// Copyright:   (c) 1998 Robert Roebling
+// Copyright:   (c) Stefan Csomor

 // Licence:     wxWindows licence
 /////////////////////////////////////////////////////////////////////////////
 
 // Licence:     wxWindows licence
 /////////////////////////////////////////////////////////////////////////////
 

-#ifdef __GNUG__
-    #pragma implementation "tooltip.h"
-#endif
-
-#include "wx/defs.h"
+#include "wx/wxprec.h"

 
 #if wxUSE_TOOLTIPS
 
 
 #if wxUSE_TOOLTIPS
 

-#include "wx/app.h"
-#include "wx/dc.h"
-#include "wx/window.h"

 #include "wx/tooltip.h"
 #include "wx/tooltip.h"

-#include "wx/timer.h"
+
+#ifndef WX_PRECOMP
+    #include "wx/app.h"
+    #include "wx/window.h"
+    #include "wx/dc.h"
+    #include "wx/timer.h"
+#endif // WX_PRECOMP
+

 #include "wx/geometry.h"
 #include "wx/mac/uma.h"
 
 #include "wx/geometry.h"
 #include "wx/mac/uma.h"
 


@@ -27,49 +27,25 @@
 // global data
 //-----------------------------------------------------------------------------
 
 // global data
 //-----------------------------------------------------------------------------
 

-class wxMacToolTipTimer ;
-
-class wxMacToolTip
-{
-    public :
-        wxMacToolTip( ) ;
-        ~wxMacToolTip() ;
-        
-        void            Setup( WindowRef window  , wxString text , wxPoint localPosition ) ;
-        long            GetMark() { return m_mark ; }
-        void             Draw() ;
-        void            Clear() ;
-        bool            IsShown() { return m_shown  ; }
-    private :
-        
-        wxString    m_label ;
-        wxPoint m_position ;
-        Rect            m_rect ;
-        WindowRef    m_window ;    
-        PicHandle    m_backpict ;
-        bool        m_shown ;
-        long        m_mark ;
-        wxMacToolTipTimer* m_timer ;
-#ifdef TARGET_CARBON
-        CFStringRef m_helpTextRef ;
-#endif
-} ;
-
+#if wxUSE_TIMER

 class wxMacToolTipTimer : public wxTimer
 {
 public:
 class wxMacToolTipTimer : public wxTimer
 {
 public:

-    wxMacToolTipTimer() {} ;

     wxMacToolTipTimer(wxMacToolTip* tip, int iMilliseconds) ;
     wxMacToolTipTimer(wxMacToolTip* tip, int iMilliseconds) ;

+    wxMacToolTipTimer() {} ;

     virtual ~wxMacToolTipTimer() {} ;
     virtual ~wxMacToolTipTimer() {} ;

+

     void Notify()
     {
         if ( m_mark == m_tip->GetMark() )
     void Notify()
     {
         if ( m_mark == m_tip->GetMark() )

-            m_tip->Draw() ;    
+            m_tip->Draw() ;

     }
     }

+

 protected:
     wxMacToolTip*     m_tip;
     long        m_mark ;
 };
 protected:
     wxMacToolTip*     m_tip;
     long        m_mark ;
 };

+#endif // wxUSE_TIMER

 
 //-----------------------------------------------------------------------------
 // wxToolTip
 
 //-----------------------------------------------------------------------------
 // wxToolTip


@@ -83,6 +59,7 @@ static WindowRef s_ToolTipWindowRef = NULL ;
 
 IMPLEMENT_ABSTRACT_CLASS(wxToolTip, wxObject)
 
 
 IMPLEMENT_ABSTRACT_CLASS(wxToolTip, wxObject)
 

+

 wxToolTip::wxToolTip( const wxString &tip )
 {
     m_text = tip;
 wxToolTip::wxToolTip( const wxString &tip )
 {
     m_text = tip;


@@ -96,16 +73,16 @@ wxToolTip::~wxToolTip()
 void wxToolTip::SetTip( const wxString &tip )
 {
     m_text = tip;
 void wxToolTip::SetTip( const wxString &tip )
 {
     m_text = tip;

-    
+

     if ( m_window )
     {
     if ( m_window )
     {

-    /*
+#if 0

     // update it immediately
     wxToolInfo ti(GetHwndOf(m_window));
     ti.lpszText = (wxChar *)m_text.c_str();
     // update it immediately
     wxToolInfo ti(GetHwndOf(m_window));
     ti.lpszText = (wxChar *)m_text.c_str();

-    
-      (void)SendTooltipMessage(GetToolTipCtrl(), TTM_UPDATETIPTEXT, 0, &ti);
-        */
+
+    (void)SendTooltipMessage(GetToolTipCtrl(), TTM_UPDATETIPTEXT, 0, &ti);
+#endif

     }
 }
 
     }
 }
 


@@ -119,6 +96,7 @@ void wxToolTip::Enable( bool flag )
     if ( s_ShowToolTips != flag )
     {
         s_ShowToolTips = flag ;
     if ( s_ShowToolTips != flag )
     {
         s_ShowToolTips = flag ;

+

         if ( s_ShowToolTips )
         {
         }
         if ( s_ShowToolTips )
         {
         }


@@ -134,6 +112,14 @@ void wxToolTip::SetDelay( long msecs )
     s_ToolTipDelay = msecs ;
 }
 
     s_ToolTipDelay = msecs ;
 }
 

+void wxToolTip::SetAutoPop( long WXUNUSED(msecs) )
+{
+}
+
+void wxToolTip::SetReshow( long WXUNUSED(msecs) )
+{
+}
+

 void wxToolTip::RelayEvent( wxWindow *win , wxMouseEvent &event )
 {
     if ( s_ShowToolTips )
 void wxToolTip::RelayEvent( wxWindow *win , wxMouseEvent &event )
 {
     if ( s_ShowToolTips )


@@ -153,8 +139,8 @@ void wxToolTip::RelayEvent( wxWindow *win , wxMouseEvent &event )
                 s_ToolTip.Clear() ;
                 s_ToolTipArea = wxRect2DInt( event.m_x - 2 , event.m_y - 2 , 4 , 4 ) ;
                 s_LastWindowEntered = win ;
                 s_ToolTip.Clear() ;
                 s_ToolTipArea = wxRect2DInt( event.m_x - 2 , event.m_y - 2 , 4 , 4 ) ;
                 s_LastWindowEntered = win ;

-                
-                WindowRef window = MAC_WXHWND( win->MacGetRootWindow() ) ;
+
+                WindowRef window = MAC_WXHWND( win->MacGetTopLevelWindowRef() ) ;

                 int x = event.m_x ;
                 int y = event.m_y ;
                 wxPoint local( x , y ) ;
                 int x = event.m_x ;
                 int y = event.m_y ;
                 wxPoint local( x , y ) ;


@@ -170,49 +156,56 @@ void wxToolTip::RemoveToolTips()
 {
     s_ToolTip.Clear() ;
 }
 {
     s_ToolTip.Clear() ;
 }

-// --- mac specific

 
 

+// --- mac specific
+#if wxUSE_TIMER 

 wxMacToolTipTimer::wxMacToolTipTimer( wxMacToolTip *tip , int msec )
 {
     m_tip = tip;
     m_mark = tip->GetMark() ;
     Start(msec, true);
 }
 wxMacToolTipTimer::wxMacToolTipTimer( wxMacToolTip *tip , int msec )
 {
     m_tip = tip;
     m_mark = tip->GetMark() ;
     Start(msec, true);
 }

+#endif // wxUSE_TIMER

 
 wxMacToolTip::wxMacToolTip()
 {
     m_window = NULL ;
     m_backpict = NULL ;
 
 wxMacToolTip::wxMacToolTip()
 {
     m_window = NULL ;
     m_backpict = NULL ;

+#if wxUSE_TIMER 
+    m_timer = NULL ;
+#endif

     m_mark = 0 ;
     m_shown = false ;
     m_mark = 0 ;
     m_shown = false ;

-    m_timer = NULL ;
-    m_helpTextRef = NULL ;

 }
 
 }
 

-void wxMacToolTip::Setup( WindowRef win  , wxString text , wxPoint localPosition ) 
+void wxMacToolTip::Setup( WindowRef win  , const wxString& text , const wxPoint& localPosition )

 {
     m_mark++ ;
 {
     m_mark++ ;

+

     Clear() ;
     m_position = localPosition ;
     Clear() ;
     m_position = localPosition ;

-    if( wxApp::s_macDefaultEncodingIsPC )
-        m_label = wxMacMakeMacStringFromPC( text ) ;
-     else
-        m_label = text ;
+    m_label = text ;

     m_window =win;
     s_ToolTipWindowRef = m_window ;
     m_backpict = NULL ;
     m_window =win;
     s_ToolTipWindowRef = m_window ;
     m_backpict = NULL ;

+#if wxUSE_TIMER 

     if ( m_timer )
         delete m_timer ;
     if ( m_timer )
         delete m_timer ;

+

     m_timer = new wxMacToolTipTimer( this , s_ToolTipDelay ) ;
     m_timer = new wxMacToolTipTimer( this , s_ToolTipDelay ) ;

+#endif // wxUSE_TIMER

 }
 
 }
 

-wxMacToolTip::~wxMacToolTip() 
+wxMacToolTip::~wxMacToolTip()

 {
 {

-    if ( m_timer ) {
+#if wxUSE_TIMER 
+    if ( m_timer )
+    {

         delete m_timer ;
         m_timer = NULL;
     }
         delete m_timer ;
         m_timer = NULL;
     }

-    if ( m_backpict ) 
+#endif // wxUSE_TIMER
+    if ( m_backpict )

         Clear() ;
 }
 
         Clear() ;
 }
 


@@ -221,259 +214,50 @@ const short kTipOffset = 5 ;
 
 void wxMacToolTip::Draw()
 {
 
 void wxMacToolTip::Draw()
 {

-    if ( m_label.Length() == 0 )
+    if ( m_label.empty() )

         return ;
         return ;

-    
+

     if ( m_window == s_ToolTipWindowRef )
     {
         m_shown = true ;
     if ( m_window == s_ToolTipWindowRef )
     {
         m_shown = true ;

-#if TARGET_CARBON
-        if ( HMDisplayTag != (void*) kUnresolvedCFragSymbolAddress )
-        {
-            HMHelpContentRec tag ;
-            tag.version = kMacHelpVersion;
-            SetRect( &tag.absHotRect , m_position.x - 2 , m_position.y - 2 , m_position.x + 2 , m_position.y + 2 ) ;
-            GrafPtr port ;
-            GetPort( &port ) ;
-            SetPortWindowPort(m_window) ;
-            LocalToGlobal( (Point *) &tag.absHotRect.top );
-            LocalToGlobal( (Point *) &tag.absHotRect.bottom );
-            SetPort( port );
-            if( m_helpTextRef )
-            {
-                CFRelease( m_helpTextRef ) ;
-                m_helpTextRef = NULL ;
-            }
-            m_helpTextRef = wxMacCreateCFString(m_label) ;
-            tag.content[kHMMinimumContentIndex].contentType = kHMCFStringContent ;
-            tag.content[kHMMinimumContentIndex].u.tagCFString = m_helpTextRef ;
-            tag.content[kHMMaximumContentIndex].contentType = kHMCFStringContent ;
-            tag.content[kHMMaximumContentIndex].u.tagCFString = m_helpTextRef ;
-            tag.tagSide = kHMDefaultSide;
-            HMDisplayTag( &tag );
-        }
-        else
-#endif
-        {
-            wxMacPortStateHelper help( (GrafPtr) GetWindowPort( m_window ) );
-#if TARGET_CARBON    
-            bool useDrawThemeText =  ( DrawThemeTextBox != (void*) kUnresolvedCFragSymbolAddress ) ;
-#endif        
-            
-            FontFamilyID fontId ;
-            Str255 fontName ;
-            SInt16 fontSize ;
-            Style fontStyle ;
-            GetThemeFont(kThemeSmallSystemFont , GetApplicationScript() , fontName , &fontSize , &fontStyle ) ;
-            GetFNum( fontName, &fontId );
-            
-            TextFont( fontId ) ;
-            TextSize( fontSize ) ;
-            TextFace( fontStyle ) ;
-            FontInfo fontInfo;
-            ::GetFontInfo(&fontInfo);
-            short lineh = fontInfo.ascent + fontInfo.descent + fontInfo.leading;
-            short height = 0 ;
-            //    short width = TextWidth( m_label , 0 ,m_label.Length() ) ;
-            
-            int i = 0 ;
-            int length = m_label.Length() ;
-            int width = 0 ;
-            int thiswidth = 0 ;
-            int laststop = 0 ;
-            const char *text = m_label ;
-            while( i < length )
-            {
-                if( text[i] == 13 || text[i] == 10)
-                {
-                    thiswidth = ::TextWidth( text , laststop , i - laststop ) ;
-                    if ( thiswidth > width )
-                        width = thiswidth ;
-                    
-                    height += lineh ;
-                    laststop = i+1 ;
-                }
-                i++ ;
-            }
-            if ( i - laststop > 0 )
-            {
-                thiswidth = ::TextWidth( text , laststop , i - laststop ) ;
-                if ( thiswidth > width )
-                    width = thiswidth ;
-                height += lineh ;
-            }
-            
-            
-            m_rect.left = m_position.x + kTipOffset;
-            m_rect.top = m_position.y + kTipOffset;
-            m_rect.right = m_rect.left + width + 2 * kTipBorder;
-#if TARGET_CARBON    
-            if ( useDrawThemeText )
-                m_rect.right += kTipBorder ;
-#endif
-            m_rect.bottom = m_rect.top + height + 2 * kTipBorder;
-            Rect r ;
-            GetPortBounds( GetWindowPort( m_window ) , &r ) ;
-            if ( m_rect.top < 0 )
-            {
-                m_rect.bottom += -m_rect.top ;
-                m_rect.top = 0 ;
-            }
-            if ( m_rect.left < 0 )
-            {
-                m_rect.right += -m_rect.left ;
-                m_rect.left = 0 ;
-            }
-            if ( m_rect.right > r.right )
-            {
-                m_rect.left -= (m_rect.right - r.right ) ;
-                m_rect.right = r.right ;
-            }
-            if ( m_rect.bottom > r.bottom )
-            {
-                m_rect.top -= (m_rect.bottom - r.bottom) ;
-                m_rect.bottom = r.bottom ;
-            }
-            ClipRect( &m_rect ) ;
-            BackColor( whiteColor ) ;
-            ForeColor(blackColor ) ;
-            GWorldPtr port ;            
-            NewGWorld( &port , wxDisplayDepth() , &m_rect , NULL , NULL , 0 ) ;
-            CGrafPtr    origPort ;
-            GDHandle    origDevice ;
-            
-            GetGWorld( &origPort , &origDevice ) ;
-            SetGWorld( port , NULL ) ;
-            
-            m_backpict = OpenPicture(&m_rect);
-            
-            CopyBits(GetPortBitMapForCopyBits(GetWindowPort(m_window)), 
-                GetPortBitMapForCopyBits(port), 
-                &m_rect, 
-                &m_rect, 
-                srcCopy, 
-                NULL);
-            ClosePicture();
-            SetGWorld( origPort , origDevice ) ;
-            DisposeGWorld( port ) ;
-            PenNormal() ;
-            
-            RGBColor tooltipbackground = { 0xFFFF , 0xFFFF , 0xC000 } ;
-            BackColor( whiteColor ) ;
-            RGBForeColor( &tooltipbackground ) ;
-            
-            PaintRect( &m_rect ) ;
-            ForeColor(blackColor ) ;
-            FrameRect( &m_rect ) ;
-            SetThemeTextColor(kThemeTextColorNotification,wxDisplayDepth(),true) ;
-            ::MoveTo( m_rect.left + kTipBorder , m_rect.top + fontInfo.ascent + kTipBorder);
-            
-            i = 0 ;
-            laststop = 0 ;
-            height = 0 ;
-            
-            while( i < length )
-            {
-                if( text[i] == 13 || text[i] == 10)
-                {
-#if TARGET_CARBON
-                    if ( useDrawThemeText )
-                    {
-                        Rect frame ;
-                        frame.top = m_rect.top + kTipBorder + height ;
-                        frame.left = m_rect.left + kTipBorder ;
-                        frame.bottom = frame.top + 1000 ;
-                        frame.right = frame.left + 1000 ;
-                        CFStringRef mString = CFStringCreateWithBytes( NULL , (UInt8*) text + laststop , i - laststop , CFStringGetSystemEncoding(), false ) ;
-                        ::DrawThemeTextBox( mString,
-                            kThemeCurrentPortFont,
-                            kThemeStateActive,
-                            true,
-                            &frame,
-                            teJustLeft,
-                            nil );
-                        CFRelease( mString ) ;
-                        height += lineh ;
-                    }
-                    else
-#endif
-                    {
-                        ::DrawText( text , laststop , i - laststop ) ;
-                        height += lineh ;
-                        ::MoveTo( m_rect.left + kTipBorder , m_rect.top + fontInfo.ascent + kTipBorder + height );
-                    }
-                    laststop = i+1 ;
-                }
-                i++ ;
-            }
-#if TARGET_CARBON
-            if ( useDrawThemeText )
-            {
-                Rect frame ;
-                frame.top = m_rect.top + kTipBorder + height ;
-                frame.left = m_rect.left + kTipBorder ;
-                frame.bottom = frame.top + 1000 ;
-                frame.right = frame.left + 1000 ;
-                CFStringRef mString = CFStringCreateWithCString( NULL , text + laststop , kCFStringEncodingMacRoman ) ;
-                ::DrawThemeTextBox( mString,
-                    kThemeCurrentPortFont,
-                    kThemeStateActive,
-                    true,
-                    &frame,
-                    teJustLeft,
-                    nil );
-                CFRelease( mString ) ;
-            }
-            else
-#endif
-            {
-                ::DrawText( text , laststop , i - laststop ) ;
-            }
-            ::TextMode( srcOr ) ;        
-       }
+
+        HMHelpContentRec tag ;
+        tag.version = kMacHelpVersion;
+
+        Point p = { m_position.y , m_position.x };
+        wxMacLocalToGlobal( m_window , &p ) ;
+        SetRect( &tag.absHotRect , p.h - 2 , p.v - 2 , p.h + 2 , p.v + 2 );
+
+        m_helpTextRef = wxCFStringRef( m_label , wxFONTENCODING_DEFAULT ) ;
+        tag.content[kHMMinimumContentIndex].contentType = kHMCFStringContent ;
+        tag.content[kHMMinimumContentIndex].u.tagCFString = m_helpTextRef ;
+        tag.content[kHMMaximumContentIndex].contentType = kHMCFStringContent ;
+        tag.content[kHMMaximumContentIndex].u.tagCFString = m_helpTextRef ;
+        tag.tagSide = kHMDefaultSide;
+        HMDisplayTag( &tag );

     }
 }
 
     }
 }
 

-void wxToolTip::NotifyWindowDelete( WXHWND win ) 
+void wxToolTip::NotifyWindowDelete( WXHWND win )

 {
     if ( win == s_ToolTipWindowRef )
 {
     if ( win == s_ToolTipWindowRef )

-    {

         s_ToolTipWindowRef = NULL ;
         s_ToolTipWindowRef = NULL ;

-    }

 }
 
 void wxMacToolTip::Clear()
 {
     m_mark++ ;
 }
 
 void wxMacToolTip::Clear()
 {
     m_mark++ ;

+#if wxUSE_TIMER 

     if ( m_timer )
     {
         delete m_timer ;
         m_timer = NULL ;
     }
     if ( m_timer )
     {
         delete m_timer ;
         m_timer = NULL ;
     }

+#endif // wxUSE_TIMER

     if ( !m_shown )
         return ;
     if ( !m_shown )
         return ;

-#if TARGET_CARBON
-    HMHideTag() ;
-    if( m_helpTextRef )
-    {
-        CFRelease( m_helpTextRef ) ;
-        m_helpTextRef = NULL ;
-    }
-#else         
-    if ( m_window == s_ToolTipWindowRef && m_backpict )
-    {
-        wxMacPortStateHelper help( (GrafPtr) GetWindowPort(m_window) ) ;

 
 

-        m_shown = false ;
-
-        BackColor( whiteColor ) ;
-        ForeColor(blackColor ) ;
-        DrawPicture(m_backpict, &m_rect);
-        KillPicture(m_backpict);
-        m_backpict = NULL ;
-    }
-#endif
+    HMHideTag() ;

 }
 
 }
 

-#endif
-
+#endif // wxUSE_TOOLTIPS