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