]>
Commit | Line | Data |
---|---|---|
1 | /////////////////////////////////////////////////////////////////////////////// | |
2 | // Name: wx/msw/tooltip.h | |
3 | // Purpose: wxToolTip class - tooltip control | |
4 | // Author: Vadim Zeitlin | |
5 | // Modified by: | |
6 | // Created: 31.01.99 | |
7 | // RCS-ID: $Id$ | |
8 | // Copyright: (c) 1999 Robert Roebling, Vadim Zeitlin | |
9 | // Licence: wxWindows licence | |
10 | /////////////////////////////////////////////////////////////////////////////// | |
11 | ||
12 | #ifndef _WX_MSW_TOOLTIP_H_ | |
13 | #define _WX_MSW_TOOLTIP_H_ | |
14 | ||
15 | #include "wx/object.h" | |
16 | ||
17 | class WXDLLIMPEXP_FWD_CORE wxWindow; | |
18 | ||
19 | class WXDLLEXPORT wxToolTip : public wxObject | |
20 | { | |
21 | public: | |
22 | // ctor & dtor | |
23 | wxToolTip(const wxString &tip); | |
24 | virtual ~wxToolTip(); | |
25 | ||
26 | // accessors | |
27 | // tip text | |
28 | void SetTip(const wxString& tip); | |
29 | const wxString& GetTip() const { return m_text; } | |
30 | ||
31 | // the window we're associated with | |
32 | void SetWindow(wxWindow *win); | |
33 | wxWindow *GetWindow() const { return m_window; } | |
34 | ||
35 | // controlling tooltip behaviour: globally change tooltip parameters | |
36 | // enable or disable the tooltips globally | |
37 | static void Enable(bool flag); | |
38 | // set the delay after which the tooltip appears | |
39 | static void SetDelay(long milliseconds); | |
40 | // set the delay after which the tooltip disappears or how long the tooltip remains visible | |
41 | static void SetAutoPop(long milliseconds); | |
42 | // set the delay between subsequent tooltips to appear | |
43 | static void SetReshow(long milliseconds); | |
44 | ||
45 | // implementation only from now on | |
46 | // ------------------------------- | |
47 | ||
48 | // should be called in responde to WM_MOUSEMOVE | |
49 | static void RelayEvent(WXMSG *msg); | |
50 | ||
51 | // add a window to the tooltip control | |
52 | void Add(WXHWND hwnd); | |
53 | ||
54 | // remove any tooltip from the window | |
55 | static void Remove(WXHWND hwnd); | |
56 | ||
57 | private: | |
58 | // the one and only one tooltip control we use - never access it directly | |
59 | // but use GetToolTipCtrl() which will create it when needed | |
60 | static WXHWND ms_hwndTT; | |
61 | ||
62 | // create the tooltip ctrl if it doesn't exist yet and return its HWND | |
63 | static WXHWND GetToolTipCtrl(); | |
64 | ||
65 | // remove this tooltip from the tooltip control | |
66 | void Remove(); | |
67 | ||
68 | wxString m_text; // tooltip text | |
69 | wxWindow *m_window; // window we're associated with | |
70 | ||
71 | DECLARE_ABSTRACT_CLASS(wxToolTip) | |
72 | DECLARE_NO_COPY_CLASS(wxToolTip) | |
73 | }; | |
74 | ||
75 | #endif // _WX_MSW_TOOLTIP_H_ |