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