]> git.saurik.com Git - wxWidgets.git/blame - src/generic/tipdlg.cpp
no_rtti fix was not having correct eval order
[wxWidgets.git] / src / generic / tipdlg.cpp
CommitLineData
c50f1fb9
VZ
1///////////////////////////////////////////////////////////////////////////////
2// Name: tipdlg.cpp
3// Purpose: implementation of wxTipDialog
4// Author: Vadim Zeitlin
5// Modified by:
6// Created: 28.06.99
7// RCS-ID: $Id$
8// Copyright: (c) Vadim Zeitlin
65571936 9// Licence: wxWindows licence
c50f1fb9
VZ
10///////////////////////////////////////////////////////////////////////////////
11
12// ============================================================================
13// declarations
14// ============================================================================
15
16// ----------------------------------------------------------------------------
17// headers
18// ----------------------------------------------------------------------------
19
14f355c2 20#if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
dfe1eee3 21 #pragma implementation "tipdlg.h"
c50f1fb9
VZ
22#endif
23
24// For compilers that support precompilation, includes "wx.h".
25#include "wx/wxprec.h"
26
27#ifdef __BORLANDC__
28 #pragma hdrstop
29#endif
30
31#if wxUSE_STARTUP_TIPS
32
33#ifndef WX_PRECOMP
34 #include "wx/button.h"
35 #include "wx/checkbox.h"
36 #include "wx/statbox.h"
c50f1fb9 37 #include "wx/dialog.h"
dfe1eee3
VZ
38 #include "wx/icon.h"
39 #include "wx/intl.h"
dfe1eee3 40 #include "wx/textctrl.h"
3bb0b01c 41 #include "wx/statbmp.h"
9c884972 42 #include "wx/stattext.h"
92afa2b1 43 #include "wx/sizer.h"
c50f1fb9
VZ
44#endif // WX_PRECOMP
45
46#include "wx/statline.h"
91f43f15 47#include "wx/artprov.h"
94f53923 48#include "wx/settings.h"
c50f1fb9
VZ
49
50#include "wx/tipdlg.h"
51
52// ----------------------------------------------------------------------------
53// constants
54// ----------------------------------------------------------------------------
55
d8d18184 56static const int wxID_NEXT_TIP = 32000; // whatever
c50f1fb9 57
8b3d02a1
WS
58// ---------------------------------------------------------------------------
59// macros
60// ---------------------------------------------------------------------------
61
62/* Macro for avoiding #ifdefs when value have to be different depending on size of
9a357011 63 device we display on - take it from something like wxDesktopPolicy in the future
8b3d02a1
WS
64 */
65
66#if defined(__SMARTPHONE__)
67 #define wxLARGESMALL(large,small) small
68#else
69 #define wxLARGESMALL(large,small) large
70#endif
71
c50f1fb9
VZ
72// ----------------------------------------------------------------------------
73// private classes
74// ----------------------------------------------------------------------------
75
76// an implementation which takes the tips from the text file - each line
77// represents a tip
12f190b0 78class WXDLLIMPEXP_ADV wxFileTipProvider : public wxTipProvider
c50f1fb9
VZ
79{
80public:
81 wxFileTipProvider(const wxString& filename, size_t currentTip);
82
83 virtual wxString GetTip();
84
85private:
86 wxTextFile m_textfile;
fc7a2a60
VZ
87
88 DECLARE_NO_COPY_CLASS(wxFileTipProvider)
c50f1fb9
VZ
89};
90
91#ifdef __WIN32__
92// TODO an implementation which takes the tips from the given registry key
12f190b0 93class WXDLLIMPEXP_ADV wxRegTipProvider : public wxTipProvider
c50f1fb9
VZ
94{
95public:
96 wxRegTipProvider(const wxString& keyname);
97
98 virtual wxString GetTip();
99};
06d7fdef
RD
100
101// Empty implementation for now to keep the linker happy
102wxString wxRegTipProvider::GetTip()
103{
abceee76 104 return wxEmptyString;
06d7fdef
RD
105}
106
c50f1fb9
VZ
107#endif // __WIN32__
108
109// the dialog we show in wxShowTip()
12f190b0 110class WXDLLIMPEXP_ADV wxTipDialog : public wxDialog
c50f1fb9
VZ
111{
112public:
113 wxTipDialog(wxWindow *parent,
114 wxTipProvider *tipProvider,
115 bool showAtStartup);
116
dabbc6a5 117 // the tip dialog has "Show tips on startup" checkbox - return true if it
c50f1fb9
VZ
118 // was checked (or wasn't unchecked)
119 bool ShowTipsOnStartup() const { return m_checkbox->GetValue(); }
120
121 // sets the (next) tip text
122 void SetTipText() { m_text->SetValue(m_tipProvider->GetTip()); }
123
124 // "Next" button handler
125 void OnNextTip(wxCommandEvent& WXUNUSED(event)) { SetTipText(); }
126
127private:
128 wxTipProvider *m_tipProvider;
129
130 wxTextCtrl *m_text;
131 wxCheckBox *m_checkbox;
132
133 DECLARE_EVENT_TABLE()
22f3361e 134 DECLARE_NO_COPY_CLASS(wxTipDialog)
c50f1fb9
VZ
135};
136
137// ============================================================================
138// implementation
139// ============================================================================
140
141// ----------------------------------------------------------------------------
142// wxFileTipProvider
143// ----------------------------------------------------------------------------
144
145wxFileTipProvider::wxFileTipProvider(const wxString& filename,
146 size_t currentTip)
147 : wxTipProvider(currentTip), m_textfile(filename)
148{
149 m_textfile.Open();
150}
151
152wxString wxFileTipProvider::GetTip()
153{
154 size_t count = m_textfile.GetLineCount();
155 if ( !count )
c50f1fb9 156 {
70373b5a 157 return _("Tips not available, sorry!");
c50f1fb9 158 }
dabbc6a5 159
70373b5a
JS
160 wxString tip;
161
162 // Comments start with a # symbol.
163 // Loop reading lines until get the first one that isn't a comment.
dabbc6a5
DS
164 // The max number of loop executions is the number of lines in the
165 // textfile so that can't go into an eternal loop in the [oddball]
166 // case of a comment-only tips file, or the developer has vetoed
70373b5a
JS
167 // them all via PreprecessTip().
168 for ( size_t i=0; i < count; i++ )
dabbc6a5
DS
169 {
170 // The current tip may be at the last line of the textfile, (or
171 // past it, if the number of lines in the textfile changed, such
70373b5a
JS
172 // as changing to a different textfile, with less tips). So check
173 // to see at last line of text file, (or past it)...
174 if ( m_currentTip >= count )
175 {
176 // .. and if so, wrap back to line 0.
177 m_currentTip = 0;
dabbc6a5
DS
178 }
179
70373b5a
JS
180 // Read the tip, and increment the current tip counter.
181 tip = m_textfile.GetLine(m_currentTip++);
dabbc6a5
DS
182
183 // Allow a derived class's overrided virtual to modify the tip
70373b5a 184 // now if so desired.
dabbc6a5
DS
185 tip = PreprocessTip(tip);
186
70373b5a
JS
187 // Break if tip isn't a comment, and isn't an empty string
188 // (or only stray space characters).
189 if ( !tip.StartsWith(wxT("#")) && (tip.Trim() != wxEmptyString) )
190 {
191 break;
192 }
193 }
dabbc6a5 194
70373b5a
JS
195 // If tip starts with '_(', then it is a gettext string of format
196 // _("My \"global\" tip text") so first strip off the leading '_("'...
197 if ( tip.StartsWith(wxT("_(\"" ), &tip))
198 {
199 //...and strip off the trailing '")'...
200 tip = tip.BeforeLast(wxT('\"'));
dabbc6a5
DS
201 // ...and replace escaped quotes
202 tip.Replace(wxT("\\\""), wxT("\""));
203 }
204
205 return tip;
c50f1fb9
VZ
206}
207
208// ----------------------------------------------------------------------------
209// wxTipDialog
210// ----------------------------------------------------------------------------
211
212BEGIN_EVENT_TABLE(wxTipDialog, wxDialog)
65fd5cb0 213 EVT_BUTTON(wxID_NEXT_TIP, wxTipDialog::OnNextTip)
eb3e6de3 214 EVT_BUTTON(wxID_CLOSE, wxTipDialog::OnCancel)
c50f1fb9
VZ
215END_EVENT_TABLE()
216
217wxTipDialog::wxTipDialog(wxWindow *parent,
218 wxTipProvider *tipProvider,
219 bool showAtStartup)
dabbc6a5 220 : wxDialog(parent, wxID_ANY, _("Tip of the Day"),
c50f1fb9
VZ
221 wxDefaultPosition, wxDefaultSize,
222 wxDEFAULT_DIALOG_STYLE | wxRESIZE_BORDER)
223{
224 m_tipProvider = tipProvider;
94f53923 225 bool isPda = (wxSystemSettings::GetScreenType() <= wxSYS_SCREEN_PDA);
c50f1fb9 226
92afa2b1 227 // 1) create all controls in tab order
abceee76 228
9a357011 229 // smart phones does not support or do not waste space for wxButtons
8b3d02a1 230#ifndef __SMARTPHONE__
eb3e6de3 231 wxButton *btnClose = new wxButton(this, wxID_CLOSE);
8b3d02a1 232#endif
abceee76 233
dabbc6a5 234 m_checkbox = new wxCheckBox(this, wxID_ANY, _("&Show tips at startup"));
92afa2b1 235 m_checkbox->SetValue(showAtStartup);
abceee76 236
9a357011 237 // smart phones does not support or do not waste space for wxButtons
8b3d02a1 238#ifndef __SMARTPHONE__
e16ebee6 239 wxButton *btnNext = new wxButton(this, wxID_NEXT_TIP, _("&Next Tip"));
8b3d02a1 240#endif
c50f1fb9 241
4e4688be
VS
242 wxStaticText *text = new wxStaticText(this, wxID_ANY, _("Did you know..."));
243
94f53923
JS
244 if (!isPda)
245 {
246 wxFont font = text->GetFont();
247 font.SetPointSize(int(1.6 * font.GetPointSize()));
248 font.SetWeight(wxFONTWEIGHT_BOLD);
249 text->SetFont(font);
250 }
c50f1fb9 251
dabbc6a5 252 m_text = new wxTextCtrl(this, wxID_ANY, wxEmptyString,
92afa2b1 253 wxDefaultPosition, wxSize(200, 160),
abceee76
VZ
254 wxTE_MULTILINE |
255 wxTE_READONLY |
58ec2255 256 wxTE_NO_VSCROLL |
abceee76
VZ
257 wxTE_RICH | // a hack to get rid of vert scrollbar
258 wxSUNKEN_BORDER);
e16ebee6 259#if defined(__WXMSW__)
58ec2255 260 m_text->SetFont(wxFont(12, wxSWISS, wxNORMAL, wxNORMAL));
e16ebee6 261#endif
c50f1fb9 262
e225b106 263//#if defined(__WXPM__)
1c4fbbf1
DW
264 //
265 // The only way to get icons into an OS/2 static bitmap control
266 //
e225b106 267// wxBitmap vBitmap;
1c4fbbf1 268
e225b106
DW
269// vBitmap.SetId(wxICON_TIP); // OS/2 specific bitmap method--OS/2 wxBitmaps all have an ID.
270// // and for StatBmp's under OS/2 it MUST be a valid resource ID.
271//
dabbc6a5 272// wxStaticBitmap* bmp = new wxStaticBitmap(this, wxID_ANY, vBitmap);
e225b106
DW
273//
274//#else
1c4fbbf1 275
91f43f15 276 wxIcon icon = wxArtProvider::GetIcon(wxART_TIP, wxART_CMN_DIALOG);
dabbc6a5 277 wxStaticBitmap *bmp = new wxStaticBitmap(this, wxID_ANY, icon);
c50f1fb9 278
e225b106 279//#endif
1c4fbbf1 280
92afa2b1 281 // 2) put them in boxes
c50f1fb9 282
92afa2b1 283 wxBoxSizer *topsizer = new wxBoxSizer( wxVERTICAL );
abceee76 284
92afa2b1
RR
285 wxBoxSizer *icon_text = new wxBoxSizer( wxHORIZONTAL );
286 icon_text->Add( bmp, 0, wxCENTER );
8b3d02a1
WS
287 icon_text->Add( text, 1, wxCENTER | wxLEFT, wxLARGESMALL(20,0) );
288 topsizer->Add( icon_text, 0, wxEXPAND | wxALL, wxLARGESMALL(10,0) );
abceee76 289
8b3d02a1 290 topsizer->Add( m_text, 1, wxEXPAND | wxLEFT|wxRIGHT, wxLARGESMALL(10,0) );
92afa2b1
RR
291
292 wxBoxSizer *bottom = new wxBoxSizer( wxHORIZONTAL );
94f53923
JS
293 if (isPda)
294 topsizer->Add( m_checkbox, 0, wxCENTER|wxTOP );
295 else
296 bottom->Add( m_checkbox, 0, wxCENTER );
8b3d02a1 297
9a357011
WS
298 // smart phones does not support or do not waste space for wxButtons
299#ifdef __SMARTPHONE__
300 SetRightMenu(wxID_NEXT_TIP, _("Next"));
eb3e6de3 301 SetLeftMenu(wxID_CLOSE);
9a357011 302#else
94f53923
JS
303 if (!isPda)
304 bottom->Add( 10,10,1 );
8b3d02a1
WS
305 bottom->Add( btnNext, 0, wxCENTER | wxLEFT, wxLARGESMALL(10,0) );
306 bottom->Add( btnClose, 0, wxCENTER | wxLEFT, wxLARGESMALL(10,0) );
307#endif
308
94f53923
JS
309 if (isPda)
310 topsizer->Add( bottom, 0, wxCENTER | wxALL, 5 );
311 else
312 topsizer->Add( bottom, 0, wxEXPAND | wxALL, wxLARGESMALL(10,0) );
c50f1fb9
VZ
313
314 SetTipText();
abceee76 315
92afa2b1 316 SetSizer( topsizer );
abceee76 317
92afa2b1
RR
318 topsizer->SetSizeHints( this );
319 topsizer->Fit( this );
c50f1fb9
VZ
320
321 Centre(wxBOTH | wxCENTER_FRAME);
c50f1fb9
VZ
322}
323
324// ----------------------------------------------------------------------------
325// our public interface
326// ----------------------------------------------------------------------------
327
328wxTipProvider *wxCreateFileTipProvider(const wxString& filename,
329 size_t currentTip)
330{
331 return new wxFileTipProvider(filename, currentTip);
332}
333
334bool wxShowTip(wxWindow *parent,
335 wxTipProvider *tipProvider,
336 bool showAtStartup)
337{
338 wxTipDialog dlg(parent, tipProvider, showAtStartup);
339 dlg.ShowModal();
340
341 return dlg.ShowTipsOnStartup();
342}
343
344#endif // wxUSE_STARTUP_TIPS
345