]> git.saurik.com Git - wxWidgets.git/blame - interface/wx/defs.h
Fix text origin and bounding box computations in wxSVGFileDC.
[wxWidgets.git] / interface / wx / defs.h
CommitLineData
23324ae1 1/////////////////////////////////////////////////////////////////////////////
706068e4 2// Name: wx/defs.h
e54c96f1 3// Purpose: interface of global functions
7c913512
FM
4// Author: wxWidgets team
5// RCS-ID: $Id$
526954c5 6// Licence: wxWindows licence
7c913512
FM
7/////////////////////////////////////////////////////////////////////////////
8
ff7774f1 9
398e3148
FM
10// ----------------------------------------------------------------------------
11// enumerations
12// ----------------------------------------------------------------------------
13
ff7774f1 14/**
99d82720 15 Generic flags.
ff7774f1 16*/
99d82720
FM
17enum wxGeometryCentre
18{
19 wxCENTRE = 0x0001,
20 wxCENTER = wxCENTRE
21};
22
99d82720
FM
23/**
24 A generic orientation value.
25*/
26enum wxOrientation
27{
28 wxHORIZONTAL = 0x0004,
29 wxVERTICAL = 0x0008,
30
31 /**
32 A mask value to indicate both vertical and horizontal orientations.
33 */
34 wxBOTH = wxVERTICAL | wxHORIZONTAL,
35
d13b34d3 36 /// A synonym for @c wxBOTH.
99d82720
FM
37 wxORIENTATION_MASK = wxBOTH
38};
39
40/**
41 A generic direction value.
42*/
43enum wxDirection
44{
45 wxLEFT = 0x0010,
46 wxRIGHT = 0x0020,
47 wxUP = 0x0040,
48 wxDOWN = 0x0080,
49
50 wxTOP = wxUP,
51 wxBOTTOM = wxDOWN,
52
53 wxNORTH = wxUP,
54 wxSOUTH = wxDOWN,
55 wxWEST = wxLEFT,
56 wxEAST = wxRIGHT,
57
58 wxALL = (wxUP | wxDOWN | wxRIGHT | wxLEFT),
59
60 /** A mask to extract direction from the combination of flags. */
61 wxDIRECTION_MASK = wxALL
62};
63
64/**
65 Generic alignment values. Can be combined together.
66*/
67enum wxAlignment
68{
ba0185b5
VZ
69 /**
70 A value different from any valid alignment value.
71
72 Note that you shouldn't use 0 for this as it's the value of (valid)
73 alignments wxALIGN_LEFT and wxALIGN_TOP.
74
75 @since 2.9.1
76 */
77 wxALIGN_INVALID = -1,
78
99d82720
FM
79 wxALIGN_NOT = 0x0000,
80 wxALIGN_CENTER_HORIZONTAL = 0x0100,
81 wxALIGN_CENTRE_HORIZONTAL = wxALIGN_CENTER_HORIZONTAL,
82 wxALIGN_LEFT = wxALIGN_NOT,
83 wxALIGN_TOP = wxALIGN_NOT,
84 wxALIGN_RIGHT = 0x0200,
85 wxALIGN_BOTTOM = 0x0400,
86 wxALIGN_CENTER_VERTICAL = 0x0800,
87 wxALIGN_CENTRE_VERTICAL = wxALIGN_CENTER_VERTICAL,
88
89 wxALIGN_CENTER = (wxALIGN_CENTER_HORIZONTAL | wxALIGN_CENTER_VERTICAL),
90 wxALIGN_CENTRE = wxALIGN_CENTER,
91
92 /** A mask to extract alignment from the combination of flags. */
93 wxALIGN_MASK = 0x0f00
94};
95
96/**
97 Miscellaneous flags for wxSizer items.
98*/
99enum wxSizerFlagBits
100{
101 wxFIXED_MINSIZE = 0x8000,
102 wxRESERVE_SPACE_EVEN_IF_HIDDEN = 0x0002,
103
104 /* a mask to extract wxSizerFlagBits from combination of flags */
105 wxSIZER_FLAG_BITS_MASK = 0x8002
106};
ff7774f1
FM
107
108/**
99d82720 109 Generic stretch values.
ff7774f1 110*/
99d82720
FM
111enum wxStretch
112{
113 wxSTRETCH_NOT = 0x0000,
114 wxSHRINK = 0x1000,
115 wxGROW = 0x2000,
116 wxEXPAND = wxGROW,
117 wxSHAPED = 0x4000,
118 wxTILE = wxSHAPED | wxFIXED_MINSIZE,
119
120 /* a mask to extract stretch from the combination of flags */
121 wxSTRETCH_MASK = 0x7000 /* sans wxTILE */
122};
ff7774f1
FM
123
124/**
99d82720 125 Border flags for wxWindow.
ff7774f1 126*/
99d82720
FM
127enum wxBorder
128{
129 /**
130 This is different from wxBORDER_NONE as by default the controls do have
131 a border.
132 */
133 wxBORDER_DEFAULT = 0,
134
135 wxBORDER_NONE = 0x00200000,
136 wxBORDER_STATIC = 0x01000000,
137 wxBORDER_SIMPLE = 0x02000000,
138 wxBORDER_RAISED = 0x04000000,
139 wxBORDER_SUNKEN = 0x08000000,
140 wxBORDER_DOUBLE = 0x10000000, /* deprecated */
141 wxBORDER_THEME = wxBORDER_DOUBLE,
142
143 /* a mask to extract border style from the combination of flags */
144 wxBORDER_MASK = 0x1f200000
145};
146
ea8fa3c4
RD
147/* ---------------------------------------------------------------------------- */
148/* Possible SetSize flags */
149/* ---------------------------------------------------------------------------- */
150
151/* Use internally-calculated width if -1 */
152#define wxSIZE_AUTO_WIDTH 0x0001
153/* Use internally-calculated height if -1 */
154#define wxSIZE_AUTO_HEIGHT 0x0002
155/* Use internally-calculated width and height if each is -1 */
156#define wxSIZE_AUTO (wxSIZE_AUTO_WIDTH|wxSIZE_AUTO_HEIGHT)
157/* Ignore missing (-1) dimensions (use existing). */
158/* For readability only: test for wxSIZE_AUTO_WIDTH/HEIGHT in code. */
159#define wxSIZE_USE_EXISTING 0x0000
160/* Allow -1 as a valid position */
161#define wxSIZE_ALLOW_MINUS_ONE 0x0004
162/* Don't do parent client adjustments (for implementation only) */
163#define wxSIZE_NO_ADJUSTMENTS 0x0008
164/* Change the window position even if it seems to be already correct */
165#define wxSIZE_FORCE 0x0010
166/* Emit size event even if size didn't change */
167#define wxSIZE_FORCE_EVENT 0x0020
168
8ff9b17d
RD
169/* ---------------------------------------------------------------------------- */
170/* Window style flags */
171/* ---------------------------------------------------------------------------- */
172
173/*
174 * Values are chosen so they can be |'ed in a bit list.
175 * Some styles are used across more than one group,
176 * so the values mustn't clash with others in the group.
177 * Otherwise, numbers can be reused across groups.
178 */
179
180/*
181 Summary of the bits used by various styles.
182
183 High word, containing styles which can be used with many windows:
184
185 +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
186 |31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|
187 +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
188 | | | | | | | | | | | | | | | |
189 | | | | | | | | | | | | | | | \_ wxFULL_REPAINT_ON_RESIZE
190 | | | | | | | | | | | | | | \____ wxPOPUP_WINDOW
191 | | | | | | | | | | | | | \_______ wxWANTS_CHARS
192 | | | | | | | | | | | | \__________ wxTAB_TRAVERSAL
193 | | | | | | | | | | | \_____________ wxTRANSPARENT_WINDOW
194 | | | | | | | | | | \________________ wxBORDER_NONE
195 | | | | | | | | | \___________________ wxCLIP_CHILDREN
196 | | | | | | | | \______________________ wxALWAYS_SHOW_SB
197 | | | | | | | \_________________________ wxBORDER_STATIC
198 | | | | | | \____________________________ wxBORDER_SIMPLE
199 | | | | | \_______________________________ wxBORDER_RAISED
200 | | | | \__________________________________ wxBORDER_SUNKEN
201 | | | \_____________________________________ wxBORDER_{DOUBLE,THEME}
202 | | \________________________________________ wxCAPTION/wxCLIP_SIBLINGS
203 | \___________________________________________ wxHSCROLL
204 \______________________________________________ wxVSCROLL
205
206
207 Low word style bits is class-specific meaning that the same bit can have
208 different meanings for different controls (e.g. 0x10 is wxCB_READONLY
209 meaning that the control can't be modified for wxComboBox but wxLB_SORT
210 meaning that the control should be kept sorted for wxListBox, while
211 wxLB_SORT has a different value -- and this is just fine).
212 */
213
214/*
215 * Window (Frame/dialog/subwindow/panel item) style flags
216 */
217#define wxVSCROLL 0x80000000
218#define wxHSCROLL 0x40000000
219#define wxCAPTION 0x20000000
220
221/* New styles (border styles are now in their own enum) */
222#define wxDOUBLE_BORDER wxBORDER_DOUBLE
223#define wxSUNKEN_BORDER wxBORDER_SUNKEN
224#define wxRAISED_BORDER wxBORDER_RAISED
225#define wxBORDER wxBORDER_SIMPLE
226#define wxSIMPLE_BORDER wxBORDER_SIMPLE
227#define wxSTATIC_BORDER wxBORDER_STATIC
228#define wxNO_BORDER wxBORDER_NONE
229
230/* wxALWAYS_SHOW_SB: instead of hiding the scrollbar when it is not needed, */
231/* disable it - but still show (see also wxLB_ALWAYS_SB style) */
232/* */
233/* NB: as this style is only supported by wxUniversal and wxMSW so far */
234#define wxALWAYS_SHOW_SB 0x00800000
235
236/* Clip children when painting, which reduces flicker in e.g. frames and */
237/* splitter windows, but can't be used in a panel where a static box must be */
238/* 'transparent' (panel paints the background for it) */
239#define wxCLIP_CHILDREN 0x00400000
240
241/* Note we're reusing the wxCAPTION style because we won't need captions */
242/* for subwindows/controls */
243#define wxCLIP_SIBLINGS 0x20000000
244
245#define wxTRANSPARENT_WINDOW 0x00100000
246
247/* Add this style to a panel to get tab traversal working outside of dialogs */
248/* (on by default for wxPanel, wxDialog, wxScrolledWindow) */
249#define wxTAB_TRAVERSAL 0x00080000
250
251/* Add this style if the control wants to get all keyboard messages (under */
252/* Windows, it won't normally get the dialog navigation key events) */
253#define wxWANTS_CHARS 0x00040000
254
255/* Make window retained (Motif only, see src/generic/scrolwing.cpp)
256 * This is non-zero only under wxMotif, to avoid a clash with wxPOPUP_WINDOW
257 * on other platforms
258 */
259
260#ifdef __WXMOTIF__
261#define wxRETAINED 0x00020000
262#else
263#define wxRETAINED 0x00000000
264#endif
265#define wxBACKINGSTORE wxRETAINED
266
267/* set this flag to create a special popup window: it will be always shown on */
268/* top of other windows, will capture the mouse and will be dismissed when the */
269/* mouse is clicked outside of it or if it loses focus in any other way */
270#define wxPOPUP_WINDOW 0x00020000
271
272/* force a full repaint when the window is resized (instead of repainting just */
273/* the invalidated area) */
274#define wxFULL_REPAINT_ON_RESIZE 0x00010000
275
276/* obsolete: now this is the default behaviour */
277/* */
278/* don't invalidate the whole window (resulting in a PAINT event) when the */
279/* window is resized (currently, makes sense for wxMSW only) */
280#define wxNO_FULL_REPAINT_ON_RESIZE 0
281
282/* A mask which can be used to filter (out) all wxWindow-specific styles.
283 */
284#define wxWINDOW_STYLE_MASK \
285 (wxVSCROLL|wxHSCROLL|wxBORDER_MASK|wxALWAYS_SHOW_SB|wxCLIP_CHILDREN| \
286 wxCLIP_SIBLINGS|wxTRANSPARENT_WINDOW|wxTAB_TRAVERSAL|wxWANTS_CHARS| \
287 wxRETAINED|wxPOPUP_WINDOW|wxFULL_REPAINT_ON_RESIZE)
288
289/*
290 * Extra window style flags (use wxWS_EX prefix to make it clear that they
291 * should be passed to wxWindow::SetExtraStyle(), not SetWindowStyle())
292 */
293
294/* by default, TransferDataTo/FromWindow() only work on direct children of the */
295/* window (compatible behaviour), set this flag to make them recursively */
296/* descend into all subwindows */
297#define wxWS_EX_VALIDATE_RECURSIVELY 0x00000001
298
299/* wxCommandEvents and the objects of the derived classes are forwarded to the */
300/* parent window and so on recursively by default. Using this flag for the */
301/* given window allows to block this propagation at this window, i.e. prevent */
302/* the events from being propagated further upwards. The dialogs have this */
303/* flag on by default. */
304#define wxWS_EX_BLOCK_EVENTS 0x00000002
305
306/* don't use this window as an implicit parent for the other windows: this must */
307/* be used with transient windows as otherwise there is the risk of creating a */
308/* dialog/frame with this window as a parent which would lead to a crash if the */
309/* parent is destroyed before the child */
310#define wxWS_EX_TRANSIENT 0x00000004
311
312/* don't paint the window background, we'll assume it will */
313/* be done by a theming engine. This is not yet used but could */
314/* possibly be made to work in the future, at least on Windows */
315#define wxWS_EX_THEMED_BACKGROUND 0x00000008
316
317/* this window should always process idle events */
318#define wxWS_EX_PROCESS_IDLE 0x00000010
319
320/* this window should always process UI update events */
321#define wxWS_EX_PROCESS_UI_UPDATES 0x00000020
322
323/* Draw the window in a metal theme on Mac */
324#define wxFRAME_EX_METAL 0x00000040
325#define wxDIALOG_EX_METAL 0x00000040
326
327/* Use this style to add a context-sensitive help to the window (currently for */
328/* Win32 only and it doesn't work if wxMINIMIZE_BOX or wxMAXIMIZE_BOX are used) */
329#define wxWS_EX_CONTEXTHELP 0x00000080
330
331/* synonyms for wxWS_EX_CONTEXTHELP for compatibility */
332#define wxFRAME_EX_CONTEXTHELP wxWS_EX_CONTEXTHELP
333#define wxDIALOG_EX_CONTEXTHELP wxWS_EX_CONTEXTHELP
334
335/* Create a window which is attachable to another top level window */
336#define wxFRAME_DRAWER 0x0020
337
338/*
339 * MDI parent frame style flags
340 * Can overlap with some of the above.
341 */
342
343#define wxFRAME_NO_WINDOW_MENU 0x0100
344
345/*
346 * wxMenuBar style flags
347 */
348/* use native docking */
349#define wxMB_DOCKABLE 0x0001
350
351/*
352 * wxMenu style flags
353 */
354#define wxMENU_TEAROFF 0x0001
355
356/*
357 * Apply to all panel items
358 */
359#define wxCOLOURED 0x0800
360#define wxFIXED_LENGTH 0x0400
361
362/*
363 * Styles for wxListBox
364 */
365#define wxLB_SORT 0x0010
366#define wxLB_SINGLE 0x0020
367#define wxLB_MULTIPLE 0x0040
368#define wxLB_EXTENDED 0x0080
369/* wxLB_OWNERDRAW is Windows-only */
370#define wxLB_NEEDED_SB 0x0000
371#define wxLB_OWNERDRAW 0x0100
372#define wxLB_ALWAYS_SB 0x0200
373#define wxLB_NO_SB 0x0400
374#define wxLB_HSCROLL wxHSCROLL
375/* always show an entire number of rows */
376#define wxLB_INT_HEIGHT 0x0800
377
378/*
379 * wxComboBox style flags
380 */
381#define wxCB_SIMPLE 0x0004
382#define wxCB_SORT 0x0008
383#define wxCB_READONLY 0x0010
384#define wxCB_DROPDOWN 0x0020
385
386/*
387 * wxRadioBox style flags
388 */
389/* should we number the items from left to right or from top to bottom in a 2d */
390/* radiobox? */
391#define wxRA_LEFTTORIGHT 0x0001
392#define wxRA_TOPTOBOTTOM 0x0002
393
394/* New, more intuitive names to specify majorDim argument */
395#define wxRA_SPECIFY_COLS wxHORIZONTAL
396#define wxRA_SPECIFY_ROWS wxVERTICAL
397
398/* Old names for compatibility */
399#define wxRA_HORIZONTAL wxHORIZONTAL
400#define wxRA_VERTICAL wxVERTICAL
8ff9b17d
RD
401
402/*
403 * wxRadioButton style flag
404 */
405#define wxRB_GROUP 0x0004
406#define wxRB_SINGLE 0x0008
8ff9b17d
RD
407
408/*
409 * wxScrollBar flags
410 */
411#define wxSB_HORIZONTAL wxHORIZONTAL
412#define wxSB_VERTICAL wxVERTICAL
413
414/*
415 * wxSpinButton flags.
416 * Note that a wxSpinCtrl is sometimes defined as a wxTextCtrl, and so the
417 * flags shouldn't overlap with wxTextCtrl flags that can be used for a single
418 * line controls (currently we reuse wxTE_CHARWRAP and wxTE_RICH2 neither of
419 * which makes sense for them).
420 */
421#define wxSP_HORIZONTAL wxHORIZONTAL /* 4 */
422#define wxSP_VERTICAL wxVERTICAL /* 8 */
423#define wxSP_ARROW_KEYS 0x4000
424#define wxSP_WRAP 0x8000
425
426/*
427 * wxTabCtrl flags
428 */
429#define wxTC_RIGHTJUSTIFY 0x0010
430#define wxTC_FIXEDWIDTH 0x0020
431#define wxTC_TOP 0x0000 /* default */
432#define wxTC_LEFT 0x0020
433#define wxTC_RIGHT 0x0040
434#define wxTC_BOTTOM 0x0080
435#define wxTC_MULTILINE 0x0200 /* == wxNB_MULTILINE */
436#define wxTC_OWNERDRAW 0x0400
437
438/*
439 * wxStaticBitmap flags
440 */
441#define wxBI_EXPAND wxEXPAND
442
443/*
444 * wxStaticLine flags
445 */
446#define wxLI_HORIZONTAL wxHORIZONTAL
447#define wxLI_VERTICAL wxVERTICAL
448
449
450/*
451 * extended dialog specifiers. these values are stored in a different
452 * flag and thus do not overlap with other style flags. note that these
453 * values do not correspond to the return values of the dialogs (for
454 * those values, look at the wxID_XXX defines).
455 */
456
457/* wxCENTRE already defined as 0x00000001 */
458#define wxYES 0x00000002
459#define wxOK 0x00000004
460#define wxNO 0x00000008
461#define wxYES_NO (wxYES | wxNO)
462#define wxCANCEL 0x00000010
463#define wxAPPLY 0x00000020
464#define wxCLOSE 0x00000040
465
466#define wxOK_DEFAULT 0x00000000 /* has no effect (default) */
467#define wxYES_DEFAULT 0x00000000 /* has no effect (default) */
468#define wxNO_DEFAULT 0x00000080 /* only valid with wxYES_NO */
469#define wxCANCEL_DEFAULT 0x80000000 /* only valid with wxCANCEL */
470
471#define wxICON_EXCLAMATION 0x00000100
472#define wxICON_HAND 0x00000200
473#define wxICON_WARNING wxICON_EXCLAMATION
474#define wxICON_ERROR wxICON_HAND
475#define wxICON_QUESTION 0x00000400
476#define wxICON_INFORMATION 0x00000800
477#define wxICON_STOP wxICON_HAND
478#define wxICON_ASTERISK wxICON_INFORMATION
479
e65ae1d3
VZ
480#define wxHELP 0x00001000
481#define wxFORWARD 0x00002000
482#define wxBACKWARD 0x00004000
483#define wxRESET 0x00008000
484#define wxMORE 0x00010000
485#define wxSETUP 0x00020000
8ff9b17d
RD
486#define wxICON_NONE 0x00040000
487
488#define wxICON_MASK \
489 (wxICON_EXCLAMATION|wxICON_HAND|wxICON_QUESTION|wxICON_INFORMATION|wxICON_NONE)
490
99d82720 491
e9321277
RD
492/* symbolic constant used by all Find()-like functions returning positive */
493/* integer on success as failure indicator */
494#define wxNOT_FOUND (-1)
495
99d82720 496/**
9c61c5b0
VZ
497 Background styles.
498
499 @see wxWindow::SetBackgroundStyle()
99d82720
FM
500*/
501enum wxBackgroundStyle
502{
9c61c5b0
VZ
503 /**
504 Default background style value indicating that the background may be
505 erased in the user-defined EVT_ERASE_BACKGROUND handler.
506
507 If no such handler is defined (or if it skips the event), the effect of
508 this style is the same as wxBG_STYLE_SYSTEM. If an empty handler (@em
509 not skipping the event) is defined, the effect is the same as
510 wxBG_STYLE_PAINT, i.e. the background is not erased at all until
511 EVT_PAINT handler is executed.
512
513 This is the only background style value for which erase background
514 events are generated at all.
515 */
516 wxBG_STYLE_ERASE,
517
518 /**
519 Use the default background, as determined by the system or the current
520 theme.
521
522 If the window has been assigned a non-default background colour, it
523 will be used for erasing its background. Otherwise the default
524 background (which might be a gradient or a pattern) will be used.
525
526 EVT_ERASE_BACKGROUND event will not be generated at all for windows
527 with this style.
528 */
99d82720
FM
529 wxBG_STYLE_SYSTEM,
530
9c61c5b0
VZ
531 /**
532 Indicates that the background is only erased in the user-defined
533 EVT_PAINT handler.
99d82720 534
9c61c5b0
VZ
535 Using this style avoids flicker which would result from redrawing the
536 background twice if the EVT_PAINT handler entirely overwrites it. It
537 must not be used however if the paint handler leaves any parts of the
538 window unpainted as their contents is then undetermined. Only use it if
539 you repaint the whole window in your handler.
99d82720 540
9c61c5b0
VZ
541 EVT_ERASE_BACKGROUND event will not be generated at all for windows
542 with this style.
543 */
e9321277
RD
544 wxBG_STYLE_PAINT,
545
546 /* this style is deprecated and doesn't do anything, don't use */
547 wxBG_STYLE_COLOUR,
548
14421681
VZ
549 /**
550 Indicates that the window background is not erased, letting the parent
551 window show through.
e9321277 552
14421681
VZ
553 Currently this style is only supported in wxOSX and wxGTK with
554 compositing available, see wxWindow::IsTransparentBackgroundSupported().
555 */
556 wxBG_STYLE_TRANSPARENT,
99d82720
FM
557};
558
559
560/**
f3b21e12
VZ
561 Standard IDs.
562
563 Notice that some, but @em not all, of these IDs are also stock IDs, i.e.
564 you can use them for the button or menu items without specifying the label
38ea03c9
FM
565 which will be provided by the underlying platform itself. See @ref page_stockitems "the
566 list of stock items" for the subset of standard IDs which are stock IDs as well.
99d82720
FM
567*/
568enum wxStandardID
569{
570 /**
571 This id delimits the lower bound of the range used by automatically-generated ids
572 (i.e. those used when wxID_ANY is specified during construction).
573 */
574 wxID_AUTO_LOWEST,
575
576 /**
577 This id delimits the upper bound of the range used by automatically-generated ids
578 (i.e. those used when wxID_ANY is specified during construction).
579 */
580 wxID_AUTO_HIGHEST,
581
582 /**
583 No id matches this one when compared to it.
584 */
585 wxID_NONE = -3,
586
587 /**
588 Id for a separator line in the menu (invalid for normal item).
589 */
590 wxID_SEPARATOR = -2,
591
592 /**
593 Any id: means that we don't care about the id, whether when installing
594 an event handler or when creating a new window.
595 */
596 wxID_ANY = -1,
597
598 wxID_LOWEST = 4999,
599
600 wxID_OPEN,
601 wxID_CLOSE,
602 wxID_NEW,
603 wxID_SAVE,
604 wxID_SAVEAS,
605 wxID_REVERT,
606 wxID_EXIT,
607 wxID_UNDO,
608 wxID_REDO,
609 wxID_HELP,
610 wxID_PRINT,
611 wxID_PRINT_SETUP,
612 wxID_PAGE_SETUP,
613 wxID_PREVIEW,
614 wxID_ABOUT,
615 wxID_HELP_CONTENTS,
616 wxID_HELP_INDEX,
617 wxID_HELP_SEARCH,
618 wxID_HELP_COMMANDS,
619 wxID_HELP_PROCEDURES,
620 wxID_HELP_CONTEXT,
621 wxID_CLOSE_ALL,
622 wxID_PREFERENCES,
623
624 wxID_EDIT = 5030,
625 wxID_CUT,
626 wxID_COPY,
627 wxID_PASTE,
628 wxID_CLEAR,
629 wxID_FIND,
630 wxID_DUPLICATE,
631 wxID_SELECTALL,
632 wxID_DELETE,
633 wxID_REPLACE,
634 wxID_REPLACE_ALL,
635 wxID_PROPERTIES,
636
637 wxID_VIEW_DETAILS,
638 wxID_VIEW_LARGEICONS,
639 wxID_VIEW_SMALLICONS,
640 wxID_VIEW_LIST,
641 wxID_VIEW_SORTDATE,
642 wxID_VIEW_SORTNAME,
643 wxID_VIEW_SORTSIZE,
644 wxID_VIEW_SORTTYPE,
645
646 wxID_FILE = 5050,
647 wxID_FILE1,
648 wxID_FILE2,
649 wxID_FILE3,
650 wxID_FILE4,
651 wxID_FILE5,
652 wxID_FILE6,
653 wxID_FILE7,
654 wxID_FILE8,
655 wxID_FILE9,
656
657 /** Standard button and menu IDs */
658 wxID_OK = 5100,
659 wxID_CANCEL,
660 wxID_APPLY,
661 wxID_YES,
662 wxID_NO,
663 wxID_STATIC,
664 wxID_FORWARD,
665 wxID_BACKWARD,
666 wxID_DEFAULT,
667 wxID_MORE,
668 wxID_SETUP,
669 wxID_RESET,
670 wxID_CONTEXT_HELP,
671 wxID_YESTOALL,
672 wxID_NOTOALL,
673 wxID_ABORT,
674 wxID_RETRY,
675 wxID_IGNORE,
676 wxID_ADD,
677 wxID_REMOVE,
678
679 wxID_UP,
680 wxID_DOWN,
681 wxID_HOME,
682 wxID_REFRESH,
683 wxID_STOP,
684 wxID_INDEX,
685
686 wxID_BOLD,
687 wxID_ITALIC,
688 wxID_JUSTIFY_CENTER,
689 wxID_JUSTIFY_FILL,
690 wxID_JUSTIFY_RIGHT,
691 wxID_JUSTIFY_LEFT,
692 wxID_UNDERLINE,
693 wxID_INDENT,
694 wxID_UNINDENT,
695 wxID_ZOOM_100,
696 wxID_ZOOM_FIT,
697 wxID_ZOOM_IN,
698 wxID_ZOOM_OUT,
699 wxID_UNDELETE,
700 wxID_REVERT_TO_SAVED,
701 wxID_CDROM,
702 wxID_CONVERT,
703 wxID_EXECUTE,
704 wxID_FLOPPY,
705 wxID_HARDDISK,
706 wxID_BOTTOM,
707 wxID_FIRST,
708 wxID_LAST,
709 wxID_TOP,
710 wxID_INFO,
711 wxID_JUMP_TO,
712 wxID_NETWORK,
713 wxID_SELECT_COLOR,
714 wxID_SELECT_FONT,
715 wxID_SORT_ASCENDING,
716 wxID_SORT_DESCENDING,
717 wxID_SPELL_CHECK,
718 wxID_STRIKETHROUGH,
719
720 /** System menu IDs (used by wxUniv): */
721 wxID_SYSTEM_MENU = 5200,
722 wxID_CLOSE_FRAME,
723 wxID_MOVE_FRAME,
724 wxID_RESIZE_FRAME,
725 wxID_MAXIMIZE_FRAME,
726 wxID_ICONIZE_FRAME,
727 wxID_RESTORE_FRAME,
728
729 /** MDI window menu ids */
730 wxID_MDI_WINDOW_FIRST = 5230,
731 wxID_MDI_WINDOW_CASCADE = wxID_MDI_WINDOW_FIRST,
732 wxID_MDI_WINDOW_TILE_HORZ,
733 wxID_MDI_WINDOW_TILE_VERT,
734 wxID_MDI_WINDOW_ARRANGE_ICONS,
735 wxID_MDI_WINDOW_PREV,
736 wxID_MDI_WINDOW_NEXT,
737 wxID_MDI_WINDOW_LAST = wxID_MDI_WINDOW_NEXT,
738
739 /** IDs used by generic file dialog (13 consecutive starting from this value) */
740 wxID_FILEDLGG = 5900,
741
742 /** IDs used by generic file ctrl (4 consecutive starting from this value) */
743 wxID_FILECTRL = 5950,
744
745 wxID_HIGHEST = 5999
746};
ff7774f1 747
f992f2ae
BP
748/**
749 Item kinds for use with wxMenu, wxMenuItem, and wxToolBar.
706068e4 750
f992f2ae
BP
751 @see wxMenu::Append(), wxMenuItem::wxMenuItem(), wxToolBar::AddTool()
752*/
753enum wxItemKind
754{
755 wxITEM_SEPARATOR = -1,
756
757 /**
758 Normal tool button / menu item.
759
760 @see wxToolBar::AddTool(), wxMenu::AppendItem().
761 */
762 wxITEM_NORMAL,
763
764 /**
765 Check (or toggle) tool button / menu item.
766
767 @see wxToolBar::AddCheckTool(), wxMenu::AppendCheckItem().
768 */
769 wxITEM_CHECK,
770
771 /**
772 Radio tool button / menu item.
773
774 @see wxToolBar::AddRadioTool(), wxMenu::AppendRadioItem().
775 */
776 wxITEM_RADIO,
777
778 /**
779 Normal tool button with a dropdown arrow next to it. Clicking the
780 dropdown arrow sends a @c wxEVT_COMMAND_TOOL_DROPDOWN_CLICKED event and may
781 also display the menu previously associated with the item with
782 wxToolBar::SetDropdownMenu(). Currently this type of tools is supported
783 under MSW and GTK.
784 */
785 wxITEM_DROPDOWN,
786
787 wxITEM_MAX
788};
789
99d82720
FM
790/**
791 Generic hit test results.
792*/
793enum wxHitTest
794{
795 wxHT_NOWHERE,
796
797 /* scrollbar */
798 wxHT_SCROLLBAR_FIRST = wxHT_NOWHERE,
799 wxHT_SCROLLBAR_ARROW_LINE_1, /**< left or upper arrow to scroll by line */
800 wxHT_SCROLLBAR_ARROW_LINE_2, /**< right or down */
801 wxHT_SCROLLBAR_ARROW_PAGE_1, /**< left or upper arrow to scroll by page */
802 wxHT_SCROLLBAR_ARROW_PAGE_2, /**< right or down */
803 wxHT_SCROLLBAR_THUMB, /**< on the thumb */
804 wxHT_SCROLLBAR_BAR_1, /**< bar to the left/above the thumb */
805 wxHT_SCROLLBAR_BAR_2, /**< bar to the right/below the thumb */
806 wxHT_SCROLLBAR_LAST,
807
808 /* window */
809 wxHT_WINDOW_OUTSIDE, /**< not in this window at all */
810 wxHT_WINDOW_INSIDE, /**< in the client area */
811 wxHT_WINDOW_VERT_SCROLLBAR, /**< on the vertical scrollbar */
812 wxHT_WINDOW_HORZ_SCROLLBAR, /**< on the horizontal scrollbar */
813 wxHT_WINDOW_CORNER, /**< on the corner between 2 scrollbars */
814
815 wxHT_MAX
816};
817
818/**
819 Data format IDs used by wxDataFormat.
820*/
821enum wxDataFormatId
822{
823 wxDF_INVALID = 0,
824 wxDF_TEXT = 1, /* CF_TEXT */
825 wxDF_BITMAP = 2, /* CF_BITMAP */
826 wxDF_METAFILE = 3, /* CF_METAFILEPICT */
827 wxDF_SYLK = 4,
828 wxDF_DIF = 5,
829 wxDF_TIFF = 6,
830 wxDF_OEMTEXT = 7, /* CF_OEMTEXT */
831 wxDF_DIB = 8, /* CF_DIB */
832 wxDF_PALETTE = 9,
833 wxDF_PENDATA = 10,
834 wxDF_RIFF = 11,
835 wxDF_WAVE = 12,
836 wxDF_UNICODETEXT = 13,
837 wxDF_ENHMETAFILE = 14,
838 wxDF_FILENAME = 15, /* CF_HDROP */
839 wxDF_LOCALE = 16,
840 wxDF_PRIVATE = 20,
841 wxDF_HTML = 30, /* Note: does not correspond to CF_ constant */
842 wxDF_MAX
843};
844
845/**
398e3148
FM
846 Virtual keycodes used by wxKeyEvent and some other wxWidgets functions.
847
86408a03
VZ
848 Note that the range <code>0..255</code> corresponds to the characters of
849 the current locale, in particular the <code>32..127</code> subrange is for
850 the ASCII symbols, and all the special key values such as @c WXK_END lie
851 above this range.
99d82720
FM
852*/
853enum wxKeyCode
854{
86408a03
VZ
855 /**
856 No key.
857
858 This value is returned by wxKeyEvent::GetKeyCode() if there is no
859 non-Unicode representation for the pressed key (e.g. a Cyrillic letter
860 was entered when not using a Cyrillic locale) and by
861 wxKeyEvent::GetUnicodeKey() if there is no Unicode representation for
862 the key (this happens for the special, non printable, keys only, e.g.
863 WXK_HOME).
864
865 @since 2.9.2 (you can simply use 0 with previous versions).
866 */
867 WXK_NONE = 0,
868
398e3148 869 WXK_BACK = 8, //!< Backspace.
99d82720
FM
870 WXK_TAB = 9,
871 WXK_RETURN = 13,
872 WXK_ESCAPE = 27,
873 WXK_SPACE = 32,
398e3148 874
99d82720
FM
875 WXK_DELETE = 127,
876
877 /**
86408a03
VZ
878 Special key values.
879
880 These are, by design, not compatible with Unicode characters.
881 If you want to get a Unicode character from a key event, use
882 wxKeyEvent::GetUnicodeKey() instead.
99d82720
FM
883 */
884 WXK_START = 300,
885 WXK_LBUTTON,
886 WXK_RBUTTON,
887 WXK_CANCEL,
888 WXK_MBUTTON,
889 WXK_CLEAR,
890 WXK_SHIFT,
891 WXK_ALT,
606e0968
SC
892 /** Note that under Mac OS X, to improve compatibility with other
893 * systems, 'WXK_CONTROL' represents the 'Command' key. Use this
894 * constant to work with keyboard shortcuts. See 'WXK_RAW_CONTROL'
895 * to get the state of the actual 'Control' key.
896 */
99d82720 897 WXK_CONTROL,
606e0968
SC
898 /** Under Mac OS X, where the 'Command' key is mapped to 'Control'
899 * to improve compatibility with other systems, WXK_RAW_CONTROL may
900 * be used to obtain the state of the actual 'Control' key
901 * ('WXK_CONTROL' would obtain the status of the 'Command' key).
d9384bfb 902 * Under Windows/Linux/Others, this is equivalent to WXK_CONTROL
606e0968
SC
903 */
904 WXK_RAW_CONTROL,
99d82720
FM
905 WXK_MENU,
906 WXK_PAUSE,
907 WXK_CAPITAL,
908 WXK_END,
909 WXK_HOME,
910 WXK_LEFT,
911 WXK_UP,
912 WXK_RIGHT,
913 WXK_DOWN,
914 WXK_SELECT,
915 WXK_PRINT,
916 WXK_EXECUTE,
917 WXK_SNAPSHOT,
918 WXK_INSERT,
919 WXK_HELP,
920 WXK_NUMPAD0,
921 WXK_NUMPAD1,
922 WXK_NUMPAD2,
923 WXK_NUMPAD3,
924 WXK_NUMPAD4,
925 WXK_NUMPAD5,
926 WXK_NUMPAD6,
927 WXK_NUMPAD7,
928 WXK_NUMPAD8,
929 WXK_NUMPAD9,
930 WXK_MULTIPLY,
931 WXK_ADD,
932 WXK_SEPARATOR,
933 WXK_SUBTRACT,
934 WXK_DECIMAL,
935 WXK_DIVIDE,
936 WXK_F1,
937 WXK_F2,
938 WXK_F3,
939 WXK_F4,
940 WXK_F5,
941 WXK_F6,
942 WXK_F7,
943 WXK_F8,
944 WXK_F9,
945 WXK_F10,
946 WXK_F11,
947 WXK_F12,
948 WXK_F13,
949 WXK_F14,
950 WXK_F15,
951 WXK_F16,
952 WXK_F17,
953 WXK_F18,
954 WXK_F19,
955 WXK_F20,
956 WXK_F21,
957 WXK_F22,
958 WXK_F23,
959 WXK_F24,
960 WXK_NUMLOCK,
961 WXK_SCROLL,
962 WXK_PAGEUP,
963 WXK_PAGEDOWN,
964
965 WXK_NUMPAD_SPACE,
966 WXK_NUMPAD_TAB,
967 WXK_NUMPAD_ENTER,
968 WXK_NUMPAD_F1,
969 WXK_NUMPAD_F2,
970 WXK_NUMPAD_F3,
971 WXK_NUMPAD_F4,
972 WXK_NUMPAD_HOME,
973 WXK_NUMPAD_LEFT,
974 WXK_NUMPAD_UP,
975 WXK_NUMPAD_RIGHT,
976 WXK_NUMPAD_DOWN,
977 WXK_NUMPAD_PAGEUP,
978 WXK_NUMPAD_PAGEDOWN,
979 WXK_NUMPAD_END,
980 WXK_NUMPAD_BEGIN,
981 WXK_NUMPAD_INSERT,
982 WXK_NUMPAD_DELETE,
983 WXK_NUMPAD_EQUAL,
984 WXK_NUMPAD_MULTIPLY,
985 WXK_NUMPAD_ADD,
986 WXK_NUMPAD_SEPARATOR,
987 WXK_NUMPAD_SUBTRACT,
988 WXK_NUMPAD_DECIMAL,
989 WXK_NUMPAD_DIVIDE,
990
991 /** The following key codes are only generated under Windows currently */
992 WXK_WINDOWS_LEFT,
993 WXK_WINDOWS_RIGHT,
994 WXK_WINDOWS_MENU ,
606e0968
SC
995
996 /** This special key code was used to represent the key used for keyboard shortcuts. Under Mac OS X,
997 * this key maps to the 'Command' (aka logo or 'Apple') key, whereas on Linux/Windows/others
998 * this is the Control key, with the new semantic of WXK_CONTROL, WXK_COMMAND is not needed anymore
999 */
99d82720
FM
1000 WXK_COMMAND,
1001
1002 /** Hardware-specific buttons */
1003 WXK_SPECIAL1 = 193,
1004 WXK_SPECIAL2,
1005 WXK_SPECIAL3,
1006 WXK_SPECIAL4,
1007 WXK_SPECIAL5,
1008 WXK_SPECIAL6,
1009 WXK_SPECIAL7,
1010 WXK_SPECIAL8,
1011 WXK_SPECIAL9,
1012 WXK_SPECIAL10,
1013 WXK_SPECIAL11,
1014 WXK_SPECIAL12,
1015 WXK_SPECIAL13,
1016 WXK_SPECIAL14,
1017 WXK_SPECIAL15,
1018 WXK_SPECIAL16,
1019 WXK_SPECIAL17,
1020 WXK_SPECIAL18,
1021 WXK_SPECIAL19,
1022 WXK_SPECIAL20
1023};
1024
1025/**
1026 This enum contains bit mask constants used in wxKeyEvent.
1027*/
1028enum wxKeyModifier
1029{
1030 wxMOD_NONE = 0x0000,
1031 wxMOD_ALT = 0x0001,
cfc77ac0 1032 /** Ctlr Key, corresponds to Command key on OS X */
99d82720
FM
1033 wxMOD_CONTROL = 0x0002,
1034 wxMOD_ALTGR = wxMOD_ALT | wxMOD_CONTROL,
1035 wxMOD_SHIFT = 0x0004,
1036 wxMOD_META = 0x0008,
1037 wxMOD_WIN = wxMOD_META,
cfc77ac0
SC
1038
1039 /** used to describe the true Ctrl Key under OSX,
1040 identic to @c wxMOD_CONTROL on other platforms */
1041 wxMOD_RAW_CONTROL,
1042
1043 /** deprecated, identic to @c wxMOD_CONTROL on all platforms */
1044 wxMOD_CMD = wxMOD_CONTROL,
99d82720
FM
1045 wxMOD_ALL = 0xffff
1046};
f992f2ae 1047
d18d9f60
BP
1048/**
1049 Paper size types for use with the printing framework.
1050
1051 @see overview_printing, wxPrintData::SetPaperId()
1052*/
1053enum wxPaperSize
1054{
1055 wxPAPER_NONE, ///< Use specific dimensions
1056 wxPAPER_LETTER, ///< Letter, 8 1/2 by 11 inches
1057 wxPAPER_LEGAL, ///< Legal, 8 1/2 by 14 inches
1058 wxPAPER_A4, ///< A4 Sheet, 210 by 297 millimeters
1059 wxPAPER_CSHEET, ///< C Sheet, 17 by 22 inches
1060 wxPAPER_DSHEET, ///< D Sheet, 22 by 34 inches
1061 wxPAPER_ESHEET, ///< E Sheet, 34 by 44 inches
1062 wxPAPER_LETTERSMALL, ///< Letter Small, 8 1/2 by 11 inches
1063 wxPAPER_TABLOID, ///< Tabloid, 11 by 17 inches
1064 wxPAPER_LEDGER, ///< Ledger, 17 by 11 inches
1065 wxPAPER_STATEMENT, ///< Statement, 5 1/2 by 8 1/2 inches
1066 wxPAPER_EXECUTIVE, ///< Executive, 7 1/4 by 10 1/2 inches
1067 wxPAPER_A3, ///< A3 sheet, 297 by 420 millimeters
1068 wxPAPER_A4SMALL, ///< A4 small sheet, 210 by 297 millimeters
1069 wxPAPER_A5, ///< A5 sheet, 148 by 210 millimeters
1070 wxPAPER_B4, ///< B4 sheet, 250 by 354 millimeters
1071 wxPAPER_B5, ///< B5 sheet, 182-by-257-millimeter paper
1072 wxPAPER_FOLIO, ///< Folio, 8-1/2-by-13-inch paper
1073 wxPAPER_QUARTO, ///< Quarto, 215-by-275-millimeter paper
1074 wxPAPER_10X14, ///< 10-by-14-inch sheet
1075 wxPAPER_11X17, ///< 11-by-17-inch sheet
1076 wxPAPER_NOTE, ///< Note, 8 1/2 by 11 inches
1077 wxPAPER_ENV_9, ///< #9 Envelope, 3 7/8 by 8 7/8 inches
1078 wxPAPER_ENV_10, ///< #10 Envelope, 4 1/8 by 9 1/2 inches
1079 wxPAPER_ENV_11, ///< #11 Envelope, 4 1/2 by 10 3/8 inches
1080 wxPAPER_ENV_12, ///< #12 Envelope, 4 3/4 by 11 inches
1081 wxPAPER_ENV_14, ///< #14 Envelope, 5 by 11 1/2 inches
1082 wxPAPER_ENV_DL, ///< DL Envelope, 110 by 220 millimeters
1083 wxPAPER_ENV_C5, ///< C5 Envelope, 162 by 229 millimeters
1084 wxPAPER_ENV_C3, ///< C3 Envelope, 324 by 458 millimeters
1085 wxPAPER_ENV_C4, ///< C4 Envelope, 229 by 324 millimeters
1086 wxPAPER_ENV_C6, ///< C6 Envelope, 114 by 162 millimeters
1087 wxPAPER_ENV_C65, ///< C65 Envelope, 114 by 229 millimeters
1088 wxPAPER_ENV_B4, ///< B4 Envelope, 250 by 353 millimeters
1089 wxPAPER_ENV_B5, ///< B5 Envelope, 176 by 250 millimeters
1090 wxPAPER_ENV_B6, ///< B6 Envelope, 176 by 125 millimeters
1091 wxPAPER_ENV_ITALY, ///< Italy Envelope, 110 by 230 millimeters
1092 wxPAPER_ENV_MONARCH, ///< Monarch Envelope, 3 7/8 by 7 1/2 inches
1093 wxPAPER_ENV_PERSONAL, ///< 6 3/4 Envelope, 3 5/8 by 6 1/2 inches
1094 wxPAPER_FANFOLD_US, ///< US Std Fanfold, 14 7/8 by 11 inches
1095 wxPAPER_FANFOLD_STD_GERMAN, ///< German Std Fanfold, 8 1/2 by 12 inches
1096 wxPAPER_FANFOLD_LGL_GERMAN, ///< German Legal Fanfold, 8 1/2 by 13 inches
1097
bb69632a 1098 // wxMSW Only
d18d9f60
BP
1099
1100 wxPAPER_ISO_B4, ///< B4 (ISO) 250 x 353 mm
1101 wxPAPER_JAPANESE_POSTCARD, ///< Japanese Postcard 100 x 148 mm
1102 wxPAPER_9X11, ///< 9 x 11 in
1103 wxPAPER_10X11, ///< 10 x 11 in
1104 wxPAPER_15X11, ///< 15 x 11 in
1105 wxPAPER_ENV_INVITE, ///< Envelope Invite 220 x 220 mm
4050e98d
BP
1106 wxPAPER_LETTER_EXTRA, ///< Letter Extra 9.5 x 12 in
1107 wxPAPER_LEGAL_EXTRA, ///< Legal Extra 9.5 x 15 in
d18d9f60
BP
1108 wxPAPER_TABLOID_EXTRA, ///< Tabloid Extra 11.69 x 18 in
1109 wxPAPER_A4_EXTRA, ///< A4 Extra 9.27 x 12.69 in
4050e98d 1110 wxPAPER_LETTER_TRANSVERSE, ///< Letter Transverse 8.5 x 11 in
d18d9f60 1111 wxPAPER_A4_TRANSVERSE, ///< A4 Transverse 210 x 297 mm
4050e98d 1112 wxPAPER_LETTER_EXTRA_TRANSVERSE, ///< Letter Extra Transverse 9.5 x 12 in
d18d9f60
BP
1113 wxPAPER_A_PLUS, ///< SuperA/SuperA/A4 227 x 356 mm
1114 wxPAPER_B_PLUS, ///< SuperB/SuperB/A3 305 x 487 mm
1115 wxPAPER_LETTER_PLUS, ///< Letter Plus 8.5 x 12.69 in
1116 wxPAPER_A4_PLUS, ///< A4 Plus 210 x 330 mm
1117 wxPAPER_A5_TRANSVERSE, ///< A5 Transverse 148 x 210 mm
1118 wxPAPER_B5_TRANSVERSE, ///< B5 (JIS) Transverse 182 x 257 mm
1119 wxPAPER_A3_EXTRA, ///< A3 Extra 322 x 445 mm
1120 wxPAPER_A5_EXTRA, ///< A5 Extra 174 x 235 mm
1121 wxPAPER_B5_EXTRA, ///< B5 (ISO) Extra 201 x 276 mm
1122 wxPAPER_A2, ///< A2 420 x 594 mm
1123 wxPAPER_A3_TRANSVERSE, ///< A3 Transverse 297 x 420 mm
1124 wxPAPER_A3_EXTRA_TRANSVERSE, ///< A3 Extra Transverse 322 x 445 mm
1125
1126 wxPAPER_DBL_JAPANESE_POSTCARD, ///< Japanese Double Postcard 200 x 148 mm
1127 wxPAPER_A6, ///< A6 105 x 148 mm
1128 wxPAPER_JENV_KAKU2, ///< Japanese Envelope Kaku #2
1129 wxPAPER_JENV_KAKU3, ///< Japanese Envelope Kaku #3
1130 wxPAPER_JENV_CHOU3, ///< Japanese Envelope Chou #3
1131 wxPAPER_JENV_CHOU4, ///< Japanese Envelope Chou #4
1132 wxPAPER_LETTER_ROTATED, ///< Letter Rotated 11 x 8 1/2 in
1133 wxPAPER_A3_ROTATED, ///< A3 Rotated 420 x 297 mm
1134 wxPAPER_A4_ROTATED, ///< A4 Rotated 297 x 210 mm
1135 wxPAPER_A5_ROTATED, ///< A5 Rotated 210 x 148 mm
1136 wxPAPER_B4_JIS_ROTATED, ///< B4 (JIS) Rotated 364 x 257 mm
1137 wxPAPER_B5_JIS_ROTATED, ///< B5 (JIS) Rotated 257 x 182 mm
1138 wxPAPER_JAPANESE_POSTCARD_ROTATED, ///< Japanese Postcard Rotated 148 x 100 mm
1139 wxPAPER_DBL_JAPANESE_POSTCARD_ROTATED, ///< Double Japanese Postcard Rotated 148 x 200 mm
1140 wxPAPER_A6_ROTATED, ///< A6 Rotated 148 x 105 mm
1141 wxPAPER_JENV_KAKU2_ROTATED, ///< Japanese Envelope Kaku #2 Rotated
1142 wxPAPER_JENV_KAKU3_ROTATED, ///< Japanese Envelope Kaku #3 Rotated
1143 wxPAPER_JENV_CHOU3_ROTATED, ///< Japanese Envelope Chou #3 Rotated
1144 wxPAPER_JENV_CHOU4_ROTATED, ///< Japanese Envelope Chou #4 Rotated
1145 wxPAPER_B6_JIS, ///< B6 (JIS) 128 x 182 mm
1146 wxPAPER_B6_JIS_ROTATED, ///< B6 (JIS) Rotated 182 x 128 mm
1147 wxPAPER_12X11, ///< 12 x 11 in
1148 wxPAPER_JENV_YOU4, ///< Japanese Envelope You #4
1149 wxPAPER_JENV_YOU4_ROTATED, ///< Japanese Envelope You #4 Rotated
1150 wxPAPER_P16K, ///< PRC 16K 146 x 215 mm
1151 wxPAPER_P32K, ///< PRC 32K 97 x 151 mm
1152 wxPAPER_P32KBIG, ///< PRC 32K(Big) 97 x 151 mm
1153 wxPAPER_PENV_1, ///< PRC Envelope #1 102 x 165 mm
1154 wxPAPER_PENV_2, ///< PRC Envelope #2 102 x 176 mm
1155 wxPAPER_PENV_3, ///< PRC Envelope #3 125 x 176 mm
1156 wxPAPER_PENV_4, ///< PRC Envelope #4 110 x 208 mm
1157 wxPAPER_PENV_5, ///< PRC Envelope #5 110 x 220 mm
1158 wxPAPER_PENV_6, ///< PRC Envelope #6 120 x 230 mm
1159 wxPAPER_PENV_7, ///< PRC Envelope #7 160 x 230 mm
1160 wxPAPER_PENV_8, ///< PRC Envelope #8 120 x 309 mm
1161 wxPAPER_PENV_9, ///< PRC Envelope #9 229 x 324 mm
1162 wxPAPER_PENV_10, ///< PRC Envelope #10 324 x 458 mm
1163 wxPAPER_P16K_ROTATED, ///< PRC 16K Rotated
1164 wxPAPER_P32K_ROTATED, ///< PRC 32K Rotated
1165 wxPAPER_P32KBIG_ROTATED, ///< PRC 32K(Big) Rotated
1166 wxPAPER_PENV_1_ROTATED, ///< PRC Envelope #1 Rotated 165 x 102 mm
1167 wxPAPER_PENV_2_ROTATED, ///< PRC Envelope #2 Rotated 176 x 102 mm
1168 wxPAPER_PENV_3_ROTATED, ///< PRC Envelope #3 Rotated 176 x 125 mm
1169 wxPAPER_PENV_4_ROTATED, ///< PRC Envelope #4 Rotated 208 x 110 mm
1170 wxPAPER_PENV_5_ROTATED, ///< PRC Envelope #5 Rotated 220 x 110 mm
1171 wxPAPER_PENV_6_ROTATED, ///< PRC Envelope #6 Rotated 230 x 120 mm
1172 wxPAPER_PENV_7_ROTATED, ///< PRC Envelope #7 Rotated 230 x 160 mm
1173 wxPAPER_PENV_8_ROTATED, ///< PRC Envelope #8 Rotated 309 x 120 mm
1174 wxPAPER_PENV_9_ROTATED, ///< PRC Envelope #9 Rotated 324 x 229 mm
1175 wxPAPER_PENV_10_ROTATED ///< PRC Envelope #10 Rotated 458 x 324 m
1176};
1177
af7e24c3
VZ
1178/**
1179 Printing orientation
1180*/
1181
1182enum wxPrintOrientation
1183{
1184 wxPORTRAIT,
1185 wxLANDSCAPE
1186};
d18d9f60 1187
99d82720
FM
1188/**
1189 Duplex printing modes.
1190*/
1191enum wxDuplexMode
1192{
1193 wxDUPLEX_SIMPLEX, /**< Non-duplex */
1194 wxDUPLEX_HORIZONTAL,
1195 wxDUPLEX_VERTICAL
1196};
1197
cda7699d
VZ
1198/**
1199 Print quality.
1200*/
1201#define wxPRINT_QUALITY_HIGH -1
1202#define wxPRINT_QUALITY_MEDIUM -2
1203#define wxPRINT_QUALITY_LOW -3
1204#define wxPRINT_QUALITY_DRAFT -4
1205
1206typedef int wxPrintQuality;
1207
99d82720
FM
1208/**
1209 Print mode (currently PostScript only).
1210*/
1211enum wxPrintMode
1212{
1213 wxPRINT_MODE_NONE = 0,
1214 wxPRINT_MODE_PREVIEW = 1, /**< Preview in external application */
1215 wxPRINT_MODE_FILE = 2, /**< Print to file */
1216 wxPRINT_MODE_PRINTER = 3, /**< Send to printer */
1217 wxPRINT_MODE_STREAM = 4 /**< Send postscript data into a stream */
1218};
1219
1220/**
1221 Flags which can be used in wxWindow::UpdateWindowUI().
1222*/
1223enum wxUpdateUI
1224{
1225 wxUPDATE_UI_NONE,
1226 wxUPDATE_UI_RECURSE,
1227 wxUPDATE_UI_FROMIDLE /**< Invoked from On(Internal)Idle */
1228};
1229
1230
febd3dca
VZ
1231// ----------------------------------------------------------------------------
1232// constants
1233// ----------------------------------------------------------------------------
1234
8ff9b17d
RD
1235/**
1236 Top level window styles common to wxFrame and wxDialog
1237*/
1238
1239#define wxSTAY_ON_TOP 0x8000
1240#define wxICONIZE 0x4000
1241#define wxMINIMIZE wxICONIZE
1242#define wxMAXIMIZE 0x2000
1243#define wxCLOSE_BOX 0x1000
1244
1245#define wxSYSTEM_MENU 0x0800
1246#define wxMINIMIZE_BOX 0x0400
1247#define wxMAXIMIZE_BOX 0x0200
1248
1249#define wxTINY_CAPTION 0x0080 // clashes with wxNO_DEFAULT
1250#define wxRESIZE_BORDER 0x0040
1251
1252
febd3dca
VZ
1253/**
1254 C99-like sized MIN/MAX constants for all integer types.
1255
1256 For each @c n in the set 8, 16, 32, 64 we define @c wxINTn_MIN, @c
1257 wxINTn_MAX and @c wxUINTc_MAX (@c wxUINTc_MIN is always 0 and so is not
1258 defined).
1259 */
1260//@{
1261#define wxINT8_MIN CHAR_MIN
1262#define wxINT8_MAX CHAR_MAX
1263#define wxUINT8_MAX UCHAR_MAX
1264
1265#define wxINT16_MIN SHRT_MIN
1266#define wxINT16_MAX SHRT_MAX
1267#define wxUINT16_MAX USHRT_MAX
1268
1269#define wxINT32_MIN INT_MIN-or-LONG_MIN
1270#define wxINT32_MAX INT_MAX-or-LONG_MAX
1271#define wxUINT32_MAX UINT_MAX-or-LONG_MAX
1272
1273#define wxINT64_MIN LLONG_MIN
1274#define wxINT64_MAX LLONG_MAX
1275#define wxUINT64_MAX ULLONG_MAX
1276//@}
99d82720 1277
398e3148
FM
1278// ----------------------------------------------------------------------------
1279// types
1280// ----------------------------------------------------------------------------
1281
1282/** The type for screen and DC coordinates. */
1283typedef int wxCoord;
1284
1285/** A special value meaning "use default coordinate". */
1286wxCoord wxDefaultCoord = -1;
1287
1288//@{
1289/** 8 bit type (the mapping is more complex than a simple @c typedef and is not shown here). */
1290typedef signed char wxInt8;
1291typedef unsigned char wxUint8;
1292typedef wxUint8 wxByte;
1293//@}
1294
1295//@{
1296/** 16 bit type (the mapping is more complex than a simple @c typedef and is not shown here). */
1297typedef signed short wxInt16;
1298typedef unsigned short wxUint16;
1299typedef wxUint16 wxWord;
1300typedef wxUint16 wxChar16;
1301//@}
1302
1303//@{
1304/** 32 bit type (the mapping is more complex than a simple @c typedef and is not shown here). */
1305typedef int wxInt32;
1306typedef unsigned int wxUint32;
1307typedef wxUint32 wxDword;
1308typedef wxUint32 wxChar32;
1309//@}
1310
1311//@{
1312/** 64 bit type (the mapping is more complex than a simple @c typedef and is not shown here). */
1313typedef wxLongLong_t wxInt64;
1314typedef wxULongLong_t wxUint64;
1315//@}
1316
1317//@{
1318/**
1319 Signed and unsigned integral types big enough to contain all of @c long,
1320 @c size_t and @c void*.
1321 (The mapping is more complex than a simple @c typedef and is not shown here).
1322*/
1323typedef ssize_t wxIntPtr;
1324typedef size_t wxUIntPtr;
1325//@}
1326
1327
1328/**
1329 32 bit IEEE float ( 1 sign, 8 exponent bits, 23 fraction bits ).
1330 (The mapping is more complex than a simple @c typedef and is not shown here).
1331*/
1332typedef float wxFloat32;
1333
1334
1335/**
1336 64 bit IEEE float ( 1 sign, 11 exponent bits, 52 fraction bits ).
1337 (The mapping is more complex than a simple @c typedef and is not shown here).
1338*/
1339typedef double wxFloat64;
1340
1341/**
1342 Native fastest representation that has at least wxFloat64 precision, so use
1343 the IEEE types for storage, and this for calculations.
1344 (The mapping is more complex than a simple @c typedef and is not shown here).
1345*/
1346typedef double wxDouble;
1347
1348
1349
1350// ----------------------------------------------------------------------------
1351// macros
1352// ----------------------------------------------------------------------------
1353
99d82720 1354
b21126db 1355/** @addtogroup group_funcmacro_byteorder */
7c913512 1356//@{
9579c1d7 1357
23324ae1 1358/**
9579c1d7
BP
1359 This macro will swap the bytes of the @a value variable from little endian
1360 to big endian or vice versa unconditionally, i.e. independently of the
23324ae1 1361 current platform.
9579c1d7
BP
1362
1363 @header{wx/defs.h}
23324ae1 1364*/
d7b99b16
FM
1365#define wxINT32_SWAP_ALWAYS( wxInt32_value )
1366#define wxUINT32_SWAP_ALWAYS( wxUint32_value )
1367#define wxINT16_SWAP_ALWAYS( wxInt16_value )
1368#define wxUINT16_SWAP_ALWAYS( wxUint16_value )
9579c1d7 1369
23324ae1
FM
1370//@}
1371
b21126db 1372/** @addtogroup group_funcmacro_byteorder */
9579c1d7
BP
1373//@{
1374
1375/**
1376 This macro will swap the bytes of the @a value variable from little endian
1377 to big endian or vice versa if the program is compiled on a big-endian
1378 architecture (such as Sun work stations). If the program has been compiled
1379 on a little-endian architecture, the value will be unchanged.
1380
1381 Use these macros to read data from and write data to a file that stores
1382 data in little-endian (for example Intel i386) format.
1383
1384 @header{wx/defs.h}
1385*/
d7b99b16
FM
1386#define wxINT32_SWAP_ON_BE( wxInt32_value )
1387#define wxUINT32_SWAP_ON_BE( wxUint32_value )
1388#define wxINT16_SWAP_ON_BE( wxInt16_value )
1389#define wxUINT16_SWAP_ON_BE( wxUint16_value )
23324ae1 1390
9579c1d7
BP
1391//@}
1392
b21126db 1393/** @addtogroup group_funcmacro_byteorder */
7c913512 1394//@{
9579c1d7 1395
23324ae1 1396/**
9579c1d7
BP
1397 This macro will swap the bytes of the @a value variable from little endian
1398 to big endian or vice versa if the program is compiled on a little-endian
1399 architecture (such as Intel PCs). If the program has been compiled on a
1400 big-endian architecture, the value will be unchanged.
1401
23324ae1
FM
1402 Use these macros to read data from and write data to a file that stores
1403 data in big-endian format.
9579c1d7
BP
1404
1405 @header{wx/defs.h}
23324ae1 1406*/
d7b99b16
FM
1407#define wxINT32_SWAP_ON_LE( wxInt32_value )
1408#define wxUINT32_SWAP_ON_LE( wxUint32_value )
1409#define wxINT16_SWAP_ON_LE( wxInt16_value )
1410#define wxUINT16_SWAP_ON_LE( wxUint16_value )
9579c1d7 1411
23324ae1
FM
1412//@}
1413
9579c1d7
BP
1414
1415
b21126db 1416/** @addtogroup group_funcmacro_misc */
7fa7088e 1417//@{
9579c1d7 1418
706068e4
VZ
1419/**
1420 This macro can be used in a class declaration to disable the generation of
1421 default assignment operator.
1422
1423 Some classes have a well-defined copy constructor but cannot have an
1424 assignment operator, typically because they can't be modified once created.
1425 In such case, this macro can be used to disable the automatic assignment
1426 operator generation.
1427
c0c133e1 1428 @see wxDECLARE_NO_COPY_CLASS()
706068e4 1429 */
c0c133e1 1430#define wxDECLARE_NO_ASSIGN_CLASS(classname)
706068e4
VZ
1431
1432/**
1433 This macro can be used in a class declaration to disable the generation of
1434 default copy ctor and assignment operator.
1435
1436 Some classes don't have a well-defined copying semantics. In this case the
1437 standard C++ convention is to not allow copying them. One way of achieving
1438 it is to use this macro which simply defines a private copy constructor and
1439 assignment operator.
1440
1441 Beware that simply not defining copy constructor and assignment operator is
1442 @em not enough as the compiler would provide its own automatically-generated
1443 versions of them -- hence the usefulness of this macro.
1444
1445 Example of use:
1446 @code
1447 class FooWidget
1448 {
1449 public:
1450 FooWidget();
1451 ...
1452
1453 private:
1454 // widgets can't be copied
c0c133e1 1455 wxDECLARE_NO_COPY_CLASS(FooWidget);
706068e4
VZ
1456 };
1457 @endcode
1458
c0c133e1
VZ
1459 Notice that a semicolon must be used after this macro and that it changes
1460 the access specifier to private internally so it is better to use it at the
1461 end of the class declaration.
1462
1463 @see wxDECLARE_NO_ASSIGN_CLASS(), wxDECLARE_NO_COPY_TEMPLATE_CLASS()
706068e4 1464 */
c0c133e1 1465#define wxDECLARE_NO_COPY_CLASS(classname)
706068e4 1466
375a5d3a 1467/**
c0c133e1 1468 Analog of wxDECLARE_NO_COPY_CLASS() for template classes.
375a5d3a
VZ
1469
1470 This macro can be used for template classes (with a single template
c0c133e1 1471 parameter) for the same purpose as wxDECLARE_NO_COPY_CLASS() is used with the
375a5d3a
VZ
1472 non-template classes.
1473
1474 @param classname The name of the template class.
1475 @param arg The name of the template parameter.
021f9dee
VZ
1476
1477 @see wxDECLARE_NO_COPY_TEMPLATE_CLASS_2
375a5d3a 1478 */
c0c133e1 1479#define wxDECLARE_NO_COPY_TEMPLATE_CLASS(classname, arg)
375a5d3a 1480
021f9dee
VZ
1481/**
1482 Analog of wxDECLARE_NO_COPY_TEMPLATE_CLASS() for templates with 2
1483 parameters.
1484
1485 This macro can be used for template classes with two template
1486 parameters for the same purpose as wxDECLARE_NO_COPY_CLASS() is used with
1487 the non-template classes.
1488
1489 @param classname The name of the template class.
1490 @param arg1 The name of the first template parameter.
1491 @param arg2 The name of the second template parameter.
1492
1493 @see wxDECLARE_NO_COPY_TEMPLATE_CLASS
1494 */
1495#define wxDECLARE_NO_COPY_TEMPLATE_CLASS_2(classname, arg1, arg2)
1496
dac8712f
VZ
1497/**
1498 A function which deletes and nulls the pointer.
1499
1500 This function uses operator delete to free the pointer and also sets it to
1501 @NULL. Notice that this does @em not work for arrays, use wxDELETEA() for
1502 them.
1503
1504 @code
1505 MyClass *ptr = new MyClass;
1506 ...
1507 wxDELETE(ptr);
1508 wxASSERT(!ptr);
1509 @endcode
1510
1511 @header{wx/defs.h}
1512*/
1513template <typename T> wxDELETE(T*& ptr);
1514
1515/**
1516 A function which deletes and nulls the pointer.
1517
1518 This function uses vector operator delete (@c delete[]) to free the array
1519 pointer and also sets it to @NULL. Notice that this does @em not work for
1520 non-array pointers, use wxDELETE() for them.
1521
1522 @code
1523 MyClass *array = new MyClass[17];
1524 ...
1525 wxDELETEA(array);
1526 wxASSERT(!array);
1527 @endcode
1528
1529 @see wxDELETE()
1530
1531 @header{wx/defs.h}
1532*/
1533template <typename T> wxDELETEA(T*& array);
1534
23324ae1 1535/**
7fa7088e
BP
1536 This macro can be used around a function declaration to generate warnings
1537 indicating that this function is deprecated (i.e. obsolete and planned to
1538 be removed in the future) when it is used. Only Visual C++ 7 and higher and
1539 g++ compilers currently support this functionality.
1540
1541 Example of use:
1542
1543 @code
1544 // old function, use wxString version instead
1545 wxDEPRECATED( void wxGetSomething(char *buf, size_t len) );
1546
1547 // ...
1548 wxString wxGetSomething();
1549 @endcode
1550
1551 @header{wx/defs.h}
1552*/
1553#define wxDEPRECATED(function)
1554
1555/**
1556 This is a special version of wxDEPRECATED() macro which only does something
1557 when the deprecated function is used from the code outside wxWidgets itself
1558 but doesn't generate warnings when it is used from wxWidgets.
1559
1560 It is used with the virtual functions which are called by the library
1561 itself -- even if such function is deprecated the library still has to call
1562 it to ensure that the existing code overriding it continues to work, but
1563 the use of this macro ensures that a deprecation warning will be generated
1564 if this function is used from the user code or, in case of Visual C++, even
1565 when it is simply overridden.
1566
1567 @header{wx/defs.h}
1568*/
1569#define wxDEPRECATED_BUT_USED_INTERNALLY(function)
1570
1571/**
1572 This macro is similar to wxDEPRECATED() but can be used to not only declare
1573 the function @a function as deprecated but to also provide its (inline)
1574 implementation @a body.
1575
23324ae1 1576 It can be used as following:
7c913512 1577
23324ae1
FM
1578 @code
1579 class wxFoo
7fa7088e
BP
1580 {
1581 public:
1582 // OldMethod() is deprecated, use NewMethod() instead
1583 void NewMethod();
531cfed2 1584 wxDEPRECATED_INLINE( void OldMethod(), NewMethod(); )
7fa7088e 1585 };
23324ae1 1586 @endcode
7fa7088e
BP
1587
1588 @header{wx/defs.h}
23324ae1 1589*/
7fa7088e 1590#define wxDEPRECATED_INLINE(func, body)
23324ae1 1591
2352862a
VZ
1592/**
1593 A helper macro allowing to easily define a simple deprecated accessor.
1594
1595 Compared to wxDEPRECATED_INLINE() it saves a @c return statement and,
1596 especially, a strangely looking semicolon inside a macro.
1597
1598 Example of use
1599 @code
1600 class wxFoo
1601 {
1602 public:
1603 int GetValue() const { return m_value; }
1604
1605 // this one is deprecated because it was erroneously non-const
1606 wxDEPRECATED_ACCESSOR( int GetValue(), m_value )
1607
1608 private:
1609 int m_value;
1610 };
1611 @endcode
1612 */
1613#define wxDEPRECATED_ACCESSOR(func, what)
1614
531cfed2
VZ
1615/**
1616 Combination of wxDEPRECATED_BUT_USED_INTERNALLY() and wxDEPRECATED_INLINE().
1617
1618 This macro should be used for deprecated functions called by the library
1619 itself (usually for backwards compatibility reasons) and which are defined
1620 inline.
1621
1622 @header{wx/defs.h}
1623*/
1624#define wxDEPRECATED_BUT_USED_INTERNALLY_INLINE(func, body)
1625
23324ae1
FM
1626/**
1627 @c wxEXPLICIT is a macro which expands to the C++ @c explicit keyword if
7fa7088e
BP
1628 the compiler supports it or nothing otherwise. Thus, it can be used even in
1629 the code which might have to be compiled with an old compiler without
1630 support for this language feature but still take advantage of it when it is
1631 available.
23324ae1 1632
7fa7088e
BP
1633 @header{wx/defs.h}
1634*/
1635#define wxEXPLICIT
23324ae1
FM
1636
1637/**
1638 GNU C++ compiler gives a warning for any class whose destructor is private
1639 unless it has a friend. This warning may sometimes be useful but it doesn't
7fa7088e
BP
1640 make sense for reference counted class which always delete themselves
1641 (hence destructor should be private) but don't necessarily have any
1642 friends, so this macro is provided to disable the warning in such case. The
1643 @a name parameter should be the name of the class but is only used to
1644 construct a unique friend class name internally.
1645
1646 Example of using the macro:
4cc4bfaf 1647
23324ae1
FM
1648 @code
1649 class RefCounted
7fa7088e
BP
1650 {
1651 public:
1652 RefCounted() { m_nRef = 1; }
1653 void IncRef() { m_nRef++ ; }
1654 void DecRef() { if ( !--m_nRef ) delete this; }
7c913512 1655
7fa7088e
BP
1656 private:
1657 ~RefCounted() { }
7c913512 1658
7fa7088e
BP
1659 wxSUPPRESS_GCC_PRIVATE_DTOR(RefCounted)
1660 };
23324ae1 1661 @endcode
7c913512 1662
23324ae1 1663 Notice that there should be no semicolon after this macro.
7c913512 1664
7fa7088e 1665 @header{wx/defs.h}
23324ae1 1666*/
7fa7088e 1667#define wxSUPPRESS_GCC_PRIVATE_DTOR_WARNING(name)
23324ae1 1668
dac8712f
VZ
1669/**
1670 Swaps the contents of two variables.
1671
1672 This is similar to std::swap() but can be used even on the platforms where
1673 the standard C++ library is not available (if you don't target such
1674 platforms, please use std::swap() instead).
1675
1676 The function relies on type T being copy constructible and assignable.
1677
1678 Example of use:
1679 @code
1680 int x = 3,
1681 y = 4;
1682 wxSwap(x, y);
1683 wxASSERT( x == 4 && y == 3 );
1684 @endcode
1685 */
1686template <typename T> wxSwap(T& first, T& second);
1687
23324ae1
FM
1688/**
1689 This macro is the same as the standard C99 @c va_copy for the compilers
7fa7088e
BP
1690 which support it or its replacement for those that don't. It must be used
1691 to preserve the value of a @c va_list object if you need to use it after
23324ae1 1692 passing it to another function because it can be modified by the latter.
7fa7088e 1693
23324ae1
FM
1694 As with @c va_start, each call to @c wxVaCopy must have a matching
1695 @c va_end.
23324ae1 1696
7fa7088e 1697 @header{wx/defs.h}
23324ae1 1698*/
7fa7088e 1699void wxVaCopy(va_list argptrDst, va_list argptrSrc);
23324ae1 1700
7fa7088e 1701//@}
23324ae1 1702
f992f2ae 1703