]> git.saurik.com Git - wxWidgets.git/blob - include/wx/setup_inc.h
don't use wxScopedPtr<> in wxDocTemplate::CreateDocument() as the document is implici...
[wxWidgets.git] / include / wx / setup_inc.h
1 ///////////////////////////////////////////////////////////////////////////////
2 // Name: wx/setup_inc.h
3 // Purpose: setup.h settings
4 // Author: Vadim Zeitlin
5 // Modified by:
6 // Created:
7 // RCS-ID: $Id$
8 // Copyright: (c) Vadim Zeitlin
9 // Licence: wxWindows licence
10 ///////////////////////////////////////////////////////////////////////////////
11
12 // ----------------------------------------------------------------------------
13 // global settings
14 // ----------------------------------------------------------------------------
15
16 // define this to 0 when building wxBase library - this can also be done from
17 // makefile/project file overriding the value here
18 #ifndef wxUSE_GUI
19 #define wxUSE_GUI 1
20 #endif // wxUSE_GUI
21
22 // ----------------------------------------------------------------------------
23 // compatibility settings
24 // ----------------------------------------------------------------------------
25
26 // This setting determines the compatibility with 2.6 API: set it to 0 to
27 // flag all cases of using deprecated functions.
28 //
29 // Default is 1 but please try building your code with 0 as the default will
30 // change to 0 in the next version and the deprecated functions will disappear
31 // in the version after it completely.
32 //
33 // Recommended setting: 0 (please update your code)
34 #define WXWIN_COMPATIBILITY_2_6 0
35
36 // This setting determines the compatibility with 2.8 API: set it to 0 to
37 // flag all cases of using deprecated functions.
38 //
39 // Default is 1 but please try building your code with 0 as the default will
40 // change to 0 in the next version and the deprecated functions will disappear
41 // in the version after it completely.
42 //
43 // Recommended setting: 0 (please update your code)
44 #define WXWIN_COMPATIBILITY_2_8 1
45
46 // Use the 2.8-compatible events and Connect(): this is set to 0 by default as
47 // the new events bring significant benefits in compile-time safety and
48 // flexibility but can be disabled to somewhat reduce the compilation time and,
49 // especially, to still allow building if the compiler template support is too
50 // bad to compile the new code.
51 //
52 // Default is 0 but this is set to 1 automatically in wx/chkconf.h for the
53 // compilers which can't build the new code (currently only g++ and MSVC >= 8
54 // can)
55 //
56 // Recommended setting: 0
57 #define wxEVENTS_COMPATIBILITY_2_8 0
58
59 // MSW-only: Set to 0 for accurate dialog units, else 1 for old behaviour when
60 // default system font is used for wxWindow::GetCharWidth/Height() instead of
61 // the current font.
62 //
63 // Default is 0
64 //
65 // Recommended setting: 0
66 #define wxDIALOG_UNIT_COMPATIBILITY 0
67
68 // ----------------------------------------------------------------------------
69 // debugging settings
70 // ----------------------------------------------------------------------------
71
72 // Generic comment about debugging settings: they are very useful if you don't
73 // use any other memory leak detection tools such as Purify/BoundsChecker, but
74 // are probably redundant otherwise. Also, Visual C++ CRT has the same features
75 // as wxWidgets memory debugging subsystem built in since version 5.0 and you
76 // may prefer to use it instead of built in memory debugging code because it is
77 // faster and more fool proof.
78 //
79 // Using VC++ CRT memory debugging is enabled by default in debug mode
80 // (__WXDEBUG__) if wxUSE_GLOBAL_MEMORY_OPERATORS is *not* enabled (i.e. is 0)
81 // and if __NO_VC_CRTDBG__ is not defined.
82
83 // If 1, enables wxDebugContext, for writing error messages to file, etc. If
84 // __WXDEBUG__ is not defined, will still use the normal memory operators.
85 //
86 // Default is 0
87 //
88 // Recommended setting: 0
89 #define wxUSE_DEBUG_CONTEXT 0
90
91 // If 1, enables debugging versions of wxObject::new and wxObject::delete *IF*
92 // __WXDEBUG__ is also defined.
93 //
94 // WARNING: this code may not work with all architectures, especially if
95 // alignment is an issue. This switch is currently ignored for mingw / cygwin
96 //
97 // Default is 0
98 //
99 // Recommended setting: 1 if you are not using a memory debugging tool, else 0
100 #define wxUSE_MEMORY_TRACING 0
101
102 // In debug mode, cause new and delete to be redefined globally.
103 // If this causes problems (e.g. link errors which is a common problem
104 // especially if you use another library which also redefines the global new
105 // and delete), set this to 0.
106 // This switch is currently ignored for mingw / cygwin
107 //
108 // Default is 0
109 //
110 // Recommended setting: 0
111 #define wxUSE_GLOBAL_MEMORY_OPERATORS 0
112
113 // In debug mode, causes new to be defined to be WXDEBUG_NEW (see object.h). If
114 // this causes problems (e.g. link errors), set this to 0. You may need to set
115 // this to 0 if using templates (at least for VC++). This switch is currently
116 // ignored for mingw / cygwin / CodeWarrior
117 //
118 // Default is 0
119 //
120 // Recommended setting: 0
121 #define wxUSE_DEBUG_NEW_ALWAYS 0
122
123 // wxHandleFatalExceptions() may be used to catch the program faults at run
124 // time and, instead of terminating the program with a usual GPF message box,
125 // call the user-defined wxApp::OnFatalException() function. If you set
126 // wxUSE_ON_FATAL_EXCEPTION to 0, wxHandleFatalExceptions() will not work.
127 //
128 // This setting is for Win32 only and can only be enabled if your compiler
129 // supports Win32 structured exception handling (currently only VC++ does)
130 //
131 // Default is 1
132 //
133 // Recommended setting: 1 if your compiler supports it.
134 #define wxUSE_ON_FATAL_EXCEPTION 1
135
136 // Set this to 1 to be able to generate a human-readable (unlike
137 // machine-readable minidump created by wxCrashReport::Generate()) stack back
138 // trace when your program crashes using wxStackWalker
139 //
140 // Default is 1 if supported by the compiler.
141 //
142 // Recommended setting: 1, set to 0 if your programs never crash
143 #define wxUSE_STACKWALKER 1
144
145 // Set this to 1 to compile in wxDebugReport class which allows you to create
146 // and optionally upload to your web site a debug report consisting of back
147 // trace of the crash (if wxUSE_STACKWALKER == 1) and other information.
148 //
149 // Default is 1 if supported by the compiler.
150 //
151 // Recommended setting: 1, it is compiled into a separate library so there
152 // is no overhead if you don't use it
153 #define wxUSE_DEBUGREPORT 1
154
155 // ----------------------------------------------------------------------------
156 // Unicode support
157 // ----------------------------------------------------------------------------
158
159 // These settings are obsolete: the library is always built in Unicode mode
160 // now, only set wxUSE_UNICODE to 0 to compile legacy code in ANSI mode if
161 // absolutely necessary -- updating it is strongly recommended as the ANSI mode
162 // will disappear completely in future wxWidgets releases.
163 #ifndef wxUSE_UNICODE
164 #define wxUSE_UNICODE 1
165 #endif
166
167 // wxUSE_WCHAR_T is required by wxWidgets now, don't change.
168 #define wxUSE_WCHAR_T 1
169
170 // ----------------------------------------------------------------------------
171 // global features
172 // ----------------------------------------------------------------------------
173
174 // Compile library in exception-safe mode? If set to 1, the library will try to
175 // behave correctly in presence of exceptions (even though it still will not
176 // use the exceptions itself) and notify the user code about any unhandled
177 // exceptions. If set to 0, propagation of the exceptions through the library
178 // code will lead to undefined behaviour -- but the code itself will be
179 // slightly smaller and faster.
180 //
181 // Note that like wxUSE_THREADS this option is automatically set to 0 if
182 // wxNO_EXCEPTIONS is defined.
183 //
184 // Default is 1
185 //
186 // Recommended setting: depends on whether you intend to use C++ exceptions
187 // in your own code (1 if you do, 0 if you don't)
188 #define wxUSE_EXCEPTIONS 1
189
190 // Set wxUSE_EXTENDED_RTTI to 1 to use extended RTTI
191 //
192 // Default is 0
193 //
194 // Recommended setting: 0 (this is still work in progress...)
195 #define wxUSE_EXTENDED_RTTI 0
196
197 // Set wxUSE_STL to 1 to derive wxList(Foo) and wxArray(Foo) from
198 // std::list<Foo*> and std::vector<Foo*>, with a compatibility interface,
199 // and for wxHashMap to be implemented with templates.
200 //
201 // Default is 0
202 //
203 // Recommended setting: YMMV
204 #define wxUSE_STL 0
205
206 // Support for message/error logging. This includes wxLogXXX() functions and
207 // wxLog and derived classes. Don't set this to 0 unless you really know what
208 // you are doing.
209 //
210 // Default is 1
211 //
212 // Recommended setting: 1 (always)
213 #define wxUSE_LOG 1
214
215 // Recommended setting: 1
216 #define wxUSE_LOGWINDOW 1
217
218 // Recommended setting: 1
219 #define wxUSE_LOGGUI 1
220
221 // Recommended setting: 1
222 #define wxUSE_LOG_DIALOG 1
223
224 // Support for command line parsing using wxCmdLineParser class.
225 //
226 // Default is 1
227 //
228 // Recommended setting: 1 (can be set to 0 if you don't use the cmd line)
229 #define wxUSE_CMDLINE_PARSER 1
230
231 // Support for multithreaded applications: if 1, compile in thread classes
232 // (thread.h) and make the library a bit more thread safe. Although thread
233 // support is quite stable by now, you may still consider recompiling the
234 // library without it if you have no use for it - this will result in a
235 // somewhat smaller and faster operation.
236 //
237 // Notice that if wxNO_THREADS is defined, wxUSE_THREADS is automatically reset
238 // to 0 in wx/chkconf.h, so, for example, if you set USE_THREADS to 0 in
239 // build/msw/config.* file this value will have no effect.
240 //
241 // Default is 1
242 //
243 // Recommended setting: 0 unless you do plan to develop MT applications
244 #define wxUSE_THREADS 1
245
246 // If enabled, compiles wxWidgets streams classes
247 //
248 // wx stream classes are used for image IO, process IO redirection, network
249 // protocols implementation and much more and so disabling this results in a
250 // lot of other functionality being lost.
251 //
252 // Default is 1
253 //
254 // Recommended setting: 1 as setting it to 0 disables many other things
255 #define wxUSE_STREAMS 1
256
257 // This is not a real option but is used as the default value for
258 // wxUSE_STD_IOSTREAM and wxUSE_STD_STRING.
259 //
260 // Currently the Digital Mars and Watcom compilers come without standard C++
261 // library headers by default, wxUSE_STD_STRING can be set to 1 if you do have
262 // them (e.g. from STLPort).
263 //
264 // VC++ 5.0 does include standard C++ library headers, however they produce
265 // many warnings that can't be turned off when compiled at warning level 4.
266 #if defined(__DMC__) || defined(__WATCOMC__) \
267 || (defined(_MSC_VER) && _MSC_VER < 1200)
268 #define wxUSE_STD_DEFAULT 0
269 #else
270 #define wxUSE_STD_DEFAULT 1
271 #endif
272
273 // Use standard C++ streams if 1 instead of wx streams in some places. If
274 // disabled (default), wx streams are used everywhere and wxWidgets doesn't
275 // depend on the standard streams library.
276 //
277 // Notice that enabling this does not replace wx streams with std streams
278 // everywhere, in a lot of places wx streams are used no matter what.
279 //
280 // Default is 0
281 //
282 // Recommended setting: 1 if you use the standard streams anyhow and so
283 // dependency on the standard streams library is not a
284 // problem
285 #define wxUSE_STD_IOSTREAM wxUSE_STD_DEFAULT
286
287 // Enable conversion to standard C++ string if 1.
288 //
289 // Default is 1 for most compilers.
290 //
291 // Recommended setting: 1 unless you want to ensure your program doesn't use
292 // the standard C++ library at all.
293 #define wxUSE_STD_STRING wxUSE_STD_DEFAULT
294
295 // Support for positional parameters (e.g. %1$d, %2$s ...) in wxVsnprintf.
296 // Note that if the system's implementation does not support positional
297 // parameters, setting this to 1 forces the use of the wxWidgets implementation
298 // of wxVsnprintf. The standard vsnprintf() supports positional parameters on
299 // many Unix systems but usually doesn't under Windows.
300 //
301 // Positional parameters are very useful when translating a program since using
302 // them in formatting strings allow translators to correctly reorder the
303 // translated sentences.
304 //
305 // Default is 1
306 //
307 // Recommended setting: 1 if you want to support multiple languages
308 #define wxUSE_PRINTF_POS_PARAMS 1
309
310 // ----------------------------------------------------------------------------
311 // non GUI features selection
312 // ----------------------------------------------------------------------------
313
314 // Set wxUSE_LONGLONG to 1 to compile the wxLongLong class. This is a 64 bit
315 // integer which is implemented in terms of native 64 bit integers if any or
316 // uses emulation otherwise.
317 //
318 // This class is required by wxDateTime and so you should enable it if you want
319 // to use wxDateTime. For most modern platforms, it will use the native 64 bit
320 // integers in which case (almost) all of its functions are inline and it
321 // almost does not take any space, so there should be no reason to switch it
322 // off.
323 //
324 // Recommended setting: 1
325 #define wxUSE_LONGLONG 1
326
327 // Set wxUSE_BASE64 to 1, to compile in Base64 support. This is required for
328 // storing binary data in wxConfig on most platforms.
329 //
330 // Default is 1.
331 //
332 // Recommended setting: 1 (but can be safely disabled if you don't use it)
333 #define wxUSE_BASE64 1
334
335 // Set this to 1 to be able to use wxEventLoop even in console applications
336 // (i.e. using base library only, without GUI). This is mostly useful for
337 // processing socket events but is also necessary to use timers in console
338 // applications
339 //
340 // Default is 1.
341 //
342 // Recommended setting: 1 (but can be safely disabled if you don't use it)
343 #define wxUSE_CONSOLE_EVENTLOOP 1
344
345 // Set wxUSE_(F)FILE to 1 to compile wx(F)File classes. wxFile uses low level
346 // POSIX functions for file access, wxFFile uses ANSI C stdio.h functions.
347 //
348 // Default is 1
349 //
350 // Recommended setting: 1 (wxFile is highly recommended as it is required by
351 // i18n code, wxFileConfig and others)
352 #define wxUSE_FILE 1
353 #define wxUSE_FFILE 1
354
355 // Use wxFSVolume class providing access to the configured/active mount points
356 //
357 // Default is 1
358 //
359 // Recommended setting: 1 (but may be safely disabled if you don't use it)
360 #define wxUSE_FSVOLUME 1
361
362 // Use wxStandardPaths class which allows to retrieve some standard locations
363 // in the file system
364 //
365 // Default is 1
366 //
367 // Recommended setting: 1 (may be disabled to save space, but not much)
368 #define wxUSE_STDPATHS 1
369
370 // use wxTextBuffer class: required by wxTextFile
371 #define wxUSE_TEXTBUFFER 1
372
373 // use wxTextFile class: requires wxFile and wxTextBuffer, required by
374 // wxFileConfig
375 #define wxUSE_TEXTFILE 1
376
377 // i18n support: _() macro, wxLocale class. Requires wxTextFile.
378 #define wxUSE_INTL 1
379
380 // Provide wxFoo_l() functions similar to standard foo() functions but taking
381 // an extra locale parameter.
382 //
383 // Notice that this is fully implemented only for the systems providing POSIX
384 // xlocale support or Microsoft Visual C++ >= 8 (which provides proprietary
385 // almost-equivalent of xlocale functions), otherwise wxFoo_l() functions will
386 // only work for the current user locale and "C" locale. You can use
387 // wxHAS_XLOCALE_SUPPORT to test whether the full support is available.
388 //
389 // Default is 1
390 //
391 // Recommended setting: 1 but may be disabled if you are writing programs
392 // running only in C locale anyhow
393 #define wxUSE_XLOCALE 1
394
395 // Set wxUSE_DATETIME to 1 to compile the wxDateTime and related classes which
396 // allow to manipulate dates, times and time intervals. wxDateTime replaces the
397 // old wxTime and wxDate classes which are still provided for backwards
398 // compatibility (and implemented in terms of wxDateTime).
399 //
400 // Note that this class is relatively new and is still officially in alpha
401 // stage because some features are not yet (fully) implemented. It is already
402 // quite useful though and should only be disabled if you are aiming at
403 // absolutely minimal version of the library.
404 //
405 // Requires: wxUSE_LONGLONG
406 //
407 // Default is 1
408 //
409 // Recommended setting: 1
410 #define wxUSE_DATETIME 1
411
412 // Set wxUSE_TIMER to 1 to compile wxTimer class
413 //
414 // Default is 1
415 //
416 // Recommended setting: 1
417 #define wxUSE_TIMER 1
418
419 // Use wxStopWatch clas.
420 //
421 // Default is 1
422 //
423 // Recommended setting: 1 (needed by wxSocket)
424 #define wxUSE_STOPWATCH 1
425
426 // Setting wxUSE_CONFIG to 1 enables the use of wxConfig and related classes
427 // which allow the application to store its settings in the persistent
428 // storage. Setting this to 1 will also enable on-demand creation of the
429 // global config object in wxApp.
430 //
431 // See also wxUSE_CONFIG_NATIVE below.
432 //
433 // Recommended setting: 1
434 #define wxUSE_CONFIG 1
435
436 // If wxUSE_CONFIG is 1, you may choose to use either the native config
437 // classes under Windows (using .INI files under Win16 and the registry under
438 // Win32) or the portable text file format used by the config classes under
439 // Unix.
440 //
441 // Default is 1 to use native classes. Note that you may still use
442 // wxFileConfig even if you set this to 1 - just the config object created by
443 // default for the applications needs will be a wxRegConfig or wxIniConfig and
444 // not wxFileConfig.
445 //
446 // Recommended setting: 1
447 #define wxUSE_CONFIG_NATIVE 1
448
449 // If wxUSE_DIALUP_MANAGER is 1, compile in wxDialUpManager class which allows
450 // to connect/disconnect from the network and be notified whenever the dial-up
451 // network connection is established/terminated. Requires wxUSE_DYNAMIC_LOADER.
452 //
453 // Default is 1.
454 //
455 // Recommended setting: 1
456 #define wxUSE_DIALUP_MANAGER 1
457
458 // Compile in classes for run-time DLL loading and function calling.
459 // Required by wxUSE_DIALUP_MANAGER.
460 //
461 // This setting is for Win32 only
462 //
463 // Default is 1.
464 //
465 // Recommended setting: 1
466 #define wxUSE_DYNLIB_CLASS 1
467
468 // experimental, don't use for now
469 #define wxUSE_DYNAMIC_LOADER 1
470
471 // Set to 1 to use socket classes
472 #define wxUSE_SOCKETS 1
473
474 // Set to 1 to use ipv6 socket classes (requires wxUSE_SOCKETS)
475 //
476 // Notice that currently setting this option under Windows will result in
477 // programs which can only run on recent OS versions (with ws2_32.dll
478 // installed) which is why it is disabled by default.
479 //
480 // Default is 1.
481 //
482 // Recommended setting: 1 if you need IPv6 support
483 #define wxUSE_IPV6 0
484
485 // Set to 1 to enable virtual file systems (required by wxHTML)
486 #define wxUSE_FILESYSTEM 1
487
488 // Set to 1 to enable virtual ZIP filesystem (requires wxUSE_FILESYSTEM)
489 #define wxUSE_FS_ZIP 1
490
491 // Set to 1 to enable virtual archive filesystem (requires wxUSE_FILESYSTEM)
492 #define wxUSE_FS_ARCHIVE 1
493
494 // Set to 1 to enable virtual Internet filesystem (requires wxUSE_FILESYSTEM)
495 #define wxUSE_FS_INET 1
496
497 // wxArchive classes for accessing archives such as zip and tar
498 #define wxUSE_ARCHIVE_STREAMS 1
499
500 // Set to 1 to compile wxZipInput/OutputStream classes.
501 #define wxUSE_ZIPSTREAM 1
502
503 // Set to 1 to compile wxTarInput/OutputStream classes.
504 #define wxUSE_TARSTREAM 1
505
506 // Set to 1 to compile wxZlibInput/OutputStream classes. Also required by
507 // wxUSE_LIBPNG
508 #define wxUSE_ZLIB 1
509
510 // If enabled, the code written by Apple will be used to write, in a portable
511 // way, float on the disk. See extended.c for the license which is different
512 // from wxWidgets one.
513 //
514 // Default is 1.
515 //
516 // Recommended setting: 1 unless you don't like the license terms (unlikely)
517 #define wxUSE_APPLE_IEEE 1
518
519 // Joystick support class
520 #define wxUSE_JOYSTICK 1
521
522 // wxFontEnumerator class
523 #define wxUSE_FONTENUM 1
524
525 // wxFontMapper class
526 #define wxUSE_FONTMAP 1
527
528 // wxMimeTypesManager class
529 #define wxUSE_MIMETYPE 1
530
531 // wxProtocol and related classes: if you want to use either of wxFTP, wxHTTP
532 // or wxURL you need to set this to 1.
533 //
534 // Default is 1.
535 //
536 // Recommended setting: 1
537 #define wxUSE_PROTOCOL 1
538
539 // The settings for the individual URL schemes
540 #define wxUSE_PROTOCOL_FILE 1
541 #define wxUSE_PROTOCOL_FTP 1
542 #define wxUSE_PROTOCOL_HTTP 1
543
544 // Define this to use wxURL class.
545 #define wxUSE_URL 1
546
547 // Define this to use native platform url and protocol support.
548 // Currently valid only for MS-Windows.
549 // Note: if you set this to 1, you can open ftp/http/gopher sites
550 // and obtain a valid input stream for these sites
551 // even when you set wxUSE_PROTOCOL_FTP/HTTP to 0.
552 // Doing so reduces the code size.
553 //
554 // This code is experimental and subject to change.
555 #define wxUSE_URL_NATIVE 0
556
557 // Support for wxVariant class used in several places throughout the library,
558 // notably in wxDataViewCtrl API.
559 //
560 // Default is 1.
561 //
562 // Recommended setting: 1 unless you want to reduce the library size as much as
563 // possible in which case setting this to 0 can gain up to 100KB.
564 #define wxUSE_VARIANT 1
565
566 // Support for regular expression matching via wxRegEx class: enable this to
567 // use POSIX regular expressions in your code. You need to compile regex
568 // library from src/regex to use it under Windows.
569 //
570 // Default is 0
571 //
572 // Recommended setting: 1 if your compiler supports it, if it doesn't please
573 // contribute us a makefile for src/regex for it
574 #define wxUSE_REGEX 1
575
576 // wxSystemOptions class
577 #define wxUSE_SYSTEM_OPTIONS 1
578
579 // wxSound class
580 #define wxUSE_SOUND 1
581
582 // Use wxMediaCtrl
583 //
584 // Default is 1.
585 //
586 // Recommended setting: 1
587 #define wxUSE_MEDIACTRL 1
588
589 // Use GStreamer for Unix.
590 //
591 // Default is 0 as this requires a lot of dependencies which might not be
592 // available.
593 //
594 // Recommended setting: 1 (wxMediaCtrl won't work by default without it)
595 #define wxUSE_GSTREAMER 0
596
597 // Use wxWidget's XRC XML-based resource system. Recommended.
598 //
599 // Default is 1
600 //
601 // Recommended setting: 1 (requires wxUSE_XML)
602 #define wxUSE_XRC 1
603
604 // XML parsing classes. Note that their API will change in the future, so
605 // using wxXmlDocument and wxXmlNode in your app is not recommended.
606 //
607 // Default is the same as wxUSE_XRC, i.e. 1 by default.
608 //
609 // Recommended setting: 1 (required by XRC)
610 #define wxUSE_XML wxUSE_XRC
611
612 // Use wxWidget's AUI docking system
613 //
614 // Default is 1
615 //
616 // Recommended setting: 1
617 #define wxUSE_AUI 1
618
619 // Use wxPropertyGrid.
620 //
621 // Default is 1
622 //
623 // Recommended setting: 1
624 #define wxUSE_PROPGRID 1
625
626 // Use wxStyledTextCtrl, a wxWidgets implementation of Scintilla.
627 //
628 // Default is 1
629 //
630 // Recommended setting: 1
631 #define wxUSE_STC 1
632
633
634 // Enable the new wxGraphicsPath and wxGraphicsContext classes for an advanced
635 // 2D drawing API. (Still somewhat experimental)
636 //
637 // Please note that on Windows you will need to link with gdiplus.lib (use
638 // USE_GDIPLUS=1 for makefile builds) and distribute gdiplus.dll with your
639 // application if you want it to be runnable on pre-XP systems.
640 //
641 // Default is 0
642 //
643 // Recommended setting: 1
644 #ifndef wxUSE_GRAPHICS_CONTEXT
645 #define wxUSE_GRAPHICS_CONTEXT 0
646 #endif
647
648 // ----------------------------------------------------------------------------
649 // Individual GUI controls
650 // ----------------------------------------------------------------------------
651
652 // You must set wxUSE_CONTROLS to 1 if you are using any controls at all
653 // (without it, wxControl class is not compiled)
654 //
655 // Default is 1
656 //
657 // Recommended setting: 1 (don't change except for very special programs)
658 #define wxUSE_CONTROLS 1
659
660 // wxPopupWindow class is a top level transient window. It is currently used
661 // to implement wxTipWindow
662 //
663 // Default is 1
664 //
665 // Recommended setting: 1 (may be set to 0 if you don't wxUSE_TIPWINDOW)
666 #define wxUSE_POPUPWIN 1
667
668 // wxTipWindow allows to implement the custom tooltips, it is used by the
669 // context help classes. Requires wxUSE_POPUPWIN.
670 //
671 // Default is 1
672 //
673 // Recommended setting: 1 (may be set to 0)
674 #define wxUSE_TIPWINDOW 1
675
676 // Each of the settings below corresponds to one wxWidgets control. They are
677 // all switched on by default but may be disabled if you are sure that your
678 // program (including any standard dialogs it can show!) doesn't need them and
679 // if you desperately want to save some space. If you use any of these you must
680 // set wxUSE_CONTROLS as well.
681 //
682 // Default is 1
683 //
684 // Recommended setting: 1
685 #define wxUSE_ANIMATIONCTRL 1 // wxAnimationCtrl
686 #define wxUSE_BUTTON 1 // wxButton
687 #define wxUSE_BMPBUTTON 1 // wxBitmapButton
688 #define wxUSE_CALENDARCTRL 1 // wxCalendarCtrl
689 #define wxUSE_CHECKBOX 1 // wxCheckBox
690 #define wxUSE_CHECKLISTBOX 1 // wxCheckListBox (requires wxUSE_OWNER_DRAWN)
691 #define wxUSE_CHOICE 1 // wxChoice
692 #define wxUSE_COLLPANE 1 // wxCollapsiblePane
693 #define wxUSE_COLOURPICKERCTRL 1 // wxColourPickerCtrl
694 #define wxUSE_COMBOBOX 1 // wxComboBox
695 #define wxUSE_DATAVIEWCTRL 1 // wxDataViewCtrl
696 #define wxUSE_DATEPICKCTRL 1 // wxDatePickerCtrl
697 #define wxUSE_DIRPICKERCTRL 1 // wxDirPickerCtrl
698 #define wxUSE_EDITABLELISTBOX 1 // wxEditableListBox
699 #define wxUSE_FILECTRL 1 // wxFileCtrl
700 #define wxUSE_FILEPICKERCTRL 1 // wxFilePickerCtrl
701 #define wxUSE_FONTPICKERCTRL 1 // wxFontPickerCtrl
702 #define wxUSE_GAUGE 1 // wxGauge
703 #define wxUSE_HEADERCTRL 1 // wxHeaderCtrl
704 #define wxUSE_HYPERLINKCTRL 1 // wxHyperlinkCtrl
705 #define wxUSE_LISTBOX 1 // wxListBox
706 #define wxUSE_LISTCTRL 1 // wxListCtrl
707 #define wxUSE_RADIOBOX 1 // wxRadioBox
708 #define wxUSE_RADIOBTN 1 // wxRadioButton
709 #define wxUSE_SCROLLBAR 1 // wxScrollBar
710 #define wxUSE_SEARCHCTRL 1 // wxSearchCtrl
711 #define wxUSE_SLIDER 1 // wxSlider
712 #define wxUSE_SPINBTN 1 // wxSpinButton
713 #define wxUSE_SPINCTRL 1 // wxSpinCtrl
714 #define wxUSE_STATBOX 1 // wxStaticBox
715 #define wxUSE_STATLINE 1 // wxStaticLine
716 #define wxUSE_STATTEXT 1 // wxStaticText
717 #define wxUSE_STATBMP 1 // wxStaticBitmap
718 #define wxUSE_TEXTCTRL 1 // wxTextCtrl
719 #define wxUSE_TOGGLEBTN 1 // requires wxButton
720 #define wxUSE_TREECTRL 1 // wxTreeCtrl
721
722 // Use a status bar class? Depending on the value of wxUSE_NATIVE_STATUSBAR
723 // below either wxStatusBar95 or a generic wxStatusBar will be used.
724 //
725 // Default is 1
726 //
727 // Recommended setting: 1
728 #define wxUSE_STATUSBAR 1
729
730 // Two status bar implementations are available under Win32: the generic one
731 // or the wrapper around native control. For native look and feel the native
732 // version should be used.
733 //
734 // Default is 1 for the platforms where native status bar is supported.
735 //
736 // Recommended setting: 1 (there is no advantage in using the generic one)
737 #define wxUSE_NATIVE_STATUSBAR 1
738
739 // wxToolBar related settings: if wxUSE_TOOLBAR is 0, don't compile any toolbar
740 // classes at all. Otherwise, use the native toolbar class unless
741 // wxUSE_TOOLBAR_NATIVE is 0.
742 //
743 // Default is 1 for all settings.
744 //
745 // Recommended setting: 1 for wxUSE_TOOLBAR and wxUSE_TOOLBAR_NATIVE.
746 #define wxUSE_TOOLBAR 1
747 #define wxUSE_TOOLBAR_NATIVE 1
748
749 // wxNotebook is a control with several "tabs" located on one of its sides. It
750 // may be used to logically organise the data presented to the user instead of
751 // putting everything in one huge dialog. It replaces wxTabControl and related
752 // classes of wxWin 1.6x.
753 //
754 // Default is 1.
755 //
756 // Recommended setting: 1
757 #define wxUSE_NOTEBOOK 1
758
759 // wxListbook control is similar to wxNotebook but uses wxListCtrl instead of
760 // the tabs
761 //
762 // Default is 1.
763 //
764 // Recommended setting: 1
765 #define wxUSE_LISTBOOK 1
766
767 // wxChoicebook control is similar to wxNotebook but uses wxChoice instead of
768 // the tabs
769 //
770 // Default is 1.
771 //
772 // Recommended setting: 1
773 #define wxUSE_CHOICEBOOK 1
774
775 // wxTreebook control is similar to wxNotebook but uses wxTreeCtrl instead of
776 // the tabs
777 //
778 // Default is 1.
779 //
780 // Recommended setting: 1
781 #define wxUSE_TREEBOOK 1
782
783 // wxToolbook control is similar to wxNotebook but uses wxToolBar instead of
784 // tabs
785 //
786 // Default is 1.
787 //
788 // Recommended setting: 1
789 #define wxUSE_TOOLBOOK 1
790
791 // wxTaskBarIcon is a small notification icon shown in the system toolbar or
792 // dock.
793 //
794 // Default is 1.
795 //
796 // Recommended setting: 1 (but can be set to 0 if you don't need it)
797 #define wxUSE_TASKBARICON 1
798
799 // wxGrid class
800 //
801 // Default is 1, set to 0 to cut down compilation time and binaries size if you
802 // don't use it.
803 //
804 // Recommended setting: 1
805 //
806 #define wxUSE_GRID 1
807
808 // wxMiniFrame class: a frame with narrow title bar
809 //
810 // Default is 1.
811 //
812 // Recommended setting: 1 (it doesn't cost almost anything)
813 #define wxUSE_MINIFRAME 1
814
815 // wxComboCtrl and related classes: combobox with custom popup window and
816 // not necessarily a listbox.
817 //
818 // Default is 1.
819 //
820 // Recommended setting: 1 but can be safely set to 0 except for wxUniv where it
821 // it used by wxComboBox
822 #define wxUSE_COMBOCTRL 1
823
824 // wxOwnerDrawnComboBox is a custom combobox allowing to paint the combobox
825 // items.
826 //
827 // Default is 1.
828 //
829 // Recommended setting: 1 but can be safely set to 0, except where it is
830 // needed as a base class for generic wxBitmapComboBox.
831 #define wxUSE_ODCOMBOBOX 1
832
833 // wxBitmapComboBox is a combobox that can have images in front of text items.
834 //
835 // Default is 1.
836 //
837 // Recommended setting: 1 but can be safely set to 0
838 #define wxUSE_BITMAPCOMBOBOX 1
839
840 // wxRearrangeCtrl is a wxCheckListBox with two buttons allowing to move items
841 // up and down in it. It is also used as part of wxRearrangeDialog.
842 //
843 // Default is 1.
844 //
845 // Recommended setting: 1 but can be safely set to 0 (currently used only by
846 // wxHeaderCtrl)
847 #define wxUSE_REARRANGECTRL 1
848
849 // ----------------------------------------------------------------------------
850 // Miscellaneous GUI stuff
851 // ----------------------------------------------------------------------------
852
853 // wxAcceleratorTable/Entry classes and support for them in wxMenu(Bar)
854 #define wxUSE_ACCEL 1
855
856 // Hotkey support (currently Windows only)
857 #define wxUSE_HOTKEY 1
858
859 // Use wxCaret: a class implementing a "cursor" in a text control (called caret
860 // under Windows).
861 //
862 // Default is 1.
863 //
864 // Recommended setting: 1 (can be safely set to 0, not used by the library)
865 #define wxUSE_CARET 1
866
867 // Use wxDisplay class: it allows enumerating all displays on a system and
868 // their geometries as well as finding the display on which the given point or
869 // window lies.
870 //
871 // Default is 1.
872 //
873 // Recommended setting: 1 if you need it, can be safely set to 0 otherwise
874 #define wxUSE_DISPLAY 1
875
876 // Miscellaneous geometry code: needed for Canvas library
877 #define wxUSE_GEOMETRY 1
878
879 // Use wxImageList. This class is needed by wxNotebook, wxTreeCtrl and
880 // wxListCtrl.
881 //
882 // Default is 1.
883 //
884 // Recommended setting: 1 (set it to 0 if you don't use any of the controls
885 // enumerated above, then this class is mostly useless too)
886 #define wxUSE_IMAGLIST 1
887
888 // Use wxMenu, wxMenuBar, wxMenuItem.
889 //
890 // Default is 1.
891 //
892 // Recommended setting: 1 (can't be disabled under MSW)
893 #define wxUSE_MENUS 1
894
895 // Use wxNotificationMessage.
896 //
897 // wxNotificationMessage allows to show non-intrusive messages to the user
898 // using balloons, banners, popups or whatever is the appropriate method for
899 // the current platform.
900 //
901 // Default is 1.
902 //
903 // Recommended setting: 1
904 #define wxUSE_NOTIFICATION_MESSAGE 1
905
906 // Use wxSashWindow class.
907 //
908 // Default is 1.
909 //
910 // Recommended setting: 1
911 #define wxUSE_SASH 1
912
913 // Use wxSplitterWindow class.
914 //
915 // Default is 1.
916 //
917 // Recommended setting: 1
918 #define wxUSE_SPLITTER 1
919
920 // Use wxToolTip and wxWindow::Set/GetToolTip() methods.
921 //
922 // Default is 1.
923 //
924 // Recommended setting: 1
925 #define wxUSE_TOOLTIPS 1
926
927 // wxValidator class and related methods
928 #define wxUSE_VALIDATORS 1
929
930 // Use reference counted ID management: this means that wxWidgets will track
931 // the automatically allocated ids (those used when you use wxID_ANY when
932 // creating a window, menu or toolbar item &c) instead of just supposing that
933 // the program never runs out of them. This is mostly useful only under wxMSW
934 // where the total ids range is limited to SHRT_MIN..SHRT_MAX and where
935 // long-running programs can run into problems with ids reuse without this. On
936 // the other platforms, where the ids have the full int range, this shouldn't
937 // be necessary.
938 #ifdef __WXMSW__
939 #define wxUSE_AUTOID_MANAGEMENT 1
940 #else
941 #define wxUSE_AUTOID_MANAGEMENT 0
942 #endif
943
944 // ----------------------------------------------------------------------------
945 // common dialogs
946 // ----------------------------------------------------------------------------
947
948 // On rare occasions (e.g. using DJGPP) may want to omit common dialogs (e.g.
949 // file selector, printer dialog). Switching this off also switches off the
950 // printing architecture and interactive wxPrinterDC.
951 //
952 // Default is 1
953 //
954 // Recommended setting: 1 (unless it really doesn't work)
955 #define wxUSE_COMMON_DIALOGS 1
956
957 // wxBusyInfo displays window with message when app is busy. Works in same way
958 // as wxBusyCursor
959 #define wxUSE_BUSYINFO 1
960
961 // Use single/multiple choice dialogs.
962 //
963 // Default is 1
964 //
965 // Recommended setting: 1 (used in the library itself)
966 #define wxUSE_CHOICEDLG 1
967
968 // Use colour picker dialog
969 //
970 // Default is 1
971 //
972 // Recommended setting: 1
973 #define wxUSE_COLOURDLG 1
974
975 // wxDirDlg class for getting a directory name from user
976 #define wxUSE_DIRDLG 1
977
978 // TODO: setting to choose the generic or native one
979
980 // Use file open/save dialogs.
981 //
982 // Default is 1
983 //
984 // Recommended setting: 1 (used in many places in the library itself)
985 #define wxUSE_FILEDLG 1
986
987 // Use find/replace dialogs.
988 //
989 // Default is 1
990 //
991 // Recommended setting: 1 (but may be safely set to 0)
992 #define wxUSE_FINDREPLDLG 1
993
994 // Use font picker dialog
995 //
996 // Default is 1
997 //
998 // Recommended setting: 1 (used in the library itself)
999 #define wxUSE_FONTDLG 1
1000
1001 // Use wxMessageDialog and wxMessageBox.
1002 //
1003 // Default is 1
1004 //
1005 // Recommended setting: 1 (used in the library itself)
1006 #define wxUSE_MSGDLG 1
1007
1008 // progress dialog class for lengthy operations
1009 #define wxUSE_PROGRESSDLG 1
1010
1011 // support for startup tips (wxShowTip &c)
1012 #define wxUSE_STARTUP_TIPS 1
1013
1014 // text entry dialog and wxGetTextFromUser function
1015 #define wxUSE_TEXTDLG 1
1016
1017 // number entry dialog
1018 #define wxUSE_NUMBERDLG 1
1019
1020 // splash screen class
1021 #define wxUSE_SPLASH 1
1022
1023 // wizards
1024 #define wxUSE_WIZARDDLG 1
1025
1026 // Compile in wxAboutBox() function showing the standard "About" dialog.
1027 //
1028 // Default is 1
1029 //
1030 // Recommended setting: 1 but can be set to 0 to save some space if you don't
1031 // use this function
1032 #define wxUSE_ABOUTDLG 1
1033
1034 // ----------------------------------------------------------------------------
1035 // Metafiles support
1036 // ----------------------------------------------------------------------------
1037
1038 // Windows supports the graphics format known as metafile which is, though not
1039 // portable, is widely used under Windows and so is supported by wxWin (under
1040 // Windows only, of course). Win16 (Win3.1) used the so-called "Window
1041 // MetaFiles" or WMFs which were replaced with "Enhanced MetaFiles" or EMFs in
1042 // Win32 (Win9x, NT, 2000). Both of these are supported in wxWin and, by
1043 // default, WMFs will be used under Win16 and EMFs under Win32. This may be
1044 // changed by setting wxUSE_WIN_METAFILES_ALWAYS to 1 and/or setting
1045 // wxUSE_ENH_METAFILE to 0. You may also set wxUSE_METAFILE to 0 to not compile
1046 // in any metafile related classes at all.
1047 //
1048 // Default is 1 for wxUSE_ENH_METAFILE and 0 for wxUSE_WIN_METAFILES_ALWAYS.
1049 //
1050 // Recommended setting: default or 0 for everything for portable programs.
1051 #define wxUSE_METAFILE 1
1052 #define wxUSE_ENH_METAFILE 1
1053 #define wxUSE_WIN_METAFILES_ALWAYS 0
1054
1055 // ----------------------------------------------------------------------------
1056 // Big GUI components
1057 // ----------------------------------------------------------------------------
1058
1059 // Set to 0 to disable MDI support.
1060 //
1061 // Requires wxUSE_NOTEBOOK under platforms other than MSW.
1062 //
1063 // Default is 1.
1064 //
1065 // Recommended setting: 1, can be safely set to 0.
1066 #define wxUSE_MDI 1
1067
1068 // Set to 0 to disable document/view architecture
1069 #define wxUSE_DOC_VIEW_ARCHITECTURE 1
1070
1071 // Set to 0 to disable MDI document/view architecture
1072 //
1073 // Requires wxUSE_MDI && wxUSE_DOC_VIEW_ARCHITECTURE
1074 #define wxUSE_MDI_ARCHITECTURE 1
1075
1076 // Set to 0 to disable print/preview architecture code
1077 #define wxUSE_PRINTING_ARCHITECTURE 1
1078
1079 // wxHTML sublibrary allows to display HTML in wxWindow programs and much,
1080 // much more.
1081 //
1082 // Default is 1.
1083 //
1084 // Recommended setting: 1 (wxHTML is great!), set to 0 if you want compile a
1085 // smaller library.
1086 #define wxUSE_HTML 1
1087
1088 // Setting wxUSE_GLCANVAS to 1 enables OpenGL support. You need to have OpenGL
1089 // headers and libraries to be able to compile the library with wxUSE_GLCANVAS
1090 // set to 1. Note that for some compilers (notably Microsoft Visual C++) you
1091 // will need to manually add opengl32.lib and glu32.lib to the list of
1092 // libraries linked with your program if you use OpenGL.
1093 //
1094 // Default is 0.
1095 //
1096 // Recommended setting: 1 if you intend to use OpenGL, 0 otherwise
1097 #define wxUSE_GLCANVAS 0
1098
1099 // wxRichTextCtrl allows editing of styled text.
1100 //
1101 // Default is 1.
1102 //
1103 // Recommended setting: 1, set to 0 if you want compile a
1104 // smaller library.
1105 #define wxUSE_RICHTEXT 1
1106
1107 // ----------------------------------------------------------------------------
1108 // Data transfer
1109 // ----------------------------------------------------------------------------
1110
1111 // Use wxClipboard class for clipboard copy/paste.
1112 //
1113 // Default is 1.
1114 //
1115 // Recommended setting: 1
1116 #define wxUSE_CLIPBOARD 1
1117
1118 // Use wxDataObject and related classes. Needed for clipboard and OLE drag and
1119 // drop
1120 //
1121 // Default is 1.
1122 //
1123 // Recommended setting: 1
1124 #define wxUSE_DATAOBJ 1
1125
1126 // Use wxDropTarget and wxDropSource classes for drag and drop (this is
1127 // different from "built in" drag and drop in wxTreeCtrl which is always
1128 // available). Requires wxUSE_DATAOBJ.
1129 //
1130 // Default is 1.
1131 //
1132 // Recommended setting: 1
1133 #define wxUSE_DRAG_AND_DROP 1
1134
1135 // Use wxAccessible for enhanced and customisable accessibility.
1136 // Depends on wxUSE_OLE.
1137 //
1138 // Default is 0.
1139 //
1140 // Recommended setting (at present): 0
1141 #define wxUSE_ACCESSIBILITY 0
1142
1143 // ----------------------------------------------------------------------------
1144 // miscellaneous settings
1145 // ----------------------------------------------------------------------------
1146
1147 // wxSingleInstanceChecker class allows to verify at startup if another program
1148 // instance is running.
1149 //
1150 // Default is 1
1151 //
1152 // Recommended setting: 1 (the class is tiny, disabling it won't save much
1153 // space)
1154 #define wxUSE_SNGLINST_CHECKER 1
1155
1156 #define wxUSE_DRAGIMAGE 1
1157
1158 #define wxUSE_IPC 1
1159 // 0 for no interprocess comms
1160 #define wxUSE_HELP 1
1161 // 0 for no help facility
1162
1163 // Should we use MS HTML help for wxHelpController? If disabled, neither
1164 // wxCHMHelpController nor wxBestHelpController are available.
1165 //
1166 // Default is 1 under MSW, 0 is always used for the other platforms.
1167 //
1168 // Recommended setting: 1, only set to 0 if you have trouble compiling
1169 // wxCHMHelpController (could be a problem with really ancient compilers)
1170 #define wxUSE_MS_HTML_HELP 1
1171
1172
1173 // Use wxHTML-based help controller?
1174 #define wxUSE_WXHTML_HELP 1
1175
1176 #define wxUSE_CONSTRAINTS 1
1177 // 0 for no window layout constraint system
1178
1179 #define wxUSE_SPLINES 1
1180 // 0 for no splines
1181
1182 #define wxUSE_MOUSEWHEEL 1
1183 // Include mouse wheel support
1184
1185 // ----------------------------------------------------------------------------
1186 // wxDC classes for various output formats
1187 // ----------------------------------------------------------------------------
1188
1189 // Set to 1 for PostScript device context.
1190 #define wxUSE_POSTSCRIPT 0
1191
1192 // Set to 1 to use font metric files in GetTextExtent
1193 #define wxUSE_AFM_FOR_POSTSCRIPT 1
1194
1195 // Set to 1 to compile in support for wxSVGFileDC, a wxDC subclass which allows
1196 // to create files in SVG (Scalable Vector Graphics) format.
1197 #define wxUSE_SVG 1
1198
1199 // ----------------------------------------------------------------------------
1200 // other compiler (mis)features
1201 // ----------------------------------------------------------------------------
1202
1203 // Set this to 0 if your compiler can't cope with omission of prototype
1204 // parameters.
1205 //
1206 // Default is 1.
1207 //
1208 // Recommended setting: 1 (should never need to set this to 0)
1209 #define REMOVE_UNUSED_ARG 1
1210
1211 // VC++ 4.2 and above allows <iostream> and <iostream.h> but you can't mix
1212 // them. Set this option to 1 to use <iostream.h>, 0 to use <iostream>.
1213 //
1214 // Note that newer compilers (including VC++ 7.1 and later) don't support
1215 // wxUSE_IOSTREAMH == 1 and so <iostream> will be used anyhow.
1216 //
1217 // Default is 0.
1218 //
1219 // Recommended setting: 0, only set to 1 if you use a really old compiler
1220 #define wxUSE_IOSTREAMH 0
1221
1222 // ----------------------------------------------------------------------------
1223 // image format support
1224 // ----------------------------------------------------------------------------
1225
1226 // wxImage supports many different image formats which can be configured at
1227 // compile-time. BMP is always supported, others are optional and can be safely
1228 // disabled if you don't plan to use images in such format sometimes saving
1229 // substantial amount of code in the final library.
1230 //
1231 // Some formats require an extra library which is included in wxWin sources
1232 // which is mentioned if it is the case.
1233
1234 // Set to 1 for wxImage support (recommended).
1235 #define wxUSE_IMAGE 1
1236
1237 // Set to 1 for PNG format support (requires libpng). Also requires wxUSE_ZLIB.
1238 #define wxUSE_LIBPNG 1
1239
1240 // Set to 1 for JPEG format support (requires libjpeg)
1241 #define wxUSE_LIBJPEG 1
1242
1243 // Set to 1 for TIFF format support (requires libtiff)
1244 #define wxUSE_LIBTIFF 1
1245
1246 // Set to 1 for TGA format support (loading only)
1247 #define wxUSE_TGA 1
1248
1249 // Set to 1 for GIF format support
1250 #define wxUSE_GIF 1
1251
1252 // Set to 1 for PNM format support
1253 #define wxUSE_PNM 1
1254
1255 // Set to 1 for PCX format support
1256 #define wxUSE_PCX 1
1257
1258 // Set to 1 for IFF format support (Amiga format)
1259 #define wxUSE_IFF 0
1260
1261 // Set to 1 for XPM format support
1262 #define wxUSE_XPM 1
1263
1264 // Set to 1 for MS Icons and Cursors format support
1265 #define wxUSE_ICO_CUR 1
1266
1267 // Set to 1 to compile in wxPalette class
1268 #define wxUSE_PALETTE 1
1269
1270 // ----------------------------------------------------------------------------
1271 // wxUniversal-only options
1272 // ----------------------------------------------------------------------------
1273
1274 // Set to 1 to enable compilation of all themes, this is the default
1275 #define wxUSE_ALL_THEMES 1
1276
1277 // Set to 1 to enable the compilation of individual theme if wxUSE_ALL_THEMES
1278 // is unset, if it is set these options are not used; notice that metal theme
1279 // uses Win32 one
1280 #define wxUSE_THEME_GTK 0
1281 #define wxUSE_THEME_METAL 0
1282 #define wxUSE_THEME_MONO 0
1283 #define wxUSE_THEME_WIN32 0
1284
1285