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