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