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