]> git.saurik.com Git - wxWidgets.git/blame_incremental - src/generic/tipdlg.cpp
Compile fixes.
[wxWidgets.git] / src / generic / tipdlg.cpp
... / ...
CommitLineData
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
9// Licence: wxWindows licence
10///////////////////////////////////////////////////////////////////////////////
11
12// ============================================================================
13// declarations
14// ============================================================================
15
16// ----------------------------------------------------------------------------
17// headers
18// ----------------------------------------------------------------------------
19
20#if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
21 #pragma implementation "tipdlg.h"
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"
37 #include "wx/dialog.h"
38 #include "wx/icon.h"
39 #include "wx/intl.h"
40 #include "wx/settings.h"
41 #include "wx/textctrl.h"
42 #include "wx/statbmp.h"
43 #include "wx/stattext.h"
44 #include "wx/sizer.h"
45#endif // WX_PRECOMP
46
47#include "wx/statline.h"
48#include "wx/artprov.h"
49
50#include "wx/tipdlg.h"
51
52// ----------------------------------------------------------------------------
53// constants
54// ----------------------------------------------------------------------------
55
56static const int wxID_NEXT_TIP = 32000; // whatever
57
58// ---------------------------------------------------------------------------
59// macros
60// ---------------------------------------------------------------------------
61
62/* Macro for avoiding #ifdefs when value have to be different depending on size of
63 device we display on
64 */
65
66#if defined(__SMARTPHONE__)
67 #define wxLARGESMALL(large,small) small
68#else
69 #define wxLARGESMALL(large,small) large
70#endif
71
72// ----------------------------------------------------------------------------
73// private classes
74// ----------------------------------------------------------------------------
75
76// an implementation which takes the tips from the text file - each line
77// represents a tip
78class WXDLLIMPEXP_ADV wxFileTipProvider : public wxTipProvider
79{
80public:
81 wxFileTipProvider(const wxString& filename, size_t currentTip);
82
83 virtual wxString GetTip();
84
85private:
86 wxTextFile m_textfile;
87
88 DECLARE_NO_COPY_CLASS(wxFileTipProvider)
89};
90
91#ifdef __WIN32__
92// TODO an implementation which takes the tips from the given registry key
93class WXDLLIMPEXP_ADV wxRegTipProvider : public wxTipProvider
94{
95public:
96 wxRegTipProvider(const wxString& keyname);
97
98 virtual wxString GetTip();
99};
100
101// Empty implementation for now to keep the linker happy
102wxString wxRegTipProvider::GetTip()
103{
104 return wxEmptyString;
105}
106
107#endif // __WIN32__
108
109// the dialog we show in wxShowTip()
110class WXDLLIMPEXP_ADV wxTipDialog : public wxDialog
111{
112public:
113 wxTipDialog(wxWindow *parent,
114 wxTipProvider *tipProvider,
115 bool showAtStartup);
116
117 // the tip dialog has "Show tips on startup" checkbox - return true if it
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()
134 DECLARE_NO_COPY_CLASS(wxTipDialog)
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 )
156 {
157 return _("Tips not available, sorry!");
158 }
159
160 wxString tip;
161
162 // Comments start with a # symbol.
163 // Loop reading lines until get the first one that isn't a comment.
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
167 // them all via PreprecessTip().
168 for ( size_t i=0; i < count; i++ )
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
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;
178 }
179
180 // Read the tip, and increment the current tip counter.
181 tip = m_textfile.GetLine(m_currentTip++);
182
183 // Allow a derived class's overrided virtual to modify the tip
184 // now if so desired.
185 tip = PreprocessTip(tip);
186
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 }
194
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('\"'));
201 // ...and replace escaped quotes
202 tip.Replace(wxT("\\\""), wxT("\""));
203 }
204
205 return tip;
206}
207
208// ----------------------------------------------------------------------------
209// wxTipDialog
210// ----------------------------------------------------------------------------
211
212BEGIN_EVENT_TABLE(wxTipDialog, wxDialog)
213 EVT_BUTTON(wxID_NEXT_TIP, wxTipDialog::OnNextTip)
214END_EVENT_TABLE()
215
216wxTipDialog::wxTipDialog(wxWindow *parent,
217 wxTipProvider *tipProvider,
218 bool showAtStartup)
219 : wxDialog(parent, wxID_ANY, _("Tip of the Day"),
220 wxDefaultPosition, wxDefaultSize,
221 wxDEFAULT_DIALOG_STYLE | wxRESIZE_BORDER)
222{
223 m_tipProvider = tipProvider;
224
225 // 1) create all controls in tab order
226
227#ifndef __SMARTPHONE__
228 // FIXME: use stock wxID_CLOSE button here!
229 wxButton *btnClose = new wxButton(this, wxID_CANCEL, _("Close"));
230#endif
231
232 m_checkbox = new wxCheckBox(this, wxID_ANY, _("&Show tips at startup"));
233 m_checkbox->SetValue(showAtStartup);
234
235#ifndef __SMARTPHONE__
236 wxButton *btnNext = new wxButton(this, wxID_NEXT_TIP, _("&Next Tip"));
237#endif
238
239 wxStaticText *text = new wxStaticText(this, wxID_ANY, _("Did you know..."));
240
241#ifndef __SMARTPHONE__
242 wxFont font = text->GetFont();
243 font.SetPointSize(int(1.6 * font.GetPointSize()));
244 font.SetWeight(wxFONTWEIGHT_BOLD);
245 text->SetFont(font);
246#endif
247
248 m_text = new wxTextCtrl(this, wxID_ANY, wxEmptyString,
249 wxDefaultPosition, wxSize(200, 160),
250 wxTE_MULTILINE |
251 wxTE_READONLY |
252 wxTE_NO_VSCROLL |
253 wxTE_RICH | // a hack to get rid of vert scrollbar
254 wxSUNKEN_BORDER);
255#if defined(__WXMSW__)
256 m_text->SetFont(wxFont(12, wxSWISS, wxNORMAL, wxNORMAL));
257#endif
258
259//#if defined(__WXPM__)
260 //
261 // The only way to get icons into an OS/2 static bitmap control
262 //
263// wxBitmap vBitmap;
264
265// vBitmap.SetId(wxICON_TIP); // OS/2 specific bitmap method--OS/2 wxBitmaps all have an ID.
266// // and for StatBmp's under OS/2 it MUST be a valid resource ID.
267//
268// wxStaticBitmap* bmp = new wxStaticBitmap(this, wxID_ANY, vBitmap);
269//
270//#else
271
272 wxIcon icon = wxArtProvider::GetIcon(wxART_TIP, wxART_CMN_DIALOG);
273 wxStaticBitmap *bmp = new wxStaticBitmap(this, wxID_ANY, icon);
274
275//#endif
276
277 // 2) put them in boxes
278
279 wxBoxSizer *topsizer = new wxBoxSizer( wxVERTICAL );
280
281 wxBoxSizer *icon_text = new wxBoxSizer( wxHORIZONTAL );
282 icon_text->Add( bmp, 0, wxCENTER );
283 icon_text->Add( text, 1, wxCENTER | wxLEFT, wxLARGESMALL(20,0) );
284 topsizer->Add( icon_text, 0, wxEXPAND | wxALL, wxLARGESMALL(10,0) );
285
286 topsizer->Add( m_text, 1, wxEXPAND | wxLEFT|wxRIGHT, wxLARGESMALL(10,0) );
287
288 wxBoxSizer *bottom = new wxBoxSizer( wxHORIZONTAL );
289 bottom->Add( m_checkbox, 0, wxCENTER );
290
291#ifndef __SMARTPHONE__
292 bottom->Add( 10,10,1 );
293 bottom->Add( btnNext, 0, wxCENTER | wxLEFT, wxLARGESMALL(10,0) );
294 bottom->Add( btnClose, 0, wxCENTER | wxLEFT, wxLARGESMALL(10,0) );
295#endif
296
297 topsizer->Add( bottom, 0, wxEXPAND | wxALL, wxLARGESMALL(10,0) );
298
299 SetTipText();
300
301 SetSizer( topsizer );
302
303 topsizer->SetSizeHints( this );
304 topsizer->Fit( this );
305
306 Centre(wxBOTH | wxCENTER_FRAME);
307
308#ifdef __SMARTPHONE__
309 SetRightMenu(wxID_NEXT_TIP, _("Next"));
310 SetLeftMenu(wxID_CANCEL, _("Close"));
311#endif
312
313}
314
315// ----------------------------------------------------------------------------
316// our public interface
317// ----------------------------------------------------------------------------
318
319wxTipProvider *wxCreateFileTipProvider(const wxString& filename,
320 size_t currentTip)
321{
322 return new wxFileTipProvider(filename, currentTip);
323}
324
325bool wxShowTip(wxWindow *parent,
326 wxTipProvider *tipProvider,
327 bool showAtStartup)
328{
329 wxTipDialog dlg(parent, tipProvider, showAtStartup);
330 dlg.ShowModal();
331
332 return dlg.ShowTipsOnStartup();
333}
334
335#endif // wxUSE_STARTUP_TIPS
336