]> git.saurik.com Git - wxWidgets.git/blame - include/wx/msw/setup0.h
Fix wxPropertyGrid::GetPropertyRect when the last item is collapsed.
[wxWidgets.git] / include / wx / msw / setup0.h
CommitLineData
9bd6a503 1/////////////////////////////////////////////////////////////////////////////
b3402d0d 2// Name: wx/msw/setup.h
9bd6a503
VZ
3// Purpose: Configuration for the library
4// Author: Julian Smart
5// Modified by:
6// Created: 01/02/97
9bd6a503 7// Copyright: (c) Julian Smart
65571936 8// Licence: wxWindows licence
9bd6a503
VZ
9/////////////////////////////////////////////////////////////////////////////
10
11#ifndef _WX_SETUP_H_
12#define _WX_SETUP_H_
13
24ab5c03 14/* --- start common options --- */
73974df1
VZ
15// ----------------------------------------------------------------------------
16// global settings
17// ----------------------------------------------------------------------------
9bd6a503 18
f6bcfd97
BP
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
22 #define wxUSE_GUI 1
23#endif // wxUSE_GUI
1f112209 24
6d167489
VZ
25// ----------------------------------------------------------------------------
26// compatibility settings
27// ----------------------------------------------------------------------------
28
dee1a63f 29// This setting determines the compatibility with 2.6 API: set it to 0 to
2b5f62a0 30// flag all cases of using deprecated functions.
874efd13 31//
134ecc85
VZ
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.
874efd13 35//
2b5f62a0 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
874efd13 48
ed6dd18a
VZ
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.
3ca6a5f0 52//
ed6dd18a 53// Default is 0
3ca6a5f0 54//
ed6dd18a
VZ
55// Recommended setting: 0
56#define wxDIALOG_UNIT_COMPATIBILITY 0
3ca6a5f0 57
3b415ba4
VZ
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
3b415ba4
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
3b415ba4
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)
3b415ba4
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
3b415ba4 120// If 1, enables wxDebugContext, for writing error messages to file, etc. If
62402193 121// __WXDEBUG__ is not defined, will still use the normal memory operators.
3b415ba4 122//
62402193 123// Default is 0
3b415ba4 124//
62402193
VZ
125// Recommended setting: 0
126#define wxUSE_DEBUG_CONTEXT 0
3b415ba4
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//
62402193 134// Default is 0
3b415ba4 135//
62402193
VZ
136// Recommended setting: 1 if you are not using a memory debugging tool, else 0
137#define wxUSE_MEMORY_TRACING 0
3b415ba4
VZ
138
139// In debug mode, cause new and delete to be redefined globally.
62402193
VZ
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.
3b415ba4
VZ
143// This switch is currently ignored for mingw / cygwin
144//
62402193 145// Default is 0
3b415ba4 146//
62402193
VZ
147// Recommended setting: 0
148#define wxUSE_GLOBAL_MEMORY_OPERATORS 0
3b415ba4
VZ
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.
3b415ba4 154//
62402193 155// Default is 0
3b415ba4 156//
62402193
VZ
157// Recommended setting: 0
158#define wxUSE_DEBUG_NEW_ALWAYS 0
3b415ba4 159
36b6448c 160
f6bcfd97
BP
161// ----------------------------------------------------------------------------
162// Unicode support
163// ----------------------------------------------------------------------------
164
8575ff50
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.
ce6cea68 169#ifndef wxUSE_UNICODE
8575ff50 170 #define wxUSE_UNICODE 1
ce6cea68 171#endif
f6bcfd97 172
8575ff50 173// wxUSE_WCHAR_T is required by wxWidgets now, don't change.
f6bcfd97
BP
174#define wxUSE_WCHAR_T 1
175
3b415ba4
VZ
176// ----------------------------------------------------------------------------
177// global features
178// ----------------------------------------------------------------------------
179
4199367e
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//
b39c4812
VZ
187// Note that like wxUSE_THREADS this option is automatically set to 0 if
188// wxNO_EXCEPTIONS is defined.
189//
4199367e
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
4ef29fb5
JS
196// Set wxUSE_EXTENDED_RTTI to 1 to use extended RTTI
197//
198// Default is 0
199//
28999ba6 200// Recommended setting: 0 (this is still work in progress...)
4ef29fb5
JS
201#define wxUSE_EXTENDED_RTTI 0
202
3b415ba4
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
874efd13 212// Recommended setting: 1
dd8b2f4a
JS
213#define wxUSE_LOGWINDOW 1
214
874efd13 215// Recommended setting: 1
dd8b2f4a
JS
216#define wxUSE_LOGGUI 1
217
874efd13 218// Recommended setting: 1
3e6e2754
JS
219#define wxUSE_LOG_DIALOG 1
220
2b5f62a0
VZ
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
3b415ba4
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//
b39c4812
VZ
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
b39c4812 236// build/msw/config.* file this value will have no effect.
3b415ba4
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
5f2c545c
VZ
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
3b415ba4
VZ
252#define wxUSE_STREAMS 1
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
5f2c545c 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.
5f2c545c
VZ
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.
5f2c545c
VZ
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
3b415ba4 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
668d55c9 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 *".
7a828c7f 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.
7a828c7f 362//
01871bf6 363// Default is 0 if wxUSE_STL has its default value or 1 if it is enabled.
7a828c7f 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
7a828c7f 380
73974df1 381// ----------------------------------------------------------------------------
40973ea5 382// non GUI features selection
73974df1
VZ
383// ----------------------------------------------------------------------------
384
40973ea5
VZ
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
396#define wxUSE_LONGLONG 1
397
4db03d26
VZ
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
a1873279
VZ
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
415
1e6feb95
VZ
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)
423#define wxUSE_FILE 1
424#define wxUSE_FFILE 1
425
05815ab3
VZ
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)
431#define wxUSE_FSVOLUME 1
432
07158944
VZ
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
a3a584a7
VZ
441// use wxTextBuffer class: required by wxTextFile
442#define wxUSE_TEXTBUFFER 1
443
444// use wxTextFile class: requires wxFile and wxTextBuffer, required by
445// wxFileConfig
1e6feb95
VZ
446#define wxUSE_TEXTFILE 1
447
448// i18n support: _() macro, wxLocale class. Requires wxTextFile.
449#define wxUSE_INTL 1
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
874efd13 466// Set wxUSE_DATETIME to 1 to compile the wxDateTime and related classes which
40973ea5
VZ
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//
874efd13
VZ
478// Default is 1
479//
40973ea5 480// Recommended setting: 1
e421922f
VZ
481#define wxUSE_DATETIME 1
482
1e6feb95
VZ
483// Set wxUSE_TIMER to 1 to compile wxTimer class
484//
485// Default is 1
486//
487// Recommended setting: 1
488#define wxUSE_TIMER 1
489
490// Use wxStopWatch clas.
491//
492// Default is 1
493//
494// Recommended setting: 1 (needed by wxSocket)
495#define wxUSE_STOPWATCH 1
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
16193c2b
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
1e6feb95 512#define wxUSE_CONFIG 1
16193c2b
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//
524// Recommended setting: 1
525#define wxUSE_CONFIG_NATIVE 1
526
bf84b0be
VZ
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
0b9ab0bd 529// network connection is established/terminated. Requires wxUSE_DYNAMIC_LOADER.
bf84b0be
VZ
530//
531// Default is 1.
532//
533// Recommended setting: 1
106f0395 534#define wxUSE_DIALUP_MANAGER 1
bf84b0be 535
0b9ab0bd 536// Compile in classes for run-time DLL loading and function calling.
c1d2466a
VZ
537// Required by wxUSE_DIALUP_MANAGER.
538//
539// This setting is for Win32 only
3b415ba4
VZ
540//
541// Default is 1.
542//
c1d2466a 543// Recommended setting: 1
466367be 544#define wxUSE_DYNLIB_CLASS 1
3b415ba4 545
466367be 546// experimental, don't use for now
abad5367 547#define wxUSE_DYNAMIC_LOADER 1
b4a5319e 548
3b415ba4
VZ
549// Set to 1 to use socket classes
550#define wxUSE_SOCKETS 1
551
8575ff50
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
3ca6a5f0 563// Set to 1 to enable virtual file systems (required by wxHTML)
3b415ba4 564#define wxUSE_FILESYSTEM 1
3ca6a5f0
BP
565
566// Set to 1 to enable virtual ZIP filesystem (requires wxUSE_FILESYSTEM)
3b415ba4 567#define wxUSE_FS_ZIP 1
3ca6a5f0 568
26e422a9
MW
569// Set to 1 to enable virtual archive filesystem (requires wxUSE_FILESYSTEM)
570#define wxUSE_FS_ARCHIVE 1
571
3ca6a5f0 572// Set to 1 to enable virtual Internet filesystem (requires wxUSE_FILESYSTEM)
3b415ba4
VZ
573#define wxUSE_FS_INET 1
574
81f90336 575// wxArchive classes for accessing archives such as zip and tar
9e8e867f 576#define wxUSE_ARCHIVE_STREAMS 1
81f90336 577
3ca6a5f0 578// Set to 1 to compile wxZipInput/OutputStream classes.
3b415ba4
VZ
579#define wxUSE_ZIPSTREAM 1
580
26e422a9
MW
581// Set to 1 to compile wxTarInput/OutputStream classes.
582#define wxUSE_TARSTREAM 1
583
3ca6a5f0 584// Set to 1 to compile wxZlibInput/OutputStream classes. Also required by
477a6238 585// wxUSE_LIBPNG
3ca6a5f0
BP
586#define wxUSE_ZLIB 1
587
3ca6a5f0
BP
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.
3ca6a5f0
BP
591//
592// Default is 1.
593//
594// Recommended setting: 1 unless you don't like the license terms (unlikely)
3b415ba4 595#define wxUSE_APPLE_IEEE 1
3b415ba4 596
29104849
RD
597// Joystick support class
598#define wxUSE_JOYSTICK 1
599
ff427585
VZ
600// wxFontEnumerator class
601#define wxUSE_FONTENUM 1
602
1e6feb95
VZ
603// wxFontMapper class
604#define wxUSE_FONTMAP 1
b9e5acef 605
1e6feb95
VZ
606// wxMimeTypesManager class
607#define wxUSE_MIMETYPE 1
29104849 608
a5d46b73
VZ
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
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
622// Define this to use wxURL class.
623#define wxUSE_URL 1
874efd13 624
25959b95
VZ
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
ca5c6ac3
VZ
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
874efd13
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
5638d705 660#define wxUSE_REGEX 1
874efd13 661
a5d46b73
VZ
662// wxSystemOptions class
663#define wxUSE_SYSTEM_OPTIONS 1
664
002ed9af
VS
665// wxSound class
666#define wxUSE_SOUND 1
874efd13 667
c8a50408
RN
668// Use wxMediaCtrl
669//
670// Default is 1.
671//
912c3932 672// Recommended setting: 1
c8a50408
RN
673#define wxUSE_MEDIACTRL 1
674
f33cb209
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)
f33cb209
RN
680#define wxUSE_XRC 1
681
27b0c286
VS
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//
a0680daf 685// Default is the same as wxUSE_XRC, i.e. 1 by default.
27b0c286 686//
f33cb209 687// Recommended setting: 1 (required by XRC)
a0680daf 688#define wxUSE_XML wxUSE_XRC
27b0c286 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
1d7d04d7
JS
718// Use wxWidget's web viewing classes
719//
720// Default is 1
721//
722// Recommended setting: 1
62f9f10d 723#define wxUSE_WEBVIEW 1
1d7d04d7
JS
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
d60b34a4
SL
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
f43426c1
RD
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.
e88f6524 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.
c0e69d72 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
c0e69d72 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
bf84b0be 797// ----------------------------------------------------------------------------
1e6feb95 798// Individual GUI controls
bf84b0be
VZ
799// ----------------------------------------------------------------------------
800
1e6feb95
VZ
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
f38bcae5
VZ
818// wxPopupWindow class is a top level transient window. It is currently used
819// to implement wxTipWindow
1e6feb95 820//
f38bcae5 821// Default is 1
1e6feb95 822//
f38bcae5
VZ
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
1e6feb95 833
77ffb593 834// Each of the settings below corresponds to one wxWidgets control. They are
1e6feb95
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
72045d57 843#define wxUSE_ANIMATIONCTRL 1 // wxAnimationCtrl
ea11bf3a 844#define wxUSE_BANNERWINDOW 1 // wxBannerWindow
17e91437
VZ
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
912c3932 851#define wxUSE_COLLPANE 1 // wxCollapsiblePane
ec376c8f 852#define wxUSE_COLOURPICKERCTRL 1 // wxColourPickerCtrl
17e91437 853#define wxUSE_COMBOBOX 1 // wxComboBox
3571e1ad 854#define wxUSE_COMMANDLINKBUTTON 1 // wxCommandLinkButton
17e91437
VZ
855#define wxUSE_DATAVIEWCTRL 1 // wxDataViewCtrl
856#define wxUSE_DATEPICKCTRL 1 // wxDatePickerCtrl
ec376c8f 857#define wxUSE_DIRPICKERCTRL 1 // wxDirPickerCtrl
56eeb973 858#define wxUSE_EDITABLELISTBOX 1 // wxEditableListBox
0cf3e587 859#define wxUSE_FILECTRL 1 // wxFileCtrl
ec376c8f
VZ
860#define wxUSE_FILEPICKERCTRL 1 // wxFilePickerCtrl
861#define wxUSE_FONTPICKERCTRL 1 // wxFontPickerCtrl
17e91437 862#define wxUSE_GAUGE 1 // wxGauge
e721a2a2 863#define wxUSE_HEADERCTRL 1 // wxHeaderCtrl
17e91437
VZ
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
17e91437 870#define wxUSE_SCROLLBAR 1 // wxScrollBar
3f7f284d 871#define wxUSE_SEARCHCTRL 1 // wxSearchCtrl
17e91437
VZ
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
17e91437
VZ
881#define wxUSE_TOGGLEBTN 1 // requires wxButton
882#define wxUSE_TREECTRL 1 // wxTreeCtrl
524cb040 883#define wxUSE_TREELISTCTRL 1 // wxTreeListCtrl
1e6feb95
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
891#define wxUSE_STATUSBAR 1
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//
c67b4daf 897// Default is 1 for the platforms where native status bar is supported.
1e6feb95
VZ
898//
899// Recommended setting: 1 (there is no advantage in using the generic one)
900#define wxUSE_NATIVE_STATUSBAR 1
901
bf84b0be
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.
bf84b0be
VZ
905//
906// Default is 1 for all settings.
907//
8a82c9ec 908// Recommended setting: 1 for wxUSE_TOOLBAR and wxUSE_TOOLBAR_NATIVE.
bf84b0be
VZ
909#define wxUSE_TOOLBAR 1
910#define wxUSE_TOOLBAR_NATIVE 1
bf84b0be 911
b3402d0d 912// wxNotebook is a control with several "tabs" located on one of its sides. It
95ae6d5f 913// may be used to logically organise the data presented to the user instead of
b3402d0d
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
f4edf138
JS
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
4f167b46
VZ
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
961
dd74a7ad 962// wxGrid class
ff2d113e 963//
c67b4daf
VZ
964// Default is 1, set to 0 to cut down compilation time and binaries size if you
965// don't use it.
ff2d113e 966//
dd74a7ad 967// Recommended setting: 1
9c824f29 968//
ff2d113e 969#define wxUSE_GRID 1
b3402d0d 970
c67b4daf
VZ
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
977
a57d600f 978// wxComboCtrl and related classes: combobox with custom popup window and
21849f3a
VZ
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
a57d600f 985#define wxUSE_COMBOCTRL 1
21849f3a
VZ
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.
a57d600f 994#define wxUSE_ODCOMBOBOX 1
21849f3a 995
95a46303
RR
996// wxBitmapComboBox is a combobox that can have images in front of text items.
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
1e6feb95
VZ
1012// ----------------------------------------------------------------------------
1013// Miscellaneous GUI stuff
1014// ----------------------------------------------------------------------------
3b415ba4
VZ
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
5048c832
JS
1042// Hotkey support (currently Windows only)
1043#define wxUSE_HOTKEY 1
1044
1e6feb95
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)
1051#define wxUSE_CARET 1
1052
8a09029e 1053// Use wxDisplay class: it allows enumerating all displays on a system and
5f2c545c
VZ
1054// their geometries as well as finding the display on which the given point or
1055// window lies.
8a09029e 1056//
5f2c545c 1057// Default is 1.
8a09029e
VZ
1058//
1059// Recommended setting: 1 if you need it, can be safely set to 0 otherwise
01c54165 1060#define wxUSE_DISPLAY 1
8a09029e 1061
1e6feb95
VZ
1062// Miscellaneous geometry code: needed for Canvas library
1063#define wxUSE_GEOMETRY 1
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)
1072#define wxUSE_IMAGLIST 1
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
1e6feb95
VZ
1082// Use wxMenu, wxMenuBar, wxMenuItem.
1083//
1084// Default is 1.
1085//
1086// Recommended setting: 1 (can't be disabled under MSW)
1087#define wxUSE_MENUS 1
1088
e36a1739
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
a9452957
VZ
1100// wxPreferencesEditor provides a common API for different ways of presenting
1101// the standard "Preferences" or "Properties" dialog under different platforms
1102// (e.g. some use modal dialogs, some use modeless ones; some apply the changes
1103// immediately while others require an explicit "Apply" button).
1104//
1105// Default is 1.
1106//
1107// Recommended setting: 1 (but can be safely disabled if you don't use it)
1108#define wxUSE_PREFERENCES_EDITOR 1
1109
e520c3f7
VZ
1110// wxRichToolTip is a customizable tooltip class which has more functionality
1111// than the stock (but native, unlike this class) wxToolTip.
1112//
1113// Default is 1.
1114//
1115// Recommended setting: 1 (but can be safely set to 0 if you don't need it)
1116#define wxUSE_RICHTOOLTIP 1
1117
1e6feb95
VZ
1118// Use wxSashWindow class.
1119//
1120// Default is 1.
1121//
1122// Recommended setting: 1
1123#define wxUSE_SASH 1
1124
1125// Use wxSplitterWindow class.
1126//
1127// Default is 1.
1128//
1129// Recommended setting: 1
1130#define wxUSE_SPLITTER 1
1131
1132// Use wxToolTip and wxWindow::Set/GetToolTip() methods.
1133//
1134// Default is 1.
1135//
1136// Recommended setting: 1
1137#define wxUSE_TOOLTIPS 1
1138
1139// wxValidator class and related methods
1140#define wxUSE_VALIDATORS 1
1141
cf2810aa
VZ
1142// Use reference counted ID management: this means that wxWidgets will track
1143// the automatically allocated ids (those used when you use wxID_ANY when
1144// creating a window, menu or toolbar item &c) instead of just supposing that
1145// the program never runs out of them. This is mostly useful only under wxMSW
1146// where the total ids range is limited to SHRT_MIN..SHRT_MAX and where
1147// long-running programs can run into problems with ids reuse without this. On
1148// the other platforms, where the ids have the full int range, this shouldn't
1149// be necessary.
75a29ef1
VZ
1150#ifdef __WXMSW__
1151#define wxUSE_AUTOID_MANAGEMENT 1
1152#else
1153#define wxUSE_AUTOID_MANAGEMENT 0
1154#endif
cf2810aa 1155
3b415ba4
VZ
1156// ----------------------------------------------------------------------------
1157// common dialogs
1158// ----------------------------------------------------------------------------
1159
3b415ba4
VZ
1160// On rare occasions (e.g. using DJGPP) may want to omit common dialogs (e.g.
1161// file selector, printer dialog). Switching this off also switches off the
1162// printing architecture and interactive wxPrinterDC.
1163//
1164// Default is 1
1165//
1166// Recommended setting: 1 (unless it really doesn't work)
1167#define wxUSE_COMMON_DIALOGS 1
1168
874efd13
VZ
1169// wxBusyInfo displays window with message when app is busy. Works in same way
1170// as wxBusyCursor
1171#define wxUSE_BUSYINFO 1
1172
1173// Use single/multiple choice dialogs.
1174//
1175// Default is 1
1176//
1177// Recommended setting: 1 (used in the library itself)
1178#define wxUSE_CHOICEDLG 1
1179
1180// Use colour picker dialog
1181//
1182// Default is 1
1183//
1184// Recommended setting: 1
1185#define wxUSE_COLOURDLG 1
1186
1187// wxDirDlg class for getting a directory name from user
1188#define wxUSE_DIRDLG 1
1189
1190// TODO: setting to choose the generic or native one
1191
1e6feb95
VZ
1192// Use file open/save dialogs.
1193//
1194// Default is 1
1195//
1196// Recommended setting: 1 (used in many places in the library itself)
1197#define wxUSE_FILEDLG 1
1198
874efd13
VZ
1199// Use find/replace dialogs.
1200//
1201// Default is 1
1202//
1203// Recommended setting: 1 (but may be safely set to 0)
baff4ae2
VZ
1204#define wxUSE_FINDREPLDLG 1
1205
1e6feb95
VZ
1206// Use font picker dialog
1207//
1208// Default is 1
1209//
1210// Recommended setting: 1 (used in the library itself)
1211#define wxUSE_FONTDLG 1
1212
e421922f 1213// Use wxMessageDialog and wxMessageBox.
1e6feb95
VZ
1214//
1215// Default is 1
1216//
1217// Recommended setting: 1 (used in the library itself)
e421922f 1218#define wxUSE_MSGDLG 1
3b415ba4 1219
874efd13
VZ
1220// progress dialog class for lengthy operations
1221#define wxUSE_PROGRESSDLG 1
3b415ba4 1222
874efd13
VZ
1223// support for startup tips (wxShowTip &c)
1224#define wxUSE_STARTUP_TIPS 1
3b415ba4 1225
e421922f
VZ
1226// text entry dialog and wxGetTextFromUser function
1227#define wxUSE_TEXTDLG 1
1228
874efd13 1229// number entry dialog
ff8b6290
JS
1230#define wxUSE_NUMBERDLG 1
1231
874efd13
VZ
1232// splash screen class
1233#define wxUSE_SPLASH 1
47606d36 1234
874efd13 1235// wizards
b1f5d087
VZ
1236#define wxUSE_WIZARDDLG 1
1237
9211cf3c
VZ
1238// Compile in wxAboutBox() function showing the standard "About" dialog.
1239//
1240// Default is 1
1241//
1242// Recommended setting: 1 but can be set to 0 to save some space if you don't
1243// use this function
1244#define wxUSE_ABOUTDLG 1
1245
a0219e45
VS
1246// wxFileHistory class
1247//
1248// Default is 1
1249//
1250// Recommended setting: 1
1251#define wxUSE_FILE_HISTORY 1
1252
d9317fd4
VZ
1253// ----------------------------------------------------------------------------
1254// Metafiles support
1255// ----------------------------------------------------------------------------
1256
1257// Windows supports the graphics format known as metafile which is, though not
1258// portable, is widely used under Windows and so is supported by wxWin (under
1259// Windows only, of course). Win16 (Win3.1) used the so-called "Window
1260// MetaFiles" or WMFs which were replaced with "Enhanced MetaFiles" or EMFs in
1261// Win32 (Win9x, NT, 2000). Both of these are supported in wxWin and, by
1262// default, WMFs will be used under Win16 and EMFs under Win32. This may be
1263// changed by setting wxUSE_WIN_METAFILES_ALWAYS to 1 and/or setting
1264// wxUSE_ENH_METAFILE to 0. You may also set wxUSE_METAFILE to 0 to not compile
1265// in any metafile related classes at all.
1266//
1267// Default is 1 for wxUSE_ENH_METAFILE and 0 for wxUSE_WIN_METAFILES_ALWAYS.
1268//
1269// Recommended setting: default or 0 for everything for portable programs.
1270#define wxUSE_METAFILE 1
1271#define wxUSE_ENH_METAFILE 1
1272#define wxUSE_WIN_METAFILES_ALWAYS 0
1273
ff2d113e
VZ
1274// ----------------------------------------------------------------------------
1275// Big GUI components
1276// ----------------------------------------------------------------------------
1277
efd17a1d
VZ
1278// Set to 0 to disable MDI support.
1279//
1280// Requires wxUSE_NOTEBOOK under platforms other than MSW.
1281//
1282// Default is 1.
1283//
1284// Recommended setting: 1, can be safely set to 0.
1285#define wxUSE_MDI 1
1286
3b415ba4
VZ
1287// Set to 0 to disable document/view architecture
1288#define wxUSE_DOC_VIEW_ARCHITECTURE 1
1289
1290// Set to 0 to disable MDI document/view architecture
efd17a1d
VZ
1291//
1292// Requires wxUSE_MDI && wxUSE_DOC_VIEW_ARCHITECTURE
3b415ba4
VZ
1293#define wxUSE_MDI_ARCHITECTURE 1
1294
1295// Set to 0 to disable print/preview architecture code
1296#define wxUSE_PRINTING_ARCHITECTURE 1
1297
ff2d113e
VZ
1298// wxHTML sublibrary allows to display HTML in wxWindow programs and much,
1299// much more.
1300//
1301// Default is 1.
1302//
1303// Recommended setting: 1 (wxHTML is great!), set to 0 if you want compile a
1304// smaller library.
1305#define wxUSE_HTML 1
1306
2b5f62a0
VZ
1307// Setting wxUSE_GLCANVAS to 1 enables OpenGL support. You need to have OpenGL
1308// headers and libraries to be able to compile the library with wxUSE_GLCANVAS
24f618ee
VZ
1309// set to 1 and, under Windows, also to add opengl32.lib and glu32.lib to the
1310// list of libraries used to link your application (although this is done
1311// implicitly for Microsoft Visual C++ users).
2b5f62a0 1312//
671683c4
VZ
1313// Default is 1 unless the compiler is known to ship without the necessary
1314// headers (Digital Mars) or the platform doesn't support OpenGL (Windows CE).
2b5f62a0 1315//
671683c4
VZ
1316// Recommended setting: 1 if you intend to use OpenGL, can be safely set to 0
1317// otherwise.
1318#define wxUSE_GLCANVAS 1
8b089c5e 1319
5d7836c4
JS
1320// wxRichTextCtrl allows editing of styled text.
1321//
1322// Default is 1.
1323//
1324// Recommended setting: 1, set to 0 if you want compile a
1325// smaller library.
1326#define wxUSE_RICHTEXT 1
1327
1e6feb95
VZ
1328// ----------------------------------------------------------------------------
1329// Data transfer
1330// ----------------------------------------------------------------------------
1331
1332// Use wxClipboard class for clipboard copy/paste.
1333//
1334// Default is 1.
1335//
1336// Recommended setting: 1
1337#define wxUSE_CLIPBOARD 1
1338
1339// Use wxDataObject and related classes. Needed for clipboard and OLE drag and
1340// drop
1341//
1342// Default is 1.
1343//
1344// Recommended setting: 1
1345#define wxUSE_DATAOBJ 1
1346
1347// Use wxDropTarget and wxDropSource classes for drag and drop (this is
1348// different from "built in" drag and drop in wxTreeCtrl which is always
1349// available). Requires wxUSE_DATAOBJ.
1350//
1351// Default is 1.
1352//
1353// Recommended setting: 1
1354#define wxUSE_DRAG_AND_DROP 1
1355
45a959a3
JS
1356// Use wxAccessible for enhanced and customisable accessibility.
1357// Depends on wxUSE_OLE.
1358//
1359// Default is 0.
1360//
1361// Recommended setting (at present): 0
1362#define wxUSE_ACCESSIBILITY 0
1363
bf84b0be 1364// ----------------------------------------------------------------------------
3b415ba4 1365// miscellaneous settings
bf84b0be
VZ
1366// ----------------------------------------------------------------------------
1367
68a602fc 1368// wxSingleInstanceChecker class allows to verify at startup if another program
52e5cc35 1369// instance is running.
68a602fc
VZ
1370//
1371// Default is 1
1372//
1373// Recommended setting: 1 (the class is tiny, disabling it won't save much
1374// space)
1375#define wxUSE_SNGLINST_CHECKER 1
1376
24fd6d87
VZ
1377#define wxUSE_DRAGIMAGE 1
1378
9bd6a503
VZ
1379#define wxUSE_IPC 1
1380 // 0 for no interprocess comms
9bd6a503
VZ
1381#define wxUSE_HELP 1
1382 // 0 for no help facility
874efd13 1383
f05b5b77
VZ
1384// Should we use MS HTML help for wxHelpController? If disabled, neither
1385// wxCHMHelpController nor wxBestHelpController are available.
1386//
a0680daf 1387// Default is 1 under MSW, 0 is always used for the other platforms.
f05b5b77
VZ
1388//
1389// Recommended setting: 1, only set to 0 if you have trouble compiling
1390// wxCHMHelpController (could be a problem with really ancient compilers)
1391#define wxUSE_MS_HTML_HELP 1
1392
1393
874efd13 1394// Use wxHTML-based help controller?
3379ed37 1395#define wxUSE_WXHTML_HELP 1
874efd13 1396
9bd6a503
VZ
1397#define wxUSE_CONSTRAINTS 1
1398 // 0 for no window layout constraint system
1399
9bd6a503 1400#define wxUSE_SPLINES 1
83b1bfaa 1401 // 0 for no splines
9bd6a503 1402
d2c52078
RD
1403#define wxUSE_MOUSEWHEEL 1
1404 // Include mouse wheel support
1405
9b7e0226 1406// Compile wxUIActionSimulator class?
571d991b 1407#define wxUSE_UIACTIONSIMULATOR 1
9b7e0226 1408
3b415ba4 1409// ----------------------------------------------------------------------------
b0fc907f 1410// wxDC classes for various output formats
3b415ba4
VZ
1411// ----------------------------------------------------------------------------
1412
3ca6a5f0 1413// Set to 1 for PostScript device context.
3b415ba4 1414#define wxUSE_POSTSCRIPT 0
3ca6a5f0
BP
1415
1416// Set to 1 to use font metric files in GetTextExtent
12bdd77c 1417#define wxUSE_AFM_FOR_POSTSCRIPT 1
9bd6a503 1418
b0fc907f 1419// Set to 1 to compile in support for wxSVGFileDC, a wxDC subclass which allows
1c4293cb 1420// to create files in SVG (Scalable Vector Graphics) format.
b0fc907f
VZ
1421#define wxUSE_SVG 1
1422
e71508e1
VZ
1423// Should wxDC provide SetTransformMatrix() and related methods?
1424//
1425// Default is 1 but can be set to 0 if this functionality is not used. Notice
1426// that currently only wxMSW supports this so setting this to 0 doesn't change
1427// much for non-MSW platforms (although it will still save a few bytes
1428// probably).
1429//
1430// Recommended setting: 1.
1431#define wxUSE_DC_TRANSFORM_MATRIX 1
1432
3b415ba4
VZ
1433// ----------------------------------------------------------------------------
1434// image format support
1435// ----------------------------------------------------------------------------
1436
3ca6a5f0
BP
1437// wxImage supports many different image formats which can be configured at
1438// compile-time. BMP is always supported, others are optional and can be safely
1439// disabled if you don't plan to use images in such format sometimes saving
1440// substantial amount of code in the final library.
1441//
1442// Some formats require an extra library which is included in wxWin sources
1443// which is mentioned if it is the case.
1444
0046ff7c
VS
1445// Set to 1 for wxImage support (recommended).
1446#define wxUSE_IMAGE 1
1447
3ca6a5f0 1448// Set to 1 for PNG format support (requires libpng). Also requires wxUSE_ZLIB.
9bd6a503 1449#define wxUSE_LIBPNG 1
3ca6a5f0
BP
1450
1451// Set to 1 for JPEG format support (requires libjpeg)
83b1bfaa 1452#define wxUSE_LIBJPEG 1
3ca6a5f0
BP
1453
1454// Set to 1 for TIFF format support (requires libtiff)
1ea67089 1455#define wxUSE_LIBTIFF 1
3ca6a5f0 1456
3af706cc
VZ
1457// Set to 1 for TGA format support (loading only)
1458#define wxUSE_TGA 1
1459
3ca6a5f0 1460// Set to 1 for GIF format support
83b1bfaa 1461#define wxUSE_GIF 1
3ca6a5f0
BP
1462
1463// Set to 1 for PNM format support
1044a386 1464#define wxUSE_PNM 1
3ca6a5f0
BP
1465
1466// Set to 1 for PCX format support
1044a386 1467#define wxUSE_PCX 1
9bd6a503 1468
d297e8ff
VZ
1469// Set to 1 for IFF format support (Amiga format)
1470#define wxUSE_IFF 0
4b6b4dfc 1471
0046ff7c
VS
1472// Set to 1 for XPM format support
1473#define wxUSE_XPM 1
1474
658974ae
VS
1475// Set to 1 for MS Icons and Cursors format support
1476#define wxUSE_ICO_CUR 1
1477
874efd13 1478// Set to 1 to compile in wxPalette class
d275c7eb
VZ
1479#define wxUSE_PALETTE 1
1480
4353a8df
VZ
1481// ----------------------------------------------------------------------------
1482// wxUniversal-only options
1483// ----------------------------------------------------------------------------
1484
1485// Set to 1 to enable compilation of all themes, this is the default
1486#define wxUSE_ALL_THEMES 1
1487
1488// Set to 1 to enable the compilation of individual theme if wxUSE_ALL_THEMES
1489// is unset, if it is set these options are not used; notice that metal theme
1490// uses Win32 one
1491#define wxUSE_THEME_GTK 0
1492#define wxUSE_THEME_METAL 0
1493#define wxUSE_THEME_MONO 0
1494#define wxUSE_THEME_WIN32 0
1495
1496
24ab5c03
VZ
1497/* --- end common options --- */
1498
508d12b2 1499/* --- start MSW options --- */
3b415ba4
VZ
1500// ----------------------------------------------------------------------------
1501// Windows-only settings
1502// ----------------------------------------------------------------------------
1318fabe 1503
2bb06220
VZ
1504// Set wxUSE_UNICODE_MSLU to 1 if you're compiling wxWidgets in Unicode mode
1505// and want to run your programs under Windows 9x and not only NT/2000/XP.
1506// This setting enables use of unicows.dll from MSLU (MS Layer for Unicode, see
1507// http://www.microsoft.com/globaldev/handson/dev/mslu_announce.mspx). Note
1508// that you will have to modify the makefiles to include unicows.lib import
1509// library as the first library (see installation instructions in install.txt
1510// to learn how to do it when building the library or samples).
1511//
1512// If your compiler doesn't have unicows.lib, you can get a version of it at
1513// http://libunicows.sourceforge.net
1514//
1515// Default is 0
1516//
1517// Recommended setting: 0 (1 if you want to deploy Unicode apps on 9x systems)
1518#ifndef wxUSE_UNICODE_MSLU
1519 #define wxUSE_UNICODE_MSLU 0
1520#endif
1521
77ffb593 1522// Set this to 1 if you want to use wxWidgets and MFC in the same program. This
3ca6a5f0
BP
1523// will override some other settings (see below)
1524//
1525// Default is 0.
1526//
1527// Recommended setting: 0 unless you really have to use MFC
3f8e5072
JS
1528#define wxUSE_MFC 0
1529
3ca6a5f0
BP
1530// Set this to 1 for generic OLE support: this is required for drag-and-drop,
1531// clipboard, OLE Automation. Only set it to 0 if your compiler is very old and
1532// can't compile/doesn't have the OLE headers.
1533//
1534// Default is 1.
1535//
1536// Recommended setting: 1
3aa0e8fa 1537#define wxUSE_OLE 1
3aa0e8fa 1538
ca5c6ac3
VZ
1539// Set this to 1 to enable wxAutomationObject class.
1540//
1541// Default is 1.
1542//
1543// Recommended setting: 1 if you need to control other applications via OLE
1544// Automation, can be safely set to 0 otherwise
1545#define wxUSE_OLE_AUTOMATION 1
1546
a1f48575
VZ
1547// Set this to 1 to enable wxActiveXContainer class allowing to embed OLE
1548// controls in wx.
1549//
1550// Default is 1.
1551//
1552// Recommended setting: 1, required by wxMediaCtrl
1553#define wxUSE_ACTIVEX 1
1554
d13b34d3 1555// wxDC caching implementation
6d1fbf78
VZ
1556#define wxUSE_DC_CACHEING 1
1557
da75a14e 1558// Set this to 1 to enable wxDIB class used internally for manipulating
f77c0fe3 1559// wxBitmap data.
da75a14e
VZ
1560//
1561// Default is 1, set it to 0 only if you don't use wxImage neither
1562//
1563// Recommended setting: 1 (without it conversion to/from wxImage won't work)
6d1fbf78
VZ
1564#define wxUSE_WXDIB 1
1565
e6bdaaad
MW
1566// Set to 0 to disable PostScript print/preview architecture code under Windows
1567// (just use Windows printing).
1568#define wxUSE_POSTSCRIPT_ARCHITECTURE_IN_MSW 1
1569
f77c0fe3
VZ
1570// Set this to 1 to compile in wxRegKey class.
1571//
1572// Default is 1
1573//
1574// Recommended setting: 1, this is used internally by wx in a few places
1575#define wxUSE_REGKEY 1
1576
3ca6a5f0
BP
1577// Set this to 1 to use RICHEDIT controls for wxTextCtrl with style wxTE_RICH
1578// which allows to put more than ~32Kb of text in it even under Win9x (NT
1579// doesn't have such limitation).
1580//
1581// Default is 1 for compilers which support it
1582//
1583// Recommended setting: 1, only set it to 0 if your compiler doesn't have
1584// or can't compile <richedit.h>
be329a3d
RD
1585#define wxUSE_RICHEDIT 1
1586
c5a12362
VZ
1587// Set this to 1 to use extra features of richedit v2 and later controls
1588//
1589// Default is 1 for compilers which support it
1590//
1591// Recommended setting: 1
be329a3d
RD
1592#define wxUSE_RICHEDIT2 1
1593
3ca6a5f0
BP
1594// Set this to 1 to enable support for the owner-drawn menu and listboxes. This
1595// is required by wxUSE_CHECKLISTBOX.
1596//
1597// Default is 1.
1598//
1599// Recommended setting: 1, set to 0 for a small library size reduction
1600#define wxUSE_OWNER_DRAWN 1
1601
23bd008a
VZ
1602// Set this to 1 to enable MSW-specific wxTaskBarIcon::ShowBalloon() method. It
1603// is required by native wxNotificationMessage implementation.
1604//
1605// Default is 1 but disabled in wx/msw/chkconf.h if SDK is too old to contain
1606// the necessary declarations.
1607//
1608// Recommended setting: 1, set to 0 for a tiny library size reduction
1609#define wxUSE_TASKBARICON_BALLOONS 1
1610
85b43fbf
JS
1611// Set to 1 to compile MS Windows XP theme engine support
1612#define wxUSE_UXTHEME 1
1613
f4edf138
JS
1614// Set to 1 to use InkEdit control (Tablet PC), if available
1615#define wxUSE_INKEDIT 0
1616
61873536
VZ
1617// Set to 1 to enable .INI files based wxConfig implementation (wxIniConfig)
1618//
1619// Default is 0.
1620//
1621// Recommended setting: 0, nobody uses .INI files any more
1622#define wxUSE_INICONF 0
1623
04049dbb
VZ
1624// ----------------------------------------------------------------------------
1625// Generic versions of native controls
1626// ----------------------------------------------------------------------------
1627
1628// Set this to 1 to be able to use wxDatePickerCtrlGeneric in addition to the
1629// native wxDatePickerCtrl
1630//
1631// Default is 0.
1632//
1633// Recommended setting: 0, this is mainly used for testing
1634#define wxUSE_DATEPICKCTRL_GENERIC 0
1635
569c7d8c
VZ
1636// Set this to 1 to be able to use wxTimePickerCtrlGeneric in addition to the
1637// native wxTimePickerCtrl for the platforms that have the latter (MSW).
1638//
1639// Default is 0.
1640//
1641// Recommended setting: 0, this is mainly used for testing
1642#define wxUSE_TIMEPICKCTRL_GENERIC 0
1643
1b68f1da
VZ
1644// ----------------------------------------------------------------------------
1645// Crash debugging helpers
1646// ----------------------------------------------------------------------------
1647
1648// Set this to 1 to be able to use wxCrashReport::Generate() to create mini
1649// dumps of your program when it crashes (or at any other moment)
1650//
3e3a3e17 1651// Default is 1 if supported by the compiler (VC++ and recent BC++ only).
1b68f1da
VZ
1652//
1653// Recommended setting: 1, set to 0 if your programs never crash
1654#define wxUSE_CRASHREPORT 1
508d12b2
VZ
1655/* --- end MSW options --- */
1656
ef782301
VZ
1657#endif // _WX_SETUP_H_
1658