Guides & Tutorials

From WxWiki

Contents 1 Getting Started 2 Setting up Your IDE 2.1 Windows 2.2 Mac OS 2.3 Linux 2.4 Other 3 wxWidget Design Patterns 4 Miscellaneous Guides 4.1 wxWiki Guides 4.2 External Guides 5 Tutorials

[edit] Getting Started

Main article: Getting Started Develeoping With wxWidgets

People who are completely new to wxWidgets would normally follow the steps illustrated below. See the main article for more details.

[edit] Setting up Your IDE

For an overview of IDEs that have been reported to work with wxWidgets, see the list of IDEs.

This section needs a lot of cleanup and reorganization. If there's anyone that can merge same IDE/Compiler version guides (there's duplicates of a few) if you work on that platform/version, any help would be appreciated.

[edit] Windows Borland C++ Builder (also BuilderX and Turbo C++) Code::Blocks Dev-C++ Digital Mars C Eclipse CDT Microsoft Visual C++ MinGW MSYS & MinGW Watcom		[edit] Mac OS Compiling wxWidgets using the command-line (Terminal) Compiling wxWidgets with Xcode Creating Xcode projects for wxWidgets applications WxMac-specific topics Legacy or Outdated Mac Articles
[edit] Linux Compiling and getting started Screencast showing how to build wxWidgets in Ubuntu Linux Anjuta Code::Blocks Installing and configuring under Ubuntu KDevelop Kdevelop Settings Netbeans Cross-Compiling Under Linux Install The Mingw Cross-Compiler		[edit] Other Emacs

The following guides involve multiple platforms or compilers, they need to be split up and merged into one of the above guides.

• Compiler Issues
• Compiling WxWidgets

[edit] wxWidget Design Patterns

• Events - Notes on using events in wxWidgets
• KeyCodes - wxWidgets keyboard mapping
• Subclassing WxControl - A simple example on how to subclass existing controls
• wxSizer - Lots of helpful tips on sizers here
• RTTI - The black art of wxWidgets RTTI (Runtime Type Information)
• Multiple Inheritance - The black art of using multiple inheritance in wxWidgets
• Wilcox:Subclassing Top Level Windows - Best Practices when subclassing wxFrame and the like
• Using XML With WxWidgets - XML processing with wxWidgets

[edit] Miscellaneous Guides

[edit] wxWiki Guides

DCs (Drawing, rendering, printing)

• Drawing on a panel with a DC
• Scrolling
• Making a render loop
• Printing
• Mixing wxWidgets with Cairo (under construction)

Text, languages, strings

• Converting everything to and from wxString
• Unicode - Unicode support in wxWidgets
• Internationalization - support for internationalization
• Reading text from a file

Libraries

• Creating a Linux shared lib (dll)
• Creating A DLL Of An Application
• Using DLL Version Of WxWidgets Compiled With Open Watcom
• Programs That Support Plugins - Using DLLs

Resources and images

• Resource Files - Using wxWidgets resource files (also known as XRC).
• Embedding PNG Images - Including PNG image files into executables.
• Using wxImage to load textures for OpenGL

Executables, binaries, installers and distribution

• Installers - Distributing your application on all platforms.
• Distributing WxWidgets Applications
• Reducing Executable Size - some tips
• Linking With Gtk And Running On Any Linux - Deliver a binary package for all linux distributions
• supporting x64 and Win32 within one solution - for VS2005 (Windows)

Internet and networking

• Launching The Default Browser - kinda tricky prior to wx 2.6
• Calling The Default Browser In WxHtmlWindow - How to call the external browser on Internet URLs
• Getting IP Address Of Host

Documentation

• WxWidgets Source Oddities - About wxT(), __GNUG__, WXUNUSED(), etc..
• Undocumented Parts Of WxWidgets
• MSDN Library And WxWidgets Help File - Learn how to integrate help files (specifically wxWidgets' ones) into the MSDN Library.
• Updating to the Latest Version of wxWidgets - Additional user notes about upgrading wxWidgets between new major and minor versions (ie: 2.6 to 2.8) not found in docs/changes.txt.

Events, threads, flow

• WxBase Eventloop - implementing an event loop and timers in wxBase
• Inter-Thread and Inter-Process communication
• Catching key events globally

Uncategorized

• Command-Line Arguments
• Debugging A WxWindow Application - Using __WXDEBUG__, for example.
• Avoiding Memory Leaks - Partly general C++ programming tips, but also some information on wxWidgets' automatic memory management that's interesting for experienced C++-programmers.
• Namespaces - How to derive from wxWidgets classes and use a namespace
• Using Text Templates - example for combining wxHashMap, wxVariant to make text templates, especially embedding wxImage in a wxHTML page.
• ODBC - howto work with it under wxWidgets
• Wx In Non-Wx Applications
• Wx Patching - How to submit a patch in 3 steps

[edit] External Guides

• wxBasic utilities - Describes how to build your complete IDE for writing Windows/Linux applications using the freeware ConTEXT text editor and the wxBasic binding. Contains English and Italian tutorials.
• Obtaining the path of the application - Not the current working directory, scroll down to 'Tips for finding the application path'.
• Doc & View in wxWidgets - contains a tutorial on document / view architecture.

[edit] Tutorials

• Writing Your First Application
  • wxTutorial by Franky Braem
    • Hello World
    • Using WxFrame
      • Creating A Frame
      • The Frame Constructor
      • Adding A Control
      • Adding A Menubar
      • Adding A Statusbar
      • Processing Menu Events
  • MadMonky1's Tutorial
    • Writing Your First Application-Introduction
    • Writing Your First Application-Adding A Button
    • Writing Your First Application-Using The WxTextCtrl
    • Writing Your First Application-Common Dialogs
    • Writing Your First Application-Closing Remarks
  • Programming with wxWindows (by David Beech)
    • Beech:First steps
    • Beech:Using controls
    • Beech:Using events
    • Beech:Using common dialogs
    • Beech:Using custom dialogs
    • Beech:Using custom dialogs with sizers
    • Beech:Creating other frames
• Building wxMGL Port
• Compiling A WxWidgets Application
• Compiling Using MSVC On The Commandline
• wxBasic Tutorial
  • WxBasic Implementation
  • WxBasic Tutorial
  • WxColourDialog-WxBasic
  • WxFontDialog-WxBasic
  • WxPrintDialog-WxBasic
  • WxTextEntryDialog-WxBasic
• wxMS_developers Tutorials and Demos
• Minimal wxFrame App using wx-DevC++
• Extended wxFrame App using wx-DevC++
• OpenGL application using wx-DevC++
• Screencast for creating simple Dialog using wxForms