win32-gui-wrapper

win32-gui-wrapper copied to clipboard

Experimental win32 GUI wrapper in C++

This is fun little project I did when learning win32 GUI API and C++. I was pretty satisfied with the result, but it was just prove of concept learning material, and it was never supposed to reach 1.0. Still, it is now good source of some win32 API examples. I remember being the most proud of working re-sizing and MDI :).

Update

21/03/2021 Due to some new stars I added some architecture overview, smart pointers where applicable and calculator example. Still, this project was done on the fly and it is obvious when reading the source code. There are no clear instance owners and memory leaks are guaranteed.

1/7/2021 I have created this project when I was pretty much C++ beginner and Win32 was already called ancient. Still, I got some stars recently, which motivated me to check it again :). Since I am way more experienced than 10 years ago, I found quite the amount of bugs and bad practices, which hopefully I will fix in my spare time.

Goal

Normally win32 applications are built around sequential message dispatcher. Inspired by Borland C++ Builder I decided to make C++ event driven wrapper.

For example:

thForm *   form = 0;
thButton * button = 0

form = new thForm( 0, 0, 0); // Parent, X-position, Y-position
form->Width = 800;
form->Height = 800;
form->X = 50;
form->Y = 50;
form->Text = L"Window caption name";
form->SetMenu( menu1);
form->OnDestroy = form_onDestroy; // register callback

button = new thButton( form, 0, form->Height - 30);
button->Width = form->Width;
button->Height = 30;
button->Anchors.Top = false;
button->Anchors.Left = true;
button->Anchors.Right = true;
button->OnClick = button_onClick;  // register callback

form->Show();

Good

• It looks nice and is intuitive to use
• As native GUI it is very responsive

Bad

• Lots of bad programming habits issues: naming and capsulation
• C++ API is mixed with native Windows types
• Only basic features (missing accelerators support, etc.)
• No good error handling in operator overloads, since I didn't want to use try-catch like Borland C++
• C++ Builder, QT or other popular frameworks use code generation for static object creation. In my code I had to workaround such problems with dynamic objects and elements, like event callbacks

TODO

• ~~architecture overview~~
• documentation
• ~~create examples (calculator)~~
• implement proper error handling
• ~~change function pointer to std::function~~
• change raw pointers to smart pointers

How to use

Project is using external components which are built into static libraries. Win32 Gui itself is also built into library.

Since this is Windows only, use free Visual Studio Community to open solution file Win32_gui_wrapper.sln:

• select solution platform (like x64)
• You MUST select example project as startup project for Run (F5) to work (right mouse button on project name in solution explorer, andchoose "Set as startup project" in the menu)
• build (ctrl+shift+b) all and Run (F5)
• amount of logs is configured with TH_DEBUG_LEVEL in thConfig.h. Set it to 1 for optimal logs and 2 for ALL logs. It can slow application startup due to amount of logs.

Note1: win32 code is using many different static libraries. You can check these in example project options under linker->input additional dependencies. Note2: the project is using some C++17 features

Use in your project

Easiest way is to copy example project and modify.

The other way is to just build Win32_gui project into static LIB and then adding it with other required dependencies into desired project. Simplest window:

#include "thWin32App.h" // master header of win32 gui wrapper

int main()
{
    thWin32App app; // application instance
    
    thForm * form = new thForm();

    form->Width = 300;
    form->Height = 200;
    form->Text = TEXT( "Application Example"); // window caption

    // register callback needed to quit application when main window is destroyed
    form->OnDestroy = []( thObject *, thEventParams_t)
    {
        constexpr const thResult_t quit_application = 1;
        return quit_application;
    };

    form->Show();

    app.Run(); // this function exits when main window is destroyed and return 1

    delete form;

    return 0;
}

Example

To try examples, in Solution Explorer select choosen one as Startup Project and press F5:

Basic components

Example using different kind of windows objects, like: MDI, buttons, combobox, etc.

Calculator

Example int32 calculator.

External

Program uses Scintilla as thRichEdit component and SimpleGrid as thStringGrid.

Architecture

This is architecture overview just to have an idea what is going on.

All visual components are based on thWindow class, which is handling common functionalities.

thWindow inherit from thObject so all instances created during runtime can be factorized.

There are also visual components that are not windows:

And there are classes that are not thObjects at all:

Parameters are mostly handled my thParam.

Some objects though need specialized parameters, for example thListView: