Click here to Skip to main content
Click here to Skip to main content

Win32 Worker Thread Wrapper

, 18 Apr 2003
Rate this:
Please Sign up or sign in to vote.
Win32 Worker Thread Wrapper
<!-- Article image -->

Sample Image - demo.jpg

<!-- Add the rest of your HTML here -->

Introduction

Windows is an OS that does a "great job" of pretending to be a multitasking environment, so it would be a shame, if we programmers would not use this feature at least just for fun. This class should bring you this fun, and maybe (I hope) some knowledge. The class CAG_Thread is just another win32 worker thread wrapper class. Yes, I am sure you could find many other classes that would do the same job just as fine or even better, but what I tried to accomplish is the simplicity. But as we all know the simplicity is subjective, so I will let you judge it for yourself.

Background

Some time ago I noticed that every once in a while I write a worker thread. Each time I need to write one, I copy and paste some functions, change them, and adjust them so they do the new job. After a while I got bored so I decided to write a class that would be very simple and still provide most common features used by me in a worker thread. So the class CAG_Thread was born.

Using the code

The class should be very simple to use. It is intended to be a base class for another class, because it contains the pure virtual function ThreadMain() which must be overridden. Here is the step by step use of the class:

  1. Include AG_Thread.cpp and AG_Thread.h into your project
  2. Derive a new class from CAG_Thread class
  3. Override in the new class the virtual function ThreadMain()
  4. Use the newly created class to instantiate and start the thread by StartThread() function

Here is more detailed explanation with sample code which could be downloaded at the top of the article. I will assume that you should know how to add files to project. Follwoing is the second step of deriving a new class, in my case myThread class from CAG_Thread class. Following is the myThread class definition.

#include "AG_Thread.h" 

class myThread : public CAG_Thread
{
public:
 myThread();
 virtual ~myThread(); 

 // I provide this function to pass any kind of parameters
 BOOL Work(CProgressCtrl *pProgress); 

protected:
 // Progress control to show progress
 CProgressCtrl *m_pProgress; 

 // must override this function
 UINT ThreadMain();
}; 

And here is (partly) the  class implementation

BOOL myThread::Work(CProgressCtrl *pProgress)
{
 if(pProgress == NULL)
  return FALSE; 

 m_pProgress = pProgress; 

 return StartThread();
} 

UINT myThread::ThreadMain()
{
 // init progress control
 m_pProgress->SetRange(0, 100);
 m_pProgress->SetPos(0); 

 for(int i=0; i<101; ++i)
 {
  if(ShouldDie())
   return 1; 

  m_pProgress->SetPos(i);
  Sleep(50);
 } 

 return 0;
}

Now we need to create instance of our class myThread in the dialog box and use it. I simply used a button for starting the thread, but it is not limited to dialog boxes. So here is the function where the starting and ending of the thread occurs.

// check is the thread running and if not then
// start it otherwise abort it
if(m_myThread.GetThreadStatus())
{
 if(m_myThread.StopThread())
 {
  AfxMessageBox(_T("Thread killed successfully!"));
  SetDlgItemText(IDC_START_STOP_BUTTON, _T("Start Thread"));
  return;
 } 

 AfxMessageBox(_T("Could not abort thread."));
}
else
{
 if(m_myThread.Work(&m_progress))
 {
  SetDlgItemText(IDC_START_STOP_BUTTON, _T("Stop Thread"));
  return;
 } 

 AfxMessageBox(_T("Could not start thread."));
}

And that should be it. The demo included is the very basic example of what this class is good for. Please note that this class does not provide any synchronization objects, with the purpose to be as simple as possible. Also the demo is not a useful application, it simply shows the principal of using the class. This article is not very detailed, which again should add to the simplicity, but the code should be documented enough. English is my third language, so if you do not understand something (and experience tells me that you will not), please leave a message and I'll try to answer.

License

This article, along with any associated source code and files, is licensed under The Apache License, Version 2.0

About the Author

Amer Gerzic
President Infinity Software Solutions, LLC.
United States United States
Originally from Bosnia and Herzegovina, but lived for 6 years in Germany where I did majority of education, then moved to US, where I live since 1999. I like programming, computers in general, but also Basketball, Soccer, Tennis, and many other things. Masters graduate from Grand Valley State University in CIS and working as a full time software developer. Please visit my website www.amergerzic.com

Comments and Discussions

 
Questionnice work Pinmembersmart_dummies18-Feb-14 19:09 
GeneralCool stuff PinmemberNedim Sabic23-Nov-08 23:44 
GeneralRe: Cool stuff PinmemberAmer Gerzic24-Nov-08 2:53 
GeneralAn alternative view PinmemberMizan Rahman21-Jul-08 1:39 
GeneralRe: An alternative view PinmemberAmer Gerzic21-Jul-08 2:33 
Questionwhat about function for chagin thread priority Pinmemberwinxalex24-Sep-03 1:36 
AnswerRe: what about function for chagin thread priority PinmemberAmer Gerzic24-Sep-03 2:22 
GeneralRe: what about function for chagin thread priority Pinmemberwinxalex24-Sep-03 4:32 
GeneralRe: what about function for chagin thread priority PinmemberAmer Gerzic24-Sep-03 7:46 
QuestionHow can i check that the thread is done ? PinmemberSickboy17-Sep-03 10:54 
AnswerRe: How can i check that the thread is done ? PinmemberAmer Gerzic18-Sep-03 1:59 
GeneralRe: How can i check that the thread is done ? PinmemberSickboy18-Sep-03 7:08 
GeneralRe: How can i check that the thread is done ? PinmemberAmer Gerzic18-Sep-03 9:47 
GeneralInteresting! PinmemberWREY30-Apr-03 14:06 
GeneralRe: Interesting! PinmemberAmer Gerzic1-May-03 1:54 
GeneralRe: Interesting! PinmemberWREY1-May-03 11:13 
GeneralRe: Interesting! PinmemberAmer Gerzic2-May-03 1:44 
GeneralCThread by Bjarke Viksoe PinsussStanislav Panasik20-Apr-03 19:02 
GeneralRe: CThread by Bjarke Viksoe PinmemberAmer Gerzic21-Apr-03 2:05 
GeneralATL Thread Classes Pinmembermdgray19-Apr-03 18:28 
GeneralRe: ATL Thread Classes PinmemberAmer Gerzic20-Apr-03 7:25 
GeneralRe: ATL Thread Classes Pinmembermdgray20-Apr-03 13:59 
GeneralNice! PinmemberDaniel Lohmann19-Apr-03 13:36 
GeneralRe: Nice! PinmemberAmer Gerzic20-Apr-03 5:42 
GeneralRe: Nice! PinmemberDaniel Lohmann20-Apr-03 10:54 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Mobile
Web04 | 2.8.140721.1 | Last Updated 19 Apr 2003
Article Copyright 2003 by Amer Gerzic
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid