added fix for MSL under Win32 (by Steve Hartwell)

[wxWidgets.git] / include / wx / tipdlg.h

diff --git a/include/wx/tipdlg.h b/include/wx/tipdlg.h
index 594eb151b4dd4355d441f01ebb3a366ba2cf37fd..97c53eeb24ef407b8ee935b83327a302ff612748 100644 (file)
--- a/include/wx/tipdlg.h
+++ b/include/wx/tipdlg.h
@@ -12,7 +12,7 @@
 #ifndef _WX_TIPDLG_H_
 #define _WX_TIPDLG_H_
 
 #ifndef _WX_TIPDLG_H_
 #define _WX_TIPDLG_H_
 

-#if defined(__GNUG__) && !defined(__APPLE__)
+#if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)

     #pragma interface "tipdlg.h"
 #endif
 
     #pragma interface "tipdlg.h"
 #endif
 


@@ -36,19 +36,24 @@
 // wxTipProvider evidently needs some internal state which is the tip "index"
 // and which should be saved/restored by the program to not always show one and
 // the same tip (of course, you may use random starting position as well...)
 // wxTipProvider evidently needs some internal state which is the tip "index"
 // and which should be saved/restored by the program to not always show one and
 // the same tip (of course, you may use random starting position as well...)

-class WXDLLEXPORT wxTipProvider
+class WXDLLIMPEXP_ADV wxTipProvider

 {
 public:
     wxTipProvider(size_t currentTip) { m_currentTip = currentTip; }
 
     // get the current tip and update the internal state to return the next tip
     // when called for the next time
 {
 public:
     wxTipProvider(size_t currentTip) { m_currentTip = currentTip; }
 
     // get the current tip and update the internal state to return the next tip
     // when called for the next time

-    virtual wxString GetTip() = 0;
+    virtual wxString GetTip() = 0;  

 
     // get the current tip "index" (or whatever allows the tip provider to know
     // from where to start the next time)
     size_t GetCurrentTip() const { return m_currentTip; }
 
 
     // get the current tip "index" (or whatever allows the tip provider to know
     // from where to start the next time)
     size_t GetCurrentTip() const { return m_currentTip; }
 

+    // Allows any user-derived class to optionally override this function to 
+    // modify the tip as soon as it is read. If return wxEmptyString, then 
+    // the tip is skipped, and the next one is read.
+    virtual wxString PreprocessTip(const wxString& tip) { return tip; }
+

     // virtual dtor for the base class
     virtual ~wxTipProvider() { }
 
     // virtual dtor for the base class
     virtual ~wxTipProvider() { }
 


@@ -60,8 +65,8 @@ protected:
 // specified text file as the source of tips (each line is a tip).
 //
 // NB: the caller is responsible for deleting the pointer!
 // specified text file as the source of tips (each line is a tip).
 //
 // NB: the caller is responsible for deleting the pointer!

-WXDLLEXPORT wxTipProvider *wxCreateFileTipProvider(const wxString& filename,
-                                                   size_t currentTip);
+WXDLLIMPEXP_ADV wxTipProvider *wxCreateFileTipProvider(const wxString& filename,
+                                                       size_t currentTip);

 
 // ----------------------------------------------------------------------------
 // wxTipDialog
 
 // ----------------------------------------------------------------------------
 // wxTipDialog


@@ -74,9 +79,9 @@ WXDLLEXPORT wxTipProvider *wxCreateFileTipProvider(const wxString& filename,
 // not, the dialog on startup depending on its value, not this class).
 //
 // The function returns TRUE if this checkbox is checked, FALSE otherwise.
 // not, the dialog on startup depending on its value, not this class).
 //
 // The function returns TRUE if this checkbox is checked, FALSE otherwise.

-WXDLLEXPORT bool wxShowTip(wxWindow *parent,
-                           wxTipProvider *tipProvider,
-                           bool showAtStartup = TRUE);
+WXDLLIMPEXP_ADV bool wxShowTip(wxWindow *parent,
+                               wxTipProvider *tipProvider,
+                               bool showAtStartup = TRUE);

 
 #endif // wxUSE_STARTUP_TIPS
 
 
 #endif // wxUSE_STARTUP_TIPS