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