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