]> git.saurik.com Git - wxWidgets.git/blob - interface/wx/chartype.h
Allow overriding print preview frame creation in docview.
[wxWidgets.git] / interface / wx / chartype.h
1 /////////////////////////////////////////////////////////////////////////////
2 // Name: chartype.h
3 // Purpose: interface of global functions
4 // Author: wxWidgets team
5 // RCS-ID: $Id$
6 // Licence: wxWindows license
7 /////////////////////////////////////////////////////////////////////////////
8
9 /** @addtogroup group_funcmacro_string */
10 //@{
11
12 /**
13 This macro can be used with character and string literals (in other words,
14 @c 'x' or @c "foo") to automatically convert them to wide strings in Unicode
15 builds of wxWidgets. This macro simply returns the value passed to it
16 without changes in ASCII build. In fact, its definition is:
17
18 @code
19 #ifdef UNICODE
20 # define wxT(x) L##x
21 #else // !Unicode
22 # define wxT(x) x
23 #endif
24 @endcode
25
26 Note that since wxWidgets 2.9.0 you shouldn't use wxT() anymore in your
27 program sources (it was previously required if you wanted to support Unicode).
28
29 @see @ref overview_unicode, wxS()
30
31 @header{wx/chartype.h}
32 */
33 #define wxT(string)
34
35 /**
36 wxS is macro which can be used with character and string literals (in other words,
37 @c 'x' or @c "foo") to either convert them to wide characters or wide strings
38 in @c wchar_t-based (UTF-16) builds or keep them unchanged in @c char-based
39 (UTF-8) builds.
40
41 Basically this macro produces characters or strings of type wxStringCharType.
42
43 The use of this macro is optional as the translation will always be done at
44 run-time even if there is a mismatch between the kind of the literal used
45 and the string or character type used in the current build.
46 However using it can be beneficial in <b>performance-sensitive code</b> to
47 do the conversion at compile-time instead.
48
49 @see @ref overview_unicode, wxT()
50
51 @header{wx/chartype.h}
52 */
53 #define wxS(string)
54
55 /**
56 This macro is exactly the same as wxT() and is defined in wxWidgets simply
57 because it may be more intuitive for Windows programmers as the standard
58 Win32 headers also define it (as well as yet another name for the same
59 macro which is _TEXT()).
60
61 Don't confuse this macro with _()!
62
63 Note that since wxWidgets 2.9.0 the use of _T() is discouraged just like
64 for wxT() and also that this macro may conflict with identifiers defined in
65 standard headers of some compilers (such as Sun CC) so its use should
66 really be avoided.
67
68 @header{wx/chartype.h}
69 */
70 #define _T(string)
71
72 /**
73 wxChar is defined to be
74 - @c char when <tt>wxUSE_UNICODE==0</tt>
75 - @c wchar_t when <tt>wxUSE_UNICODE==1</tt> (the default).
76 */
77 typedef wxUSE_UNICODE_dependent wxChar;
78
79 /**
80 wxSChar is defined to be
81 - <tt>signed char</tt> when <tt>wxUSE_UNICODE==0</tt>
82 - @c wchar_t when <tt>wxUSE_UNICODE==1</tt> (the default).
83 */
84 typedef wxUSE_UNICODE_dependent wxSChar;
85
86 /**
87 wxUChar is defined to be
88 - <tt>unsigned char</tt> when <tt>wxUSE_UNICODE==0</tt>
89 - @c wchar_t when <tt>wxUSE_UNICODE==1</tt> (the default).
90 */
91 typedef wxUSE_UNICODE_dependent wxUChar;
92
93 /**
94 wxStringCharType is defined to be:
95 - @c char when <tt>wxUSE_UNICODE==0</tt>
96 - @c char when <tt>wxUSE_UNICODE_WCHAR==0</tt> and <tt>wxUSE_UNICODE==1</tt>
97 - @c wchar_t when <tt>wxUSE_UNICODE_WCHAR==1</tt> and <tt>wxUSE_UNICODE==1</tt>
98
99 The @c wxUSE_UNICODE_WCHAR symbol is defined to @c 1 when building on
100 Windows while it's defined to @c 0 when building on Unix, Linux or OS X.
101 (Note that @c wxUSE_UNICODE_UTF8 symbol is defined as the opposite of
102 @c wxUSE_UNICODE_WCHAR.)
103
104 Note that wxStringCharType (as the name says) is the type used by wxString
105 for internal storage of the characters.
106 */
107 typedef wxUSE_UNICODE_WCHAR_dependent wxStringCharType;
108
109 //@}