wxWidgets — Cross-Platform C++ GUI Library with Native Look

Introduction

wxWidgets is a mature, open-source C++ library for building cross-platform desktop applications. Unlike GUI toolkits that draw their own widgets, wxWidgets wraps each platform's native controls — Win32 on Windows, Cocoa on macOS, GTK on Linux — so applications automatically match the OS look and feel without extra theming work.

What wxWidgets Does

• Wraps native platform widgets so buttons, menus, dialogs, and text controls match the host OS appearance
• Provides a comprehensive class library covering GUI, networking, threading, file I/O, and database access
• Supports Windows, macOS, Linux, and experimentally iOS and Android from a single codebase
• Includes an event system, sizers for responsive layout, and a document-view architecture
• Offers bindings for Python (wxPython), Perl, Ruby, and other languages

Architecture Overview

wxWidgets uses a thin abstraction layer over platform-native toolkits. On Windows it calls Win32 and Common Controls APIs, on macOS it uses Cocoa and AppKit, and on Linux it delegates to GTK 3. Each wxWidgets class (wxButton, wxTextCtrl, wxTreeCtrl) maps to a platform-specific peer that creates and manages the real native control. Layout is handled by a sizer system that calculates geometry at runtime, adapting to different DPI settings and platform conventions.

Self-Hosting & Configuration

• On Linux: install via package manager (apt install libwxgtk3.2-dev) or build from source
• On macOS: install via Homebrew (brew install wxwidgets) or build with Xcode
• On Windows: build with CMake + MSVC or use prebuilt binaries from the wxWidgets website
• Use wx-config --cxxflags --libs on Unix to get compiler and linker flags
• Configure build options via CMake flags: wxBUILD_SHARED, wxUSE_OPENGL, wxUSE_WEBVIEW, etc.

Key Features

• True native appearance on every platform without custom themes or widget painting
• 30+ years of stability and backwards compatibility with active development
• Built-in XRC resource system for loading UI layouts from XML files
• Comprehensive non-GUI utilities: sockets, HTTP client, XML parsing, regular expressions, and ZIP handling
• wxPython provides a complete Python binding for rapid prototyping and scripting

Comparison with Similar Tools

• Qt — Feature-rich cross-platform framework with custom-drawn widgets; wxWidgets uses native controls for OS-authentic appearance
• GTK — Linux-native toolkit; wxWidgets wraps GTK on Linux but also runs natively on Windows and macOS
• Dear ImGui — Immediate-mode GPU-rendered UI for tools; wxWidgets is retained-mode with native OS widgets for end-user applications
• FLTK — Lightweight cross-platform toolkit with its own rendering; wxWidgets is larger but matches native platform appearance
• Avalonia — .NET/XAML cross-platform UI; wxWidgets is C++-native with three decades of stability

FAQ

Q: Is wxWidgets still actively maintained? A: Yes. wxWidgets has been in active development since 1992 and continues to receive regular releases with modern C++ support and new platform features.

Q: Can I use modern C++ with wxWidgets? A: wxWidgets 3.2+ fully supports C++11/14/17 and modern idioms. The API uses RAII patterns, standard containers, and range-based iteration where appropriate.

Q: How does wxPython compare to PyQt or Tkinter? A: wxPython provides native-looking widgets on all platforms. It is wxWidgets-licensed (essentially LGPL with static linking exception), avoiding Qt's commercial licensing considerations.

Q: Does wxWidgets support high-DPI displays? A: Yes. wxWidgets 3.2+ includes per-monitor DPI awareness on Windows and proper Retina support on macOS.

Sources

• https://github.com/wxWidgets/wxWidgets
• https://docs.wxwidgets.org/