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