]> git.saurik.com Git - wxWidgets.git/blame - include/wx/univ/setup0.h
Make Unix wxAppConsole signal handling more flexible.
[wxWidgets.git] / include / wx / univ / setup0.h
CommitLineData
3b7c589c 1/////////////////////////////////////////////////////////////////////////////
2b5f62a0 2// Name: wx/univ/setup.h
3b7c589c
VZ
3// Purpose: Configuration for the universal build of the library
4// Author: Julian Smart
5// Created: 01/02/97
2b5f62a0 6// RCS-ID: $Id$
3b7c589c 7// Copyright: (c) Julian Smart
65571936 8// Licence: wxWindows licence
3b7c589c 9/////////////////////////////////////////////////////////////////////////////
b1ab4762 10
3b7c589c
VZ
11#ifndef _WX_SETUP_H_
12#define _WX_SETUP_H_
b1ab4762 13
3b7c589c 14/* --- start common options --- */
2b5f62a0
VZ
15// ----------------------------------------------------------------------------
16// global settings
17// ----------------------------------------------------------------------------
18
19// define this to 0 when building wxBase library - this can also be done from
20// makefile/project file overriding the value here
21#ifndef wxUSE_GUI
b1ab4762 22 #define wxUSE_GUI 1
2b5f62a0
VZ
23#endif // wxUSE_GUI
24
25// ----------------------------------------------------------------------------
26// compatibility settings
27// ----------------------------------------------------------------------------
28
dee1a63f 29// This setting determines the compatibility with 2.6 API: set it to 0 to
134ecc85
VZ
30// flag all cases of using deprecated functions.
31//
32// Default is 1 but please try building your code with 0 as the default will
33// change to 0 in the next version and the deprecated functions will disappear
34// in the version after it completely.
35//
36// Recommended setting: 0 (please update your code)
abb6edd1
VS
37#define WXWIN_COMPATIBILITY_2_6 0
38
39// This setting determines the compatibility with 2.8 API: set it to 0 to
40// flag all cases of using deprecated functions.
41//
42// Default is 1 but please try building your code with 0 as the default will
43// change to 0 in the next version and the deprecated functions will disappear
44// in the version after it completely.
45//
46// Recommended setting: 0 (please update your code)
47#define WXWIN_COMPATIBILITY_2_8 1
134ecc85 48
b1ab4762
CE
49// MSW-only: Set to 0 for accurate dialog units, else 1 for old behaviour when
50// default system font is used for wxWindow::GetCharWidth/Height() instead of
51// the current font.
2b5f62a0 52//
b1ab4762 53// Default is 0
2b5f62a0 54//
b1ab4762
CE
55// Recommended setting: 0
56#define wxDIALOG_UNIT_COMPATIBILITY 0
2b5f62a0
VZ
57
58// ----------------------------------------------------------------------------
59// debugging settings
60// ----------------------------------------------------------------------------
61
ab06470e
VZ
62// wxDEBUG_LEVEL will be defined as 1 in wx/debug.h so normally there is no
63// need to define it here. You may do it for two reasons: either completely
64// disable/compile out the asserts in release version (then do it inside #ifdef
65// NDEBUG) or, on the contrary, enable more asserts, including the usually
66// disabled ones, in the debug build (then do it inside #ifndef NDEBUG)
67//
68// #ifdef NDEBUG
69// #define wxDEBUG_LEVEL 0
70// #else
71// #define wxDEBUG_LEVEL 2
72// #endif
73
74// wxHandleFatalExceptions() may be used to catch the program faults at run
75// time and, instead of terminating the program with a usual GPF message box,
76// call the user-defined wxApp::OnFatalException() function. If you set
77// wxUSE_ON_FATAL_EXCEPTION to 0, wxHandleFatalExceptions() will not work.
78//
79// This setting is for Win32 only and can only be enabled if your compiler
80// supports Win32 structured exception handling (currently only VC++ does)
81//
82// Default is 1
83//
84// Recommended setting: 1 if your compiler supports it.
85#define wxUSE_ON_FATAL_EXCEPTION 1
86
87// Set this to 1 to be able to generate a human-readable (unlike
88// machine-readable minidump created by wxCrashReport::Generate()) stack back
89// trace when your program crashes using wxStackWalker
90//
91// Default is 1 if supported by the compiler.
92//
93// Recommended setting: 1, set to 0 if your programs never crash
94#define wxUSE_STACKWALKER 1
95
96// Set this to 1 to compile in wxDebugReport class which allows you to create
97// and optionally upload to your web site a debug report consisting of back
98// trace of the crash (if wxUSE_STACKWALKER == 1) and other information.
99//
100// Default is 1 if supported by the compiler.
101//
102// Recommended setting: 1, it is compiled into a separate library so there
103// is no overhead if you don't use it
104#define wxUSE_DEBUGREPORT 1
105
2b5f62a0
VZ
106// Generic comment about debugging settings: they are very useful if you don't
107// use any other memory leak detection tools such as Purify/BoundsChecker, but
108// are probably redundant otherwise. Also, Visual C++ CRT has the same features
77ffb593 109// as wxWidgets memory debugging subsystem built in since version 5.0 and you
2b5f62a0
VZ
110// may prefer to use it instead of built in memory debugging code because it is
111// faster and more fool proof.
112//
ab06470e
VZ
113// Using VC++ CRT memory debugging is enabled by default in debug build (_DEBUG
114// is defined) if wxUSE_GLOBAL_MEMORY_OPERATORS is *not* enabled (i.e. is 0)
2b5f62a0
VZ
115// and if __NO_VC_CRTDBG__ is not defined.
116
ab06470e
VZ
117// The rest of the options in this section are obsolete and not supported,
118// enable them at your own risk.
119
2b5f62a0
VZ
120// If 1, enables wxDebugContext, for writing error messages to file, etc. If
121// __WXDEBUG__ is not defined, will still use the normal memory operators.
122//
123// Default is 0
124//
125// Recommended setting: 0
b1ab4762 126#define wxUSE_DEBUG_CONTEXT 0
2b5f62a0
VZ
127
128// If 1, enables debugging versions of wxObject::new and wxObject::delete *IF*
129// __WXDEBUG__ is also defined.
130//
131// WARNING: this code may not work with all architectures, especially if
132// alignment is an issue. This switch is currently ignored for mingw / cygwin
133//
134// Default is 0
135//
136// Recommended setting: 1 if you are not using a memory debugging tool, else 0
137#define wxUSE_MEMORY_TRACING 0
138
139// In debug mode, cause new and delete to be redefined globally.
140// If this causes problems (e.g. link errors which is a common problem
141// especially if you use another library which also redefines the global new
142// and delete), set this to 0.
143// This switch is currently ignored for mingw / cygwin
144//
145// Default is 0
146//
147// Recommended setting: 0
148#define wxUSE_GLOBAL_MEMORY_OPERATORS 0
149
150// In debug mode, causes new to be defined to be WXDEBUG_NEW (see object.h). If
151// this causes problems (e.g. link errors), set this to 0. You may need to set
152// this to 0 if using templates (at least for VC++). This switch is currently
2415cf67 153// ignored for MinGW/Cygwin.
2b5f62a0
VZ
154//
155// Default is 0
156//
157// Recommended setting: 0
158#define wxUSE_DEBUG_NEW_ALWAYS 0
159
2b5f62a0
VZ
160
161// ----------------------------------------------------------------------------
162// Unicode support
163// ----------------------------------------------------------------------------
164
3b7c589c
VZ
165// These settings are obsolete: the library is always built in Unicode mode
166// now, only set wxUSE_UNICODE to 0 to compile legacy code in ANSI mode if
167// absolutely necessary -- updating it is strongly recommended as the ANSI mode
168// will disappear completely in future wxWidgets releases.
86c8acb7 169#ifndef wxUSE_UNICODE
3b7c589c 170 #define wxUSE_UNICODE 1
86c8acb7 171#endif
2b5f62a0 172
3b7c589c 173// wxUSE_WCHAR_T is required by wxWidgets now, don't change.
b1ab4762 174#define wxUSE_WCHAR_T 1
2b5f62a0
VZ
175
176// ----------------------------------------------------------------------------
177// global features
178// ----------------------------------------------------------------------------
179
c37dc21c
VZ
180// Compile library in exception-safe mode? If set to 1, the library will try to
181// behave correctly in presence of exceptions (even though it still will not
182// use the exceptions itself) and notify the user code about any unhandled
183// exceptions. If set to 0, propagation of the exceptions through the library
184// code will lead to undefined behaviour -- but the code itself will be
185// slightly smaller and faster.
186//
b1ab4762
CE
187// Note that like wxUSE_THREADS this option is automatically set to 0 if
188// wxNO_EXCEPTIONS is defined.
189//
c37dc21c
VZ
190// Default is 1
191//
192// Recommended setting: depends on whether you intend to use C++ exceptions
193// in your own code (1 if you do, 0 if you don't)
194#define wxUSE_EXCEPTIONS 1
195
b1ab4762
CE
196// Set wxUSE_EXTENDED_RTTI to 1 to use extended RTTI
197//
198// Default is 0
199//
200// Recommended setting: 0 (this is still work in progress...)
201#define wxUSE_EXTENDED_RTTI 0
202
2b5f62a0
VZ
203// Support for message/error logging. This includes wxLogXXX() functions and
204// wxLog and derived classes. Don't set this to 0 unless you really know what
205// you are doing.
206//
207// Default is 1
208//
209// Recommended setting: 1 (always)
210#define wxUSE_LOG 1
211
2b5f62a0
VZ
212// Recommended setting: 1
213#define wxUSE_LOGWINDOW 1
214
215// Recommended setting: 1
216#define wxUSE_LOGGUI 1
217
218// Recommended setting: 1
219#define wxUSE_LOG_DIALOG 1
220
715d7d25
JS
221// Support for command line parsing using wxCmdLineParser class.
222//
223// Default is 1
224//
225// Recommended setting: 1 (can be set to 0 if you don't use the cmd line)
226#define wxUSE_CMDLINE_PARSER 1
227
2b5f62a0
VZ
228// Support for multithreaded applications: if 1, compile in thread classes
229// (thread.h) and make the library a bit more thread safe. Although thread
230// support is quite stable by now, you may still consider recompiling the
231// library without it if you have no use for it - this will result in a
232// somewhat smaller and faster operation.
233//
b1ab4762
CE
234// Notice that if wxNO_THREADS is defined, wxUSE_THREADS is automatically reset
235// to 0 in wx/chkconf.h, so, for example, if you set USE_THREADS to 0 in
236// build/msw/config.* file this value will have no effect.
2b5f62a0
VZ
237//
238// Default is 1
239//
240// Recommended setting: 0 unless you do plan to develop MT applications
241#define wxUSE_THREADS 1
242
b1ab4762
CE
243// If enabled, compiles wxWidgets streams classes
244//
245// wx stream classes are used for image IO, process IO redirection, network
246// protocols implementation and much more and so disabling this results in a
247// lot of other functionality being lost.
248//
249// Default is 1
250//
251// Recommended setting: 1 as setting it to 0 disables many other things
252#define wxUSE_STREAMS 1
2b5f62a0 253
01871bf6
VZ
254// Support for positional parameters (e.g. %1$d, %2$s ...) in wxVsnprintf.
255// Note that if the system's implementation does not support positional
256// parameters, setting this to 1 forces the use of the wxWidgets implementation
257// of wxVsnprintf. The standard vsnprintf() supports positional parameters on
258// many Unix systems but usually doesn't under Windows.
259//
260// Positional parameters are very useful when translating a program since using
261// them in formatting strings allow translators to correctly reorder the
262// translated sentences.
263//
264// Default is 1
265//
266// Recommended setting: 1 if you want to support multiple languages
267#define wxUSE_PRINTF_POS_PARAMS 1
268
b33e9f40
VZ
269// Enable the use of compiler-specific thread local storage keyword, if any.
270// This is used for wxTLS_XXX() macros implementation and normally should use
271// the compiler-provided support as it's simpler and more efficient, but must
272// not use it if wxWidgets is used in a dynamically loaded Win32 (i.e. using
273// LoadLibrary()/GetProcAddress()) as this triggers a bug in compiler TLS
274// support that results in crashes when any TLS variables are used. So if you
275// are building a Win32 DLL using wxWidgets that can be loaded dynamically, set
276// this to 0.
277//
278// Default is 1, but set to 0 if the scenario above is applicable.
279#define wxUSE_COMPILER_TLS 1
01871bf6
VZ
280
281// ----------------------------------------------------------------------------
282// Interoperability with the standard library.
283// ----------------------------------------------------------------------------
284
285// Set wxUSE_STL to 1 to enable maximal interoperability with the standard
286// library, even at the cost of backwards compatibility.
287//
288// Default is 0
289//
290// Recommended setting: 0 as the options below already provide a relatively
291// good level of interoperability and changing this option arguably isn't worth
292// diverging from the official builds of the library.
293#define wxUSE_STL 0
294
bb445ba7 295// This is not a real option but is used as the default value for
01871bf6 296// wxUSE_STD_IOSTREAM, wxUSE_STD_STRING and wxUSE_STD_CONTAINERS.
bb445ba7
VZ
297//
298// Currently the Digital Mars and Watcom compilers come without standard C++
299// library headers by default, wxUSE_STD_STRING can be set to 1 if you do have
300// them (e.g. from STLPort).
301//
302// VC++ 5.0 does include standard C++ library headers, however they produce
303// many warnings that can't be turned off when compiled at warning level 4.
304#if defined(__DMC__) || defined(__WATCOMC__) \
305 || (defined(_MSC_VER) && _MSC_VER < 1200)
306 #define wxUSE_STD_DEFAULT 0
307#else
308 #define wxUSE_STD_DEFAULT 1
309#endif
310
01871bf6
VZ
311// Use standard C++ containers to implement wxVector<>, wxStack<>, wxDList<>
312// and wxHashXXX<> classes. If disabled, wxWidgets own (mostly compatible but
313// usually more limited) implementations are used which allows to avoid the
314// dependency on the C++ run-time library.
315//
7311debd
VZ
316// Notice that the compilers mentioned in wxUSE_STD_DEFAULT comment above don't
317// support using standard containers and that VC6 needs non-default options for
318// such build to avoid getting "fatal error C1076: compiler limit : internal
319// heap limit reached; use /Zm to specify a higher limit" in its own standard
320// headers, so you need to ensure you do increase the heap size before enabling
321// this option for this compiler.
322//
323// Default is 0 for compatibility reasons.
324//
325// Recommended setting: 1 unless compatibility with the official wxWidgets
326// build and/or the existing code is a concern.
327#define wxUSE_STD_CONTAINERS 0
01871bf6 328
b1ab4762 329// Use standard C++ streams if 1 instead of wx streams in some places. If
01871bf6
VZ
330// disabled, wx streams are used everywhere and wxWidgets doesn't depend on the
331// standard streams library.
b1ab4762
CE
332//
333// Notice that enabling this does not replace wx streams with std streams
334// everywhere, in a lot of places wx streams are used no matter what.
335//
01871bf6 336// Default is 1 if compiler supports it.
b1ab4762
CE
337//
338// Recommended setting: 1 if you use the standard streams anyhow and so
339// dependency on the standard streams library is not a
340// problem
bb445ba7 341#define wxUSE_STD_IOSTREAM wxUSE_STD_DEFAULT
2b5f62a0 342
01871bf6
VZ
343// Enable minimal interoperability with the standard C++ string class if 1.
344// "Minimal" means that wxString can be constructed from std::string or
345// std::wstring but can't be implicitly converted to them. You need to enable
346// the option below for the latter.
8bb9d852
MW
347//
348// Default is 1 for most compilers.
349//
bb445ba7
VZ
350// Recommended setting: 1 unless you want to ensure your program doesn't use
351// the standard C++ library at all.
352#define wxUSE_STD_STRING wxUSE_STD_DEFAULT
8bb9d852 353
01871bf6
VZ
354// Make wxString as much interchangeable with std::[w]string as possible, in
355// particular allow implicit conversion of wxString to either of these classes.
356// This comes at a price (or a benefit, depending on your point of view) of not
357// allowing implicit conversion to "const char *" and "const wchar_t *".
b41af6aa 358//
01871bf6
VZ
359// Because a lot of existing code relies on these conversions, this option is
360// disabled by default but can be enabled for your build if you don't care
361// about compatibility.
b41af6aa 362//
01871bf6 363// Default is 0 if wxUSE_STL has its default value or 1 if it is enabled.
b41af6aa 364//
01871bf6
VZ
365// Recommended setting: 0 to remain compatible with the official builds of
366// wxWidgets.
367#define wxUSE_STD_STRING_CONV_IN_WXSTRING wxUSE_STL
368
02f170d7
VZ
369// VC++ 4.2 and above allows <iostream> and <iostream.h> but you can't mix
370// them. Set this option to 1 to use <iostream.h>, 0 to use <iostream>.
371//
372// Note that newer compilers (including VC++ 7.1 and later) don't support
373// wxUSE_IOSTREAMH == 1 and so <iostream> will be used anyhow.
374//
375// Default is 0.
376//
377// Recommended setting: 0, only set to 1 if you use a really old compiler
378#define wxUSE_IOSTREAMH 0
379
b41af6aa 380
2b5f62a0
VZ
381// ----------------------------------------------------------------------------
382// non GUI features selection
383// ----------------------------------------------------------------------------
384
385// Set wxUSE_LONGLONG to 1 to compile the wxLongLong class. This is a 64 bit
386// integer which is implemented in terms of native 64 bit integers if any or
387// uses emulation otherwise.
388//
389// This class is required by wxDateTime and so you should enable it if you want
390// to use wxDateTime. For most modern platforms, it will use the native 64 bit
391// integers in which case (almost) all of its functions are inline and it
392// almost does not take any space, so there should be no reason to switch it
393// off.
394//
395// Recommended setting: 1
b1ab4762
CE
396#define wxUSE_LONGLONG 1
397
398// Set wxUSE_BASE64 to 1, to compile in Base64 support. This is required for
399// storing binary data in wxConfig on most platforms.
400//
401// Default is 1.
402//
403// Recommended setting: 1 (but can be safely disabled if you don't use it)
404#define wxUSE_BASE64 1
405
406// Set this to 1 to be able to use wxEventLoop even in console applications
407// (i.e. using base library only, without GUI). This is mostly useful for
408// processing socket events but is also necessary to use timers in console
409// applications
410//
411// Default is 1.
412//
413// Recommended setting: 1 (but can be safely disabled if you don't use it)
414#define wxUSE_CONSOLE_EVENTLOOP 1
2b5f62a0
VZ
415
416// Set wxUSE_(F)FILE to 1 to compile wx(F)File classes. wxFile uses low level
417// POSIX functions for file access, wxFFile uses ANSI C stdio.h functions.
418//
419// Default is 1
420//
421// Recommended setting: 1 (wxFile is highly recommended as it is required by
422// i18n code, wxFileConfig and others)
b1ab4762
CE
423#define wxUSE_FILE 1
424#define wxUSE_FFILE 1
2b5f62a0
VZ
425
426// Use wxFSVolume class providing access to the configured/active mount points
427//
428// Default is 1
429//
430// Recommended setting: 1 (but may be safely disabled if you don't use it)
b1ab4762 431#define wxUSE_FSVOLUME 1
2b5f62a0 432
a28b4703
WS
433// Use wxStandardPaths class which allows to retrieve some standard locations
434// in the file system
435//
436// Default is 1
437//
438// Recommended setting: 1 (may be disabled to save space, but not much)
439#define wxUSE_STDPATHS 1
440
2b5f62a0 441// use wxTextBuffer class: required by wxTextFile
b1ab4762 442#define wxUSE_TEXTBUFFER 1
2b5f62a0
VZ
443
444// use wxTextFile class: requires wxFile and wxTextBuffer, required by
445// wxFileConfig
b1ab4762 446#define wxUSE_TEXTFILE 1
2b5f62a0
VZ
447
448// i18n support: _() macro, wxLocale class. Requires wxTextFile.
b1ab4762 449#define wxUSE_INTL 1
2b5f62a0 450
6e4ae332
VZ
451// Provide wxFoo_l() functions similar to standard foo() functions but taking
452// an extra locale parameter.
453//
454// Notice that this is fully implemented only for the systems providing POSIX
455// xlocale support or Microsoft Visual C++ >= 8 (which provides proprietary
456// almost-equivalent of xlocale functions), otherwise wxFoo_l() functions will
457// only work for the current user locale and "C" locale. You can use
458// wxHAS_XLOCALE_SUPPORT to test whether the full support is available.
459//
460// Default is 1
461//
462// Recommended setting: 1 but may be disabled if you are writing programs
463// running only in C locale anyhow
464#define wxUSE_XLOCALE 1
465
2b5f62a0
VZ
466// Set wxUSE_DATETIME to 1 to compile the wxDateTime and related classes which
467// allow to manipulate dates, times and time intervals. wxDateTime replaces the
468// old wxTime and wxDate classes which are still provided for backwards
469// compatibility (and implemented in terms of wxDateTime).
470//
471// Note that this class is relatively new and is still officially in alpha
472// stage because some features are not yet (fully) implemented. It is already
473// quite useful though and should only be disabled if you are aiming at
474// absolutely minimal version of the library.
475//
476// Requires: wxUSE_LONGLONG
477//
478// Default is 1
479//
480// Recommended setting: 1
b1ab4762 481#define wxUSE_DATETIME 1
2b5f62a0 482
2b5f62a0
VZ
483// Set wxUSE_TIMER to 1 to compile wxTimer class
484//
485// Default is 1
486//
487// Recommended setting: 1
b1ab4762 488#define wxUSE_TIMER 1
2b5f62a0
VZ
489
490// Use wxStopWatch clas.
491//
492// Default is 1
493//
494// Recommended setting: 1 (needed by wxSocket)
b1ab4762 495#define wxUSE_STOPWATCH 1
2b5f62a0 496
6b8ef0b3
VZ
497// Set wxUSE_FSWATCHER to 1 if you want to enable wxFileSystemWatcher
498//
499// Default is 1
500//
501// Recommended setting: 1
502#define wxUSE_FSWATCHER 1
503
2b5f62a0
VZ
504// Setting wxUSE_CONFIG to 1 enables the use of wxConfig and related classes
505// which allow the application to store its settings in the persistent
506// storage. Setting this to 1 will also enable on-demand creation of the
507// global config object in wxApp.
508//
509// See also wxUSE_CONFIG_NATIVE below.
510//
511// Recommended setting: 1
b1ab4762 512#define wxUSE_CONFIG 1
2b5f62a0
VZ
513
514// If wxUSE_CONFIG is 1, you may choose to use either the native config
515// classes under Windows (using .INI files under Win16 and the registry under
516// Win32) or the portable text file format used by the config classes under
517// Unix.
518//
519// Default is 1 to use native classes. Note that you may still use
520// wxFileConfig even if you set this to 1 - just the config object created by
521// default for the applications needs will be a wxRegConfig or wxIniConfig and
522// not wxFileConfig.
523//
b1ab4762
CE
524// Recommended setting: 1
525#define wxUSE_CONFIG_NATIVE 1
2b5f62a0
VZ
526
527// If wxUSE_DIALUP_MANAGER is 1, compile in wxDialUpManager class which allows
528// to connect/disconnect from the network and be notified whenever the dial-up
529// network connection is established/terminated. Requires wxUSE_DYNAMIC_LOADER.
530//
531// Default is 1.
532//
533// Recommended setting: 1
b1ab4762 534#define wxUSE_DIALUP_MANAGER 1
2b5f62a0
VZ
535
536// Compile in classes for run-time DLL loading and function calling.
537// Required by wxUSE_DIALUP_MANAGER.
538//
539// This setting is for Win32 only
540//
541// Default is 1.
542//
543// Recommended setting: 1
b1ab4762 544#define wxUSE_DYNLIB_CLASS 1
2b5f62a0
VZ
545
546// experimental, don't use for now
b1ab4762 547#define wxUSE_DYNAMIC_LOADER 1
2b5f62a0
VZ
548
549// Set to 1 to use socket classes
b1ab4762 550#define wxUSE_SOCKETS 1
2b5f62a0 551
3b7c589c
VZ
552// Set to 1 to use ipv6 socket classes (requires wxUSE_SOCKETS)
553//
554// Notice that currently setting this option under Windows will result in
555// programs which can only run on recent OS versions (with ws2_32.dll
556// installed) which is why it is disabled by default.
557//
558// Default is 1.
559//
560// Recommended setting: 1 if you need IPv6 support
561#define wxUSE_IPV6 0
562
2b5f62a0 563// Set to 1 to enable virtual file systems (required by wxHTML)
b1ab4762 564#define wxUSE_FILESYSTEM 1
2b5f62a0
VZ
565
566// Set to 1 to enable virtual ZIP filesystem (requires wxUSE_FILESYSTEM)
b1ab4762 567#define wxUSE_FS_ZIP 1
2b5f62a0 568
26e422a9
MW
569// Set to 1 to enable virtual archive filesystem (requires wxUSE_FILESYSTEM)
570#define wxUSE_FS_ARCHIVE 1
571
b1ab4762
CE
572// Set to 1 to enable virtual Internet filesystem (requires wxUSE_FILESYSTEM)
573#define wxUSE_FS_INET 1
574
81f90336 575// wxArchive classes for accessing archives such as zip and tar
b1ab4762 576#define wxUSE_ARCHIVE_STREAMS 1
81f90336 577
2b5f62a0 578// Set to 1 to compile wxZipInput/OutputStream classes.
b1ab4762 579#define wxUSE_ZIPSTREAM 1
2b5f62a0 580
26e422a9
MW
581// Set to 1 to compile wxTarInput/OutputStream classes.
582#define wxUSE_TARSTREAM 1
583
2b5f62a0 584// Set to 1 to compile wxZlibInput/OutputStream classes. Also required by
477a6238 585// wxUSE_LIBPNG
6f96ac03
VZ
586#define wxUSE_ZLIB 1
587
2b5f62a0
VZ
588// If enabled, the code written by Apple will be used to write, in a portable
589// way, float on the disk. See extended.c for the license which is different
77ffb593 590// from wxWidgets one.
2b5f62a0
VZ
591//
592// Default is 1.
593//
594// Recommended setting: 1 unless you don't like the license terms (unlikely)
b1ab4762 595#define wxUSE_APPLE_IEEE 1
2b5f62a0
VZ
596
597// Joystick support class
b1ab4762
CE
598#define wxUSE_JOYSTICK 1
599
600// wxFontEnumerator class
601#define wxUSE_FONTENUM 1
2b5f62a0
VZ
602
603// wxFontMapper class
604#define wxUSE_FONTMAP 1
605
606// wxMimeTypesManager class
607#define wxUSE_MIMETYPE 1
608
609// wxProtocol and related classes: if you want to use either of wxFTP, wxHTTP
610// or wxURL you need to set this to 1.
611//
612// Default is 1.
613//
614// Recommended setting: 1
615#define wxUSE_PROTOCOL 1
616
2b5f62a0
VZ
617// The settings for the individual URL schemes
618#define wxUSE_PROTOCOL_FILE 1
619#define wxUSE_PROTOCOL_FTP 1
620#define wxUSE_PROTOCOL_HTTP 1
621
715d7d25
JS
622// Define this to use wxURL class.
623#define wxUSE_URL 1
624
b1ab4762
CE
625// Define this to use native platform url and protocol support.
626// Currently valid only for MS-Windows.
627// Note: if you set this to 1, you can open ftp/http/gopher sites
628// and obtain a valid input stream for these sites
629// even when you set wxUSE_PROTOCOL_FTP/HTTP to 0.
630// Doing so reduces the code size.
631//
632// This code is experimental and subject to change.
633#define wxUSE_URL_NATIVE 0
634
b6428aba
WS
635// Support for wxVariant class used in several places throughout the library,
636// notably in wxDataViewCtrl API.
637//
638// Default is 1.
639//
640// Recommended setting: 1 unless you want to reduce the library size as much as
641// possible in which case setting this to 0 can gain up to 100KB.
642#define wxUSE_VARIANT 1
643
178c7760
JS
644// Support for wxAny class, the successor for wxVariant.
645//
646// Default is 1.
647//
648// Recommended setting: 1 unless you want to reduce the library size by a small amount,
649// or your compiler cannot for some reason cope with complexity of templates used.
650#define wxUSE_ANY 1
651
2b5f62a0
VZ
652// Support for regular expression matching via wxRegEx class: enable this to
653// use POSIX regular expressions in your code. You need to compile regex
654// library from src/regex to use it under Windows.
655//
656// Default is 0
657//
658// Recommended setting: 1 if your compiler supports it, if it doesn't please
659// contribute us a makefile for src/regex for it
b1ab4762 660#define wxUSE_REGEX 1
2b5f62a0
VZ
661
662// wxSystemOptions class
663#define wxUSE_SYSTEM_OPTIONS 1
664
002ed9af 665// wxSound class
b1ab4762 666#define wxUSE_SOUND 1
2b5f62a0 667
c8a50408
RN
668// Use wxMediaCtrl
669//
670// Default is 1.
671//
922bcaff 672// Recommended setting: 1
c8a50408
RN
673#define wxUSE_MEDIACTRL 1
674
9581c3c6
RN
675// Use wxWidget's XRC XML-based resource system. Recommended.
676//
677// Default is 1
678//
84fe931d 679// Recommended setting: 1 (requires wxUSE_XML)
9581c3c6
RN
680#define wxUSE_XRC 1
681
7de1e98d
JS
682// XML parsing classes. Note that their API will change in the future, so
683// using wxXmlDocument and wxXmlNode in your app is not recommended.
684//
b1ab4762 685// Default is the same as wxUSE_XRC, i.e. 1 by default.
7de1e98d 686//
9581c3c6 687// Recommended setting: 1 (required by XRC)
b1ab4762 688#define wxUSE_XML wxUSE_XRC
7de1e98d 689
5e4903f5
JS
690// Use wxWidget's AUI docking system
691//
692// Default is 1
693//
694// Recommended setting: 1
695#define wxUSE_AUI 1
696
3c3ead1d
PC
697// Use wxWidget's Ribbon classes for interfaces
698//
699// Default is 1
700//
701// Recommended setting: 1
702#define wxUSE_RIBBON 1
703
1c4293cb
VZ
704// Use wxPropertyGrid.
705//
706// Default is 1
707//
708// Recommended setting: 1
709#define wxUSE_PROPGRID 1
710
29825f5f
PC
711// Use wxStyledTextCtrl, a wxWidgets implementation of Scintilla.
712//
713// Default is 1
714//
715// Recommended setting: 1
716#define wxUSE_STC 1
717
d60b34a4
SL
718// Use wxWidget's web viewing classes
719//
720// Default is 1
721//
722// Recommended setting: 1
723#define wxUSE_WEBVIEW 1
724
725// Use the IE wxWebView backend
726//
727// Default is 1 on MSW
728//
729// Recommended setting: 1
730#ifdef __WXMSW__
731#define wxUSE_WEBVIEW_IE 1
732#else
733#define wxUSE_WEBVIEW_IE 0
734#endif
735
736// Use the WebKit wxWebView backend
737//
738// Default is 1 on GTK and OSX
739//
740// Recommended setting: 1
741#if defined(__WXGTK__) || defined(__WXOSX__)
742#define wxUSE_WEBVIEW_WEBKIT 1
743#else
744#define wxUSE_WEBVIEW_WEBKIT 0
745#endif
9fb52312
WS
746
747// Enable the new wxGraphicsPath and wxGraphicsContext classes for an advanced
748// 2D drawing API. (Still somewhat experimental)
749//
a12bd55b
VZ
750// Please note that on Windows gdiplus.dll is loaded dynamically which means
751// that nothing special needs to be done as long as you don't use
752// wxGraphicsContext at all or only use it on XP and later systems but you
753// still do need to distribute it yourself for an application using
754// wxGraphicsContext to be runnable on pre-XP systems.
9fb52312 755//
cde23b64
VZ
756// Default is 1 except if you're using a non-Microsoft compiler under Windows
757// as only MSVC7+ is known to ship with gdiplus.h. For other compilers (e.g.
758// mingw32) you may need to install the headers (and just the headers)
759// yourself. If you do, change the setting below manually.
9fb52312 760//
961f4d0c
VZ
761// Recommended setting: 1 if supported by the compilation environment
762
763// notice that we can't use wxCHECK_VISUALC_VERSION() here as this file is
764// included from wx/platform.h before wxCHECK_VISUALC_VERSION() is defined
765#ifdef _MSC_VER
cc16513e
VZ
766# if _MSC_VER >= 1310
767 // MSVC7.1+ comes with new enough Platform SDK, enable
768 // wxGraphicsContext support for it
961f4d0c
VZ
769# define wxUSE_GRAPHICS_CONTEXT 1
770# else
771 // MSVC 6 didn't include GDI+ headers so disable by default, enable it
772 // here if you use MSVC 6 with a newer SDK
773# define wxUSE_GRAPHICS_CONTEXT 0
774# endif
cde23b64 775#else
961f4d0c
VZ
776 // Disable support for other Windows compilers, enable it if your compiler
777 // comes with new enough SDK or you installed the headers manually.
778 //
779 // Notice that this will be set by configure under non-Windows platforms
780 // anyhow so the value there is not important.
781# define wxUSE_GRAPHICS_CONTEXT 0
cde23b64 782#endif
9fb52312 783
711a4812
VZ
784// Enable wxGraphicsContext implementation using Cairo library.
785//
786// This is not needed under Windows and detected automatically by configure
787// under other systems, however you may set this to 1 manually if you installed
788// Cairo under Windows yourself and prefer to use it instead the native GDI+
789// implementation.
790//
791// Default is 0
792//
793// Recommended setting: 0
794#define wxUSE_CAIRO 0
795
796
2b5f62a0
VZ
797// ----------------------------------------------------------------------------
798// Individual GUI controls
799// ----------------------------------------------------------------------------
800
801// You must set wxUSE_CONTROLS to 1 if you are using any controls at all
802// (without it, wxControl class is not compiled)
803//
804// Default is 1
805//
806// Recommended setting: 1 (don't change except for very special programs)
807#define wxUSE_CONTROLS 1
808
f5bdfc69
VZ
809// Support markup in control labels, i.e. provide wxControl::SetLabelMarkup().
810// Currently markup is supported only by a few controls and only some ports but
811// their number will increase with time.
812//
813// Default is 1
814//
815// Recommended setting: 1 (may be set to 0 if you want to save on code size)
816#define wxUSE_MARKUP 1
817
2b5f62a0
VZ
818// wxPopupWindow class is a top level transient window. It is currently used
819// to implement wxTipWindow
820//
821// Default is 1
822//
823// Recommended setting: 1 (may be set to 0 if you don't wxUSE_TIPWINDOW)
824#define wxUSE_POPUPWIN 1
825
826// wxTipWindow allows to implement the custom tooltips, it is used by the
827// context help classes. Requires wxUSE_POPUPWIN.
828//
829// Default is 1
830//
831// Recommended setting: 1 (may be set to 0)
832#define wxUSE_TIPWINDOW 1
833
77ffb593 834// Each of the settings below corresponds to one wxWidgets control. They are
2b5f62a0
VZ
835// all switched on by default but may be disabled if you are sure that your
836// program (including any standard dialogs it can show!) doesn't need them and
837// if you desperately want to save some space. If you use any of these you must
838// set wxUSE_CONTROLS as well.
839//
840// Default is 1
841//
842// Recommended setting: 1
b1ab4762 843#define wxUSE_ANIMATIONCTRL 1 // wxAnimationCtrl
ea11bf3a 844#define wxUSE_BANNERWINDOW 1 // wxBannerWindow
b1ab4762
CE
845#define wxUSE_BUTTON 1 // wxButton
846#define wxUSE_BMPBUTTON 1 // wxBitmapButton
847#define wxUSE_CALENDARCTRL 1 // wxCalendarCtrl
848#define wxUSE_CHECKBOX 1 // wxCheckBox
849#define wxUSE_CHECKLISTBOX 1 // wxCheckListBox (requires wxUSE_OWNER_DRAWN)
850#define wxUSE_CHOICE 1 // wxChoice
851#define wxUSE_COLLPANE 1 // wxCollapsiblePane
24bbfc62 852#define wxUSE_COLOURPICKERCTRL 1 // wxColourPickerCtrl
b1ab4762 853#define wxUSE_COMBOBOX 1 // wxComboBox
3571e1ad 854#define wxUSE_COMMANDLINKBUTTON 1 // wxCommandLinkButton
b1ab4762
CE
855#define wxUSE_DATAVIEWCTRL 1 // wxDataViewCtrl
856#define wxUSE_DATEPICKCTRL 1 // wxDatePickerCtrl
857#define wxUSE_DIRPICKERCTRL 1 // wxDirPickerCtrl
858#define wxUSE_EDITABLELISTBOX 1 // wxEditableListBox
859#define wxUSE_FILECTRL 1 // wxFileCtrl
860#define wxUSE_FILEPICKERCTRL 1 // wxFilePickerCtrl
861#define wxUSE_FONTPICKERCTRL 1 // wxFontPickerCtrl
862#define wxUSE_GAUGE 1 // wxGauge
e721a2a2 863#define wxUSE_HEADERCTRL 1 // wxHeaderCtrl
b1ab4762
CE
864#define wxUSE_HYPERLINKCTRL 1 // wxHyperlinkCtrl
865#define wxUSE_LISTBOX 1 // wxListBox
866#define wxUSE_LISTCTRL 1 // wxListCtrl
867#define wxUSE_RADIOBOX 1 // wxRadioBox
868#define wxUSE_RADIOBTN 1 // wxRadioButton
a1bdd4ab 869#define wxUSE_RICHMSGDLG 1 // wxRichMessageDialog
b1ab4762
CE
870#define wxUSE_SCROLLBAR 1 // wxScrollBar
871#define wxUSE_SEARCHCTRL 1 // wxSearchCtrl
872#define wxUSE_SLIDER 1 // wxSlider
873#define wxUSE_SPINBTN 1 // wxSpinButton
874#define wxUSE_SPINCTRL 1 // wxSpinCtrl
875#define wxUSE_STATBOX 1 // wxStaticBox
876#define wxUSE_STATLINE 1 // wxStaticLine
877#define wxUSE_STATTEXT 1 // wxStaticText
878#define wxUSE_STATBMP 1 // wxStaticBitmap
879#define wxUSE_TEXTCTRL 1 // wxTextCtrl
569c7d8c 880#define wxUSE_TIMEPICKCTRL 1 // wxTimePickerCtrl
b1ab4762
CE
881#define wxUSE_TOGGLEBTN 1 // requires wxButton
882#define wxUSE_TREECTRL 1 // wxTreeCtrl
524cb040 883#define wxUSE_TREELISTCTRL 1 // wxTreeListCtrl
2b5f62a0
VZ
884
885// Use a status bar class? Depending on the value of wxUSE_NATIVE_STATUSBAR
886// below either wxStatusBar95 or a generic wxStatusBar will be used.
887//
888// Default is 1
889//
890// Recommended setting: 1
b1ab4762 891#define wxUSE_STATUSBAR 1
2b5f62a0
VZ
892
893// Two status bar implementations are available under Win32: the generic one
894// or the wrapper around native control. For native look and feel the native
895// version should be used.
896//
b1ab4762 897// Default is 1 for the platforms where native status bar is supported.
2b5f62a0 898//
b1ab4762
CE
899// Recommended setting: 1 (there is no advantage in using the generic one)
900#define wxUSE_NATIVE_STATUSBAR 1
3b7c589c 901
2b5f62a0
VZ
902// wxToolBar related settings: if wxUSE_TOOLBAR is 0, don't compile any toolbar
903// classes at all. Otherwise, use the native toolbar class unless
8a82c9ec 904// wxUSE_TOOLBAR_NATIVE is 0.
2b5f62a0 905//
b1ab4762 906// Default is 1 for all settings.
2b5f62a0 907//
b1ab4762 908// Recommended setting: 1 for wxUSE_TOOLBAR and wxUSE_TOOLBAR_NATIVE.
2b5f62a0 909#define wxUSE_TOOLBAR 1
b1ab4762 910#define wxUSE_TOOLBAR_NATIVE 1
2b5f62a0 911
2b5f62a0 912// wxNotebook is a control with several "tabs" located on one of its sides. It
b1ab4762 913// may be used to logically organise the data presented to the user instead of
2b5f62a0
VZ
914// putting everything in one huge dialog. It replaces wxTabControl and related
915// classes of wxWin 1.6x.
916//
917// Default is 1.
918//
919// Recommended setting: 1
920#define wxUSE_NOTEBOOK 1
921
e9c0df38
VZ
922// wxListbook control is similar to wxNotebook but uses wxListCtrl instead of
923// the tabs
924//
925// Default is 1.
926//
927// Recommended setting: 1
928#define wxUSE_LISTBOOK 1
929
f5e0b4bc
WS
930// wxChoicebook control is similar to wxNotebook but uses wxChoice instead of
931// the tabs
932//
933// Default is 1.
934//
935// Recommended setting: 1
936#define wxUSE_CHOICEBOOK 1
937
eca15c0d
VZ
938// wxTreebook control is similar to wxNotebook but uses wxTreeCtrl instead of
939// the tabs
940//
941// Default is 1.
942//
943// Recommended setting: 1
944#define wxUSE_TREEBOOK 1
945
e36bdde2
WS
946// wxToolbook control is similar to wxNotebook but uses wxToolBar instead of
947// tabs
948//
949// Default is 1.
950//
951// Recommended setting: 1
952#define wxUSE_TOOLBOOK 1
953
b1ab4762
CE
954// wxTaskBarIcon is a small notification icon shown in the system toolbar or
955// dock.
956//
957// Default is 1.
958//
959// Recommended setting: 1 (but can be set to 0 if you don't need it)
960#define wxUSE_TASKBARICON 1
2b5f62a0 961
e36bdde2
WS
962// wxGrid class
963//
964// Default is 1, set to 0 to cut down compilation time and binaries size if you
965// don't use it.
966//
967// Recommended setting: 1
2b5f62a0 968//
b1ab4762
CE
969#define wxUSE_GRID 1
970
971// wxMiniFrame class: a frame with narrow title bar
972//
973// Default is 1.
974//
975// Recommended setting: 1 (it doesn't cost almost anything)
976#define wxUSE_MINIFRAME 1
2b5f62a0 977
e36bdde2
WS
978// wxComboCtrl and related classes: combobox with custom popup window and
979// not necessarily a listbox.
980//
981// Default is 1.
982//
983// Recommended setting: 1 but can be safely set to 0 except for wxUniv where it
984// it used by wxComboBox
985#define wxUSE_COMBOCTRL 1
986
987// wxOwnerDrawnComboBox is a custom combobox allowing to paint the combobox
988// items.
989//
990// Default is 1.
991//
95a46303
RR
992// Recommended setting: 1 but can be safely set to 0, except where it is
993// needed as a base class for generic wxBitmapComboBox.
e36bdde2
WS
994#define wxUSE_ODCOMBOBOX 1
995
b1ab4762 996// wxBitmapComboBox is a combobox that can have images in front of text items.
95a46303
RR
997//
998// Default is 1.
999//
1000// Recommended setting: 1 but can be safely set to 0
1001#define wxUSE_BITMAPCOMBOBOX 1
1002
f0bb342f
VZ
1003// wxRearrangeCtrl is a wxCheckListBox with two buttons allowing to move items
1004// up and down in it. It is also used as part of wxRearrangeDialog.
1005//
1006// Default is 1.
1007//
1008// Recommended setting: 1 but can be safely set to 0 (currently used only by
1009// wxHeaderCtrl)
1010#define wxUSE_REARRANGECTRL 1
1011
2b5f62a0
VZ
1012// ----------------------------------------------------------------------------
1013// Miscellaneous GUI stuff
1014// ----------------------------------------------------------------------------
1015
1016// wxAcceleratorTable/Entry classes and support for them in wxMenu(Bar)
1017#define wxUSE_ACCEL 1
1018
2e9b5717
VZ
1019// Use the standard art provider. The icons returned by this provider are
1020// embedded into the library as XPMs so disabling it reduces the library size
1021// somewhat but this should only be done if you use your own custom art
1022// provider returning the icons or never use any icons not provided by the
1023// native art provider (which might not be implemented at all for some
1024// platforms) or by the Tango icons provider (if it's not itself disabled
1025// below).
1026//
1027// Default is 1.
1028//
1029// Recommended setting: 1 unless you use your own custom art provider.
1030#define wxUSE_ARTPROVIDER_STD 1
1031
c1d2466a
VZ
1032// Use art provider providing Tango icons: this art provider has higher quality
1033// icons than the default ones using smaller size XPM icons without
1034// transparency but the embedded PNG icons add to the library size.
1035//
2e9b5717
VZ
1036// Default is 1 under non-GTK ports. Under wxGTK the native art provider using
1037// the GTK+ stock icons replaces it so it is normally not necessary.
c1d2466a
VZ
1038//
1039// Recommended setting: 1 but can be turned off to reduce the library size.
1040#define wxUSE_ARTPROVIDER_TANGO 1
1041
b1ab4762
CE
1042// Hotkey support (currently Windows only)
1043#define wxUSE_HOTKEY 1
1044
2b5f62a0
VZ
1045// Use wxCaret: a class implementing a "cursor" in a text control (called caret
1046// under Windows).
1047//
1048// Default is 1.
1049//
1050// Recommended setting: 1 (can be safely set to 0, not used by the library)
b1ab4762 1051#define wxUSE_CARET 1
2b5f62a0 1052
715d7d25 1053// Use wxDisplay class: it allows enumerating all displays on a system and
b1ab4762
CE
1054// their geometries as well as finding the display on which the given point or
1055// window lies.
715d7d25 1056//
b1ab4762 1057// Default is 1.
715d7d25
JS
1058//
1059// Recommended setting: 1 if you need it, can be safely set to 0 otherwise
b1ab4762 1060#define wxUSE_DISPLAY 1
715d7d25 1061
2b5f62a0 1062// Miscellaneous geometry code: needed for Canvas library
b1ab4762 1063#define wxUSE_GEOMETRY 1
2b5f62a0
VZ
1064
1065// Use wxImageList. This class is needed by wxNotebook, wxTreeCtrl and
1066// wxListCtrl.
1067//
1068// Default is 1.
1069//
1070// Recommended setting: 1 (set it to 0 if you don't use any of the controls
1071// enumerated above, then this class is mostly useless too)
b1ab4762 1072#define wxUSE_IMAGLIST 1
2b5f62a0 1073
a92b5dfe
VZ
1074// Use wxInfoBar class.
1075//
1076// Default is 1.
1077//
1078// Recommended setting: 1 (but can be disabled without problems as nothing
1079// depends on it)
1080#define wxUSE_INFOBAR 1
1081
2b5f62a0
VZ
1082// Use wxMenu, wxMenuBar, wxMenuItem.
1083//
1084// Default is 1.
1085//
1086// Recommended setting: 1 (can't be disabled under MSW)
b1ab4762 1087#define wxUSE_MENUS 1
2b5f62a0 1088
3b7c589c
VZ
1089// Use wxNotificationMessage.
1090//
1091// wxNotificationMessage allows to show non-intrusive messages to the user
1092// using balloons, banners, popups or whatever is the appropriate method for
1093// the current platform.
1094//
1095// Default is 1.
1096//
1097// Recommended setting: 1
1098#define wxUSE_NOTIFICATION_MESSAGE 1
1099
e520c3f7
VZ
1100// wxRichToolTip is a customizable tooltip class which has more functionality
1101// than the stock (but native, unlike this class) wxToolTip.
1102//
1103// Default is 1.
1104//
1105// Recommended setting: 1 (but can be safely set to 0 if you don't need it)
1106#define wxUSE_RICHTOOLTIP 1
1107
2b5f62a0
VZ
1108// Use wxSashWindow class.
1109//
1110// Default is 1.
1111//
1112// Recommended setting: 1
b1ab4762 1113#define wxUSE_SASH 1
2b5f62a0
VZ
1114
1115// Use wxSplitterWindow class.
1116//
1117// Default is 1.
1118//
1119// Recommended setting: 1
b1ab4762 1120#define wxUSE_SPLITTER 1
2b5f62a0
VZ
1121
1122// Use wxToolTip and wxWindow::Set/GetToolTip() methods.
1123//
1124// Default is 1.
1125//
1126// Recommended setting: 1
b1ab4762 1127#define wxUSE_TOOLTIPS 1
2b5f62a0
VZ
1128
1129// wxValidator class and related methods
1130#define wxUSE_VALIDATORS 1
1131
3b7c589c
VZ
1132// Use reference counted ID management: this means that wxWidgets will track
1133// the automatically allocated ids (those used when you use wxID_ANY when
1134// creating a window, menu or toolbar item &c) instead of just supposing that
1135// the program never runs out of them. This is mostly useful only under wxMSW
1136// where the total ids range is limited to SHRT_MIN..SHRT_MAX and where
1137// long-running programs can run into problems with ids reuse without this. On
1138// the other platforms, where the ids have the full int range, this shouldn't
1139// be necessary.
1140#ifdef __WXMSW__
1141#define wxUSE_AUTOID_MANAGEMENT 1
1142#else
1143#define wxUSE_AUTOID_MANAGEMENT 0
1144#endif
1145
2b5f62a0
VZ
1146// ----------------------------------------------------------------------------
1147// common dialogs
1148// ----------------------------------------------------------------------------
1149
2b5f62a0
VZ
1150// On rare occasions (e.g. using DJGPP) may want to omit common dialogs (e.g.
1151// file selector, printer dialog). Switching this off also switches off the
1152// printing architecture and interactive wxPrinterDC.
1153//
1154// Default is 1
1155//
1156// Recommended setting: 1 (unless it really doesn't work)
1157#define wxUSE_COMMON_DIALOGS 1
1158
1159// wxBusyInfo displays window with message when app is busy. Works in same way
1160// as wxBusyCursor
b1ab4762 1161#define wxUSE_BUSYINFO 1
2b5f62a0
VZ
1162
1163// Use single/multiple choice dialogs.
1164//
1165// Default is 1
1166//
1167// Recommended setting: 1 (used in the library itself)
b1ab4762 1168#define wxUSE_CHOICEDLG 1
2b5f62a0
VZ
1169
1170// Use colour picker dialog
1171//
1172// Default is 1
1173//
1174// Recommended setting: 1
b1ab4762 1175#define wxUSE_COLOURDLG 1
2b5f62a0
VZ
1176
1177// wxDirDlg class for getting a directory name from user
1178#define wxUSE_DIRDLG 1
1179
1180// TODO: setting to choose the generic or native one
1181
1182// Use file open/save dialogs.
1183//
1184// Default is 1
1185//
1186// Recommended setting: 1 (used in many places in the library itself)
b1ab4762 1187#define wxUSE_FILEDLG 1
2b5f62a0
VZ
1188
1189// Use find/replace dialogs.
1190//
1191// Default is 1
1192//
1193// Recommended setting: 1 (but may be safely set to 0)
b1ab4762 1194#define wxUSE_FINDREPLDLG 1
2b5f62a0
VZ
1195
1196// Use font picker dialog
1197//
1198// Default is 1
1199//
1200// Recommended setting: 1 (used in the library itself)
b1ab4762 1201#define wxUSE_FONTDLG 1
2b5f62a0
VZ
1202
1203// Use wxMessageDialog and wxMessageBox.
1204//
1205// Default is 1
1206//
1207// Recommended setting: 1 (used in the library itself)
b1ab4762 1208#define wxUSE_MSGDLG 1
2b5f62a0
VZ
1209
1210// progress dialog class for lengthy operations
1211#define wxUSE_PROGRESSDLG 1
1212
1213// support for startup tips (wxShowTip &c)
1214#define wxUSE_STARTUP_TIPS 1
1215
1216// text entry dialog and wxGetTextFromUser function
1217#define wxUSE_TEXTDLG 1
1218
1219// number entry dialog
1220#define wxUSE_NUMBERDLG 1
1221
1222// splash screen class
1223#define wxUSE_SPLASH 1
1224
1225// wizards
29f82345 1226#define wxUSE_WIZARDDLG 1
2b5f62a0 1227
9fb52312
WS
1228// Compile in wxAboutBox() function showing the standard "About" dialog.
1229//
1230// Default is 1
1231//
1232// Recommended setting: 1 but can be set to 0 to save some space if you don't
1233// use this function
1234#define wxUSE_ABOUTDLG 1
1235
a0219e45
VS
1236// wxFileHistory class
1237//
1238// Default is 1
1239//
1240// Recommended setting: 1
1241#define wxUSE_FILE_HISTORY 1
1242
2b5f62a0
VZ
1243// ----------------------------------------------------------------------------
1244// Metafiles support
1245// ----------------------------------------------------------------------------
1246
1247// Windows supports the graphics format known as metafile which is, though not
1248// portable, is widely used under Windows and so is supported by wxWin (under
1249// Windows only, of course). Win16 (Win3.1) used the so-called "Window
1250// MetaFiles" or WMFs which were replaced with "Enhanced MetaFiles" or EMFs in
1251// Win32 (Win9x, NT, 2000). Both of these are supported in wxWin and, by
1252// default, WMFs will be used under Win16 and EMFs under Win32. This may be
1253// changed by setting wxUSE_WIN_METAFILES_ALWAYS to 1 and/or setting
1254// wxUSE_ENH_METAFILE to 0. You may also set wxUSE_METAFILE to 0 to not compile
1255// in any metafile related classes at all.
1256//
1257// Default is 1 for wxUSE_ENH_METAFILE and 0 for wxUSE_WIN_METAFILES_ALWAYS.
1258//
1259// Recommended setting: default or 0 for everything for portable programs.
b1ab4762
CE
1260#define wxUSE_METAFILE 1
1261#define wxUSE_ENH_METAFILE 1
1262#define wxUSE_WIN_METAFILES_ALWAYS 0
2b5f62a0
VZ
1263
1264// ----------------------------------------------------------------------------
1265// Big GUI components
1266// ----------------------------------------------------------------------------
1267
496e80e5
JS
1268// Set to 0 to disable MDI support.
1269//
1270// Requires wxUSE_NOTEBOOK under platforms other than MSW.
1271//
1272// Default is 1.
1273//
1274// Recommended setting: 1, can be safely set to 0.
1275#define wxUSE_MDI 1
1276
2b5f62a0
VZ
1277// Set to 0 to disable document/view architecture
1278#define wxUSE_DOC_VIEW_ARCHITECTURE 1
1279
1280// Set to 0 to disable MDI document/view architecture
81152407
VZ
1281//
1282// Requires wxUSE_MDI && wxUSE_DOC_VIEW_ARCHITECTURE
b1ab4762 1283#define wxUSE_MDI_ARCHITECTURE 1
2b5f62a0
VZ
1284
1285// Set to 0 to disable print/preview architecture code
b1ab4762 1286#define wxUSE_PRINTING_ARCHITECTURE 1
2b5f62a0
VZ
1287
1288// wxHTML sublibrary allows to display HTML in wxWindow programs and much,
1289// much more.
1290//
1291// Default is 1.
1292//
1293// Recommended setting: 1 (wxHTML is great!), set to 0 if you want compile a
1294// smaller library.
b1ab4762 1295#define wxUSE_HTML 1
2b5f62a0 1296
715d7d25
JS
1297// Setting wxUSE_GLCANVAS to 1 enables OpenGL support. You need to have OpenGL
1298// headers and libraries to be able to compile the library with wxUSE_GLCANVAS
24f618ee
VZ
1299// set to 1 and, under Windows, also to add opengl32.lib and glu32.lib to the
1300// list of libraries used to link your application (although this is done
1301// implicitly for Microsoft Visual C++ users).
715d7d25 1302//
671683c4
VZ
1303// Default is 1 unless the compiler is known to ship without the necessary
1304// headers (Digital Mars) or the platform doesn't support OpenGL (Windows CE).
715d7d25 1305//
671683c4
VZ
1306// Recommended setting: 1 if you intend to use OpenGL, can be safely set to 0
1307// otherwise.
1308#define wxUSE_GLCANVAS 1
2b5f62a0 1309
922bcaff
WS
1310// wxRichTextCtrl allows editing of styled text.
1311//
1312// Default is 1.
1313//
1314// Recommended setting: 1, set to 0 if you want compile a
1315// smaller library.
1316#define wxUSE_RICHTEXT 1
1317
2b5f62a0
VZ
1318// ----------------------------------------------------------------------------
1319// Data transfer
1320// ----------------------------------------------------------------------------
1321
1322// Use wxClipboard class for clipboard copy/paste.
1323//
1324// Default is 1.
1325//
1326// Recommended setting: 1
b1ab4762 1327#define wxUSE_CLIPBOARD 1
2b5f62a0
VZ
1328
1329// Use wxDataObject and related classes. Needed for clipboard and OLE drag and
1330// drop
1331//
1332// Default is 1.
1333//
b1ab4762
CE
1334// Recommended setting: 1
1335#define wxUSE_DATAOBJ 1
2b5f62a0
VZ
1336
1337// Use wxDropTarget and wxDropSource classes for drag and drop (this is
1338// different from "built in" drag and drop in wxTreeCtrl which is always
1339// available). Requires wxUSE_DATAOBJ.
1340//
1341// Default is 1.
1342//
1343// Recommended setting: 1
b1ab4762 1344#define wxUSE_DRAG_AND_DROP 1
2b5f62a0 1345
715d7d25
JS
1346// Use wxAccessible for enhanced and customisable accessibility.
1347// Depends on wxUSE_OLE.
1348//
1349// Default is 0.
1350//
1351// Recommended setting (at present): 0
1352#define wxUSE_ACCESSIBILITY 0
1353
2b5f62a0
VZ
1354// ----------------------------------------------------------------------------
1355// miscellaneous settings
1356// ----------------------------------------------------------------------------
1357
1358// wxSingleInstanceChecker class allows to verify at startup if another program
3b7c589c 1359// instance is running.
2b5f62a0
VZ
1360//
1361// Default is 1
1362//
1363// Recommended setting: 1 (the class is tiny, disabling it won't save much
1364// space)
b1ab4762 1365#define wxUSE_SNGLINST_CHECKER 1
2b5f62a0 1366
2b5f62a0
VZ
1367#define wxUSE_DRAGIMAGE 1
1368
b1ab4762
CE
1369#define wxUSE_IPC 1
1370 // 0 for no interprocess comms
1371#define wxUSE_HELP 1
1372 // 0 for no help facility
2b5f62a0 1373
b1ab4762
CE
1374// Should we use MS HTML help for wxHelpController? If disabled, neither
1375// wxCHMHelpController nor wxBestHelpController are available.
1376//
1377// Default is 1 under MSW, 0 is always used for the other platforms.
1378//
1379// Recommended setting: 1, only set to 0 if you have trouble compiling
1380// wxCHMHelpController (could be a problem with really ancient compilers)
2b5f62a0
VZ
1381#define wxUSE_MS_HTML_HELP 1
1382
b1ab4762
CE
1383
1384// Use wxHTML-based help controller?
aab49a0b 1385#define wxUSE_WXHTML_HELP 1
2b5f62a0 1386
2b5f62a0 1387#define wxUSE_CONSTRAINTS 1
b1ab4762 1388 // 0 for no window layout constraint system
2b5f62a0 1389
b1ab4762
CE
1390#define wxUSE_SPLINES 1
1391 // 0 for no splines
2b5f62a0 1392
b1ab4762
CE
1393#define wxUSE_MOUSEWHEEL 1
1394 // Include mouse wheel support
2b5f62a0 1395
9b7e0226 1396// Compile wxUIActionSimulator class?
571d991b 1397#define wxUSE_UIACTIONSIMULATOR 1
9b7e0226 1398
2b5f62a0 1399// ----------------------------------------------------------------------------
b1ab4762 1400// wxDC classes for various output formats
2b5f62a0
VZ
1401// ----------------------------------------------------------------------------
1402
1403// Set to 1 for PostScript device context.
b1ab4762 1404#define wxUSE_POSTSCRIPT 0
2b5f62a0
VZ
1405
1406// Set to 1 to use font metric files in GetTextExtent
1407#define wxUSE_AFM_FOR_POSTSCRIPT 1
1408
b1ab4762 1409// Set to 1 to compile in support for wxSVGFileDC, a wxDC subclass which allows
1c4293cb 1410// to create files in SVG (Scalable Vector Graphics) format.
b1ab4762
CE
1411#define wxUSE_SVG 1
1412
e71508e1
VZ
1413// Should wxDC provide SetTransformMatrix() and related methods?
1414//
1415// Default is 1 but can be set to 0 if this functionality is not used. Notice
1416// that currently only wxMSW supports this so setting this to 0 doesn't change
1417// much for non-MSW platforms (although it will still save a few bytes
1418// probably).
1419//
1420// Recommended setting: 1.
1421#define wxUSE_DC_TRANSFORM_MATRIX 1
1422
2b5f62a0
VZ
1423// ----------------------------------------------------------------------------
1424// image format support
1425// ----------------------------------------------------------------------------
1426
1427// wxImage supports many different image formats which can be configured at
1428// compile-time. BMP is always supported, others are optional and can be safely
1429// disabled if you don't plan to use images in such format sometimes saving
1430// substantial amount of code in the final library.
1431//
1432// Some formats require an extra library which is included in wxWin sources
1433// which is mentioned if it is the case.
1434
1435// Set to 1 for wxImage support (recommended).
b1ab4762 1436#define wxUSE_IMAGE 1
2b5f62a0
VZ
1437
1438// Set to 1 for PNG format support (requires libpng). Also requires wxUSE_ZLIB.
b1ab4762 1439#define wxUSE_LIBPNG 1
2b5f62a0
VZ
1440
1441// Set to 1 for JPEG format support (requires libjpeg)
b1ab4762 1442#define wxUSE_LIBJPEG 1
2b5f62a0
VZ
1443
1444// Set to 1 for TIFF format support (requires libtiff)
b1ab4762
CE
1445#define wxUSE_LIBTIFF 1
1446
1447// Set to 1 for TGA format support (loading only)
1448#define wxUSE_TGA 1
2b5f62a0
VZ
1449
1450// Set to 1 for GIF format support
b1ab4762 1451#define wxUSE_GIF 1
2b5f62a0
VZ
1452
1453// Set to 1 for PNM format support
b1ab4762 1454#define wxUSE_PNM 1
2b5f62a0
VZ
1455
1456// Set to 1 for PCX format support
b1ab4762 1457#define wxUSE_PCX 1
2b5f62a0
VZ
1458
1459// Set to 1 for IFF format support (Amiga format)
b1ab4762 1460#define wxUSE_IFF 0
2b5f62a0
VZ
1461
1462// Set to 1 for XPM format support
b1ab4762 1463#define wxUSE_XPM 1
2b5f62a0
VZ
1464
1465// Set to 1 for MS Icons and Cursors format support
b1ab4762 1466#define wxUSE_ICO_CUR 1
2b5f62a0
VZ
1467
1468// Set to 1 to compile in wxPalette class
b1ab4762
CE
1469#define wxUSE_PALETTE 1
1470
1471// ----------------------------------------------------------------------------
1472// wxUniversal-only options
1473// ----------------------------------------------------------------------------
1474
1475// Set to 1 to enable compilation of all themes, this is the default
1476#define wxUSE_ALL_THEMES 1
1477
1478// Set to 1 to enable the compilation of individual theme if wxUSE_ALL_THEMES
1479// is unset, if it is set these options are not used; notice that metal theme
1480// uses Win32 one
1481#define wxUSE_THEME_GTK 0
1482#define wxUSE_THEME_METAL 0
1483#define wxUSE_THEME_MONO 0
1484#define wxUSE_THEME_WIN32 0
1485
2b5f62a0 1486
3b7c589c
VZ
1487/* --- end common options --- */
1488
1489/* --- start MSW options --- */
2b5f62a0
VZ
1490// ----------------------------------------------------------------------------
1491// Windows-only settings
1492// ----------------------------------------------------------------------------
b1ab4762
CE
1493
1494// Set wxUSE_UNICODE_MSLU to 1 if you're compiling wxWidgets in Unicode mode
1495// and want to run your programs under Windows 9x and not only NT/2000/XP.
1496// This setting enables use of unicows.dll from MSLU (MS Layer for Unicode, see
1497// http://www.microsoft.com/globaldev/handson/dev/mslu_announce.mspx). Note
1498// that you will have to modify the makefiles to include unicows.lib import
1499// library as the first library (see installation instructions in install.txt
1500// to learn how to do it when building the library or samples).
1501//
1502// If your compiler doesn't have unicows.lib, you can get a version of it at
1503// http://libunicows.sourceforge.net
1504//
1505// Default is 0
1506//
1507// Recommended setting: 0 (1 if you want to deploy Unicode apps on 9x systems)
1508#ifndef wxUSE_UNICODE_MSLU
1509 #define wxUSE_UNICODE_MSLU 0
1510#endif
2b5f62a0 1511
77ffb593 1512// Set this to 1 if you want to use wxWidgets and MFC in the same program. This
2b5f62a0
VZ
1513// will override some other settings (see below)
1514//
1515// Default is 0.
1516//
1517// Recommended setting: 0 unless you really have to use MFC
b1ab4762 1518#define wxUSE_MFC 0
2b5f62a0
VZ
1519
1520// Set this to 1 for generic OLE support: this is required for drag-and-drop,
1521// clipboard, OLE Automation. Only set it to 0 if your compiler is very old and
1522// can't compile/doesn't have the OLE headers.
1523//
1524// Default is 1.
1525//
b1ab4762
CE
1526// Recommended setting: 1
1527#define wxUSE_OLE 1
1528
1529// Set this to 1 to enable wxAutomationObject class.
1530//
1531// Default is 1.
1532//
1533// Recommended setting: 1 if you need to control other applications via OLE
1534// Automation, can be safely set to 0 otherwise
1535#define wxUSE_OLE_AUTOMATION 1
1536
1537// Set this to 1 to enable wxActiveXContainer class allowing to embed OLE
1538// controls in wx.
1539//
1540// Default is 1.
1541//
1542// Recommended setting: 1, required by wxMediaCtrl
1543#define wxUSE_ACTIVEX 1
1544
d13b34d3 1545// wxDC caching implementation
b1ab4762
CE
1546#define wxUSE_DC_CACHEING 1
1547
1548// Set this to 1 to enable wxDIB class used internally for manipulating
1549// wxBitmap data.
1550//
1551// Default is 1, set it to 0 only if you don't use wxImage neither
1552//
1553// Recommended setting: 1 (without it conversion to/from wxImage won't work)
1554#define wxUSE_WXDIB 1
2b5f62a0 1555
e6bdaaad
MW
1556// Set to 0 to disable PostScript print/preview architecture code under Windows
1557// (just use Windows printing).
b1ab4762
CE
1558#define wxUSE_POSTSCRIPT_ARCHITECTURE_IN_MSW 1
1559
1560// Set this to 1 to compile in wxRegKey class.
1561//
1562// Default is 1
1563//
1564// Recommended setting: 1, this is used internally by wx in a few places
1565#define wxUSE_REGKEY 1
e6bdaaad 1566
2b5f62a0
VZ
1567// Set this to 1 to use RICHEDIT controls for wxTextCtrl with style wxTE_RICH
1568// which allows to put more than ~32Kb of text in it even under Win9x (NT
1569// doesn't have such limitation).
1570//
1571// Default is 1 for compilers which support it
1572//
1573// Recommended setting: 1, only set it to 0 if your compiler doesn't have
1574// or can't compile <richedit.h>
b1ab4762 1575#define wxUSE_RICHEDIT 1
2b5f62a0 1576
b1ab4762
CE
1577// Set this to 1 to use extra features of richedit v2 and later controls
1578//
1579// Default is 1 for compilers which support it
1580//
1581// Recommended setting: 1
1582#define wxUSE_RICHEDIT2 1
2b5f62a0 1583
b1ab4762
CE
1584// Set this to 1 to enable support for the owner-drawn menu and listboxes. This
1585// is required by wxUSE_CHECKLISTBOX.
2b5f62a0
VZ
1586//
1587// Default is 1.
1588//
1589// Recommended setting: 1, set to 0 for a small library size reduction
b1ab4762 1590#define wxUSE_OWNER_DRAWN 1
2b5f62a0 1591
3b7c589c
VZ
1592// Set this to 1 to enable MSW-specific wxTaskBarIcon::ShowBalloon() method. It
1593// is required by native wxNotificationMessage implementation.
1594//
1595// Default is 1 but disabled in wx/msw/chkconf.h if SDK is too old to contain
1596// the necessary declarations.
1597//
1598// Recommended setting: 1, set to 0 for a tiny library size reduction
1599#define wxUSE_TASKBARICON_BALLOONS 1
1600
b1ab4762
CE
1601// Set to 1 to compile MS Windows XP theme engine support
1602#define wxUSE_UXTHEME 1
1603
1604// Set to 1 to use InkEdit control (Tablet PC), if available
1605#define wxUSE_INKEDIT 0
1606
1607// Set to 1 to enable .INI files based wxConfig implementation (wxIniConfig)
ee64d4f3 1608//
b1ab4762 1609// Default is 0.
ee64d4f3 1610//
b1ab4762
CE
1611// Recommended setting: 0, nobody uses .INI files any more
1612#define wxUSE_INICONF 0
2b5f62a0 1613
2b5f62a0 1614// ----------------------------------------------------------------------------
b1ab4762 1615// Generic versions of native controls
2b5f62a0
VZ
1616// ----------------------------------------------------------------------------
1617
b1ab4762
CE
1618// Set this to 1 to be able to use wxDatePickerCtrlGeneric in addition to the
1619// native wxDatePickerCtrl
1620//
1621// Default is 0.
1622//
1623// Recommended setting: 0, this is mainly used for testing
1624#define wxUSE_DATEPICKCTRL_GENERIC 0
1625
1626// ----------------------------------------------------------------------------
1627// Crash debugging helpers
1628// ----------------------------------------------------------------------------
2b5f62a0 1629
b1ab4762
CE
1630// Set this to 1 to be able to use wxCrashReport::Generate() to create mini
1631// dumps of your program when it crashes (or at any other moment)
1632//
1633// Default is 1 if supported by the compiler (VC++ and recent BC++ only).
1634//
1635// Recommended setting: 1, set to 0 if your programs never crash
1636#define wxUSE_CRASHREPORT 1
3b7c589c
VZ
1637/* --- end MSW options --- */
1638
1639/* --- start wxUniv options --- */
1640// ----------------------------------------------------------------------------
1641// wxUniversal-only options
1642// ----------------------------------------------------------------------------
1643
1644// Set to 1 to enable compilation of all themes, this is the default
1645#define wxUSE_ALL_THEMES 1
1646
1647// Set to 1 to enable the compilation of individual theme if wxUSE_ALL_THEMES
1648// is unset, if it is set these options are not used; notice that metal theme
1649// uses Win32 one
1650#define wxUSE_THEME_GTK 0
1651#define wxUSE_THEME_METAL 0
1652#define wxUSE_THEME_MONO 0
1653#define wxUSE_THEME_WIN32 0
1654/* --- end wxUniv options --- */
1655
1656#endif // _WX_SETUP_H_
1657