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