Page 1 of 2

How to make a simple Win32 program

Posted: Mon Nov 07, 2011 7:58 pm
by MrAksel
After i started programming in unmanaged C++ i have realized how incredibly much the .NET framework has done to make programming simple. Im now going to show you how to make a window in a Win32 program.
This tutorial assumes that you have a basic knowledge of C++.

Lets start with the headers. You need to include <Windows.h> for the window functions, and thats about it. Then, you need your windows main function and your window procedure. I will take you step by step through them.
Code: Select all
int       WINAPI   WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int iCmdShow);
LRESULT   CALLBACK WndProc(HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam);
Okay thats the easy part. Now for the hard part.
Code: Select all
int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int iCmdShow) {
    WNDCLASS wc;     
    MSG msg;
    BOOL Quit = false;
    HWND hWnd = NULL;
We will need these two variables to store our window class, for retrieving messages and to decide when to quit.

Next comes the code that sets the info about our window. It sets information such as background color, the window procedure, the icon, the cursor, a menu, and most important; the class name.
Code: Select all
    wc.style = CS_OWNDC;
    wc.lpfnWndProc = WndProc; //Window procedure
    wc.cbClsExtra = 0; //Extra space (in bytes) for the application
    wc.cbWndExtra = 0; //Extra space (in bytes) for each window
    wc.hInstance = hInstance; //Instance
    wc.hIcon = LoadIcon (NULL, IDI_APPLICATION); //Icon
    wc.hCursor = LoadCursor (NULL, IDC_ARROW); //Cursor
    wc.hbrBackground = CreateSolidBrush(RGB(123, 123, 123)); //Background
    wc.lpszMenuName = NULL; //No menu
    wc.lpszClassName = "MyWindow"; //Class name
Then we have to register the class
Code: Select all
    RegisterClass (&wc);
Now we have come far enough to create our window, it has been much more work than Dim form = New Form1 hasn't it?
Code: Select all
    hWnd = CreateWindow (
      "MyWindow", "Awesome Window Title",  //MyWindow MUST be the same as the lpszClassName ^^
      WS_OVERLAPPEDWINDOW, //Window style
      0, 0, 600, 300, //x, y, width, height
      NULL, NULL, hInstance, NULL); //parent, menu, app instance, ?? lpvoid ??
So we have to show our window:
Code: Select all
    ShowWindow(hWnd, 5);
Now comes our message loop, this catches care of all incoming messages and processes them.
Code: Select all
    while (!Quit)
    {
        if (PeekMessage (&msg, NULL, 0, 0, PM_REMOVE))
        {
            if (msg.message == WM_QUIT)
            {
                Quit = TRUE;
            }
            else
            {
                TranslateMessage (&msg);
                DispatchMessage (&msg); //An indirect call to the WndProc you defined in wc.lpfnWndProc 
            }
        }
        else
        {
            //Application idle
        }         
    }
When your application is idle, it means that it has no messages to process, so it is free to do any task.
There is another way of coding the message loop too, that method waits until it gets a message to process, so your application is never idle (as far as i know). Feel free to use the one you like.
Code: Select all
    while(!Quit) {
        while(GetMessage(&msg, NULL, 0, 0) > 0)
        {
            if (msg.message == WM_QUIT) { Quit = TRUE; }
            TranslateMessage(&msg);
            DispatchMessage(&msg); //Indirect call to wc.lpfnWndProc
        }
    }
Finally, we return the result returned from WndProc (wc.lpfnWndProc). 0 for success, and nonzero for fail.
Code: Select all
    return msg.wParam;
}
Finally finished you might think, but no. This was just our main window function. Now we need to create our WndProc function. This handles messages for us.
Code: Select all
LRESULT CALLBACK WndProc (HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam)
{
    switch (uMsg)
    {         
hWnd is the window handle.
uMsg is the message id/type.
wParam and lParam is additional information for a message.
We have a switch statement to use the right code on the right message. In this tutorial we will handle WM_CREATE (creation) and WM_CLOSE (closing). We will leave the rest to DefWindowProc.
Code: Select all
        case WM_CREATE:
             MessageBox(hWnd, "An awesome messagebox", "Title", MB_OK);
             return 0;
        
        case WM_CLOSE:
             MessageBox(hWnd, "Closing :(", ":'(", MB_OK);
             PostQuitMessage(0);
             return 0;
        
        default:
             return DefWindowProc(hWnd, uMsg, wParam, lParam);
    }
}
Now, finally we come to an end. If you managed to understand all this, I'm impressed. If everything was copy/paste, try again :P
Please leave a rep and a download :D

Re: How to make a simple Win32 program

Posted: Mon Nov 07, 2011 8:31 pm
by Dummy1912
omg; you call that simple :lol:

well seems a nice code even am to nerner; for it
but keep up the nice job :)

Re: How to make a simple Win32 program

Posted: Mon Nov 07, 2011 9:08 pm
by Axel
I think .NET is rather just a wrapper to make it lots easier lol
Btw, I liked the events more so where you place the switch with messages, I execute a function like btnGrav_click(), makes it feel more C# :P

Re: How to make a simple Win32 program

Posted: Mon Nov 07, 2011 11:02 pm
by mandai
Where is the hWnd variable declared?
This is not a very efficient way to look for window messages as it keeps the CPU at 100%.
Also you should add exit(0); in the closing function for the process to actually exit.

Re: How to make a simple Win32 program

Posted: Mon Nov 07, 2011 11:10 pm
by Axel
mandai wrote:
Where is the hWnd variable declared?
This is not a very efficient way to look for window messages as it keeps the CPU at 100%.
Also you should add exit(0); in the closing function for the process to actually exit.
This seems to just be the default sample provided by visual studio lol

Re: How to make a simple Win32 program

Posted: Tue Nov 08, 2011 1:18 pm
by MrAksel
mandai wrote:
Where is the hWnd variable declared?
This is not a very efficient way to look for window messages as it keeps the CPU at 100%.
Also you should add exit(0); in the closing function for the process to actually exit.
Yes i know i forgot to add that part. Easy fixed :D

Re: How to make a simple Win32 program

Posted: Tue Nov 08, 2011 5:51 pm
by kylepantall
wow i didn't know how easy it was, thanks.

Re: How to make a simple Win32 program

Posted: Fri Nov 25, 2011 7:53 am
by blondie134
What software do you used to make C++ programs?

Re: How to make a simple Win32 program

Posted: Fri Nov 25, 2011 9:28 am
by smashapps
Microsoft Visual C++ Express

Microsoft Visual Studio

Re: How to make a simple Win32 program

Posted: Fri Nov 25, 2011 2:47 pm
by MrAksel
I prefer Bloodshed Dev C++, because it is much easier to write string literals. In MVC++, you have to use the TEXT macro on every API that uses TPCSTR or LPCWSTR as the string type.