]> git.saurik.com Git - wxWidgets.git/blame - include/wx/mac/setup0.h
changed wxSystemSettings::HasFrameDecorations to more general GetCapability(index)
[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
0dbd6262
SC
6// Created: ??/??/98
7// RCS-ID: $Id$
8// Copyright: (c) AUTHOR
9// Licence: wxWindows licence
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
be7b3226
GD
39// in wxMSW version 2.1.11 and earlier, wxIcon always derives from wxBitmap,
40// but this is very dangerous because you can mistakenly pass an icon instead
41// of a bitmap to a function taking "const wxBitmap&" - which will *not* work
42// because an icon is not a valid bitmap
43//
44// Starting from 2.1.12, you have the choice under this backwards compatible
45// behaviour (your code will still compile, but probably won't behave as
46// expected!) and not deriving wxIcon class from wxBitmap, but providing a
47// conversion ctor wxBitmap(const wxIcon&) instead.
48//
49// Recommended setting: 0
50#define wxICON_IS_BITMAP 0
e7549107 51
be7b3226
GD
52// Define as 1 for font size to be backward compatible to 1.63 and earlier.
53// 1.64 and later define point sizes to be compatible with Windows.
54//
55// Default is 0
56//
57// Recommended setting: 0
58#define wxFONT_SIZE_COMPATIBILITY 0
e7549107 59
be7b3226
GD
60// Set to 0 for accurate dialog units, else 1 to be as per 2.1.16 and before.
61// If migrating between versions, your dialogs may seem to shrink.
62//
63// Default is 1
64//
65// Recommended setting: 0 (the new calculations are more correct!)
66#define wxDIALOG_UNIT_COMPATIBILITY 1
67
68// ----------------------------------------------------------------------------
69// debugging settings
70// ----------------------------------------------------------------------------
71
72// Generic comment about debugging settings: they are very useful if you don't
73// use any other memory leak detection tools such as Purify/BoundsChecker, but
74// are probably redundant otherwise. Also, Visual C++ CRT has the same features
75// as wxWindows memory debugging subsystem built in since version 5.0 and you
76// may prefer to use it instead of built in memory debugging code because it is
77// faster and more fool proof.
78//
79// Using VC++ CRT memory debugging is enabled by default in debug mode
80// (__WXDEBUG__) if wxUSE_GLOBAL_MEMORY_OPERATORS is *not* enabled (i.e. is 0)
81// and if __NO_VC_CRTDBG__ is not defined.
82
83// If 1, enables wxDebugContext, for writing error messages to file, etc. If
84// __WXDEBUG__ is not defined, will still use normal memory operators. It's
85// recommended to set this to 1, since you may well need to output an error log
86// in a production version (or non-debugging beta).
87//
88// Default is 1.
89//
90// Recommended setting: 1 but see comment above
91#ifndef __MWERKS__
92#define wxUSE_DEBUG_CONTEXT 0
93#else
94#define wxUSE_DEBUG_CONTEXT 1
95#endif
96
97// If 1, enables debugging versions of wxObject::new and wxObject::delete *IF*
98// __WXDEBUG__ is also defined.
99//
100// WARNING: this code may not work with all architectures, especially if
101// alignment is an issue. This switch is currently ignored for mingw / cygwin
102//
103// Default is 1
104//
105// Recommended setting: 1 but see comment in the beginning of this section
106#define wxUSE_MEMORY_TRACING 1
107
108// In debug mode, cause new and delete to be redefined globally.
109// If this causes problems (e.g. link errors), set this to 0.
110// This switch is currently ignored for mingw / cygwin
111//
112// Default is 1
113//
114// Recommended setting: 1 but see comment in the beginning of this section
115#define wxUSE_GLOBAL_MEMORY_OPERATORS 0
116
117// In debug mode, causes new to be defined to be WXDEBUG_NEW (see object.h). If
118// this causes problems (e.g. link errors), set this to 0. You may need to set
119// this to 0 if using templates (at least for VC++). This switch is currently
120// ignored for mingw / cygwin
121//
122// Default is 1
123//
124// Recommended setting: 1 but see comment in the beginning of this section
125#define wxUSE_DEBUG_NEW_ALWAYS 1
126
127// wxHandleFatalExceptions() may be used to catch the program faults at run
128// time and, instead of terminating the program with a usual GPF message box,
129// call the user-defined wxApp::OnFatalException() function. If you set
130// wxUSE_ON_FATAL_EXCEPTION to 0, wxHandleFatalExceptions() will not work.
131//
132// This setting is for Win32 only and can only be enabled if your compiler
133// supports Win32 structured exception handling (currently only VC++ does)
134//
135// Default is 1
136//
137// Recommended setting: 1 if your compiler supports it.
138#ifdef _MSC_VER
139 #define wxUSE_ON_FATAL_EXCEPTION 1
140#else
141 #define wxUSE_ON_FATAL_EXCEPTION 0
142#endif
143
144// ----------------------------------------------------------------------------
145// Unicode support
146// ----------------------------------------------------------------------------
147
148// Set wxUSE_UNICODE to 1 to compile wxWindows in Unicode mode: wxChar will be
149// defined as wchar_t, wxString will use Unicode internally. If you set this
150// to 1, you must use wxT() macro for all literal strings in the program.
151//
152// Unicode is currently only fully supported under Windows NT/2000 (Windows 9x
153// doesn't support it and the programs compiled in Unicode mode will not run
154// under 9x).
155//
156// Default is 0
157//
158// Recommended setting: 0 (unless you only plan to use Windows NT/2000)
159#define wxUSE_UNICODE 0
160
161// Setting wxUSE_WCHAR_T to 1 gives you some degree of Unicode support without
162// compiling the program in Unicode mode. More precisely, it will be possible
163// to construct wxString from a wide (Unicode) string and convert any wxString
164// to Unicode.
165//
166// Default is 1
167//
168// Recommended setting: 1
169#define wxUSE_WCHAR_T 1
170
171// ----------------------------------------------------------------------------
172// global features
173// ----------------------------------------------------------------------------
174
175// Support for message/error logging. This includes wxLogXXX() functions and
176// wxLog and derived classes. Don't set this to 0 unless you really know what
177// you are doing.
178//
179// Default is 1
180//
181// Recommended setting: 1 (always)
182#define wxUSE_LOG 1
183
184// Recommended setting: 1 (always)
185#define wxUSE_LOGWINDOW 1
d11ec3df 186
be7b3226
GD
187// Recommended setting: 1 (always)
188#define wxUSE_LOGGUI 1
189
d11ec3df
GD
190// Recommended setting: 1 (always)
191#define wxUSE_LOG_DIALOG 1
192
be7b3226
GD
193// Support for multithreaded applications: if 1, compile in thread classes
194// (thread.h) and make the library a bit more thread safe. Although thread
195// support is quite stable by now, you may still consider recompiling the
196// library without it if you have no use for it - this will result in a
197// somewhat smaller and faster operation.
198//
199// This is ignored under Win16, threads are only supported under Win32.
200//
201// Default is 1
202//
203// Recommended setting: 0 unless you do plan to develop MT applications
204#define wxUSE_THREADS 1
205
206// If enabled (1), compiles wxWindows streams classes
207#define wxUSE_STREAMS 1
208
209// Use standard C++ streams if 1. If 0, use wxWin streams implementation.
210#ifndef __MWERKS__
211#define wxUSE_STD_IOSTREAM 0
212#else
213#define wxUSE_STD_IOSTREAM 1
214#endif
215
216// Use serialization (requires utils/serialize)
217#define wxUSE_SERIAL 0
218
219// ----------------------------------------------------------------------------
220// non GUI features selection
221// ----------------------------------------------------------------------------
222
223// Set wxUSE_LONGLONG to 1 to compile the wxLongLong class. This is a 64 bit
224// integer which is implemented in terms of native 64 bit integers if any or
225// uses emulation otherwise.
226//
227// This class is required by wxDateTime and so you should enable it if you want
228// to use wxDateTime. For most modern platforms, it will use the native 64 bit
229// integers in which case (almost) all of its functions are inline and it
230// almost does not take any space, so there should be no reason to switch it
231// off.
232//
233// Recommended setting: 1
234#define wxUSE_LONGLONG 1
235
236// Set wxUSE_(F)FILE to 1 to compile wx(F)File classes. wxFile uses low level
237// POSIX functions for file access, wxFFile uses ANSI C stdio.h functions.
238//
239// Default is 1
240//
241// Recommended setting: 1 (wxFile is highly recommended as it is required by
242// i18n code, wxFileConfig and others)
243#define wxUSE_FILE 1
244#define wxUSE_FFILE 1
245
246// use wxTextFile class: requires wxFile, required by wxFileConfig
247#define wxUSE_TEXTFILE 1
248
249// i18n support: _() macro, wxLocale class. Requires wxTextFile.
250#define wxUSE_INTL 1
251
252// Set wxUSE_DATETIME to 1 to compile the wxDateTime and related classes which
253// allow to manipulate dates, times and time intervals. wxDateTime replaces the
254// old wxTime and wxDate classes which are still provided for backwards
255// compatibility (and implemented in terms of wxDateTime).
256//
257// Note that this class is relatively new and is still officially in alpha
258// stage because some features are not yet (fully) implemented. It is already
259// quite useful though and should only be disabled if you are aiming at
260// absolutely minimal version of the library.
261//
262// Requires: wxUSE_LONGLONG
263//
264// Default is 1
265//
266// Recommended setting: 1
267#define wxUSE_DATETIME 1
268
269// wxUSE_TIMEDATE enables compilation of the old wxDate and wxTime classes (not
270// the same as wxDateTime!). These classes are obsolete and shouldn't be used
271// in new code
272//
273// Default is 0
274//
275// Recommended setting: 0 unless you have legacy code which uses these classes
276#define wxUSE_TIMEDATE 0
277
278// Set wxUSE_TIMER to 1 to compile wxTimer class
279//
280// Default is 1
281//
282// Recommended setting: 1
283#define wxUSE_TIMER 1
284
285// Use wxStopWatch clas.
286//
287// Default is 1
288//
289// Recommended setting: 1 (needed by wxSocket)
290#define wxUSE_STOPWATCH 1
291
292// Setting wxUSE_CONFIG to 1 enables the use of wxConfig and related classes
293// which allow the application to store its settings in the persistent
294// storage. Setting this to 1 will also enable on-demand creation of the
295// global config object in wxApp.
296//
297// See also wxUSE_CONFIG_NATIVE below.
298//
299// Recommended setting: 1
300#define wxUSE_CONFIG 1
301
302// If wxUSE_CONFIG is 1, you may choose to use either the native config
303// classes under Windows (using .INI files under Win16 and the registry under
304// Win32) or the portable text file format used by the config classes under
305// Unix.
306//
307// Default is 1 to use native classes. Note that you may still use
308// wxFileConfig even if you set this to 1 - just the config object created by
309// default for the applications needs will be a wxRegConfig or wxIniConfig and
310// not wxFileConfig.
311//
312// Recommended setting: 1
313#define wxUSE_CONFIG_NATIVE 1
314
315// If wxUSE_DIALUP_MANAGER is 1, compile in wxDialUpManager class which allows
316// to connect/disconnect from the network and be notified whenever the dial-up
317// network connection is established/terminated. Requires wxUSE_DYNLIB_CLASS.
318//
319// Default is 1.
320//
321// Recommended setting: 1
322#define wxUSE_DIALUP_MANAGER 1
323
324// Compile in wxLibrary class for run-time DLL loading and function calling.
325// Required by wxUSE_DIALUP_MANAGER.
326//
327// This setting is for Win32 only
328//
329// Default is 1.
330//
331// Recommended setting: 1
332#define wxUSE_DYNLIB_CLASS 1
333
334// Set to 1 to use socket classes
335#define wxUSE_SOCKETS 1
336
337// Set to 1 to enable virtual file systems (required by wxHTML)
338#define wxUSE_FILESYSTEM 1
339
340// Set to 1 to enable virtual ZIP filesystem (requires wxUSE_FILESYSTEM)
341#define wxUSE_FS_ZIP 1
342
343// Set to 1 to enable virtual Internet filesystem (requires wxUSE_FILESYSTEM)
344#define wxUSE_FS_INET 1
345
346// Set to 1 to compile wxZipInput/OutputStream classes.
347#define wxUSE_ZIPSTREAM 1
348
349// Set to 1 to compile wxZlibInput/OutputStream classes. Also required by
350// wxUSE_LIBPNG.
351#define wxUSE_ZLIB 1
e7549107 352
be7b3226
GD
353// If enabled, the code written by Apple will be used to write, in a portable
354// way, float on the disk. See extended.c for the license which is different
355// from wxWindows one.
356//
357// Default is 1.
358//
359// Recommended setting: 1 unless you don't like the license terms (unlikely)
360#define wxUSE_APPLE_IEEE 1
e7549107 361
be7b3226
GD
362// Joystick support class
363#define wxUSE_JOYSTICK 1
e7549107 364
be7b3226
GD
365// wxFontMapper class
366#define wxUSE_FONTMAP 1
e7549107 367
be7b3226
GD
368// wxMimeTypesManager class
369#define wxUSE_MIMETYPE 1
370
0cbff120
JS
371// wxSystemOptions class
372#define wxUSE_SYSTEM_OPTIONS 1
373
954fc50b
SC
374// Support for regular expression matching via wxRegEx class: enable this to
375// use POSIX regular expressions in your code. You need to compile regex
376// library from src/regex to use it under Windows.
377//
378// Default is 0
379//
380// Recommended setting: 1 if your compiler supports it, if it doesn't please
381// contribute us a makefile for src/regex for it
382#define wxUSE_REGEX 0
383
be7b3226
GD
384// ----------------------------------------------------------------------------
385// Individual GUI controls
386// ----------------------------------------------------------------------------
e7549107 387
be7b3226
GD
388// You must set wxUSE_CONTROLS to 1 if you are using any controls at all
389// (without it, wxControl class is not compiled)
390//
391// Default is 1
392//
393// Recommended setting: 1 (don't change except for very special programs)
394#define wxUSE_CONTROLS 1
e7549107 395
be7b3226
GD
396// wxPopupWindow class is not used currently by wxMSW
397//
398// Default is 0
399//
400// Recommended setting: 0
401#define wxUSE_POPUPWIN 0
402
403// Each of the settings below corresponds to one wxWindows control. They are
404// all switched on by default but may be disabled if you are sure that your
405// program (including any standard dialogs it can show!) doesn't need them and
406// if you desperately want to save some space. If you use any of these you must
407// set wxUSE_CONTROLS as well.
408//
409// Default is 1
410//
411// Recommended setting: 1
412#define wxUSE_BUTTON 1 // wxButton
413#define wxUSE_BMPBUTTON 1 // wxBitmapButton
414#define wxUSE_CALENDARCTRL 1 // wxCalendarCtrl
415#define wxUSE_CHECKBOX 1 // wxCheckBox
416#define wxUSE_CHECKLISTBOX 1 // wxCheckListBox (requires wxUSE_OWNER_DRAWN)
417#define wxUSE_CHOICE 1 // wxChoice
418#define wxUSE_COMBOBOX 1 // wxComboBox
419#define wxUSE_GAUGE 1 // wxGauge
420#define wxUSE_LISTBOX 1 // wxListBox
421#define wxUSE_LISTCTRL 1 // wxListCtrl
d11ec3df 422#define wxUSE_PROPSHEET 1 // wxProperty
be7b3226
GD
423#define wxUSE_RADIOBOX 1 // wxRadioBox
424#define wxUSE_RADIOBTN 1 // wxRadioButton
425#define wxUSE_SCROLLBAR 1 // wxScrollBar
426#define wxUSE_SLIDER 1 // wxSlider
427#define wxUSE_SPINBTN 1 // wxSpinButton
428#define wxUSE_SPINCTRL 1 // wxSpinCtrl
429#define wxUSE_STATBOX 1 // wxStaticBox
430#define wxUSE_STATLINE 1 // wxStaticLine
431#define wxUSE_STATTEXT 1 // wxStaticText
432#define wxUSE_STATBMP 1 // wxStaticBitmap
433#define wxUSE_TEXTCTRL 1 // wxTextCtrl
90b959ae 434#define wxUSE_TOGGLEBTN 0 // requires wxButton
be7b3226
GD
435#define wxUSE_TREECTRL 1 // wxTreeCtrl
436
437// Use a status bar class? Depending on the value of wxUSE_NATIVE_STATUSBAR
438// below either wxStatusBar95 or a generic wxStatusBar will be used.
439//
440// Default is 1
441//
442// Recommended setting: 1
443#define wxUSE_STATUSBAR 1
22e0ea84 444
be7b3226
GD
445// Two status bar implementations are available under Win32: the generic one
446// or the wrapper around native control. For native look and feel the native
447// version should be used.
448//
449// Default is 1.
450//
451// Recommended setting: 1 (there is no advantage in using the generic one)
452#define wxUSE_NATIVE_STATUSBAR 1
7f0275ef 453
be7b3226
GD
454// wxToolBar related settings: if wxUSE_TOOLBAR is 0, don't compile any toolbar
455// classes at all. Otherwise, use the native toolbar class unless
456// wxUSE_TOOLBAR_NATIVE is 0. Additionally, the generic toolbar class which
457// supports some features which might not be supported by the native wxToolBar
458// class may be compiled in if wxUSE_TOOLBAR_SIMPLE is 1.
459//
460// Default is 1 for all settings.
461//
462// Recommended setting: 1 for wxUSE_TOOLBAR and wxUSE_TOOLBAR_NATIVE and 0 for
463// wxUSE_TOOLBAR_SIMPLE (the default is 1 mainly for backwards compatibility).
464#define wxUSE_TOOLBAR 1
465#define wxUSE_TOOLBAR_NATIVE 1
466#define wxUSE_TOOLBAR_SIMPLE 1
467
468// this setting is obsolete, value is ignored
469#define wxUSE_BUTTONBAR 1
470
471// wxNotebook is a control with several "tabs" located on one of its sides. It
472// may be used ot logically organise the data presented to the user instead of
473// putting everything in one huge dialog. It replaces wxTabControl and related
474// classes of wxWin 1.6x.
475//
476// Default is 1.
477//
478// Recommended setting: 1
22e0ea84 479#define wxUSE_NOTEBOOK 1
e7549107 480
be7b3226
GD
481// wxTabDialog is a generic version of wxNotebook but it is incompatible with
482// the new class. It shouldn't be used in new code.
483//
484// Default is 0.
485//
486// Recommended setting: 0 (use wxNotebook)
487#define wxUSE_TAB_DIALOG 0
0dbd6262 488
be7b3226
GD
489// wxGrid class comes in two flavours: the original (pre wxWin 2.2) one and
490// the new, much imporved and enhanced version. The new version is backwards
491// compatible with the old one and should be used whenever possible, i.e. if
492// you set wxUSE_GRID to 1, set wxUSE_NEW_GRID to 1 too.
493//
494// Default is 1 for both options.
495//
496// Recommended setting: 1 for wxUSE_NEW_GRID, 0 if you have an old code using
497// wxGrid and 100% backwards compatibality (with all old wxGrid quirks) is
498// essential.
499//
500// WIN16/BC++ resets wxUSE_NEW_GRID to 0 because it exceeds the data limit.
501#define wxUSE_GRID 1
502#define wxUSE_NEW_GRID 1
e7549107 503
be7b3226
GD
504// ----------------------------------------------------------------------------
505// Miscellaneous GUI stuff
506// ----------------------------------------------------------------------------
e7549107 507
be7b3226
GD
508// wxAcceleratorTable/Entry classes and support for them in wxMenu(Bar)
509#define wxUSE_ACCEL 1
510
511// Use wxCaret: a class implementing a "cursor" in a text control (called caret
512// under Windows).
513//
514// Default is 1.
515//
516// Recommended setting: 1 (can be safely set to 0, not used by the library)
517#define wxUSE_CARET 1
518
519// Miscellaneous geometry code: needed for Canvas library
520#define wxUSE_GEOMETRY 1
521
522// Use wxImageList. This class is needed by wxNotebook, wxTreeCtrl and
523// wxListCtrl.
524//
525// Default is 1.
526//
527// Recommended setting: 1 (set it to 0 if you don't use any of the controls
528// enumerated above, then this class is mostly useless too)
529#define wxUSE_IMAGLIST 1
530
531// Use wxMenu, wxMenuBar, wxMenuItem.
532//
533// Default is 1.
534//
535// Recommended setting: 1 (can't be disabled under MSW)
536#define wxUSE_MENUS 1
537
538// Use wxSashWindow class.
539//
540// Default is 1.
541//
542// Recommended setting: 1
543#define wxUSE_SASH 1
544
545// Use wxSplitterWindow class.
546//
547// Default is 1.
548//
549// Recommended setting: 1
550#define wxUSE_SPLITTER 1
551
552// Use wxToolTip and wxWindow::Set/GetToolTip() methods.
553//
554// Default is 1.
555//
556// Recommended setting: 1
557#define wxUSE_TOOLTIPS 1
558
559// wxValidator class and related methods
560#define wxUSE_VALIDATORS 1
561
0cbff120
JS
562// wxDC cacheing implementation
563#define wxUSE_DC_CACHEING 0
564
be7b3226
GD
565// ----------------------------------------------------------------------------
566// common dialogs
567// ----------------------------------------------------------------------------
568
be7b3226
GD
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
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
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
608// Use wxMessageDialog and wxMessageBox.
609//
610// Default is 1
611//
612// Recommended setting: 1 (used in the library itself)
613#define wxUSE_MSGDLG 1
614
615// progress dialog class for lengthy operations
616#define wxUSE_PROGRESSDLG 1
0dbd6262 617
e7549107 618// support for startup tips (wxShowTip &c)
be7b3226 619#define wxUSE_STARTUP_TIPS 1
e7549107 620
be7b3226
GD
621// text entry dialog and wxGetTextFromUser function
622#define wxUSE_TEXTDLG 1
623
624// number entry dialog
625#define wxUSE_NUMBERDLG 1
626
49a91764
SC
627// color chooser dialog
628#define wxUSE_COLOURDLG 1
629
d11ec3df
GD
630// splash screen class
631#define wxUSE_SPLASH 1
632
633// wizards
634#define wxUSE_WIZARDDLG 1
635
be7b3226
GD
636// ----------------------------------------------------------------------------
637// Metafiles support
638// ----------------------------------------------------------------------------
639
640// Windows supports the graphics format known as metafile which is, though not
641// portable, is widely used under Windows and so is supported by wxWin (under
642// Windows only, of course). Win16 (Win3.1) used the so-called "Window
643// MetaFiles" or WMFs which were replaced with "Enhanced MetaFiles" or EMFs in
644// Win32 (Win9x, NT, 2000). Both of these are supported in wxWin and, by
645// default, WMFs will be used under Win16 and EMFs under Win32. This may be
646// changed by setting wxUSE_WIN_METAFILES_ALWAYS to 1 and/or setting
647// wxUSE_ENH_METAFILE to 0. You may also set wxUSE_METAFILE to 0 to not compile
648// in any metafile related classes at all.
649//
650// Default is 1 for wxUSE_ENH_METAFILE and 0 for wxUSE_WIN_METAFILES_ALWAYS.
651//
652// Recommended setting: default or 0 for everything for portable programs.
653#define wxUSE_METAFILE 1
654#define wxUSE_ENH_METAFILE 1
655#define wxUSE_WIN_METAFILES_ALWAYS 0
656
657// ----------------------------------------------------------------------------
658// Big GUI components
659// ----------------------------------------------------------------------------
e7549107 660
be7b3226 661// Set to 0 to disable document/view architecture
0dbd6262 662#define wxUSE_DOC_VIEW_ARCHITECTURE 1
be7b3226
GD
663
664// Set to 0 to disable MDI document/view architecture
665#define wxUSE_MDI_ARCHITECTURE 1
666
667// Set to 0 to disable print/preview architecture code
519cb848 668#define wxUSE_PRINTING_ARCHITECTURE 1
0dbd6262 669
be7b3226
GD
670// wxHTML sublibrary allows to display HTML in wxWindow programs and much,
671// much more.
672//
673// Default is 1.
674//
675// Recommended setting: 1 (wxHTML is great!), set to 0 if you want compile a
676// smaller library.
677#define wxUSE_HTML 1
678
679// OpenGL canvas
680#define wxUSE_GLCANVAS 1
681
682// wxTreeLayout class
683#define wxUSE_TREELAYOUT 1
0dbd6262 684
be7b3226
GD
685// ----------------------------------------------------------------------------
686// Data transfer
687// ----------------------------------------------------------------------------
0dbd6262 688
be7b3226
GD
689// Use wxClipboard class for clipboard copy/paste.
690//
691// Default is 1.
692//
693// Recommended setting: 1
694#define wxUSE_CLIPBOARD 1
f6bcfd97 695
be7b3226
GD
696// Use wxDataObject and related classes. Needed for clipboard and OLE drag and
697// drop
698//
699// Default is 1.
700//
701// Recommended setting: 1
702#define wxUSE_DATAOBJ 1
f6bcfd97 703
be7b3226
GD
704// Use wxDropTarget and wxDropSource classes for drag and drop (this is
705// different from "built in" drag and drop in wxTreeCtrl which is always
706// available). Requires wxUSE_DATAOBJ.
707//
708// Default is 1.
709//
710// Recommended setting: 0 for Mac OS as drag and drop is not yet implemented
711#define wxUSE_DRAG_AND_DROP 0
9695185a 712
be7b3226
GD
713// ----------------------------------------------------------------------------
714// miscellaneous settings
715// ----------------------------------------------------------------------------
9695185a 716
be7b3226
GD
717// wxSingleInstanceChecker class allows to verify at startup if another program
718// instance is running (it is only available under Win32)
719//
720// Default is 1
721//
722// Recommended setting: 1 (the class is tiny, disabling it won't save much
723// space)
724#define wxUSE_SNGLINST_CHECKER 1
0dbd6262 725
d11ec3df
GD
726#define wxUSE_DRAGIMAGE 1
727
be7b3226
GD
728#define wxUSE_IPC 0
729 // 0 for no interprocess comms
730#define wxUSE_HELP 1
731 // 0 for no help facility
e766c8a9 732#define wxUSE_WXHTML_HELP 1
be7b3226
GD
733 // 0 for no MS HTML Help
734#define wxUSE_RESOURCES 1
735 // 0 for no wxGetResource/wxWriteResource
736#define wxUSE_CONSTRAINTS 1
737 // 0 for no window layout constraint system
0dbd6262 738
be7b3226
GD
739#define wxUSE_SPLINES 1
740 // 0 for no splines
519cb848 741
be7b3226
GD
742#define wxUSE_WX_RESOURCES 1
743 // Use .wxr resource mechanism (requires PrologIO library)
744
745#define wxUSE_MOUSEWHEEL 1
746 // Include mouse wheel support
747
748// ----------------------------------------------------------------------------
749// postscript support settings
750// ----------------------------------------------------------------------------
751
752// Set to 1 for PostScript device context.
753#define wxUSE_POSTSCRIPT 0
754
755// Set to 1 to use font metric files in GetTextExtent
756#define wxUSE_AFM_FOR_POSTSCRIPT 0
757
be7b3226
GD
758// ----------------------------------------------------------------------------
759// database classes
760// ----------------------------------------------------------------------------
761
762// Define 1 to use ODBC classes
763#define wxUSE_ODBC 0
764
765// For backward compatibility reasons, this parameter now only controls the
766// default scrolling method used by cursors. This default behavior can be
767// overriden by setting the second param of wxDB::wxDbGetConnection() or
768// wxDb() constructor to indicate whether the connection (and any wxDbTable()s
769// that use the connection) should support forward only scrolling of cursors,
770// or both forward and backward support for backward scrolling cursors is
771// dependent on the data source as well as the ODBC driver being used.
772#define wxODBC_FWD_ONLY_CURSORS 1
773
774// Default is 0. Set to 1 to use the deprecated classes, enum types, function,
775// member variables. With a setting of 1, full backward compatability with the
776// 2.0.x release is possible. It is STRONGLY recommended that this be set to 0,
777// as future development will be done only on the non-deprecated
778// functions/classes/member variables/etc.
779#define wxODBC_BACKWARD_COMPATABILITY 0
780
781// ----------------------------------------------------------------------------
782// other compiler (mis)features
783// ----------------------------------------------------------------------------
784
785// Set this to 0 if your compiler can't cope with omission of prototype
786// parameters.
787//
788// Default is 1.
789//
790// Recommended setting: 1 (should never need to set this to 0)
791#define REMOVE_UNUSED_ARG 1
792
793// VC++ 4.2 and above allows <iostream> and <iostream.h> but you can't mix
794// them. Set to 1 for <iostream.h>, 0 for <iostream>
795//
796// Default is 1.
797//
798// Recommended setting: whatever your compiler likes more
05adb9d2 799#ifndef __MWERKS__
be7b3226 800#define wxUSE_IOSTREAMH 0
05adb9d2 801#else
be7b3226 802#define wxUSE_IOSTREAMH 1
05adb9d2 803#endif
e7549107 804
94fdced0
SC
805// ----------------------------------------------------------------------------
806// image format support
807// ----------------------------------------------------------------------------
808
809// wxImage supports many different image formats which can be configured at
810// compile-time. BMP is always supported, others are optional and can be safely
811// disabled if you don't plan to use images in such format sometimes saving
812// substantial amount of code in the final library.
813//
814// Some formats require an extra library which is included in wxWin sources
815// which is mentioned if it is the case.
816
817// Set to 1 for wxImage support (recommended).
818#define wxUSE_IMAGE 1
819
be7b3226 820// Set to 1 for PNG format support (requires libpng). Also requires wxUSE_ZLIB.
e7549107 821#define wxUSE_LIBPNG 1
be7b3226
GD
822
823// Set to 1 for JPEG format support (requires libjpeg)
05adb9d2 824#define wxUSE_LIBJPEG 1
be7b3226
GD
825
826// Set to 1 for TIFF format support (requires libtiff)
827#define wxUSE_LIBTIFF 1
828
829// Set to 1 for GIF format support
830#define wxUSE_GIF 1
831
94fdced0
SC
832// Set to 1 for PNM format support
833#define wxUSE_PNM 1
834
835// Set to 1 for PCX format support
836#define wxUSE_PCX 1
837
838// Set to 1 for XPM format support
839#define wxUSE_XPM 1
840
ea48aa7c
GD
841// Set to 1 to compile in wxPalette class
842#define wxUSE_PALETTE 1
843
be7b3226
GD
844// ----------------------------------------------------------------------------
845// Mac-only settings
846// ----------------------------------------------------------------------------
e7549107 847
be7b3226 848#define WORDS_BIGENDIAN 1
0dbd6262 849
be7b3226
GD
850// ----------------------------------------------------------------------------
851// Windows-only settings
852// ----------------------------------------------------------------------------
0dbd6262 853
be7b3226
GD
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
860#define wxUSE_MFC 0
519cb848 861
be7b3226
GD
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
869#define wxUSE_OLE 1
519cb848 870
be7b3226
GD
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
877#if defined(__WIN95__)
878#define wxUSE_CTL3D 0
879#else
880#define wxUSE_CTL3D 1
881#endif
519cb848 882
be7b3226
GD
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
519cb848 895
be7b3226
GD
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>
904#if defined(__WIN95__) && !defined(__TWIN32__) && !defined(__GNUWIN32_OLD__)
905#define wxUSE_RICHEDIT 1
519cb848 906
be7b3226
GD
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
519cb848 910
be7b3226
GD
911#else
912#define wxUSE_RICHEDIT 0
913#define wxUSE_RICHEDIT2 0
914#endif
519cb848 915
be7b3226
GD
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 0
519cb848 923
be7b3226
GD
924// ----------------------------------------------------------------------------
925// obsolete settings
926// ----------------------------------------------------------------------------
519cb848 927
be7b3226
GD
928// NB: all settings in this section are obsolete and should not be used/changed
929// at all, they will disappear
519cb848 930
be7b3226
GD
931// Set to 1 to use PenWindows
932#define wxUSE_PENWINDOWS 0
519cb848 933
be7b3226
GD
934// Define 1 to use bitmap messages.
935#define wxUSE_BITMAP_MESSAGE 1
e7549107 936
be7b3226
GD
937// If 1, enables provision of run-time type information.
938// NOW MANDATORY: don't change.
939#define wxUSE_DYNAMIC_CLASSES 1
e7549107 940
be7b3226
GD
941// ----------------------------------------------------------------------------
942// disable the settings which don't work for some compilers
943// ----------------------------------------------------------------------------
944
945#ifndef wxUSE_NORLANDER_HEADERS
946#if (defined(__MINGW32__) || defined(__CYGWIN__)) && ((__GNUC__>2) ||((__GNUC__==2) && (__GNUC_MINOR__>=95)))
947# define wxUSE_NORLANDER_HEADERS 1
e7549107 948#else
be7b3226
GD
949# define wxUSE_NORLANDER_HEADERS 0
950#endif
e7549107
SC
951#endif
952
be7b3226
GD
953#if defined(__GNUWIN32__)
954// These don't work as expected for mingw32 and cygwin32
955#undef wxUSE_MEMORY_TRACING
956#define wxUSE_MEMORY_TRACING 0
e7549107 957
be7b3226
GD
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
963
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
970#endif
971
972#endif // __GNUWIN32__
973
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
981#endif // wxUSE_MFC
982
983// ODBC classes aren't Unicode-compatible yet
984#if wxUSE_UNICODE
985#undef wxUSE_ODBC
986#define wxUSE_ODBC 0
987#endif
988
989#if (!defined(WIN32) && !defined(__WIN32__)) || (defined(__GNUWIN32__) && !wxUSE_NORLANDER_HEADERS)
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
1003#if !wxUSE_OWNER_DRAWN
1004#undef wxUSE_CHECKLISTBOX
1005#define wxUSE_CHECKLISTBOX 0
1006#endif
1007
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
e7549107 1012
be7b3226
GD
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
1022#undef wxUSE_OWNER_DRAWN
1023#define wxUSE_OWNER_DRAWN 0
1024#endif // __SALFORDC__
1025
1026#ifdef __TWIN32__
1027
1028#undef wxUSE_THREADS
1029#define wxUSE_THREADS 0
1030
1031#undef wxUSE_ODBC
1032#define wxUSE_ODBC 0
1033
1034#endif // __TWIN32__
1035
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
1040
1041#undef wxUSE_ODBC
1042#define wxUSE_ODBC 0
1043
1044#undef wxUSE_NEW_GRID
1045#define wxUSE_NEW_GRID 0
1046#endif
1047
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
1054// wxUSE_DEBUG_NEW_ALWAYS = 1 not compatible with BC++ in DLL mode
1055#if defined(__BORLANDC__) && (defined(WXMAKINGDLL) || defined(WXUSINGDLL))
1056#undef wxUSE_DEBUG_NEW_ALWAYS
1057#define wxUSE_DEBUG_NEW_ALWAYS 0
1058#endif
1059
1060#if defined(__WXMSW__) && defined(__WATCOMC__)
e7549107 1061/*
be7b3226
GD
1062#undef wxUSE_GLCANVAS
1063#define wxUSE_GLCANVAS 0
1064*/
1065
1066#undef wxUSE_WCHAR_T
1067#define wxUSE_WCHAR_T 0
1068#endif
1069
1070#if defined(__WXMSW__) && !defined(__WIN32__)
1071
1072#undef wxUSE_SOCKETS
1073#define wxUSE_SOCKETS 0
1074
1075#undef wxUSE_THREADS
1076#define wxUSE_THREADS 0
1077
1078#undef wxUSE_TOOLTIPS
1079#define wxUSE_TOOLTIPS 0
1080
1081#undef wxUSE_SPINCTRL
1082#define wxUSE_SPINCTRL 0
e7549107 1083
be7b3226
GD
1084#undef wxUSE_SPINBTN
1085#define wxUSE_SPINBTN 0
1086
1087#undef wxUSE_LIBPNG
1088#define wxUSE_LIBPNG 0
1089
1090#undef wxUSE_LIBJPEG
1091#define wxUSE_LIBJPEG 0
1092
1093#undef wxUSE_LIBTIFF
1094#define wxUSE_LIBTIFF 0
1095
1096#undef wxUSE_GIF
1097#define wxUSE_GIF 0
1098
1099#undef wxUSE_PNM
1100#define wxUSE_PNM 0
1101
1102#undef wxUSE_PCX
1103#define wxUSE_PCX 0
1104
1105#undef wxUSE_GLCANVAS
1106#define wxUSE_GLCANVAS 0
1107
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
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
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
1133#if wxUSE_DATETIME && !wxUSE_LONGLONG
1134 #error wxDateTime requires wxLongLong
1135#endif
1136
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
e7549107 1148
be7b3226 1149// add more tests here...
e7549107 1150
0dbd6262
SC
1151#endif
1152 // _WX_SETUP_H_