]>
Commit | Line | Data |
---|---|---|
82052aff GL |
1 | ///////////////////////////////////////////////////////////////////////////// |
2 | // Name: test.cpp | |
3 | // Purpose: wxWindows thread sample | |
4 | // Author: Julian Smart(minimal)/Guilhem Lavaux(thread test) | |
5 | // Modified by: | |
6 | // Created: 06/16/98 | |
7 | // RCS-ID: $Id$ | |
8 | // Copyright: (c) Julian Smart, Markus Holzem, Guilhem Lavaux | |
3222fde2 | 9 | // Licence: wxWindows license |
82052aff GL |
10 | ///////////////////////////////////////////////////////////////////////////// |
11 | ||
bee503b0 | 12 | /* |
98f026a6 VZ |
13 | TODO: use worker threads to update progress controls instead of writing |
14 | messages - it will be more visual | |
bee503b0 VZ |
15 | */ |
16 | ||
82052aff | 17 | #ifdef __GNUG__ |
bee503b0 VZ |
18 | #pragma implementation "test.cpp" |
19 | #pragma interface "test.cpp" | |
82052aff GL |
20 | #endif |
21 | ||
22 | // For compilers that support precompilation, includes "wx/wx.h". | |
23 | #include "wx/wxprec.h" | |
24 | ||
25 | #ifdef __BORLANDC__ | |
3222fde2 | 26 | #pragma hdrstop |
82052aff GL |
27 | #endif |
28 | ||
29 | #ifndef WX_PRECOMP | |
3222fde2 | 30 | #include "wx/wx.h" |
82052aff GL |
31 | #endif |
32 | ||
3222fde2 VZ |
33 | #if !wxUSE_THREADS |
34 | #error "This sample requires thread support!" | |
35 | #endif // wxUSE_THREADS | |
36 | ||
82052aff GL |
37 | #include "wx/thread.h" |
38 | #include "wx/dynarray.h" | |
3222fde2 | 39 | #include "wx/time.h" |
82052aff | 40 | |
1bd3e1ef GL |
41 | class MyThread; |
42 | WX_DEFINE_ARRAY(wxThread *, wxArrayThread); | |
43 | ||
82052aff | 44 | // Define a new application type |
bf1852e1 | 45 | class MyApp : public wxApp |
82052aff | 46 | { |
98f026a6 VZ |
47 | public: |
48 | virtual bool OnInit(); | |
49 | ||
50 | public: | |
51 | // all the threads currently alive - as soon as the thread terminates, it's | |
52 | // removed from the array | |
53 | wxArrayThread m_threads; | |
54 | ||
55 | // crit section protects access to all of the arrays below | |
56 | wxCriticalSection m_critsect; | |
82052aff GL |
57 | }; |
58 | ||
1bd3e1ef | 59 | // Create a new application object |
98f026a6 | 60 | IMPLEMENT_APP(MyApp) |
82052aff GL |
61 | |
62 | // Define a new frame type | |
63 | class MyFrame: public wxFrame | |
64 | { | |
a6b0bd49 VZ |
65 | public: |
66 | // ctor | |
bf1852e1 | 67 | MyFrame(wxFrame *frame, const wxString& title, int x, int y, int w, int h); |
3222fde2 | 68 | |
a6b0bd49 VZ |
69 | // operations |
70 | void WriteText(const wxString& text) { m_txtctrl->WriteText(text); } | |
71 | ||
72 | // callbacks | |
82052aff GL |
73 | void OnQuit(wxCommandEvent& event); |
74 | void OnAbout(wxCommandEvent& event); | |
bee503b0 | 75 | void OnClear(wxCommandEvent& event); |
a6b0bd49 | 76 | |
82052aff | 77 | void OnStartThread(wxCommandEvent& event); |
7c3d7e2d | 78 | void OnStartThreads(wxCommandEvent& event); |
82052aff GL |
79 | void OnStopThread(wxCommandEvent& event); |
80 | void OnPauseThread(wxCommandEvent& event); | |
a6b0bd49 VZ |
81 | void OnResumeThread(wxCommandEvent& event); |
82 | ||
3222fde2 | 83 | void OnIdle(wxIdleEvent &event); |
3222fde2 | 84 | |
a6b0bd49 | 85 | private: |
7c3d7e2d VZ |
86 | // helper function - creates a new thread (but doesn't run it) |
87 | MyThread *CreateThread(); | |
88ac883a | 88 | |
bf1852e1 VZ |
89 | // just some place to put our messages in |
90 | wxTextCtrl *m_txtctrl; | |
3222fde2 | 91 | |
7c3d7e2d VZ |
92 | // remember the number of running threads and total number of threads |
93 | size_t m_nRunning, m_nCount; | |
94 | ||
a6b0bd49 | 95 | DECLARE_EVENT_TABLE() |
82052aff GL |
96 | }; |
97 | ||
bee503b0 | 98 | class MyThread : public wxThread |
82052aff | 99 | { |
a6b0bd49 | 100 | public: |
82052aff | 101 | MyThread(MyFrame *frame); |
3222fde2 VZ |
102 | |
103 | // thread execution starts here | |
104 | virtual void *Entry(); | |
105 | ||
bf1852e1 VZ |
106 | // called when the thread exits - whether it terminates normally or is |
107 | // stopped with Delete() (but not when it is Kill()ed!) | |
bee503b0 VZ |
108 | virtual void OnExit(); |
109 | ||
3222fde2 VZ |
110 | // write something to the text control |
111 | void WriteText(const wxString& text); | |
a6b0bd49 VZ |
112 | |
113 | public: | |
114 | size_t m_count; | |
82052aff GL |
115 | MyFrame *m_frame; |
116 | }; | |
117 | ||
118 | MyThread::MyThread(MyFrame *frame) | |
a6b0bd49 | 119 | : wxThread() |
82052aff | 120 | { |
a6b0bd49 VZ |
121 | m_count = 0; |
122 | m_frame = frame; | |
82052aff GL |
123 | } |
124 | ||
3222fde2 VZ |
125 | void MyThread::WriteText(const wxString& text) |
126 | { | |
127 | wxString msg; | |
3222fde2 VZ |
128 | |
129 | // before doing any GUI calls we must ensure that this thread is the only | |
130 | // one doing it! | |
88ac883a | 131 | |
7b90a8f2 | 132 | wxMutexGuiEnter(); |
88ac883a | 133 | |
81f1bb40 | 134 | msg << wxTime().FormatTime() << ": " << text; |
bee503b0 | 135 | |
3222fde2 | 136 | m_frame->WriteText(msg); |
7b90a8f2 RR |
137 | |
138 | wxMutexGuiLeave(); | |
bee503b0 VZ |
139 | } |
140 | ||
141 | void MyThread::OnExit() | |
142 | { | |
1bd3e1ef GL |
143 | wxCriticalSectionLocker locker(wxGetApp().m_critsect); |
144 | ||
145 | wxGetApp().m_threads.Remove(this); | |
3222fde2 VZ |
146 | } |
147 | ||
82052aff GL |
148 | void *MyThread::Entry() |
149 | { | |
a6b0bd49 | 150 | wxString text; |
3222fde2 | 151 | |
98f026a6 VZ |
152 | text.Printf("Thread 0x%x started (priority = %d).\n", |
153 | GetID(), GetPriority()); | |
3222fde2 VZ |
154 | WriteText(text); |
155 | ||
bee503b0 | 156 | for ( m_count = 0; m_count < 10; m_count++ ) |
3222fde2 VZ |
157 | { |
158 | // check if we were asked to exit | |
159 | if ( TestDestroy() ) | |
160 | break; | |
161 | ||
162 | text.Printf("[%u] Thread 0x%x here.\n", m_count, GetID()); | |
163 | WriteText(text); | |
a6b0bd49 | 164 | |
bf1852e1 VZ |
165 | // wxSleep() can't be called from non-GUI thread! |
166 | wxThread::Sleep(1000); | |
a6b0bd49 | 167 | } |
3222fde2 VZ |
168 | |
169 | text.Printf("Thread 0x%x finished.\n", GetID()); | |
170 | WriteText(text); | |
171 | ||
a6b0bd49 | 172 | return NULL; |
82052aff GL |
173 | } |
174 | ||
175 | // ID for the menu commands | |
3222fde2 VZ |
176 | enum |
177 | { | |
178 | TEST_QUIT = 1, | |
179 | TEST_TEXT = 101, | |
7c3d7e2d VZ |
180 | TEST_ABOUT, |
181 | TEST_CLEAR, | |
182 | TEST_START_THREAD = 201, | |
183 | TEST_START_THREADS, | |
184 | TEST_STOP_THREAD, | |
185 | TEST_PAUSE_THREAD, | |
186 | TEST_RESUME_THREAD | |
3222fde2 | 187 | }; |
82052aff GL |
188 | |
189 | BEGIN_EVENT_TABLE(MyFrame, wxFrame) | |
a6b0bd49 VZ |
190 | EVT_MENU(TEST_QUIT, MyFrame::OnQuit) |
191 | EVT_MENU(TEST_ABOUT, MyFrame::OnAbout) | |
bee503b0 | 192 | EVT_MENU(TEST_CLEAR, MyFrame::OnClear) |
a6b0bd49 | 193 | EVT_MENU(TEST_START_THREAD, MyFrame::OnStartThread) |
7c3d7e2d | 194 | EVT_MENU(TEST_START_THREADS, MyFrame::OnStartThreads) |
a6b0bd49 VZ |
195 | EVT_MENU(TEST_STOP_THREAD, MyFrame::OnStopThread) |
196 | EVT_MENU(TEST_PAUSE_THREAD, MyFrame::OnPauseThread) | |
197 | EVT_MENU(TEST_RESUME_THREAD, MyFrame::OnResumeThread) | |
198 | ||
3222fde2 | 199 | EVT_IDLE(MyFrame::OnIdle) |
82052aff GL |
200 | END_EVENT_TABLE() |
201 | ||
82052aff | 202 | // `Main program' equivalent, creating windows and returning main app frame |
3222fde2 | 203 | bool MyApp::OnInit() |
82052aff | 204 | { |
a6b0bd49 | 205 | // Create the main frame window |
bee503b0 VZ |
206 | MyFrame *frame = new MyFrame((wxFrame *)NULL, "wxWindows threads sample", |
207 | 50, 50, 450, 340); | |
3222fde2 | 208 | |
a6b0bd49 VZ |
209 | // Make a menubar |
210 | wxMenu *file_menu = new wxMenu; | |
3222fde2 | 211 | |
98f026a6 | 212 | file_menu->Append(TEST_CLEAR, "&Clear log\tCtrl-L"); |
bee503b0 | 213 | file_menu->AppendSeparator(); |
a6b0bd49 | 214 | file_menu->Append(TEST_ABOUT, "&About"); |
bee503b0 | 215 | file_menu->AppendSeparator(); |
98f026a6 | 216 | file_menu->Append(TEST_QUIT, "E&xit\tAlt-X"); |
a6b0bd49 VZ |
217 | wxMenuBar *menu_bar = new wxMenuBar; |
218 | menu_bar->Append(file_menu, "&File"); | |
3222fde2 | 219 | |
a6b0bd49 | 220 | wxMenu *thread_menu = new wxMenu; |
98f026a6 | 221 | thread_menu->Append(TEST_START_THREAD, "&Start a new thread\tCtrl-N"); |
7c3d7e2d | 222 | thread_menu->Append(TEST_START_THREADS, "Start &many threads at once"); |
98f026a6 | 223 | thread_menu->Append(TEST_STOP_THREAD, "S&top a running thread\tCtrl-S"); |
a6b0bd49 | 224 | thread_menu->AppendSeparator(); |
98f026a6 VZ |
225 | thread_menu->Append(TEST_PAUSE_THREAD, "&Pause a running thread\tCtrl-P"); |
226 | thread_menu->Append(TEST_RESUME_THREAD, "&Resume suspended thread\tCtrl-R"); | |
3222fde2 | 227 | menu_bar->Append(thread_menu, "&Thread"); |
a6b0bd49 | 228 | frame->SetMenuBar(menu_bar); |
3222fde2 | 229 | |
a6b0bd49 VZ |
230 | // Show the frame |
231 | frame->Show(TRUE); | |
3222fde2 | 232 | |
a6b0bd49 | 233 | SetTopWindow(frame); |
3222fde2 | 234 | |
a6b0bd49 | 235 | return TRUE; |
82052aff GL |
236 | } |
237 | ||
238 | // My frame constructor | |
bf1852e1 VZ |
239 | MyFrame::MyFrame(wxFrame *frame, const wxString& title, |
240 | int x, int y, int w, int h) | |
a6b0bd49 | 241 | : wxFrame(frame, -1, title, wxPoint(x, y), wxSize(w, h)) |
82052aff | 242 | { |
7c3d7e2d VZ |
243 | m_nRunning = m_nCount = 0; |
244 | ||
245 | CreateStatusBar(2); | |
3222fde2 | 246 | |
bee503b0 VZ |
247 | m_txtctrl = new wxTextCtrl(this, -1, "", wxPoint(0, 0), wxSize(0, 0), |
248 | wxTE_MULTILINE | wxTE_READONLY); | |
82052aff | 249 | |
a6b0bd49 | 250 | } |
82052aff | 251 | |
7c3d7e2d | 252 | MyThread *MyFrame::CreateThread() |
a6b0bd49 VZ |
253 | { |
254 | MyThread *thread = new MyThread(this); | |
3222fde2 | 255 | |
bf1852e1 VZ |
256 | if ( thread->Create() != wxTHREAD_NO_ERROR ) |
257 | { | |
258 | wxLogError("Can't create thread!"); | |
259 | } | |
3222fde2 | 260 | |
1bd3e1ef GL |
261 | wxCriticalSectionLocker enter(wxGetApp().m_critsect); |
262 | wxGetApp().m_threads.Add(thread); | |
bf1852e1 | 263 | |
7c3d7e2d VZ |
264 | return thread; |
265 | } | |
266 | ||
267 | void MyFrame::OnStartThreads(wxCommandEvent& WXUNUSED(event) ) | |
268 | { | |
269 | static wxString s_str; | |
270 | s_str = wxGetTextFromUser("How many threads to start: ", | |
271 | "wxThread sample", | |
272 | s_str, this); | |
273 | if ( s_str.IsEmpty() ) | |
274 | return; | |
275 | ||
276 | size_t count, n; | |
277 | sscanf(s_str, "%u", &count); | |
278 | if ( count == 0 ) | |
279 | return; | |
280 | ||
281 | wxArrayThread threads; | |
282 | ||
283 | // first create them all... | |
284 | for ( n = 0; n < count; n++ ) | |
285 | { | |
98f026a6 VZ |
286 | wxThread *thr = CreateThread(); |
287 | ||
288 | // we want to show the effect of SetPriority(): the first thread will | |
289 | // have the lowest priority, the second - the highest, all the rest | |
290 | // the normal one | |
291 | if ( n == 0 ) | |
292 | thr->SetPriority(WXTHREAD_MIN_PRIORITY); | |
293 | else if ( n == 1 ) | |
294 | thr->SetPriority(WXTHREAD_MAX_PRIORITY); | |
295 | else | |
296 | thr->SetPriority(WXTHREAD_DEFAULT_PRIORITY); | |
297 | ||
298 | threads.Add(thr); | |
7c3d7e2d VZ |
299 | } |
300 | ||
301 | wxString msg; | |
302 | msg.Printf("%d new threads created.", count); | |
303 | SetStatusText(msg, 1); | |
304 | ||
305 | // ...and then start them | |
306 | for ( n = 0; n < count; n++ ) | |
307 | { | |
308 | threads[n]->Run(); | |
309 | } | |
310 | } | |
311 | ||
312 | void MyFrame::OnStartThread(wxCommandEvent& WXUNUSED(event) ) | |
313 | { | |
314 | MyThread *thread = CreateThread(); | |
315 | ||
bf1852e1 VZ |
316 | if ( thread->Run() != wxTHREAD_NO_ERROR ) |
317 | { | |
318 | wxLogError("Can't start thread!"); | |
319 | } | |
7c3d7e2d VZ |
320 | |
321 | SetStatusText("New thread started.", 1); | |
82052aff GL |
322 | } |
323 | ||
e3e65dac | 324 | void MyFrame::OnStopThread(wxCommandEvent& WXUNUSED(event) ) |
82052aff | 325 | { |
bf1852e1 | 326 | // stop the last thread |
1bd3e1ef | 327 | if ( wxGetApp().m_threads.IsEmpty() ) |
bee503b0 VZ |
328 | { |
329 | wxLogError("No thread to stop!"); | |
bee503b0 | 330 | } |
bf1852e1 VZ |
331 | else |
332 | { | |
1bd3e1ef | 333 | wxGetApp().m_critsect.Enter(); |
7c3d7e2d | 334 | |
1bd3e1ef | 335 | wxThread *thread = wxGetApp().m_threads.Last(); |
7c3d7e2d VZ |
336 | |
337 | // it's important to leave critical section before calling Delete() | |
1bd3e1ef | 338 | // because delete will (implicitly) call OnExit() which also tries |
7c3d7e2d | 339 | // to enter the same crit section - would dead lock. |
1bd3e1ef | 340 | wxGetApp().m_critsect.Leave(); |
7c3d7e2d VZ |
341 | |
342 | thread->Delete(); | |
343 | ||
344 | SetStatusText("Thread stopped.", 1); | |
bf1852e1 | 345 | } |
a6b0bd49 | 346 | } |
82052aff | 347 | |
a6b0bd49 VZ |
348 | void MyFrame::OnResumeThread(wxCommandEvent& WXUNUSED(event) ) |
349 | { | |
1bd3e1ef | 350 | wxCriticalSectionLocker enter(wxGetApp().m_critsect); |
bee503b0 | 351 | |
3222fde2 | 352 | // resume first suspended thread |
1bd3e1ef GL |
353 | size_t n = 0, count = wxGetApp().m_threads.Count(); |
354 | while ( n < count && !wxGetApp().m_threads[n]->IsPaused() ) | |
bf1852e1 | 355 | n++; |
3222fde2 | 356 | |
bf1852e1 | 357 | if ( n == count ) |
7c3d7e2d | 358 | { |
bee503b0 | 359 | wxLogError("No thread to resume!"); |
7c3d7e2d | 360 | } |
a6b0bd49 | 361 | else |
7c3d7e2d | 362 | { |
1bd3e1ef | 363 | wxGetApp().m_threads[n]->Resume(); |
7c3d7e2d VZ |
364 | |
365 | SetStatusText("Thread resumed.", 1); | |
366 | } | |
82052aff GL |
367 | } |
368 | ||
e3e65dac | 369 | void MyFrame::OnPauseThread(wxCommandEvent& WXUNUSED(event) ) |
f3855ef0 | 370 | { |
1bd3e1ef | 371 | wxCriticalSectionLocker enter(wxGetApp().m_critsect); |
bee503b0 | 372 | |
3222fde2 | 373 | // pause last running thread |
1bd3e1ef GL |
374 | int n = wxGetApp().m_threads.Count() - 1; |
375 | while ( n >= 0 && !wxGetApp().m_threads[n]->IsRunning() ) | |
a6b0bd49 | 376 | n--; |
3222fde2 | 377 | |
a6b0bd49 | 378 | if ( n < 0 ) |
7c3d7e2d | 379 | { |
a6b0bd49 | 380 | wxLogError("No thread to pause!"); |
7c3d7e2d | 381 | } |
a6b0bd49 | 382 | else |
7c3d7e2d | 383 | { |
1bd3e1ef | 384 | wxGetApp().m_threads[n]->Pause(); |
88ac883a | 385 | |
7c3d7e2d VZ |
386 | SetStatusText("Thread paused.", 1); |
387 | } | |
f3855ef0 RR |
388 | } |
389 | ||
3222fde2 VZ |
390 | // set the frame title indicating the current number of threads |
391 | void MyFrame::OnIdle(wxIdleEvent &event) | |
392 | { | |
7fe4f500 | 393 | // update the counts of running/total threads |
3222fde2 | 394 | size_t nRunning = 0, |
1bd3e1ef | 395 | nCount = wxGetApp().m_threads.Count(); |
3222fde2 VZ |
396 | for ( size_t n = 0; n < nCount; n++ ) |
397 | { | |
1bd3e1ef | 398 | if ( wxGetApp().m_threads[n]->IsRunning() ) |
3222fde2 VZ |
399 | nRunning++; |
400 | } | |
401 | ||
7c3d7e2d VZ |
402 | if ( nCount != m_nCount || nRunning != m_nRunning ) |
403 | { | |
404 | m_nRunning = nRunning; | |
405 | m_nCount = nCount; | |
406 | ||
407 | wxLogStatus(this, "%u threads total, %u running.", nCount, nRunning); | |
408 | } | |
409 | //else: avoid flicker - don't print anything | |
f3855ef0 | 410 | } |
82052aff | 411 | |
e3e65dac | 412 | void MyFrame::OnQuit(wxCommandEvent& WXUNUSED(event) ) |
82052aff | 413 | { |
1bd3e1ef | 414 | size_t count = wxGetApp().m_threads.Count(); |
bf1852e1 VZ |
415 | for ( size_t i = 0; i < count; i++ ) |
416 | { | |
1bd3e1ef | 417 | wxGetApp().m_threads[0]->Delete(); |
bf1852e1 | 418 | } |
3222fde2 | 419 | |
a6b0bd49 | 420 | Close(TRUE); |
82052aff GL |
421 | } |
422 | ||
e3e65dac | 423 | void MyFrame::OnAbout(wxCommandEvent& WXUNUSED(event) ) |
82052aff | 424 | { |
bf1852e1 VZ |
425 | wxMessageDialog dialog(this, "wxWindows multithreaded application sample\n" |
426 | "(c) 1998 Julian Smart, Guilhem Lavaux\n" | |
427 | "(c) 1999 Vadim Zeitlin", | |
3222fde2 VZ |
428 | "About wxThread sample", |
429 | wxOK | wxICON_INFORMATION); | |
430 | ||
a6b0bd49 | 431 | dialog.ShowModal(); |
82052aff GL |
432 | } |
433 | ||
bee503b0 VZ |
434 | void MyFrame::OnClear(wxCommandEvent& WXUNUSED(event)) |
435 | { | |
436 | m_txtctrl->Clear(); | |
437 | } |