1 0 Configuration This is the top-level configuration item.

1 0 Target Choose a target There may be several targets per platform; for example on MS Windows, you can choose the native widgets target (Windows) or the wxUniversal widgets target (Windows/Universal).

1 0 Windows The WIN32 port. This port is for Windows 9x, ME, NT, 2K, XP, using the native widgets.

MGL,X11,Mac Carbon,GTK+ 1.x,Motif,OS/2,Mac Cocoa,GTK+ 2.x,Wine,Windows/Universal

--with-msw

1 1 Windows/Universal Windows/Universal A port for MS Windows, using the wxUniversal widget set.

GTK+ 1.x,GTK+ 2.x,Mac Carbon,Mac Cocoa,MGL,Motif,OS/2,Windows,Wine,X11

--with-msw

1 0 X11 The Xlib/Unix port. This port is based on the wxUniversal widgets.

MGL,Mac Carbon,Windows,GTK+ 1.x,Motif,OS/2,Mac Cocoa,GTK+ 2.x,Wine,Windows/Universal

--with-x11

1 0 Mac Carbon The Mac Carbon and Classic port. A port for Mac OS 9 and Mac OS 10.x.

MGL,X11,Windows,GTK+ 1.x,Motif,OS/2,Mac Cocoa,GTK+ 2.x,Wine,Windows/Universal

--with-mac

1 0 Mac Cocoa Cocoa port This port uses the Cocoa API on Mac OS X.

GTK+ 2.x,GTK+ 1.x,Mac Carbon,MGL,Motif,Windows,OS/2,Wine,X11,Windows/Universal

--with-cocoa

1 0 GTK+ 1.x The GTK+ port. This port is based on the GTK+ 1.x and 2.x widget set.

MGL,X11,Mac Carbon,Windows,Motif,OS/2,Mac Cocoa,GTK+ 2.x,Wine,Windows/Universal

--with-gtk

1 0 GTK+ 2.x wxGTK with GTK+ 2 This port uses GTK+ 2.

Mac Cocoa,GTK+ 1.x,Mac Carbon,MGL,Motif,Windows,OS/2,Wine,X11,Windows/Universal

--with-gtk2

1 0 Motif The Motif/Lesstif port. This port uses Motif 1.x/2.x or Lesstif.

MGL,X11,Mac Carbon,Windows,GTK+ 1.x,OS/2,Mac Cocoa,GTK+ 2.x,Wine,Windows/Universal

--with-motif

1 0 OS/2 OS/2 Presentation Manager This port uses OS/2 Presentation Manager.

GTK+ 1.x,Mac Carbon,MGL,Motif,Windows,X11,Mac Cocoa,GTK+ 2.x,Wine,Windows/Universal

--with-pm

1 0 Wine Wine port The wxMSW port built for Wine (Windows emulation library).

Mac Cocoa,GTK+ 1.x,GTK+ 2.x,Mac Carbon,MGL,Motif,Windows,OS/2,X11,Windows/Universal

--with-wine

1 0 MGL The MGL Linux and DOS port. This port is based on the wxUniversal widgets.

X11,Mac Carbon,Windows,GTK+ 1.x,Motif,OS/2,Mac Cocoa,Wine,GTK+ 2.x,Windows/Universal

--with-mgl

1 0 Build options Build options Major build options.

1 1 wxUSE_GUI Use GUI If on, builds a GUI version of the library as opposed to wxBase. Currently, this needs to be enabled.

--enable-gui

0 1 __WXMSW__ This is enabled if the relevant platform settings are enabled.

Windows,Wine,Windows/Universal

0 0 __WXGTK__ This is enabled if the relevant platform settings are enabled.

GTK+ 1.x,GTK+ 2.x

0 0 __WXGTK20__ This is enabled if the relevant platform settings are enabled.

GTK+ 2.x

0 0 __WXX11__ This is enabled if the relevant platform settings are enabled.

X11

0 0 __WXMOTIF__ This is enabled if the relevant platform settings are enabled.

Motif

0 0 __WXMAC__ This is enabled if the relevant platform settings are enabled.

Mac Carbon

0 0 __WXCOCOA__ This is enabled if the relevant platform settings are enabled.

Mac Cocoa

0 0 __WXPM__ This is enabled if the relevant platform settings are enabled.

OS/2

0 0 __WXMGL__ This is enabled if the relevant platform settings are enabled.

MGL

0 1 __WXUNIVERSAL__ This is enabled if the relevant platform settings are enabled.

X11,MGL,Windows/Universal

0 1 wxUSE_UNIVERSAL Universal Specifies if wxUniversal should be used instead of native widgets. If the selected port in Platform is a wxUniversal port, this setting is enabled and is not user-editable. Otherwise, it can be enabled or disabled. However this doesn't necessarily mean that the configuration is supported for any given platform.

__WXUNIVERSAL__

--enable-universal

1 0 C++ options C++ options A variety of options, mostly specific to Unix compilers.

1 0 wxUSE_DMALLOC Dmalloc Use the dmalloc library. See: http://dmalloc.com.

--with-dmalloc

1 0 wxUSE_SHARED Shared library Use a shared library.

--with-shared

1 0 wxUSE_SONAME Soname Set the DT_SONAME field in ELF shared libraries

--with-soname

1 0 wxUSE_OPTIMISE Optimise Create optimised code.

--enable-optimise

1 0 wxUSE_DEBUG Use debugging information Same as wxUSE_DEBUG_FLAG (set __WXDEBUG__ flag) and wxUSE_DEBUG_INFO (create code with debugging information).

--with-debug

1 0 wxUSE_DEBUG_GDB GDB debugging information Create code with extra GDB debugging information.

--with-debug_gdb

1 0 wxUSE_PROFILE Profiling information Create code with profiling information.

--with-profile

1 0 wxUSE_NO_RTTI No RTTI Create code without RTTI (Run-time type) information.

--with-no_rtti

1 0 wxUSE_NO_EXCEPTIONS No exception handling Create code without C++ exceptions handling.

--with-no_exceptions

1 0 wxUSE_PERMISSIVE

--with-permissive

1 0 wxUSE_NO_DEPS No dependency information Create code without dependency information.

--with-no_deps

1 0 wxUSE_RPATH Rpath Output the rpath flag from wx-config. If you enable this setting, please enter the path into the value property.

--enable-rpath

1 0 wxUSE_WXPRINTFV Use wxWindows implementation of wxPrintfv Check to use the wxWindows implementation.

--enable-wxprintfv

1 0 Compatibility Various options for backward compatibility

1 0 WXWIN_COMPATIBILITY This setting determines the compatibility with 1.68 API Level 0: no backward compatibility, all new features Level 1: some extra methods are defined for compatibility. Default is 0. Recommended setting: 0 (in fact the compatibility code is now very minimal so there is little advantage to setting it to 1.

1 0 WXWIN_COMPATIBILITY_2 This setting determines the compatibility with 2.0 API Set it to 1 to enable it. Default is 0. Recommended setting: 0 (please update your code instead!)

--enable-compat20

1 0 WXWIN_COMPATIBILITY_2_2 This setting determines the compatibility with 2.2 API Set it to 1 to enable it but please consider updating your code instead. The default is 0. Recommended setting: 0 (please update your code)

--enable-compat22

1 0 WXWIN_COMPATIBILITY_2_4 This setting determines the compatibility with 2.4 API Set it to 0 to flag all cases of using deprecated functions. Default is 1 but please try building your code with 0 as the default will change to 0 in the next version and the deprecated functions will disappear in the version after it completely. Recommended setting: 0 (please update your code)

--enable-compat24

1 1 wxFONT_SIZE_COMPATIBILITY Define as 1 for font size to be backward compatible to 1.63 and earlier. 1.64 and later define point sizes to be compatible with Windows. Default is 0.

__WXMSW__

wxFont

1 1 wxDIALOG_UNIT_COMPATIBILITY Set to 0 for accurate dialog units, else 1 to be as per 2.1.16 and before. If migrating between versions, your dialogs may seem to shrink. Default is 1. Recommended setting: 0 (the new calculations are more correct!)

__WXMSW__

wxDialog

1 0 Debugging Debugging settings See also C++ options. Generic comment about debugging settings: they are very useful if you don't use any other memory leak detection tools such as Purify/BoundsChecker, but are probably redundant otherwise. Also, Visual C++ CRT has the same features as wxWindows memory debugging subsystem built in since version 5.0 and you may prefer to use it instead of built in memory debugging code because it is faster and more fool-proof. Using VC++ CRT memory debugging is enabled by default in debug mode (__WXDEBUG__) if wxUSE_GLOBAL_MEMORY_OPERATORS is *not* enabled (i.e. is 0) and if __NO_VC_CRTDBG__ is not defined.

1 1 wxUSE_DEBUG_CONTEXT If 1, enables wxDebugContext, for writing error messages to file, etc. If __WXDEBUG__ is not defined, will still use the normal memory operators. Default is 0. Recommended setting: 0

--enable-debug_cntxt

wxDebugContext

1 1 wxUSE_MEMORY_TRACING If 1, enables debugging versions of wxObject::new and wxObject::delete *IF* __WXDEBUG__ is also defined. WARNING: this code may not work with all architectures, especially if alignment is an issue. This switch is currently ignored for mingw / cygwin. Default is 0. Recommended setting: 1 if you are not using a memory debugging tool, else 0

--enable-mem_tracing

Debugging overview

1 1 wxUSE_GLOBAL_MEMORY_OPERATORS In debug mode, cause new and delete to be redefined globally. If this causes problems (e.g. link errors which is a common problem especially if you use another library which also redefines the global new and delete), set this to 0. This switch is currently ignored for MinGW/Cygwin. The configure script sets this to 1 if wxUSE_MEMORY_TRACING is 1. Default: 0. Recommended setting: 0

Debugging Overview

1 1 wxUSE_DEBUG_NEW_ALWAYS In debug mode, causes new to be defined to be WXDEBUG_NEW (see object.h). If this causes problems (e.g. link errors), set this to 0. You may need to set this to 0 if using templates (at least for VC++). This switch is currently ignored for MinGW/Cygwin/CodeWarrior. Default: 0. Recommended setting: 0

Debugging overview

1 1 wxUSE_ON_FATAL_EXCEPTION Fatal exceptions handling wxHandleFatalExceptions() may be used to catch the program faults at run time and, instead of terminating the program with a usual GPF message box, call the user-defined wxApp::OnFatalException() function. If you set wxUSE_ON_FATAL_EXCEPTION to 0, wxHandleFatalExceptions() will not work. This setting is for Win32 only and can only be enabled if your compiler supports Win32 structured exception handling (currently only VC++ does). Default: 1. Recommended setting: 1 if your compiler supports it.

__WXMSW__

--enable-catch_segvs

1 0 Unicode Unicode settings

1 0 wxUSE_UNICODE Unicode mode Set wxUSE_UNICODE to 1 to compile wxWindows in Unicode mode: wxChar will be defined as wchar_t, wxString will use Unicode internally. If you set this to 1, you must use the wxT() macro for all literal strings in the program. Unicode is currently only fully supported under Windows NT/2000/XP (Windows 9x doesn't support it and the programs compiled in Unicode mode will not run under 9x -- but see wxUSE_UNICODE_MSLU below). Default: 0. Recommended setting: 0 (unless you only plan to use Windows NT/2000/XP)

--enable-unicode

Unicode support in wxWindows

0 0 wxUSE_UNICODE_MSLU Unicode MSLU support Set wxUSE_UNICODE_MSLU to 1 if you want to compile wxWindows in Unicode mode and be able to run compiled apps under Windows 9x as well as NT/2000/XP. This setting enables use of unicows.dll from MSLU, the MS Layer for Unicode, see: http://www.microsoft.com/globaldev/handson/dev/mslu_announce.mspx Note that you will have to modify the makefiles to include unicows.lib import library as the first library (if you use MSVC, you can run the makefile with: nmake MSLU=1 UNICODE=1 If your compiler doesn't have unicows.lib, you can get a version of it at: http://libunicows.sourceforge.net Default: 0. Recommended setting: 0 (1 if you want to deploy Unicode apps on 9x systems)

wxUSE_UNICODE

__WXMSW__

--enable-mslu

Unicode support in wxWindows

1 1 wxUSE_WCHAR_T Wide character support Setting wxUSE_WCHAR_T to 1 gives you some degree of Unicode support without compiling the program in Unicode mode. More precisely, it will be possible to construct wxString from a wide (Unicode) string and convert any wxString to Unicode. If using configure, this setting is automatically detected and set. Default: 1. Recommended setting: 1

Internationalization 1 1 Logging wxLog facilities

1 1 wxUSE_LOG wxLog Support for message/error logging. This includes wxLogXXX() functions and wxLog and derived classes. Don't set this to 0 unless you really know what you are doing. Default: 1. Recommended setting: 1 (always)

--enable-log

wxLog

1 1 wxUSE_LOGWINDOW wxLogWindow

wxUSE_TEXTCTRL

--enable-logwin

wxLog

1 1 wxUSE_LOGGUI wxLogGui

--enable-loggui

wxLog

1 1 wxUSE_LOG_DIALOG wxLogDialog

wxUSE_LISTCTRL

--enable-logdialog

wxLog

1 0 Files and streams

1 1 wxUSE_STREAMS Stream support If enabled (1), compiles wxWindows streams classes. Default: 1. Recommended setting: 1

--enable-streams

wxStreams overview

1 1 wxUSE_ZIPSTREAM wxZipInputStream, wxZipOutputStream Default: 1

--enable-zipstream

1 0 wxUSE_STD_IOSTREAM Standard C++ streams Use standard C++ streams if 1. If 0, use wxWin streams implementation. Default: 0

--enable-std_iostreams

1 1 wxUSE_FILE wxFile support Set wxUSE_FILE to 1 to compile wxFile classes. wxFile uses low level POSIX functions for file access, wxFFile uses ANSI C stdio.h functions. Default: 1. Recommended setting: 1. wxFile is highly recommended as it is required by i18n code, wxFileConfig and others.

--enable-file

wxFile

1 1 wxUSE_FFILE wxFFile support Set wxUSE_FFILE to 1 to compile wxFFile classes. wxFFile uses ANSI C stdio.h functions. Default: 1. Recommended setting: 1.

--enable-ffile

wxFFile

1 1 wxUSE_FSVOLUME wxFSVolume Use wxFSVolume class to provide access to the configured/active mount points. Default: 1. Recommended setting: 1 (but may be safely disabled if you don't use it)

wxFSVolume

1 1 wxUSE_TEXTBUFFER wxTextBuffer This class is required by wxTextFile.

--enable-textbuf

wxTextFile

1 1 wxUSE_TEXTFILE wxTextFile Requires wxFile and wxTextBuffer, required by wxFileConfig.

wxUSE_TEXTBUFFER,wxUSE_FILE

--enable-textfile

wxTextFile

1 1 wxUSE_CONFIG wxConfig Setting wxUSE_CONFIG to 1 enables the use of wxConfig and related classes which allow the application to store its settings in the persistent storage. Setting this to 1 will also enable on-demand creation of the global config object in wxApp. Default: 1.

--enable-config

wxConfig classes overview

1 1 wxUSE_CONFIG_NATIVE Native Config If wxUSE_CONFIG is 1, you may choose to use either the native config classes under Windows (using .INI files under Win16 and the registry under Win32) or the portable text file format used by the config classes under Unix. Default: 1 to use native classes. Note that you may still use wxFileConfig even if you set this to 1 - just the config object created by default for the applications needs will be a wxRegConfig or wxIniConfig and not wxFileConfig. Default: 1. Recommended setting: 1

wxConfig classes overview

1 1 wxUSE_MIMETYPE wxMimeTypesManager Default: 1

wxUSE_TEXTFILE

--enable-mimetype

wxMimeTypesManager

1 1 wxUSE_FILESYSTEM Virtual file systems Enable virtual file systems (required by wxHTML)

--enable-filesystem

wxFileSystem

1 1 wxUSE_FS_ZIP Virtual Zip filesystem Allows the application to extract files from zip files. Default: 1

--enable-fs_zip

1 1 wxUSE_FS_INET Virtual Internet file system Default: 1

wxUSE_STREAMS

--enable-fs_inet

1 1 wxUSE_RESOURCES wxGetResource/wxWriteResource Deprecated resource functions. On wxMSW, these functions use .ini files. On wxGTK+, they are implemented using wxFileConfig. On wxMotif, they use XrmDatabase. On all other platforms, they are not implemented. You might want to use them on wxMotif to access X11 resource files easily, but otherwise it is best to use wxConfig instead. Default: 1

--enable-xresources

1 1 wxUSE_IOSTREAMH iostream setting VC++ 4.2 and above allows <iostream> and <iostream.h> but you can't mix them. Set to 1 for <iostream.h>, 0 for <iostream>. Note that VC++ 7.1 and later doesn't support wxUSE_IOSTREAMH == 1 and so <iostream> will be used anyhow. Default is 1. Recommended setting: whatever your compiler likes more

1 1 wxUSE_LARGEFILE Large file support Clear to disable large file support (-D_LARGE_FILES).

--enable-largefile

1 0 Data Data classes

1 1 wxUSE_LONGLONG wxLongLong support Set wxUSE_LONGLONG to 1 to compile the wxLongLong class. This is a 64 bit integer which is implemented in terms of native 64 bit integers if any or uses emulation otherwise. This class is required by wxDateTime and so you should enable it if you want to use wxDateTime. For most modern platforms, it will use the native 64 bit integers in which case (almost) all of its functions are inline and it almost does not take any space, so there should be no reason to switch it off. Default: 1. Recommended setting: 1

--enable-longlong

wxLongLong

1 1 wxUSE_APPLE_IEEE IEEE floating point code If enabled, the code written by Apple will be used to write, in a portable way, floating point data on disk. See extended.c for the licence which is different from the wxWindows one. Default: 1. Recommended setting: 1 unless you don't like the licence terms (unlikely)

--enable-apple_ieee

1 1 wxUSE_REGEX wxRegEx Support for regular expression matching via wxRegEx class: enable this to use POSIX regular expressions in your code. You need to compile theh regex library from src/regex to use it under Windows. Default: 1 Recommended setting: 1 if your compiler supports it.

--with-regex

wxRegEx

0 1 1 wxUSE_GEOMETRY Miscellaneous geometry code

--enable-geometry

1 0 Time

1 1 wxUSE_DATETIME wxDateTime Set wxUSE_DATETIME to 1 to compile the wxDateTime and related classes which manipulate dates, times and time intervals. wxDateTime replaces the old wxTime and wxDate classes which are still provided for backwards compatibility (and implemented in terms of wxDateTime). Note that this class is relatively new and is still officially in alpha stage because some features are not yet (fully) implemented. It is already quite useful though and should only be disabled if you are aiming at absolutely minimal version of the library. Requires: wxUSE_LONGLONG. Default: 1

wxUSE_LONGLONG

--enable-datetime

wxDateTime

1 1 wxUSE_TIMER wxTimer Default: 1.

--enable-timer

wxTimer

1 1 wxUSE_STOPWATCH wxStopWatch Default: 1. Needed by wxSocket.

wxUSE_LONGLONG

--enable-stopwatch

wxStopWatch

1 0 Network

1 1 wxUSE_DIALUP_MANAGER wxDialUpManager If wxUSE_DIALUP_MANAGER is 1, compiles in wxDialUpManager class which allows connection to/disconnection from the network and notificaton whenever the dial-up network connection is established or terminated. Requires wxUSE_DYNAMIC_LOADER. Default: 1. Recommended setting: 1

--enable-dialupman

wxDialupManager

1 1 wxUSE_SOCKETS wxSocket wxSocket and friends. Default: 1

wxUSE_STOPWATCH

--enable-sockets

wxSocketBase

1 1 wxUSE_PROTOCOL wxProtocol wxProtocol and related classes: if you want to use any of wxFTP, wxHTTP or wxURL you need to set this to 1. Default: 1

wxUSE_STREAMS

--enable-protocol

wxProtocol

1 1 wxUSE_PROTOCOL_FILE wxFileProto

--enable-protocol-file

wxProtocol

1 1 wxUSE_PROTOCOL_FTP wxFTP

--enable-protocol-ftp

wxFTP

1 1 wxUSE_PROTOCOL_HTTP wxHTTP

--enable-protocol-http

wxHTTP

1 1 wxUSE_URL wxURL

--enable-url

wxURL

1 1 wxUSE_IPC wxIPC The wxServer, wxClient and wxConnection classes are a high-level IPC implementation, using DDE on MS Windows and sockets on other platforms. Default: 1. Recommended value: 1.

--enable-ipc

Interprocess communication overview

1 0 Windows

1 1 wxUSE_STATUSBAR wxStatusBar On MS Windows, depending on the value of wxUSE_NATIVE_STATUSBAR, either wxStatusBar95 or a generic wxStatusBar will be used.

--enable-statusbar

wxStatusBar

1 1 wxUSE_NATIVE_STATUSBAR Two status bar implementations are available under Win32: the generic one or the wrapper around native control. For native look and feel, the native version should be used. Default: 1. Recommended setting: 1 (there is no advantage in using the generic one)

wxStatusBar

1 1 wxUSE_TOOLBAR wxToolBar If wxUSE_TOOLBAR is 0, don't compile any toolbar classes at all. Otherwise, use the native toolbar class unless wxUSE_TOOLBAR_NATIVE is 0. Additionally, the generic toolbar class which supports some features which might not be supported by the native wxToolBar class may be compiled in if wxUSE_TOOLBAR_SIMPLE is 1. Default: 1. Recommended setting: 1

--enable-toolbar

wxToolBar

1 1 wxUSE_TOOLBAR_NATIVE Use the native toolbar implementation wherever possible.

--enable-tbarnative

wxToolBar

1 0 wxUSE_TOOLBAR_SIMPLE Compile wxToolBarSimple, a simple generic toolbar implementation, in addition to any others that are enabled. This must be enabled if wxUSE_TOOLBAR_NATIVE is disabled.

wxUSE_TOOLBAR_NATIVE

--enable-tbarsmpl

wxToolBar

1 1 wxUSE_GRID wxGrid wxGrid class.

--enable-grid

wxGrid

1 1 wxUSE_SASH wxSashWindow

--enable-sash

wxSashWindow

1 1 wxUSE_SPLITTER wxSplitterWindow

--enable-splitter

wxSplitterWindow

1 0 wxUSE_GLCANVAS wxGLCanvas

--with-opengl

wxGLCanvas

1 1 wxUSE_POPUPWINDOW wxPopupWindow Enables the popup window class.

--enable-popupwin

wxPopupWindow

1 1 wxUSE_TIPWINDOW wxTipWindow Enables the generic tip window class. This is used to implement tooltips on some ports.

--enable-tipwindow

wxTipWindow

1 1 wxUSE_MINIFRAME Miniframe Use the wxMiniFrame class. Not implemented on all platforms.

--enable-miniframe

wxMiniFrame

1 1 wxUSE_CONTROLS Controls You must set wxUSE_CONTROLS to 1 if you are using any controls at all (without it, the wxControl class is not compiled).

--enable-controls

1 1 wxUSE_BUTTON wxButton

--enable-button

wxButton

1 1 wxUSE_BMPBUTTON wxBitmapButton

--enable-bmpbutton

wxBitmapButton

1 1 wxUSE_CALENDARCTRL wxCalCtrl A calendar control.

wxUSE_SPINBTN,wxUSE_COMBOBOX

--enable-calendar

wxCalCtrl

1 1 wxUSE_CHECKBOX wxCheckBox

--enable-checkbox

wxCheckBox

1 1 wxUSE_CHECKLISTBOX wxCheckListBox

wxUSE_LISTBOX

--enable-checklst

wxCheckListBox

1 1 wxUSE_CHOICE wxChoice

--enable-choice

wxChoice

1 1 wxUSE_COMBOBOX wxComboBox

--enable-combobox

wxComboBox

1 1 wxUSE_GAUGE wxGauge

--enable-gauge

wxGauge

1 1 wxUSE_LISTBOX wxListBox

--enable-listbox

wxListBox

1 1 wxUSE_LISTCTRL wxListCtrl

wxUSE_IMAGLIST

--enable-listctrl

wxListCtrl

1 1 wxUSE_NOTEBOOK wxNotebook wxNotebook is a control with several "tabs" located on one of its sides. It may be used ot logically organise the data presented to the user instead of putting everything in one huge dialog. Default: 1.

wxUSE_IMAGLIST

--enable-notebook

wxNotebook

1 1 wxUSE_RADIOBOX wxRadioBox

wxUSE_RADIOBTN,wxUSE_STATBOX

--enable-radiobox

wxRadioBox

1 1 wxUSE_RADIOBTN wxRadioButton

--enable-radiobtn

wxRadioButton

1 1 wxUSE_SCROLLBAR wxScrollBar

--enable-scrollbar

wxScrollBar

1 1 wxUSE_SLIDER wxSlider

--enable-slider

wxSlider

1 1 wxUSE_SPINBTN wxSpinButton

--enable-spinbtn

wxSpinButton

1 1 wxUSE_SPINCTRL wxSpinCtrl

--enable-spinctrl

wxSpinCtrl

1 1 wxUSE_STATBOX wxStaticBox

--enable-statbox

wxStaticBox

1 1 wxUSE_STATLINE wxStaticLine

--enable-statline

wxStaticBitmap

1 1 wxUSE_STATTEXT wxStaticText

--enable-stattext

wxStaticText

1 1 wxUSE_STATBMP wxStaticBitmap

--enable-staticbmp

wxStaticBitmap

1 1 wxUSE_TEXTCTRL wxTextCtrl

--enable-textctrl

wxTextCtrl

1 1 wxUSE_TOGGLEBTN wxToggleButton

--enable-togglebtn

wxToggleButton

1 1 wxUSE_TREECTRL wxTreeCtrl

wxUSE_IMAGLIST

--enable-treectrl

wxTreeCtrl

1 0 Imaging Imaging Features relating to images

1 1 wxUSE_IMAGLIST wxImageList This class is needed by wxNotebook, wxTreeCtrl and wxListCtrl.

--enable-imaglist

wxImageList

1 1 wxUSE_METAFILE wxMetaFile This option is relevant on MS Windows only. Windows supports the graphics format known as metafile which is, though not portable, is widely used under Windows and so is supported by wxWin (under Windows only, of course). Win16 (Win3.1) used the so-called "Window MetaFiles" or WMFs which were replaced with "Enhanced MetaFiles" or EMFs in Win32 (Win9x, NT, 2000). Both of these are supported in wxWin and, by default, WMFs will be used under Win16 and EMFs under Win32. This may be changed by setting wxUSE_WIN_METAFILES_ALWAYS to 1 and/or setting wxUSE_ENH_METAFILE to 0. You may also set wxUSE_METAFILE to 0 to not compile in any metafile related classes at all. Default: 1 for wxUSE_ENH_METAFILE and 0 for wxUSE_WIN_METAFILES_ALWAYS. Recommended setting: default or 0 for everything for portable programs.

__WXMSW__

--enable-metafile

wxMetaFile

1 1 wxUSE_ENH_METAFILE wxEnhMetaFile Enhanced metafile (recommended).

__WXMSW__

wxMetaFile

1 1 wxUSE_WIN_METAFILES_ALWAYS This option is obsolete. Set to 0.

__WXMSW__

wxMetaFile

1 1 wxUSE_DRAGIMAGE wxDragImage This class is useful for implementing drag operations. Default: 1. Recommended value: 1.

--enable-dragimage

wxDragImage

1 1 wxUSE_IMAGE wxImage wxImage supports many different image formats which can be configured at compile-time. BMP and XPM are always supported, others are optional and can be safely disabled if you don't plan to use images in such format sometimes saving substantial amount of code in the final library. Some formats require an extra library which is included in wxWin sources which is mentioned if it is the case. Default: 1

--enable-image

wxImage

1 1 wxUSE_LIBPNG PNG support Set to 1 for PNG format support (requires libpng). Also requires wxUSE_ZLIB.

--with-libpng

wxImage

0 1 1 wxUSE_LIBJPEG JPEG support Set to 1 for JPEG format support (requires libjpeg).

--with-libjpeg

wxImage

0 1 1 wxUSE_LIBTIFF TIFF support Set to 1 for TIFF format support (requires libtiff).

--with-libtiff

wxImage

0 1 1 wxUSE_GIF GIF support Set to 1 for read-only GIF format support.

--enable-gif

wxImage

1 1 wxUSE_PNM PNM support Set to 1 for PNM format support.

--enable-pnm

wxImage

1 1 wxUSE_PCX PCX support Set to 1 for PCX format support.

--enable-pcx

wxImage

1 1 wxUSE_IFF IFF support Set to 1 for IFF (Amiga) format support.

--enable-iff

wxImage

1 1 wxUSE_XPM XPM support Set to 1 for XPM format support.

--enable-xpm

wxImage

1 1 wxUSE_ICO_CUR MS Windows icons and cursors support Set to 1 for MS Icons and Cursors format support.

__WXMSW__

--enable-icocur

wxImage

1 1 wxUSE_PALETTE wxPalette Set to 1 to enable the wxPalette class.

--enable-palette

wxPalette

1 0 Common dialogs Common dialogs Controls options relating to common dialogs, such wxColourDialog and wxDirDialog.

Common dialogs overview

1 0 wxUSE_GENERIC_DIALOGS_IN_MSW Generic dialog support in Windows Define 1 to use generic dialogs in Windows, even though they duplicate native common dialog (e.g. wxColourDialog). This is mainly useful for testing. Default: 0. Recommended setting: 0

Common dialogs overview

1 1 wxUSE_COMMON_DIALOGS Common dialogs On rare occasions (e.g. using DJGPP) may want to omit common dialogs (e.g. file selector, printer dialog). Switching this off also switches off the printing architecture and interactive wxPrinterDC. This relates to the native common dialogs and not to generic dialogs such as wxBusyInfo. Default: 1. Recommended setting: 1 (unless it really doesn't work)

--enable-commondlg

Common dialogs overview

1 1 wxUSE_BUSYINFO wxBusyInfo wxBusyInfo displays window with a message when the app is busy. Works in the same way as wxBusyCursor.

--enable-busyinfo

wxBusyInfo

1 1 wxUSE_CHOICEDLG Single and multiple choice dialogs Default: 1. Recommended setting: 1 (used in the library itself)

--enable-choicedlg

Dialog functions

1 1 wxUSE_COLOURDLG wxColourDialog Use the colour picker dialog. Default: 1. Recommended setting: 1

--enable-coldlg

wxColourDialog

1 1 wxUSE_DIRDLG wxDirDlg A class for getting a directory name from the user. Default: 1. Recommended setting: 1.

--enable-dirdlg

wxDirDialog

1 1 wxUSE_FILEDLG wxFileDialog Open and save file dialogs. Default: 1. Recommended setting: 1 (used in many places in the library itself)

--enable-filedlg

wxFileDialog

1 1 wxUSE_FINDREPLDLG wxFindReplaceDialog Default: 1. Recommended setting: 1 (but may be safely set to 0)

--enable-finddlg

wxFindReplaceDialog

1 1 wxUSE_FONTDLG wxFontDialog Font picker dialog. Default: 1. Recommended setting: 1 (used in the library itself)

--enable-fontdlg

wxFontDialog

1 1 wxUSE_MSGDLG wxMessageDialog and wxMessageBox Default: 1. Recommended setting: 1 (used in the library itself)

wxMessageDialog

1 1 wxUSE_PROGRESSDLG wxProgressDialog Progress dialog class for lengthy operations

--enable-msgdlg

wxProgressDialog

1 1 wxUSE_STARTUP_TIPS wxShowTip Support for startup tips.

--enable-tipdlg

Dialog functions

1 1 wxUSE_TEXTDLG wxTextEntryDialog Text entry dialog and wxGetTextFromUser function.

--enable-textdlg

wxTextEntryDialog

1 1 wxUSE_NUMBERDLG wxGetNumberFromUser Number entry dialog. This option is not currently used.

--enable-numberdlg

Dialog functions

1 1 wxUSE_SPLASH wxSplashScreen A splash window.

--enable-splash

wxSplashScreen

1 1 wxUSE_WIZARDDLG wxWizard The wizard dialog.

--enable-wizarddlg

wxWizard

1 0 Large components Frameworks This category consists of large components, such as the printing and document/view frameworks.

1 1 wxUSE_DOC_VIEW_ARCHITECTURE Document/view architecture

wxUSE_MENUS,wxUSE_FILEDLG

--enable-docview

Document/view overview

1 1 wxUSE_MDI_ARCHITECTURE Multiple Document Interface

--enable-mdi

wxMDIParentFrame

1 1 wxUSE_PRINTING_ARCHITECTURE Print/preview architecture code Your application can still print without this, but it is highly recommended that you use the framework provided.

wxUSE_COMBOBOX

--enable-printarch

Printing overview

1 1 wxUSE_HTML wxHTML The wxHTML subsystem consists of wxHtmlWindow, wxHtmlHelpController, wxHtmlEasyPrinting and other components.

wxUSE_FILESYSTEM

--enable-html

wxHTML Overview

1 0 Miscellaneous Miscellaneous features

1 1 wxUSE_CMDLINE_PARSER Support for command line parsing using wxCmdLineParser class Default: 1 Recommended setting: 1 (can be set to 0 if you don't use the command line)

--enable-cmdline

wxCmdLineParser

1 1 wxUSE_THREADS Support for multithreaded applications If 1, compile in thread classes (thread.h) and make the library a bit more thread safe. Although thread support is quite stable by now, you may still consider recompiling the library without it if you have no use for it - this will result in a somewhat smaller and faster operation. Default: 1. Recommended setting: 0 unless you do plan to develop MT applications

--enable-threads

wxThread

1 1 wxUSE_INTL Internationlisation support _() macro, wxLocale class. Requires wxTextFile.

--enable-intl

Internationalization

1 1 wxUSE_DYNLIB_CLASS wxDynamicLibrary Compiles in classes for run-time DLL loading and function calling. Default: 1. Required by wxUSE_DIALUP_MANAGER.

--enable-dynlib

wxDynamicLibrary

1 1 wxUSE_DYNAMIC_LOADER Dynamic loader Experimental, don't use for now

--enable-dynamicloader

wxDynamicLibrary

1 1 wxUSE_FONTMAP wxFontMapper Default: 1

--enable-fontmap

wxFontMapper

1 1 wxUSE_SYSTEM_OPTIONS wxSystemOptions A class for setting miscellaneous options that do not fit in with the wxWindows API. For example, drawing optimizations can be tweaked using this class.

--enable-sysoptions

wxSystemOptions

1 1 wxUSE_WAVE wxWave Simple .wav class for short sounds.

--enable-wave

wxWave

1 1 wxUSE_ACCEL wxAcceleratorTable/wxAcceleratorTableEntry classes and support for them in wxMenu(Bar)

--enable-accel

wxAcceleratorTable

1 1 wxUSE_CARET A class implementing a "cursor" in a text control (called caret under Windows).

--enable-caret

wxCaret

1 1 wxUSE_DISPLAY wxDisplay The wxDisplay class allows enumeration of all displays on a system and working with them. Default: 0 because it isn't yet implemented on all platforms. Recommended setting: 1 if you need it, can be safely set to 0 otherwise

--enable-display

wxDisplay

1 1 wxUSE_MENUS wxMenu wxMenu, wxMenuBar. Should not be disabled.

--enable-menus

wxMenu

1 1 wxUSE_VALIDATORS wxValidator and derived classes

--enable-validators

wxValidator

1 0 wxUSE_ACCESSIBILITY Accessibility Use the wxAccessible class for enhanced and customisable accessibility. Currently available on MS Windows only. Requires wxUSE_OLE. Default: 0. Recommended setting: 0

--enable-accessibility

wxAccessible

1 1 wxUSE_SNGLINST_CHECKER wxSingleInstanceChecker wxSingleInstanceChecker class allows the application to verify at startup if another program instance is running. Currently only available under MS Windows. Default: 1. Recommended value: 1

--enable-snglinst

wxSingleInstanceChecker

1 1 wxUSE_CONSTRAINTS Layout constraints The old constraint-based layout system is deprecated in favour of sizers, and may be safely disabled since they are not used within wxWindows any more. Default: 1

--enable-constraints

Constraints overview

1 1 wxUSE_SPLINES Splines Enables spline drawing code in wxDC. Default: 1

--enable-splines

wxDC

1 1 wxUSE_DYNAMIC_CLASSES Dynamic classes If 1, enables provision of run-time type information. NOW MANDATORY: don't change.

Run time class information overview

1 1 wxUSE_ZLIB Zlib, wxZlibInputStream, wxZlibOutputStream Default: 1

--with-zlib

0 1 0 Data transfer Data transfer Data transfer encompasses clipboard and drag-and-drop operations.

wxDataObject overview

1 1 wxUSE_CLIPBOARD wxClipboard Clipboard copy/paste. Default: 1. Recommended value: 1

wxUSE_DATAOBJ

--enable-clipboard

wxClipboard

1 1 wxUSE_DATAOBJ wxDataObject Use wxDataObject and related classes. Needed for clipboard and OLE drag and drop. Default: 1. Recommended value: 1

wxUSE_OLE

--enable-dataobj

wxDataObject

1 1 wxUSE_DRAG_AND_DROP Drag and drop Use wxDropTarget and wxDropSource classes for drag and drop (this is different from "built in" drag and drop in wxTreeCtrl which is always available). Requires wxUSE_DATAOBJ. Default: 1. Recommended setting: 1

wxUSE_OLE,wxUSE_DATAOBJ

--enable-dnd

Drag and drop overview

1 0 Help

1 1 wxUSE_HELP Online help Enables all online help (but not context-sensitive help). Default: 1.

--enable-help

wxHelpController

1 1 wxUSE_MS_HTML_HELP MS HTML Help Enables the wxCHMHelpController class. Default: 1.

wxUSE_DYNAMIC_LOADER

__WXMSW__

--enable-mshtmlhelp

wxHelpController

1 1 wxUSE_WXHTML_HELP wxHTML Help Enables the built-in HTML help controller. Default: 1

wxUSE_HTML,wxUSE_COMBOBOX,wxUSE_NOTEBOOK,wxUSE_FILEDLG

--enable-htmlhelp

wxHtmlHelpController

1 1 wxUSE_TOOLTIPS wxToolTip

--enable-tooltips

wxToolTip

1 0 Input devices Input devices Settings for various input devices.

1 1 wxUSE_MOUSEWHEEL Mousewheel support Enables mousewheel support. So far this is only supported in MS Windows. Default: 1

__WXMSW__

wxMouseEvent

1 1 wxUSE_JOYSTICK wxJoystick Under wxGTK, this requires wxUSE_THREADS to be enabled. Default: 1

wxUSE_THREADS

--enable-joystick

wxJoystick

1 0 Printing Printing settings See also: Large components for wxUSE_PRINTING_ARCHITECTURE.

1 1 wxUSE_POSTSCRIPT PostScript Enables PostScript printing support.

--enable-postscript

wxPostScriptDC

1 0 wxUSE_AFM_FOR_POSTSCRIPT AFM support Set to 1 to use font metric files in GetTextExtent.

wxPostScriptDC

1 0 wxUSE_POSTSCRIPT_ARCHITECTURE_IN_MSW PostScript under MS Windows Enables PostScript on MS Windows.

wxPostScriptDC

1 0 Database

1 0 wxUSE_ODBC ODBC support Enables wxDb and related classes for accessing ODBC on all supported platforms. Default: 0

wxUSE_UNICODE

--with-odbc

Database classes overview

0 0 wxODBC_FWD_ONLY_CURSORS wxDb cursor scrolling For backward compatibility reasons, this parameter now only controls the default scrolling method used by cursors. This default behavior can be overriden by setting the second param of wxDb::wxDbGetConnection() or wxDb() constructor to indicate whether the connection (and any wxDbTables that use the connection) should support forward only scrolling of cursors, or both forward and backward support for backward scrolling cursors is dependent on the data source as well as the ODBC driver being used. Default: 1

Database classes overview

0 0 wxODBC_BACKWARD_COMPATABILITY ODBC classes backward compatibility Set to 1 to use the deprecated classes, enum types, function, member variables. With a setting of 1, full backward compatability with the 2.0.x release is possible. It is STRONGLY recommended that this be set to 0, as future development will be done only on the non-deprecated functions/classes/member variables/etc. Default: 0

Database classes overview

1 0 Platform-specific

1 0 wxMSW

1 1 wxUSE_OWNER_DRAWN Owner-drawn controls Set this to 1 to enable support for the owner-drawn menu and listboxes. This is required by wxUSE_CHECKLISTBOX. Default: 1. Recommended setting: 1, set to 0 for a small library size reduction.

__WXMSW__

1 1 wxUSE_RICHEDIT Rich edit control support Set this to 1 to use RICHEDIT controls for wxTextCtrl with style wxTE_RICH which allows to put more than ~32Kb of text in it even under Win9x (NT doesn't have such limitation). Default: 1 for compilers which support it Recommended setting: 1, only set it to 0 if your compiler doesn't have or can't compile richedit.h.

__WXMSW__

1 1 wxUSE_RICHEDIT2 Rich edit control version 2 Enable rich edit version 2.0. Default: 1

__WXMSW__

1 0 wxUSE_MFC MFC interoperation Set this to 1 if you want to use wxWindows and MFC in the same program. This will override some other settings. Default: 0. Recommended setting: 0 unless you really have to use MFC

__WXMSW__

1 1 wxUSE_OLE OLE support Set this to 1 for generic OLE support: this is required for drag-and-drop, clipboard, OLE Automation. Only set it to 0 if your compiler is very old and can't compile/doesn't have the OLE headers. Default: 1. Recommended setting: 1

__WXMSW__

--enable-ole

1 1 wxUSE_UXTHEME MS Windows XP UX Theme Engine support Set to 1 to compile MS Windows XP theme engine support.

__WXMSW__

1 1 wxUSE_UXTHEME_AUTO MS Windows XP UX Theme Engine auto-adaptation Set to 1 to auto-adapt to MS Windows XP themes where possible (notably, wxNotebook pages).

wxUSE_UXTHEME

__WXMSW__

1 1 wxUSE_DC_CACHEING Caches device contexts to improve performance. This is a Windows-only option. Default: 1

__WXMSW__

1 0 wxUSE_DIB_FOR_BITMAP Set this to 1 to enable the use of DIB's for wxBitmap to support bitmaps > 16MB on Win95/98/Me. Set to 0 to use DDB's only. Default: 0

__WXMSW__

1 0 wxGTK

0 1 wxUSE_GTKTEST GTK+ test Try to compile and run a test GTK program.

__WXGTK__

--enable-gtktest

0 0 wxUSE_GTKPREFIX GTK+ prefix Prefix where GTK+ is installed (optional). Type the prefix into the value field.

__WXGTK__

--with-gtk-prefix

0 0 wxUSE_GTKEXECPREFIX GTK+ exec prefix Exec prefix where GTK+ is installed (optional). Type the prefix into the value field.

__WXGTK__

--with-gtk-exec-prefix

1 0 wxUSE_LIBICONV_PREFIX libiconv prefix Search for libiconv in DIR/include and DIR/lib. Type the prefix into the value field.

--with-libiconv-prefix

0 1 wxUSE_X Use X Use the X window system.

__WXGTK__

--with-x