Added possibility of 2-step initialisation, and wxWIZARD_EX_HELPBUTTON style.
[wxWidgets.git] / include / wx / msw / setup0.h
CommitLineData
9bd6a503 1/////////////////////////////////////////////////////////////////////////////
b3402d0d 2// Name: wx/msw/setup.h
9bd6a503
VZ
3// Purpose: Configuration for the library
4// Author: Julian Smart
5// Modified by:
6// Created: 01/02/97
7// RCS-ID: $Id$
8// Copyright: (c) Julian Smart
3ca6a5f0 9// Licence: wxWindows license
9bd6a503
VZ
10/////////////////////////////////////////////////////////////////////////////
11
12#ifndef _WX_SETUP_H_
13#define _WX_SETUP_H_
14
73974df1
VZ
15// ----------------------------------------------------------------------------
16// global settings
17// ----------------------------------------------------------------------------
9bd6a503 18
f6bcfd97
BP
19// define this to 0 when building wxBase library - this can also be done from
20// makefile/project file overriding the value here
21#ifndef wxUSE_GUI
22 #define wxUSE_GUI 1
23#endif // wxUSE_GUI
1f112209 24
6d167489
VZ
25// ----------------------------------------------------------------------------
26// compatibility settings
27// ----------------------------------------------------------------------------
28
b3402d0d
VZ
29// This setting determines the compatibility with 1.68 API:
30// Level 0: no backward compatibility, all new features
31// Level 1: some extra methods are defined for compatibility.
32//
33// Default is 0.
34//
35// Recommended setting: 0 (in fact the compatibility code is now very minimal
36// so there is little advantage to setting it to 1.
9bd6a503 37#define WXWIN_COMPATIBILITY 0
9bd6a503 38
54276ccf
VZ
39// This setting determines the compatibility with 2.0 API: set it to 1 to
40// enable it
41//
42// Default is 0.
43//
44// Recommended setting: 0 (please update your code instead!)
45#define WXWIN_COMPATIBILITY_2 0
46
47// This setting determines the compatibility with 2.0 API: set it to 1 to
48// enable it
49//
50// Default is 0.
51//
52// Recommended setting: 0 (please update your code instead!)
53#define WXWIN_COMPATIBILITY_2_2 0
54
6d167489
VZ
55// in wxMSW version 2.1.11 and earlier, wxIcon always derives from wxBitmap,
56// but this is very dangerous because you can mistakenly pass an icon instead
57// of a bitmap to a function taking "const wxBitmap&" - which will *not* work
58// because an icon is not a valid bitmap
59//
60// Starting from 2.1.12, you have the choice under this backwards compatible
61// behaviour (your code will still compile, but probably won't behave as
62// expected!) and not deriving wxIcon class from wxBitmap, but providing a
63// conversion ctor wxBitmap(const wxIcon&) instead.
64//
65// Recommended setting: 0
66#define wxICON_IS_BITMAP 0
67
3ca6a5f0
BP
68// Define as 1 for font size to be backward compatible to 1.63 and earlier.
69// 1.64 and later define point sizes to be compatible with Windows.
70//
71// Default is 0
72//
73// Recommended setting: 0
74#define wxFONT_SIZE_COMPATIBILITY 0
75
76// Set to 0 for accurate dialog units, else 1 to be as per 2.1.16 and before.
77// If migrating between versions, your dialogs may seem to shrink.
78//
79// Default is 1
80//
81// Recommended setting: 0 (the new calculations are more correct!)
82#define wxDIALOG_UNIT_COMPATIBILITY 1
83
3b415ba4
VZ
84// ----------------------------------------------------------------------------
85// debugging settings
86// ----------------------------------------------------------------------------
87
88// Generic comment about debugging settings: they are very useful if you don't
89// use any other memory leak detection tools such as Purify/BoundsChecker, but
90// are probably redundant otherwise. Also, Visual C++ CRT has the same features
91// as wxWindows memory debugging subsystem built in since version 5.0 and you
92// may prefer to use it instead of built in memory debugging code because it is
93// faster and more fool proof.
94//
95// Using VC++ CRT memory debugging is enabled by default in debug mode
96// (__WXDEBUG__) if wxUSE_GLOBAL_MEMORY_OPERATORS is *not* enabled (i.e. is 0)
97// and if __NO_VC_CRTDBG__ is not defined.
98
99// If 1, enables wxDebugContext, for writing error messages to file, etc. If
100// __WXDEBUG__ is not defined, will still use normal memory operators. It's
101// recommended to set this to 1, since you may well need to output an error log
102// in a production version (or non-debugging beta).
103//
104// Default is 1.
105//
106// Recommended setting: 1 but see comment above
107#define wxUSE_DEBUG_CONTEXT 1
108
109// If 1, enables debugging versions of wxObject::new and wxObject::delete *IF*
110// __WXDEBUG__ is also defined.
111//
112// WARNING: this code may not work with all architectures, especially if
113// alignment is an issue. This switch is currently ignored for mingw / cygwin
114//
115// Default is 1
116//
117// Recommended setting: 1 but see comment in the beginning of this section
118#define wxUSE_MEMORY_TRACING 1
119
120// In debug mode, cause new and delete to be redefined globally.
121// If this causes problems (e.g. link errors), set this to 0.
122// This switch is currently ignored for mingw / cygwin
123//
124// Default is 1
125//
126// Recommended setting: 1 but see comment in the beginning of this section
127#define wxUSE_GLOBAL_MEMORY_OPERATORS 1
128
129// In debug mode, causes new to be defined to be WXDEBUG_NEW (see object.h). If
130// this causes problems (e.g. link errors), set this to 0. You may need to set
131// this to 0 if using templates (at least for VC++). This switch is currently
132// ignored for mingw / cygwin
133//
134// Default is 1
135//
136// Recommended setting: 1 but see comment in the beginning of this section
137#define wxUSE_DEBUG_NEW_ALWAYS 1
138
139// wxHandleFatalExceptions() may be used to catch the program faults at run
140// time and, instead of terminating the program with a usual GPF message box,
141// call the user-defined wxApp::OnFatalException() function. If you set
142// wxUSE_ON_FATAL_EXCEPTION to 0, wxHandleFatalExceptions() will not work.
143//
144// This setting is for Win32 only and can only be enabled if your compiler
145// supports Win32 structured exception handling (currently only VC++ does)
146//
147// Default is 1
148//
149// Recommended setting: 1 if your compiler supports it.
150#ifdef _MSC_VER
151 #define wxUSE_ON_FATAL_EXCEPTION 1
152#else
153 #define wxUSE_ON_FATAL_EXCEPTION 0
154#endif
155
f6bcfd97
BP
156// ----------------------------------------------------------------------------
157// Unicode support
158// ----------------------------------------------------------------------------
159
160// Set wxUSE_UNICODE to 1 to compile wxWindows in Unicode mode: wxChar will be
161// defined as wchar_t, wxString will use Unicode internally. If you set this
162// to 1, you must use wxT() macro for all literal strings in the program.
163//
164// Unicode is currently only fully supported under Windows NT/2000 (Windows 9x
165// doesn't support it and the programs compiled in Unicode mode will not run
166// under 9x).
167//
168// Default is 0
169//
170// Recommended setting: 0 (unless you only plan to use Windows NT/2000)
171#define wxUSE_UNICODE 0
172
173// Setting wxUSE_WCHAR_T to 1 gives you some degree of Unicode support without
174// compiling the program in Unicode mode. More precisely, it will be possible
175// to construct wxString from a wide (Unicode) string and convert any wxString
176// to Unicode.
177//
178// Default is 1
179//
180// Recommended setting: 1
181#define wxUSE_WCHAR_T 1
182
3b415ba4
VZ
183// ----------------------------------------------------------------------------
184// global features
185// ----------------------------------------------------------------------------
186
187// Support for message/error logging. This includes wxLogXXX() functions and
188// wxLog and derived classes. Don't set this to 0 unless you really know what
189// you are doing.
190//
191// Default is 1
192//
193// Recommended setting: 1 (always)
194#define wxUSE_LOG 1
195
a5bb60ce
VZ
196// Support for command line parsing using wxCmdLineParser class.
197//
198// Default is 1
199//
200// Recommended setting: 1 (can be set to 0 if you don't use the cmd line)
201#define wxUSE_CMDLINE_PARSER 1
202
203// Recommended setting: 1
dd8b2f4a
JS
204#define wxUSE_LOGWINDOW 1
205
a5bb60ce 206// Recommended setting: 1
dd8b2f4a
JS
207#define wxUSE_LOGGUI 1
208
a5bb60ce 209// Recommended setting: 1
3e6e2754
JS
210#define wxUSE_LOG_DIALOG 1
211
3b415ba4
VZ
212// Support for multithreaded applications: if 1, compile in thread classes
213// (thread.h) and make the library a bit more thread safe. Although thread
214// support is quite stable by now, you may still consider recompiling the
215// library without it if you have no use for it - this will result in a
216// somewhat smaller and faster operation.
217//
218// This is ignored under Win16, threads are only supported under Win32.
219//
220// Default is 1
221//
222// Recommended setting: 0 unless you do plan to develop MT applications
223#define wxUSE_THREADS 1
224
225// If enabled (1), compiles wxWindows streams classes
226#define wxUSE_STREAMS 1
227
228// Use standard C++ streams if 1. If 0, use wxWin streams implementation.
229#define wxUSE_STD_IOSTREAM 0
230
231// Use serialization (requires utils/serialize)
232#define wxUSE_SERIAL 0
233
73974df1 234// ----------------------------------------------------------------------------
40973ea5 235// non GUI features selection
73974df1
VZ
236// ----------------------------------------------------------------------------
237
40973ea5
VZ
238// Set wxUSE_LONGLONG to 1 to compile the wxLongLong class. This is a 64 bit
239// integer which is implemented in terms of native 64 bit integers if any or
240// uses emulation otherwise.
241//
242// This class is required by wxDateTime and so you should enable it if you want
243// to use wxDateTime. For most modern platforms, it will use the native 64 bit
244// integers in which case (almost) all of its functions are inline and it
245// almost does not take any space, so there should be no reason to switch it
246// off.
247//
248// Recommended setting: 1
249#define wxUSE_LONGLONG 1
250
1e6feb95
VZ
251// Set wxUSE_(F)FILE to 1 to compile wx(F)File classes. wxFile uses low level
252// POSIX functions for file access, wxFFile uses ANSI C stdio.h functions.
253//
254// Default is 1
255//
256// Recommended setting: 1 (wxFile is highly recommended as it is required by
257// i18n code, wxFileConfig and others)
258#define wxUSE_FILE 1
259#define wxUSE_FFILE 1
260
261// use wxTextFile class: requires wxFile, required by wxFileConfig
262#define wxUSE_TEXTFILE 1
263
264// i18n support: _() macro, wxLocale class. Requires wxTextFile.
265#define wxUSE_INTL 1
266
e421922f 267// Set wxUSE_DATETIME to 1 to compile the wxDateTime and related classes which
40973ea5
VZ
268// allow to manipulate dates, times and time intervals. wxDateTime replaces the
269// old wxTime and wxDate classes which are still provided for backwards
270// compatibility (and implemented in terms of wxDateTime).
271//
272// Note that this class is relatively new and is still officially in alpha
273// stage because some features are not yet (fully) implemented. It is already
274// quite useful though and should only be disabled if you are aiming at
275// absolutely minimal version of the library.
276//
277// Requires: wxUSE_LONGLONG
278//
e421922f
VZ
279// Default is 1
280//
40973ea5 281// Recommended setting: 1
e421922f
VZ
282#define wxUSE_DATETIME 1
283
284// wxUSE_TIMEDATE enables compilation of the old wxDate and wxTime classes (not
285// the same as wxDateTime!). These classes are obsolete and shouldn't be used
286// in new code
287//
288// Default is 0
289//
290// Recommended setting: 0 unless you have legacy code which uses these classes
291#define wxUSE_TIMEDATE 0
40973ea5 292
1e6feb95
VZ
293// Set wxUSE_TIMER to 1 to compile wxTimer class
294//
295// Default is 1
296//
297// Recommended setting: 1
298#define wxUSE_TIMER 1
299
300// Use wxStopWatch clas.
301//
302// Default is 1
303//
304// Recommended setting: 1 (needed by wxSocket)
305#define wxUSE_STOPWATCH 1
306
16193c2b
VZ
307// Setting wxUSE_CONFIG to 1 enables the use of wxConfig and related classes
308// which allow the application to store its settings in the persistent
309// storage. Setting this to 1 will also enable on-demand creation of the
310// global config object in wxApp.
311//
312// See also wxUSE_CONFIG_NATIVE below.
313//
314// Recommended setting: 1
1e6feb95 315#define wxUSE_CONFIG 1
16193c2b
VZ
316
317// If wxUSE_CONFIG is 1, you may choose to use either the native config
318// classes under Windows (using .INI files under Win16 and the registry under
319// Win32) or the portable text file format used by the config classes under
320// Unix.
321//
322// Default is 1 to use native classes. Note that you may still use
323// wxFileConfig even if you set this to 1 - just the config object created by
324// default for the applications needs will be a wxRegConfig or wxIniConfig and
325// not wxFileConfig.
326//
327// Recommended setting: 1
328#define wxUSE_CONFIG_NATIVE 1
329
bf84b0be
VZ
330// If wxUSE_DIALUP_MANAGER is 1, compile in wxDialUpManager class which allows
331// to connect/disconnect from the network and be notified whenever the dial-up
3ca6a5f0 332// network connection is established/terminated. Requires wxUSE_DYNLIB_CLASS.
bf84b0be
VZ
333//
334// Default is 1.
335//
336// Recommended setting: 1
106f0395 337#define wxUSE_DIALUP_MANAGER 1
bf84b0be 338
3ca6a5f0
BP
339// Compile in wxLibrary class for run-time DLL loading and function calling.
340// Required by wxUSE_DIALUP_MANAGER.
3b415ba4
VZ
341//
342// This setting is for Win32 only
343//
344// Default is 1.
345//
346// Recommended setting: 1
347#define wxUSE_DYNLIB_CLASS 1
348
349// Set to 1 to use socket classes
350#define wxUSE_SOCKETS 1
351
3ca6a5f0 352// Set to 1 to enable virtual file systems (required by wxHTML)
3b415ba4 353#define wxUSE_FILESYSTEM 1
3ca6a5f0
BP
354
355// Set to 1 to enable virtual ZIP filesystem (requires wxUSE_FILESYSTEM)
3b415ba4 356#define wxUSE_FS_ZIP 1
3ca6a5f0
BP
357
358// Set to 1 to enable virtual Internet filesystem (requires wxUSE_FILESYSTEM)
3b415ba4
VZ
359#define wxUSE_FS_INET 1
360
3ca6a5f0 361// Set to 1 to compile wxZipInput/OutputStream classes.
3b415ba4
VZ
362#define wxUSE_ZIPSTREAM 1
363
3ca6a5f0
BP
364// Set to 1 to compile wxZlibInput/OutputStream classes. Also required by
365// wxUSE_LIBPNG.
366#define wxUSE_ZLIB 1
367
3ca6a5f0
BP
368// If enabled, the code written by Apple will be used to write, in a portable
369// way, float on the disk. See extended.c for the license which is different
370// from wxWindows one.
371//
372// Default is 1.
373//
374// Recommended setting: 1 unless you don't like the license terms (unlikely)
3b415ba4 375#define wxUSE_APPLE_IEEE 1
3b415ba4 376
29104849
RD
377// Joystick support class
378#define wxUSE_JOYSTICK 1
379
1e6feb95
VZ
380// wxFontMapper class
381#define wxUSE_FONTMAP 1
b9e5acef 382
1e6feb95
VZ
383// wxMimeTypesManager class
384#define wxUSE_MIMETYPE 1
29104849 385
0cbff120
JS
386// wxSystemOptions class
387#define wxUSE_SYSTEM_OPTIONS 1
388
208750a5
VZ
389// Support for regular expression matching via wxRegEx class: enable this to
390// use POSIX regular expressions in your code. You need to compile regex
391// library from src/regex to use it under Windows.
392//
393// Default is 0
394//
395// Recommended setting: 1 if your compiler supports it, if it doesn't please
396// contribute us a makefile for src/regex for it
397#define wxUSE_REGEX 0
398
ea37d858
RD
399// wxWave class
400#define wxUSE_WAVE 1
401
bf84b0be 402// ----------------------------------------------------------------------------
1e6feb95 403// Individual GUI controls
bf84b0be
VZ
404// ----------------------------------------------------------------------------
405
1e6feb95
VZ
406// You must set wxUSE_CONTROLS to 1 if you are using any controls at all
407// (without it, wxControl class is not compiled)
408//
409// Default is 1
410//
411// Recommended setting: 1 (don't change except for very special programs)
412#define wxUSE_CONTROLS 1
413
414// wxPopupWindow class is not used currently by wxMSW
415//
416// Default is 0
417//
418// Recommended setting: 0
419#define wxUSE_POPUPWIN 0
420
421// Each of the settings below corresponds to one wxWindows control. They are
422// all switched on by default but may be disabled if you are sure that your
423// program (including any standard dialogs it can show!) doesn't need them and
424// if you desperately want to save some space. If you use any of these you must
425// set wxUSE_CONTROLS as well.
426//
427// Default is 1
428//
429// Recommended setting: 1
430#define wxUSE_BUTTON 1 // wxButton
431#define wxUSE_BMPBUTTON 1 // wxBitmapButton
432#define wxUSE_CALENDARCTRL 1 // wxCalendarCtrl
433#define wxUSE_CHECKBOX 1 // wxCheckBox
434#define wxUSE_CHECKLISTBOX 1 // wxCheckListBox (requires wxUSE_OWNER_DRAWN)
435#define wxUSE_CHOICE 1 // wxChoice
436#define wxUSE_COMBOBOX 1 // wxComboBox
437#define wxUSE_GAUGE 1 // wxGauge
438#define wxUSE_LISTBOX 1 // wxListBox
439#define wxUSE_LISTCTRL 1 // wxListCtrl
440#define wxUSE_RADIOBOX 1 // wxRadioBox
441#define wxUSE_RADIOBTN 1 // wxRadioButton
442#define wxUSE_SCROLLBAR 1 // wxScrollBar
443#define wxUSE_SLIDER 1 // wxSlider
444#define wxUSE_SPINBTN 1 // wxSpinButton
445#define wxUSE_SPINCTRL 1 // wxSpinCtrl
446#define wxUSE_STATBOX 1 // wxStaticBox
447#define wxUSE_STATLINE 1 // wxStaticLine
448#define wxUSE_STATTEXT 1 // wxStaticText
449#define wxUSE_STATBMP 1 // wxStaticBitmap
450#define wxUSE_TEXTCTRL 1 // wxTextCtrl
451#define wxUSE_TOGGLEBTN 1 // requires wxButton
452#define wxUSE_TREECTRL 1 // wxTreeCtrl
453
454// Use a status bar class? Depending on the value of wxUSE_NATIVE_STATUSBAR
455// below either wxStatusBar95 or a generic wxStatusBar will be used.
456//
457// Default is 1
458//
459// Recommended setting: 1
460#define wxUSE_STATUSBAR 1
461
462// Two status bar implementations are available under Win32: the generic one
463// or the wrapper around native control. For native look and feel the native
464// version should be used.
465//
466// Default is 1.
467//
468// Recommended setting: 1 (there is no advantage in using the generic one)
469#define wxUSE_NATIVE_STATUSBAR 1
470
bf84b0be
VZ
471// wxToolBar related settings: if wxUSE_TOOLBAR is 0, don't compile any toolbar
472// classes at all. Otherwise, use the native toolbar class unless
473// wxUSE_TOOLBAR_NATIVE is 0. Additionally, the generic toolbar class which
474// supports some features which might not be supported by the native wxToolBar
475// class may be compiled in if wxUSE_TOOLBAR_SIMPLE is 1.
476//
477// Default is 1 for all settings.
478//
479// Recommended setting: 1 for wxUSE_TOOLBAR and wxUSE_TOOLBAR_NATIVE and 0 for
480// wxUSE_TOOLBAR_SIMPLE (the default is 1 mainly for backwards compatibility).
481#define wxUSE_TOOLBAR 1
482#define wxUSE_TOOLBAR_NATIVE 1
483#define wxUSE_TOOLBAR_SIMPLE 1
484
1e6feb95
VZ
485// this setting is obsolete, value is ignored
486#define wxUSE_BUTTONBAR 1
487
b3402d0d
VZ
488// wxNotebook is a control with several "tabs" located on one of its sides. It
489// may be used ot logically organise the data presented to the user instead of
490// putting everything in one huge dialog. It replaces wxTabControl and related
491// classes of wxWin 1.6x.
492//
493// Default is 1.
494//
495// Recommended setting: 1
496#define wxUSE_NOTEBOOK 1
497
1e6feb95
VZ
498// wxTabDialog is a generic version of wxNotebook but it is incompatible with
499// the new class. It shouldn't be used in new code.
3b415ba4 500//
1e6feb95 501// Default is 0.
3b415ba4 502//
1e6feb95
VZ
503// Recommended setting: 0 (use wxNotebook)
504#define wxUSE_TAB_DIALOG 0
ff2d113e
VZ
505
506// wxGrid class comes in two flavours: the original (pre wxWin 2.2) one and
507// the new, much imporved and enhanced version. The new version is backwards
508// compatible with the old one and should be used whenever possible, i.e. if
509// you set wxUSE_GRID to 1, set wxUSE_NEW_GRID to 1 too.
510//
511// Default is 1 for both options.
512//
513// Recommended setting: 1 for wxUSE_NEW_GRID, 0 if you have an old code using
3ca6a5f0 514// wxGrid and 100% backwards compatibality (with all old wxGrid quirks) is
ff2d113e 515// essential.
9c824f29
JS
516//
517// WIN16/BC++ resets wxUSE_NEW_GRID to 0 because it exceeds the data limit.
ff2d113e
VZ
518#define wxUSE_GRID 1
519#define wxUSE_NEW_GRID 1
b3402d0d 520
1e6feb95
VZ
521// ----------------------------------------------------------------------------
522// Miscellaneous GUI stuff
523// ----------------------------------------------------------------------------
3b415ba4
VZ
524
525// wxAcceleratorTable/Entry classes and support for them in wxMenu(Bar)
526#define wxUSE_ACCEL 1
527
1e6feb95
VZ
528// Use wxCaret: a class implementing a "cursor" in a text control (called caret
529// under Windows).
530//
531// Default is 1.
532//
533// Recommended setting: 1 (can be safely set to 0, not used by the library)
534#define wxUSE_CARET 1
535
536// Miscellaneous geometry code: needed for Canvas library
537#define wxUSE_GEOMETRY 1
538
539// Use wxImageList. This class is needed by wxNotebook, wxTreeCtrl and
540// wxListCtrl.
541//
542// Default is 1.
543//
544// Recommended setting: 1 (set it to 0 if you don't use any of the controls
545// enumerated above, then this class is mostly useless too)
546#define wxUSE_IMAGLIST 1
547
548// Use wxMenu, wxMenuBar, wxMenuItem.
549//
550// Default is 1.
551//
552// Recommended setting: 1 (can't be disabled under MSW)
553#define wxUSE_MENUS 1
554
555// Use wxSashWindow class.
556//
557// Default is 1.
558//
559// Recommended setting: 1
560#define wxUSE_SASH 1
561
562// Use wxSplitterWindow class.
563//
564// Default is 1.
565//
566// Recommended setting: 1
567#define wxUSE_SPLITTER 1
568
569// Use wxToolTip and wxWindow::Set/GetToolTip() methods.
570//
571// Default is 1.
572//
573// Recommended setting: 1
574#define wxUSE_TOOLTIPS 1
575
576// wxValidator class and related methods
577#define wxUSE_VALIDATORS 1
578
0cbff120
JS
579// wxDC cacheing implementation
580#define wxUSE_DC_CACHEING 1
581
3b415ba4
VZ
582// ----------------------------------------------------------------------------
583// common dialogs
584// ----------------------------------------------------------------------------
585
586// Define 1 to use generic dialogs in Windows, even though they duplicate
587// native common dialog (e.g. wxColourDialog). This is mainly useful for
588// testing.
589//
590// Default is 0
591//
592// Recommended setting: 0
593#define wxUSE_GENERIC_DIALOGS_IN_MSW 0
594
595// On rare occasions (e.g. using DJGPP) may want to omit common dialogs (e.g.
596// file selector, printer dialog). Switching this off also switches off the
597// printing architecture and interactive wxPrinterDC.
598//
599// Default is 1
600//
601// Recommended setting: 1 (unless it really doesn't work)
602#define wxUSE_COMMON_DIALOGS 1
603
e421922f
VZ
604// wxBusyInfo displays window with message when app is busy. Works in same way
605// as wxBusyCursor
606#define wxUSE_BUSYINFO 1
607
608// Use single/multiple choice dialogs.
609//
610// Default is 1
611//
612// Recommended setting: 1 (used in the library itself)
613#define wxUSE_CHOICEDLG 1
614
a2c0a9c5
VZ
615// Use colour picker dialog
616//
617// Default is 1
618//
619// Recommended setting: 1
620#define wxUSE_COLOURDLG 1
621
e421922f
VZ
622// wxDirDlg class for getting a directory name from user
623#define wxUSE_DIRDLG 1
624
625// TODO: setting to choose the generic or native one
626
1e6feb95
VZ
627// Use file open/save dialogs.
628//
629// Default is 1
630//
631// Recommended setting: 1 (used in many places in the library itself)
632#define wxUSE_FILEDLG 1
633
baff4ae2
VZ
634// Use find/replace dialogs.
635//
636// Default is 1
637//
638// Recommended setting: 1 (but may be safely set to 0)
639#define wxUSE_FINDREPLDLG 1
640
1e6feb95
VZ
641// Use font picker dialog
642//
643// Default is 1
644//
645// Recommended setting: 1 (used in the library itself)
646#define wxUSE_FONTDLG 1
647
e421922f 648// Use wxMessageDialog and wxMessageBox.
1e6feb95
VZ
649//
650// Default is 1
651//
652// Recommended setting: 1 (used in the library itself)
e421922f 653#define wxUSE_MSGDLG 1
3b415ba4
VZ
654
655// progress dialog class for lengthy operations
656#define wxUSE_PROGRESSDLG 1
657
3b415ba4
VZ
658// support for startup tips (wxShowTip &c)
659#define wxUSE_STARTUP_TIPS 1
660
e421922f
VZ
661// text entry dialog and wxGetTextFromUser function
662#define wxUSE_TEXTDLG 1
663
ff8b6290
JS
664// number entry dialog
665#define wxUSE_NUMBERDLG 1
666
47606d36
VZ
667// splash screen class
668#define wxUSE_SPLASH 1
669
b1f5d087
VZ
670// wizards
671#define wxUSE_WIZARDDLG 1
672
d9317fd4
VZ
673// ----------------------------------------------------------------------------
674// Metafiles support
675// ----------------------------------------------------------------------------
676
677// Windows supports the graphics format known as metafile which is, though not
678// portable, is widely used under Windows and so is supported by wxWin (under
679// Windows only, of course). Win16 (Win3.1) used the so-called "Window
680// MetaFiles" or WMFs which were replaced with "Enhanced MetaFiles" or EMFs in
681// Win32 (Win9x, NT, 2000). Both of these are supported in wxWin and, by
682// default, WMFs will be used under Win16 and EMFs under Win32. This may be
683// changed by setting wxUSE_WIN_METAFILES_ALWAYS to 1 and/or setting
684// wxUSE_ENH_METAFILE to 0. You may also set wxUSE_METAFILE to 0 to not compile
685// in any metafile related classes at all.
686//
687// Default is 1 for wxUSE_ENH_METAFILE and 0 for wxUSE_WIN_METAFILES_ALWAYS.
688//
689// Recommended setting: default or 0 for everything for portable programs.
690#define wxUSE_METAFILE 1
691#define wxUSE_ENH_METAFILE 1
692#define wxUSE_WIN_METAFILES_ALWAYS 0
693
ff2d113e
VZ
694// ----------------------------------------------------------------------------
695// Big GUI components
696// ----------------------------------------------------------------------------
697
3b415ba4
VZ
698// Set to 0 to disable document/view architecture
699#define wxUSE_DOC_VIEW_ARCHITECTURE 1
700
701// Set to 0 to disable MDI document/view architecture
702#define wxUSE_MDI_ARCHITECTURE 1
703
704// Set to 0 to disable print/preview architecture code
705#define wxUSE_PRINTING_ARCHITECTURE 1
706
ff2d113e
VZ
707// wxHTML sublibrary allows to display HTML in wxWindow programs and much,
708// much more.
709//
710// Default is 1.
711//
712// Recommended setting: 1 (wxHTML is great!), set to 0 if you want compile a
713// smaller library.
714#define wxUSE_HTML 1
715
8b089c5e
JS
716// OpenGL canvas
717#define wxUSE_GLCANVAS 0
718
babc9758
JS
719// wxTreeLayout class
720#define wxUSE_TREELAYOUT 1
721
1e6feb95
VZ
722// ----------------------------------------------------------------------------
723// Data transfer
724// ----------------------------------------------------------------------------
725
726// Use wxClipboard class for clipboard copy/paste.
727//
728// Default is 1.
729//
730// Recommended setting: 1
731#define wxUSE_CLIPBOARD 1
732
733// Use wxDataObject and related classes. Needed for clipboard and OLE drag and
734// drop
735//
736// Default is 1.
737//
738// Recommended setting: 1
739#define wxUSE_DATAOBJ 1
740
741// Use wxDropTarget and wxDropSource classes for drag and drop (this is
742// different from "built in" drag and drop in wxTreeCtrl which is always
743// available). Requires wxUSE_DATAOBJ.
744//
745// Default is 1.
746//
747// Recommended setting: 1
748#define wxUSE_DRAG_AND_DROP 1
749
bf84b0be 750// ----------------------------------------------------------------------------
3b415ba4 751// miscellaneous settings
bf84b0be
VZ
752// ----------------------------------------------------------------------------
753
68a602fc
VZ
754// wxSingleInstanceChecker class allows to verify at startup if another program
755// instance is running (it is only available under Win32)
756//
757// Default is 1
758//
759// Recommended setting: 1 (the class is tiny, disabling it won't save much
760// space)
761#define wxUSE_SNGLINST_CHECKER 1
762
24fd6d87
VZ
763#define wxUSE_DRAGIMAGE 1
764
9bd6a503
VZ
765#define wxUSE_IPC 1
766 // 0 for no interprocess comms
9bd6a503
VZ
767#define wxUSE_HELP 1
768 // 0 for no help facility
f6bcfd97
BP
769#define wxUSE_MS_HTML_HELP 0
770 // 0 for no MS HTML Help
3379ed37
VZ
771
772// Use wxHTML-based help controller?
773#define wxUSE_WXHTML_HELP 1
774
9bd6a503
VZ
775#define wxUSE_RESOURCES 1
776 // 0 for no wxGetResource/wxWriteResource
777#define wxUSE_CONSTRAINTS 1
778 // 0 for no window layout constraint system
779
9bd6a503 780#define wxUSE_SPLINES 1
83b1bfaa 781 // 0 for no splines
9bd6a503 782
1e6feb95
VZ
783#define wxUSE_XPM_IN_MSW 1
784 // 0 for no XPM support in wxBitmap.
785 // Default is 1, as XPM is now fully
786 // supported this makes easier the issue
787 // of portable icons and bitmaps.
9bd6a503 788
9bd6a503 789#define wxUSE_IMAGE_LOADING_IN_MSW 1
83b1bfaa 790 // Use dynamic DIB loading/saving code in utils/dib under MSW.
9bd6a503 791#define wxUSE_RESOURCE_LOADING_IN_MSW 1
83b1bfaa
GRG
792 // Use dynamic icon/cursor loading/saving code
793 // under MSW.
9bd6a503 794#define wxUSE_WX_RESOURCES 1
83b1bfaa 795 // Use .wxr resource mechanism (requires PrologIO library)
9bd6a503 796
d2c52078
RD
797#define wxUSE_MOUSEWHEEL 1
798 // Include mouse wheel support
799
3b415ba4 800// ----------------------------------------------------------------------------
3ca6a5f0 801// postscript support settings
3b415ba4
VZ
802// ----------------------------------------------------------------------------
803
3ca6a5f0 804// Set to 1 for PostScript device context.
3b415ba4 805#define wxUSE_POSTSCRIPT 0
3ca6a5f0
BP
806
807// Set to 1 to use font metric files in GetTextExtent
3b415ba4 808#define wxUSE_AFM_FOR_POSTSCRIPT 0
9bd6a503 809
3ca6a5f0
BP
810// Set to 0 to disable PostScript print/preview architecture code under Windows
811// (just use Windows printing).
9bd6a503 812#define wxUSE_POSTSCRIPT_ARCHITECTURE_IN_MSW 1
3b415ba4
VZ
813
814// ----------------------------------------------------------------------------
815// database classes
816// ----------------------------------------------------------------------------
9bd6a503 817
3ca6a5f0 818// Define 1 to use ODBC classes
83b1bfaa 819#define wxUSE_ODBC 0
9bd6a503 820
3ca6a5f0
BP
821// For backward compatibility reasons, this parameter now only controls the
822// default scrolling method used by cursors. This default behavior can be
d2c52078 823// overriden by setting the second param of wxDB::wxDbGetConnection() or
3ca6a5f0 824// wxDb() constructor to indicate whether the connection (and any wxDbTable()s
d2c52078
RD
825// that use the connection) should support forward only scrolling of cursors,
826// or both forward and backward support for backward scrolling cursors is
3ca6a5f0 827// dependent on the data source as well as the ODBC driver being used.
aeb040bf 828#define wxODBC_FWD_ONLY_CURSORS 1
9695185a 829
3ca6a5f0
BP
830// Default is 0. Set to 1 to use the deprecated classes, enum types, function,
831// member variables. With a setting of 1, full backward compatability with the
832// 2.0.x release is possible. It is STRONGLY recommended that this be set to 0,
833// as future development will be done only on the non-deprecated
834// functions/classes/member variables/etc.
f6bcfd97 835#define wxODBC_BACKWARD_COMPATABILITY 0
f6bcfd97 836
3b415ba4
VZ
837// ----------------------------------------------------------------------------
838// other compiler (mis)features
839// ----------------------------------------------------------------------------
840
841// Set this to 0 if your compiler can't cope with omission of prototype
842// parameters.
843//
844// Default is 1.
845//
846// Recommended setting: 1 (should never need to set this to 0)
847#define REMOVE_UNUSED_ARG 1
848
849// VC++ 4.2 and above allows <iostream> and <iostream.h> but you can't mix
850// them. Set to 1 for <iostream.h>, 0 for <iostream>
851//
852// Default is 1.
853//
854// Recommended setting: whatever your compiler likes more
dbda9e86 855#define wxUSE_IOSTREAMH 1
d4ec5d32 856
3b415ba4
VZ
857// ----------------------------------------------------------------------------
858// image format support
859// ----------------------------------------------------------------------------
860
3ca6a5f0
BP
861// wxImage supports many different image formats which can be configured at
862// compile-time. BMP is always supported, others are optional and can be safely
863// disabled if you don't plan to use images in such format sometimes saving
864// substantial amount of code in the final library.
865//
866// Some formats require an extra library which is included in wxWin sources
867// which is mentioned if it is the case.
868
0046ff7c
VS
869// Set to 1 for wxImage support (recommended).
870#define wxUSE_IMAGE 1
871
3ca6a5f0 872// Set to 1 for PNG format support (requires libpng). Also requires wxUSE_ZLIB.
9bd6a503 873#define wxUSE_LIBPNG 1
3ca6a5f0
BP
874
875// Set to 1 for JPEG format support (requires libjpeg)
83b1bfaa 876#define wxUSE_LIBJPEG 1
3ca6a5f0
BP
877
878// Set to 1 for TIFF format support (requires libtiff)
1ea67089 879#define wxUSE_LIBTIFF 1
3ca6a5f0
BP
880
881// Set to 1 for GIF format support
83b1bfaa 882#define wxUSE_GIF 1
3ca6a5f0
BP
883
884// Set to 1 for PNM format support
1044a386 885#define wxUSE_PNM 1
3ca6a5f0
BP
886
887// Set to 1 for PCX format support
1044a386 888#define wxUSE_PCX 1
9bd6a503 889
0046ff7c
VS
890// Set to 1 for XPM format support
891#define wxUSE_XPM 1
892
3b415ba4
VZ
893// ----------------------------------------------------------------------------
894// Windows-only settings
895// ----------------------------------------------------------------------------
1318fabe 896
3ca6a5f0
BP
897// Set this to 1 if you want to use wxWindows and MFC in the same program. This
898// will override some other settings (see below)
899//
900// Default is 0.
901//
902// Recommended setting: 0 unless you really have to use MFC
3f8e5072
JS
903#define wxUSE_MFC 0
904
3ca6a5f0
BP
905// Set this to 1 for generic OLE support: this is required for drag-and-drop,
906// clipboard, OLE Automation. Only set it to 0 if your compiler is very old and
907// can't compile/doesn't have the OLE headers.
908//
909// Default is 1.
910//
911// Recommended setting: 1
3aa0e8fa 912#define wxUSE_OLE 1
3aa0e8fa 913
3ca6a5f0
BP
914// Set this to 1 to use Microsoft CTL3D library for "3D-look" under Win16 or NT
915// 3.x. This setting is ignored under Win9x and NT 4.0+.
916//
917// Default is 0 for (most) Win32 (systems), 1 for Win16
918//
919// Recommended setting: same as default
9bd6a503 920#if defined(__WIN95__)
1f112209 921#define wxUSE_CTL3D 0
9bd6a503 922#else
1f112209 923#define wxUSE_CTL3D 1
9bd6a503
VZ
924#endif
925
3ca6a5f0
BP
926// Define as 1 to use Microsoft's ItsyBitsy small title bar library, for
927// wxMiniFrame. This setting is only used for Win3.1; Win9x and NT use native
928// miniframes support instead.
929//
930// Default is 0 for (most) Win32 (systems), 1 for Win16
931//
932// Recommended setting: same as default
933#if defined(__WIN95__)
934#define wxUSE_ITSY_BITSY 0
935#else
936#define wxUSE_ITSY_BITSY 1
937#endif
938
939// Set this to 1 to use RICHEDIT controls for wxTextCtrl with style wxTE_RICH
940// which allows to put more than ~32Kb of text in it even under Win9x (NT
941// doesn't have such limitation).
942//
943// Default is 1 for compilers which support it
944//
945// Recommended setting: 1, only set it to 0 if your compiler doesn't have
946// or can't compile <richedit.h>
6d167489 947#if defined(__WIN95__) && !defined(__TWIN32__) && !defined(__GNUWIN32_OLD__)
be329a3d
RD
948#define wxUSE_RICHEDIT 1
949
950// TODO: This should be ifdef'ed for any compilers that don't support
951// RichEdit 2.0 but do have RichEdit 1.0...
952#define wxUSE_RICHEDIT2 1
953
6d167489 954#else
be329a3d
RD
955#define wxUSE_RICHEDIT 0
956#define wxUSE_RICHEDIT2 0
6d167489
VZ
957#endif
958
3ca6a5f0
BP
959// Set this to 1 to enable support for the owner-drawn menu and listboxes. This
960// is required by wxUSE_CHECKLISTBOX.
961//
962// Default is 1.
963//
964// Recommended setting: 1, set to 0 for a small library size reduction
965#define wxUSE_OWNER_DRAWN 1
966
967// ----------------------------------------------------------------------------
968// obsolete settings
969// ----------------------------------------------------------------------------
970
971// NB: all settings in this section are obsolete and should not be used/changed
972// at all, they will disappear
973
974// Set to 1 to use PenWindows
7fee680b 975#define wxUSE_PENWINDOWS 0
9bd6a503 976
3ca6a5f0
BP
977// Define 1 to use bitmap messages.
978#define wxUSE_BITMAP_MESSAGE 1
979
980// If 1, enables provision of run-time type information.
981// NOW MANDATORY: don't change.
982#define wxUSE_DYNAMIC_CLASSES 1
983
984// ----------------------------------------------------------------------------
985// disable the settings which don't work for some compilers
986// ----------------------------------------------------------------------------
9bd6a503 987
1a7f3062 988#ifndef wxUSE_NORLANDER_HEADERS
b64f0a5f 989#if (defined(__MINGW32__) || defined(__CYGWIN__)) && ((__GNUC__>2) ||((__GNUC__==2) && (__GNUC_MINOR__>=95)))
1a7f3062 990# define wxUSE_NORLANDER_HEADERS 1
b64f0a5f
RL
991#else
992# define wxUSE_NORLANDER_HEADERS 0
1a7f3062
JS
993#endif
994#endif
995
1ea67089 996#if defined(__GNUWIN32__)
f6bcfd97 997// These don't work as expected for mingw32 and cygwin32
1ea67089
GRG
998#undef wxUSE_MEMORY_TRACING
999#define wxUSE_MEMORY_TRACING 0
1000
1001#undef wxUSE_GLOBAL_MEMORY_OPERATORS
1002#define wxUSE_GLOBAL_MEMORY_OPERATORS 0
1003
1004#undef wxUSE_DEBUG_NEW_ALWAYS
1005#define wxUSE_DEBUG_NEW_ALWAYS 0
f6bcfd97 1006
74afbadc
JS
1007// Cygwin betas don't have wcslen
1008#if defined(__CYGWIN__) || defined(__CYGWIN32__)
1009# if ! ((__GNUC__>2) ||((__GNUC__==2) && (__GNUC_MINOR__>=95)))
1010# undef wxUSE_WCHAR_T
1011# define wxUSE_WCHAR_T 0
1012# endif
f6bcfd97
BP
1013#endif
1014
74afbadc
JS
1015#endif // __GNUWIN32__
1016
3f8e5072
JS
1017// MFC duplicates these operators
1018#if wxUSE_MFC
1019#undef wxUSE_GLOBAL_MEMORY_OPERATORS
1020#define wxUSE_GLOBAL_MEMORY_OPERATORS 0
1021
1022#undef wxUSE_DEBUG_NEW_ALWAYS
1023#define wxUSE_DEBUG_NEW_ALWAYS 0
3b415ba4 1024#endif // wxUSE_MFC
3f8e5072 1025
f6bcfd97
BP
1026// ODBC classes aren't Unicode-compatible yet
1027#if wxUSE_UNICODE
1028#undef wxUSE_ODBC
1029#define wxUSE_ODBC 0
1030#endif
1031
e06b9569 1032#if (!defined(WIN32) && !defined(__WIN32__)) || (defined(__GNUWIN32__) && !wxUSE_NORLANDER_HEADERS)
9bd6a503
VZ
1033// Can't use OLE drag and drop in Windows 3.1 because we don't know how
1034// to implement UUIDs
1035// GnuWin32 doesn't have appropriate headers for e.g. IUnknown.
1036#undef wxUSE_DRAG_AND_DROP
1037#define wxUSE_DRAG_AND_DROP 0
1038#endif
1039
1040// Only WIN32 supports wxStatusBar95
1041#if !defined(__WIN32__) && wxUSE_NATIVE_STATUSBAR
1042#undef wxUSE_NATIVE_STATUSBAR
1043#define wxUSE_NATIVE_STATUSBAR 0
1044#endif
1045
f6bcfd97
BP
1046#if !wxUSE_OWNER_DRAWN
1047#undef wxUSE_CHECKLISTBOX
1048#define wxUSE_CHECKLISTBOX 0
1049#endif
1050
9bd6a503
VZ
1051// Salford C++ doesn't like some of the memory operator definitions
1052#ifdef __SALFORDC__
1053#undef wxUSE_MEMORY_TRACING
1054#define wxUSE_MEMORY_TRACING 0
1055
1056#undef wxUSE_GLOBAL_MEMORY_OPERATORS
1057#define wxUSE_GLOBAL_MEMORY_OPERATORS 0
1058
1059#undef wxUSE_DEBUG_NEW_ALWAYS
1060#define wxUSE_DEBUG_NEW_ALWAYS 0
1061
1062#undef wxUSE_THREADS
1063#define wxUSE_THREADS 0
1064
9bd6a503
VZ
1065#undef wxUSE_OWNER_DRAWN
1066#define wxUSE_OWNER_DRAWN 0
f6bcfd97 1067#endif // __SALFORDC__
9bd6a503
VZ
1068
1069#ifdef __TWIN32__
1070
1071#undef wxUSE_THREADS
1072#define wxUSE_THREADS 0
1073
9bd6a503
VZ
1074#undef wxUSE_ODBC
1075#define wxUSE_ODBC 0
1076
f6bcfd97 1077#endif // __TWIN32__
9bd6a503 1078
448af9a4
JS
1079// BC++/Win16 can't cope with the amount of data in resource.cpp
1080#if defined(__WIN16__) && defined(__BORLANDC__)
1081#undef wxUSE_WX_RESOURCES
1082#define wxUSE_WX_RESOURCES 0
154f22b3
JS
1083
1084#undef wxUSE_ODBC
1085#define wxUSE_ODBC 0
9c824f29
JS
1086
1087#undef wxUSE_NEW_GRID
1088#define wxUSE_NEW_GRID 0
448af9a4
JS
1089#endif
1090
b2cf617c
JS
1091#if defined(__BORLANDC__) && (__BORLANDC__ < 0x500)
1092// BC++ 4.0 can't compile JPEG library
1093#undef wxUSE_LIBJPEG
1094#define wxUSE_LIBJPEG 0
1095#endif
1096
3ca6a5f0 1097// wxUSE_DEBUG_NEW_ALWAYS = 1 not compatible with BC++ in DLL mode
f6bcfd97
BP
1098#if defined(__BORLANDC__) && (defined(WXMAKINGDLL) || defined(WXUSINGDLL))
1099#undef wxUSE_DEBUG_NEW_ALWAYS
1100#define wxUSE_DEBUG_NEW_ALWAYS 0
1101#endif
b2cf617c 1102
f6bcfd97
BP
1103#if defined(__WXMSW__) && defined(__WATCOMC__)
1104/*
b2cf617c
JS
1105#undef wxUSE_GLCANVAS
1106#define wxUSE_GLCANVAS 0
f6bcfd97
BP
1107*/
1108
f6bcfd97
BP
1109#undef wxUSE_WCHAR_T
1110#define wxUSE_WCHAR_T 0
0cdf89ab
JS
1111#endif
1112
9bd6a503
VZ
1113#if defined(__WXMSW__) && !defined(__WIN32__)
1114
8fb3a512
JS
1115#undef wxUSE_SOCKETS
1116#define wxUSE_SOCKETS 0
1117
9bd6a503
VZ
1118#undef wxUSE_THREADS
1119#define wxUSE_THREADS 0
1120
750b78ba
JS
1121#undef wxUSE_TOOLTIPS
1122#define wxUSE_TOOLTIPS 0
1123
0e528b99
JS
1124#undef wxUSE_SPINCTRL
1125#define wxUSE_SPINCTRL 0
1126
1127#undef wxUSE_SPINBTN
1128#define wxUSE_SPINBTN 0
1129
1044a386
JS
1130#undef wxUSE_LIBPNG
1131#define wxUSE_LIBPNG 0
1132
1133#undef wxUSE_LIBJPEG
1134#define wxUSE_LIBJPEG 0
1135
669f7a11
JS
1136#undef wxUSE_LIBTIFF
1137#define wxUSE_LIBTIFF 0
1138
83b1bfaa
GRG
1139#undef wxUSE_GIF
1140#define wxUSE_GIF 0
1044a386
JS
1141
1142#undef wxUSE_PNM
1143#define wxUSE_PNM 0
1144
1145#undef wxUSE_PCX
1146#define wxUSE_PCX 0
1147
b2cf617c
JS
1148#undef wxUSE_GLCANVAS
1149#define wxUSE_GLCANVAS 0
1150
f6bcfd97
BP
1151#undef wxUSE_MS_HTML_HELP
1152#define wxUSE_MS_HTML_HELP 0
1153
1154#undef wxUSE_WCHAR_T
1155#define wxUSE_WCHAR_T 0
1156
1157#endif // Win16
1158
3ca6a5f0
BP
1159// ----------------------------------------------------------------------------
1160// undef the things which don't make sense for wxBase build
1161// ----------------------------------------------------------------------------
1162
1163#if !wxUSE_GUI
1164
1165#undef wxUSE_HTML
1166#define wxUSE_HTML 0
1167
1168#endif // !wxUSE_GUI
1169
f6bcfd97
BP
1170// ----------------------------------------------------------------------------
1171// check the settings consistency: do it here to abort compilation immediately
1172// and not almost in the very end when the relevant file fails to compile and
1173// you need to modify setup.h and rebuild everything
1174// ----------------------------------------------------------------------------
1175
e421922f 1176#if wxUSE_DATETIME && !wxUSE_LONGLONG
f6bcfd97 1177 #error wxDateTime requires wxLongLong
9bd6a503
VZ
1178#endif
1179
f6bcfd97
BP
1180#if wxUSE_TEXTFILE && !wxUSE_FILE
1181 #error You cannot compile wxTextFile without wxFile
1182#endif
1183
1184#if wxUSE_FILESYSTEM && !wxUSE_STREAMS
1185 #error You cannot compile virtual file systems without wxUSE_STREAMS
1186#endif
1187
1188#if wxUSE_HTML && !wxUSE_FILESYSTEM
1189 #error You cannot compile wxHTML without virtual file systems
1190#endif
1191
1192// add more tests here...
1193
9bd6a503
VZ
1194#endif
1195 // _WX_SETUP_H_