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