]> git.saurik.com Git - wxWidgets.git/blame - include/wx/msw/setup0.h
don't process VK_OEM_XXX key presses
[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
634// Use font picker dialog
635//
636// Default is 1
637//
638// Recommended setting: 1 (used in the library itself)
639#define wxUSE_FONTDLG 1
640
e421922f 641// Use wxMessageDialog and wxMessageBox.
1e6feb95
VZ
642//
643// Default is 1
644//
645// Recommended setting: 1 (used in the library itself)
e421922f 646#define wxUSE_MSGDLG 1
3b415ba4
VZ
647
648// progress dialog class for lengthy operations
649#define wxUSE_PROGRESSDLG 1
650
3b415ba4
VZ
651// support for startup tips (wxShowTip &c)
652#define wxUSE_STARTUP_TIPS 1
653
e421922f
VZ
654// text entry dialog and wxGetTextFromUser function
655#define wxUSE_TEXTDLG 1
656
ff8b6290
JS
657// number entry dialog
658#define wxUSE_NUMBERDLG 1
659
b1f5d087
VZ
660// wizards
661#define wxUSE_WIZARDDLG 1
662
d9317fd4
VZ
663// ----------------------------------------------------------------------------
664// Metafiles support
665// ----------------------------------------------------------------------------
666
667// Windows supports the graphics format known as metafile which is, though not
668// portable, is widely used under Windows and so is supported by wxWin (under
669// Windows only, of course). Win16 (Win3.1) used the so-called "Window
670// MetaFiles" or WMFs which were replaced with "Enhanced MetaFiles" or EMFs in
671// Win32 (Win9x, NT, 2000). Both of these are supported in wxWin and, by
672// default, WMFs will be used under Win16 and EMFs under Win32. This may be
673// changed by setting wxUSE_WIN_METAFILES_ALWAYS to 1 and/or setting
674// wxUSE_ENH_METAFILE to 0. You may also set wxUSE_METAFILE to 0 to not compile
675// in any metafile related classes at all.
676//
677// Default is 1 for wxUSE_ENH_METAFILE and 0 for wxUSE_WIN_METAFILES_ALWAYS.
678//
679// Recommended setting: default or 0 for everything for portable programs.
680#define wxUSE_METAFILE 1
681#define wxUSE_ENH_METAFILE 1
682#define wxUSE_WIN_METAFILES_ALWAYS 0
683
ff2d113e
VZ
684// ----------------------------------------------------------------------------
685// Big GUI components
686// ----------------------------------------------------------------------------
687
3b415ba4
VZ
688// Set to 0 to disable document/view architecture
689#define wxUSE_DOC_VIEW_ARCHITECTURE 1
690
691// Set to 0 to disable MDI document/view architecture
692#define wxUSE_MDI_ARCHITECTURE 1
693
694// Set to 0 to disable print/preview architecture code
695#define wxUSE_PRINTING_ARCHITECTURE 1
696
ff2d113e
VZ
697// wxHTML sublibrary allows to display HTML in wxWindow programs and much,
698// much more.
699//
700// Default is 1.
701//
702// Recommended setting: 1 (wxHTML is great!), set to 0 if you want compile a
703// smaller library.
704#define wxUSE_HTML 1
705
8b089c5e
JS
706// OpenGL canvas
707#define wxUSE_GLCANVAS 0
708
babc9758
JS
709// wxTreeLayout class
710#define wxUSE_TREELAYOUT 1
711
1e6feb95
VZ
712// ----------------------------------------------------------------------------
713// Data transfer
714// ----------------------------------------------------------------------------
715
716// Use wxClipboard class for clipboard copy/paste.
717//
718// Default is 1.
719//
720// Recommended setting: 1
721#define wxUSE_CLIPBOARD 1
722
723// Use wxDataObject and related classes. Needed for clipboard and OLE drag and
724// drop
725//
726// Default is 1.
727//
728// Recommended setting: 1
729#define wxUSE_DATAOBJ 1
730
731// Use wxDropTarget and wxDropSource classes for drag and drop (this is
732// different from "built in" drag and drop in wxTreeCtrl which is always
733// available). Requires wxUSE_DATAOBJ.
734//
735// Default is 1.
736//
737// Recommended setting: 1
738#define wxUSE_DRAG_AND_DROP 1
739
bf84b0be 740// ----------------------------------------------------------------------------
3b415ba4 741// miscellaneous settings
bf84b0be
VZ
742// ----------------------------------------------------------------------------
743
68a602fc
VZ
744// wxSingleInstanceChecker class allows to verify at startup if another program
745// instance is running (it is only available under Win32)
746//
747// Default is 1
748//
749// Recommended setting: 1 (the class is tiny, disabling it won't save much
750// space)
751#define wxUSE_SNGLINST_CHECKER 1
752
24fd6d87
VZ
753#define wxUSE_DRAGIMAGE 1
754
9bd6a503
VZ
755#define wxUSE_IPC 1
756 // 0 for no interprocess comms
9bd6a503
VZ
757#define wxUSE_HELP 1
758 // 0 for no help facility
f6bcfd97
BP
759#define wxUSE_MS_HTML_HELP 0
760 // 0 for no MS HTML Help
3379ed37
VZ
761
762// Use wxHTML-based help controller?
763#define wxUSE_WXHTML_HELP 1
764
9bd6a503
VZ
765#define wxUSE_RESOURCES 1
766 // 0 for no wxGetResource/wxWriteResource
767#define wxUSE_CONSTRAINTS 1
768 // 0 for no window layout constraint system
769
9bd6a503 770#define wxUSE_SPLINES 1
83b1bfaa 771 // 0 for no splines
9bd6a503 772
1e6feb95
VZ
773#define wxUSE_XPM_IN_MSW 1
774 // 0 for no XPM support in wxBitmap.
775 // Default is 1, as XPM is now fully
776 // supported this makes easier the issue
777 // of portable icons and bitmaps.
9bd6a503 778
9bd6a503 779#define wxUSE_IMAGE_LOADING_IN_MSW 1
83b1bfaa 780 // Use dynamic DIB loading/saving code in utils/dib under MSW.
9bd6a503 781#define wxUSE_RESOURCE_LOADING_IN_MSW 1
83b1bfaa
GRG
782 // Use dynamic icon/cursor loading/saving code
783 // under MSW.
9bd6a503 784#define wxUSE_WX_RESOURCES 1
83b1bfaa 785 // Use .wxr resource mechanism (requires PrologIO library)
9bd6a503 786
d2c52078
RD
787#define wxUSE_MOUSEWHEEL 1
788 // Include mouse wheel support
789
3b415ba4 790// ----------------------------------------------------------------------------
3ca6a5f0 791// postscript support settings
3b415ba4
VZ
792// ----------------------------------------------------------------------------
793
3ca6a5f0 794// Set to 1 for PostScript device context.
3b415ba4 795#define wxUSE_POSTSCRIPT 0
3ca6a5f0
BP
796
797// Set to 1 to use font metric files in GetTextExtent
3b415ba4 798#define wxUSE_AFM_FOR_POSTSCRIPT 0
9bd6a503 799
3ca6a5f0
BP
800// Set to 0 to disable PostScript print/preview architecture code under Windows
801// (just use Windows printing).
9bd6a503 802#define wxUSE_POSTSCRIPT_ARCHITECTURE_IN_MSW 1
3b415ba4
VZ
803
804// ----------------------------------------------------------------------------
805// database classes
806// ----------------------------------------------------------------------------
9bd6a503 807
3ca6a5f0 808// Define 1 to use ODBC classes
83b1bfaa 809#define wxUSE_ODBC 0
9bd6a503 810
3ca6a5f0
BP
811// For backward compatibility reasons, this parameter now only controls the
812// default scrolling method used by cursors. This default behavior can be
d2c52078 813// overriden by setting the second param of wxDB::wxDbGetConnection() or
3ca6a5f0 814// wxDb() constructor to indicate whether the connection (and any wxDbTable()s
d2c52078
RD
815// that use the connection) should support forward only scrolling of cursors,
816// or both forward and backward support for backward scrolling cursors is
3ca6a5f0 817// dependent on the data source as well as the ODBC driver being used.
aeb040bf 818#define wxODBC_FWD_ONLY_CURSORS 1
9695185a 819
3ca6a5f0
BP
820// Default is 0. Set to 1 to use the deprecated classes, enum types, function,
821// member variables. With a setting of 1, full backward compatability with the
822// 2.0.x release is possible. It is STRONGLY recommended that this be set to 0,
823// as future development will be done only on the non-deprecated
824// functions/classes/member variables/etc.
f6bcfd97 825#define wxODBC_BACKWARD_COMPATABILITY 0
f6bcfd97 826
3b415ba4
VZ
827// ----------------------------------------------------------------------------
828// other compiler (mis)features
829// ----------------------------------------------------------------------------
830
831// Set this to 0 if your compiler can't cope with omission of prototype
832// parameters.
833//
834// Default is 1.
835//
836// Recommended setting: 1 (should never need to set this to 0)
837#define REMOVE_UNUSED_ARG 1
838
839// VC++ 4.2 and above allows <iostream> and <iostream.h> but you can't mix
840// them. Set to 1 for <iostream.h>, 0 for <iostream>
841//
842// Default is 1.
843//
844// Recommended setting: whatever your compiler likes more
dbda9e86 845#define wxUSE_IOSTREAMH 1
d4ec5d32 846
3b415ba4
VZ
847// ----------------------------------------------------------------------------
848// image format support
849// ----------------------------------------------------------------------------
850
3ca6a5f0
BP
851// wxImage supports many different image formats which can be configured at
852// compile-time. BMP is always supported, others are optional and can be safely
853// disabled if you don't plan to use images in such format sometimes saving
854// substantial amount of code in the final library.
855//
856// Some formats require an extra library which is included in wxWin sources
857// which is mentioned if it is the case.
858
0046ff7c
VS
859// Set to 1 for wxImage support (recommended).
860#define wxUSE_IMAGE 1
861
3ca6a5f0 862// Set to 1 for PNG format support (requires libpng). Also requires wxUSE_ZLIB.
9bd6a503 863#define wxUSE_LIBPNG 1
3ca6a5f0
BP
864
865// Set to 1 for JPEG format support (requires libjpeg)
83b1bfaa 866#define wxUSE_LIBJPEG 1
3ca6a5f0
BP
867
868// Set to 1 for TIFF format support (requires libtiff)
1ea67089 869#define wxUSE_LIBTIFF 1
3ca6a5f0
BP
870
871// Set to 1 for GIF format support
83b1bfaa 872#define wxUSE_GIF 1
3ca6a5f0
BP
873
874// Set to 1 for PNM format support
1044a386 875#define wxUSE_PNM 1
3ca6a5f0
BP
876
877// Set to 1 for PCX format support
1044a386 878#define wxUSE_PCX 1
9bd6a503 879
0046ff7c
VS
880// Set to 1 for XPM format support
881#define wxUSE_XPM 1
882
3b415ba4
VZ
883// ----------------------------------------------------------------------------
884// Windows-only settings
885// ----------------------------------------------------------------------------
1318fabe 886
3ca6a5f0
BP
887// Set this to 1 if you want to use wxWindows and MFC in the same program. This
888// will override some other settings (see below)
889//
890// Default is 0.
891//
892// Recommended setting: 0 unless you really have to use MFC
3f8e5072
JS
893#define wxUSE_MFC 0
894
3ca6a5f0
BP
895// Set this to 1 for generic OLE support: this is required for drag-and-drop,
896// clipboard, OLE Automation. Only set it to 0 if your compiler is very old and
897// can't compile/doesn't have the OLE headers.
898//
899// Default is 1.
900//
901// Recommended setting: 1
3aa0e8fa 902#define wxUSE_OLE 1
3aa0e8fa 903
3ca6a5f0
BP
904// Set this to 1 to use Microsoft CTL3D library for "3D-look" under Win16 or NT
905// 3.x. This setting is ignored under Win9x and NT 4.0+.
906//
907// Default is 0 for (most) Win32 (systems), 1 for Win16
908//
909// Recommended setting: same as default
9bd6a503 910#if defined(__WIN95__)
1f112209 911#define wxUSE_CTL3D 0
9bd6a503 912#else
1f112209 913#define wxUSE_CTL3D 1
9bd6a503
VZ
914#endif
915
3ca6a5f0
BP
916// Define as 1 to use Microsoft's ItsyBitsy small title bar library, for
917// wxMiniFrame. This setting is only used for Win3.1; Win9x and NT use native
918// miniframes support instead.
919//
920// Default is 0 for (most) Win32 (systems), 1 for Win16
921//
922// Recommended setting: same as default
923#if defined(__WIN95__)
924#define wxUSE_ITSY_BITSY 0
925#else
926#define wxUSE_ITSY_BITSY 1
927#endif
928
929// Set this to 1 to use RICHEDIT controls for wxTextCtrl with style wxTE_RICH
930// which allows to put more than ~32Kb of text in it even under Win9x (NT
931// doesn't have such limitation).
932//
933// Default is 1 for compilers which support it
934//
935// Recommended setting: 1, only set it to 0 if your compiler doesn't have
936// or can't compile <richedit.h>
6d167489 937#if defined(__WIN95__) && !defined(__TWIN32__) && !defined(__GNUWIN32_OLD__)
be329a3d
RD
938#define wxUSE_RICHEDIT 1
939
940// TODO: This should be ifdef'ed for any compilers that don't support
941// RichEdit 2.0 but do have RichEdit 1.0...
942#define wxUSE_RICHEDIT2 1
943
6d167489 944#else
be329a3d
RD
945#define wxUSE_RICHEDIT 0
946#define wxUSE_RICHEDIT2 0
6d167489
VZ
947#endif
948
3ca6a5f0
BP
949// Set this to 1 to enable support for the owner-drawn menu and listboxes. This
950// is required by wxUSE_CHECKLISTBOX.
951//
952// Default is 1.
953//
954// Recommended setting: 1, set to 0 for a small library size reduction
955#define wxUSE_OWNER_DRAWN 1
956
957// ----------------------------------------------------------------------------
958// obsolete settings
959// ----------------------------------------------------------------------------
960
961// NB: all settings in this section are obsolete and should not be used/changed
962// at all, they will disappear
963
964// Set to 1 to use PenWindows
7fee680b 965#define wxUSE_PENWINDOWS 0
9bd6a503 966
3ca6a5f0
BP
967// Define 1 to use bitmap messages.
968#define wxUSE_BITMAP_MESSAGE 1
969
970// If 1, enables provision of run-time type information.
971// NOW MANDATORY: don't change.
972#define wxUSE_DYNAMIC_CLASSES 1
973
974// ----------------------------------------------------------------------------
975// disable the settings which don't work for some compilers
976// ----------------------------------------------------------------------------
9bd6a503 977
1a7f3062 978#ifndef wxUSE_NORLANDER_HEADERS
b64f0a5f 979#if (defined(__MINGW32__) || defined(__CYGWIN__)) && ((__GNUC__>2) ||((__GNUC__==2) && (__GNUC_MINOR__>=95)))
1a7f3062 980# define wxUSE_NORLANDER_HEADERS 1
b64f0a5f
RL
981#else
982# define wxUSE_NORLANDER_HEADERS 0
1a7f3062
JS
983#endif
984#endif
985
1ea67089 986#if defined(__GNUWIN32__)
f6bcfd97 987// These don't work as expected for mingw32 and cygwin32
1ea67089
GRG
988#undef wxUSE_MEMORY_TRACING
989#define wxUSE_MEMORY_TRACING 0
990
991#undef wxUSE_GLOBAL_MEMORY_OPERATORS
992#define wxUSE_GLOBAL_MEMORY_OPERATORS 0
993
994#undef wxUSE_DEBUG_NEW_ALWAYS
995#define wxUSE_DEBUG_NEW_ALWAYS 0
f6bcfd97 996
74afbadc
JS
997// Cygwin betas don't have wcslen
998#if defined(__CYGWIN__) || defined(__CYGWIN32__)
999# if ! ((__GNUC__>2) ||((__GNUC__==2) && (__GNUC_MINOR__>=95)))
1000# undef wxUSE_WCHAR_T
1001# define wxUSE_WCHAR_T 0
1002# endif
f6bcfd97
BP
1003#endif
1004
74afbadc
JS
1005#endif // __GNUWIN32__
1006
3f8e5072
JS
1007// MFC duplicates these operators
1008#if wxUSE_MFC
1009#undef wxUSE_GLOBAL_MEMORY_OPERATORS
1010#define wxUSE_GLOBAL_MEMORY_OPERATORS 0
1011
1012#undef wxUSE_DEBUG_NEW_ALWAYS
1013#define wxUSE_DEBUG_NEW_ALWAYS 0
3b415ba4 1014#endif // wxUSE_MFC
3f8e5072 1015
f6bcfd97
BP
1016// ODBC classes aren't Unicode-compatible yet
1017#if wxUSE_UNICODE
1018#undef wxUSE_ODBC
1019#define wxUSE_ODBC 0
1020#endif
1021
e06b9569 1022#if (!defined(WIN32) && !defined(__WIN32__)) || (defined(__GNUWIN32__) && !wxUSE_NORLANDER_HEADERS)
9bd6a503
VZ
1023// Can't use OLE drag and drop in Windows 3.1 because we don't know how
1024// to implement UUIDs
1025// GnuWin32 doesn't have appropriate headers for e.g. IUnknown.
1026#undef wxUSE_DRAG_AND_DROP
1027#define wxUSE_DRAG_AND_DROP 0
1028#endif
1029
1030// Only WIN32 supports wxStatusBar95
1031#if !defined(__WIN32__) && wxUSE_NATIVE_STATUSBAR
1032#undef wxUSE_NATIVE_STATUSBAR
1033#define wxUSE_NATIVE_STATUSBAR 0
1034#endif
1035
f6bcfd97
BP
1036#if !wxUSE_OWNER_DRAWN
1037#undef wxUSE_CHECKLISTBOX
1038#define wxUSE_CHECKLISTBOX 0
1039#endif
1040
9bd6a503
VZ
1041// Salford C++ doesn't like some of the memory operator definitions
1042#ifdef __SALFORDC__
1043#undef wxUSE_MEMORY_TRACING
1044#define wxUSE_MEMORY_TRACING 0
1045
1046#undef wxUSE_GLOBAL_MEMORY_OPERATORS
1047#define wxUSE_GLOBAL_MEMORY_OPERATORS 0
1048
1049#undef wxUSE_DEBUG_NEW_ALWAYS
1050#define wxUSE_DEBUG_NEW_ALWAYS 0
1051
1052#undef wxUSE_THREADS
1053#define wxUSE_THREADS 0
1054
9bd6a503
VZ
1055#undef wxUSE_OWNER_DRAWN
1056#define wxUSE_OWNER_DRAWN 0
f6bcfd97 1057#endif // __SALFORDC__
9bd6a503
VZ
1058
1059#ifdef __TWIN32__
1060
1061#undef wxUSE_THREADS
1062#define wxUSE_THREADS 0
1063
9bd6a503
VZ
1064#undef wxUSE_ODBC
1065#define wxUSE_ODBC 0
1066
f6bcfd97 1067#endif // __TWIN32__
9bd6a503 1068
448af9a4
JS
1069// BC++/Win16 can't cope with the amount of data in resource.cpp
1070#if defined(__WIN16__) && defined(__BORLANDC__)
1071#undef wxUSE_WX_RESOURCES
1072#define wxUSE_WX_RESOURCES 0
154f22b3
JS
1073
1074#undef wxUSE_ODBC
1075#define wxUSE_ODBC 0
9c824f29
JS
1076
1077#undef wxUSE_NEW_GRID
1078#define wxUSE_NEW_GRID 0
448af9a4
JS
1079#endif
1080
b2cf617c
JS
1081#if defined(__BORLANDC__) && (__BORLANDC__ < 0x500)
1082// BC++ 4.0 can't compile JPEG library
1083#undef wxUSE_LIBJPEG
1084#define wxUSE_LIBJPEG 0
1085#endif
1086
3ca6a5f0 1087// wxUSE_DEBUG_NEW_ALWAYS = 1 not compatible with BC++ in DLL mode
f6bcfd97
BP
1088#if defined(__BORLANDC__) && (defined(WXMAKINGDLL) || defined(WXUSINGDLL))
1089#undef wxUSE_DEBUG_NEW_ALWAYS
1090#define wxUSE_DEBUG_NEW_ALWAYS 0
1091#endif
b2cf617c 1092
f6bcfd97
BP
1093#if defined(__WXMSW__) && defined(__WATCOMC__)
1094/*
b2cf617c
JS
1095#undef wxUSE_GLCANVAS
1096#define wxUSE_GLCANVAS 0
f6bcfd97
BP
1097*/
1098
f6bcfd97
BP
1099#undef wxUSE_WCHAR_T
1100#define wxUSE_WCHAR_T 0
0cdf89ab
JS
1101#endif
1102
9bd6a503
VZ
1103#if defined(__WXMSW__) && !defined(__WIN32__)
1104
8fb3a512
JS
1105#undef wxUSE_SOCKETS
1106#define wxUSE_SOCKETS 0
1107
9bd6a503
VZ
1108#undef wxUSE_THREADS
1109#define wxUSE_THREADS 0
1110
750b78ba
JS
1111#undef wxUSE_TOOLTIPS
1112#define wxUSE_TOOLTIPS 0
1113
0e528b99
JS
1114#undef wxUSE_SPINCTRL
1115#define wxUSE_SPINCTRL 0
1116
1117#undef wxUSE_SPINBTN
1118#define wxUSE_SPINBTN 0
1119
1044a386
JS
1120#undef wxUSE_LIBPNG
1121#define wxUSE_LIBPNG 0
1122
1123#undef wxUSE_LIBJPEG
1124#define wxUSE_LIBJPEG 0
1125
669f7a11
JS
1126#undef wxUSE_LIBTIFF
1127#define wxUSE_LIBTIFF 0
1128
83b1bfaa
GRG
1129#undef wxUSE_GIF
1130#define wxUSE_GIF 0
1044a386
JS
1131
1132#undef wxUSE_PNM
1133#define wxUSE_PNM 0
1134
1135#undef wxUSE_PCX
1136#define wxUSE_PCX 0
1137
b2cf617c
JS
1138#undef wxUSE_GLCANVAS
1139#define wxUSE_GLCANVAS 0
1140
f6bcfd97
BP
1141#undef wxUSE_MS_HTML_HELP
1142#define wxUSE_MS_HTML_HELP 0
1143
1144#undef wxUSE_WCHAR_T
1145#define wxUSE_WCHAR_T 0
1146
1147#endif // Win16
1148
3ca6a5f0
BP
1149// ----------------------------------------------------------------------------
1150// undef the things which don't make sense for wxBase build
1151// ----------------------------------------------------------------------------
1152
1153#if !wxUSE_GUI
1154
1155#undef wxUSE_HTML
1156#define wxUSE_HTML 0
1157
1158#endif // !wxUSE_GUI
1159
f6bcfd97
BP
1160// ----------------------------------------------------------------------------
1161// check the settings consistency: do it here to abort compilation immediately
1162// and not almost in the very end when the relevant file fails to compile and
1163// you need to modify setup.h and rebuild everything
1164// ----------------------------------------------------------------------------
1165
e421922f 1166#if wxUSE_DATETIME && !wxUSE_LONGLONG
f6bcfd97 1167 #error wxDateTime requires wxLongLong
9bd6a503
VZ
1168#endif
1169
f6bcfd97
BP
1170#if wxUSE_TEXTFILE && !wxUSE_FILE
1171 #error You cannot compile wxTextFile without wxFile
1172#endif
1173
1174#if wxUSE_FILESYSTEM && !wxUSE_STREAMS
1175 #error You cannot compile virtual file systems without wxUSE_STREAMS
1176#endif
1177
1178#if wxUSE_HTML && !wxUSE_FILESYSTEM
1179 #error You cannot compile wxHTML without virtual file systems
1180#endif
1181
1182// add more tests here...
1183
9bd6a503
VZ
1184#endif
1185 // _WX_SETUP_H_