]> git.saurik.com Git - wxWidgets.git/blob - docs/todo30.txt
added very preliminary wxRenderer documentation
[wxWidgets.git] / docs / todo30.txt
1 Enhancements for wxWindows 3.0
2 ==============================
3
4 This table contains the brief summary of the issues below. Priority and
5 Difficulty are values from 1 to 10 with 1 being the least important/difficult
6 and 10 the most.
7
8 Item Prio Diff
9 ----------------------------------------------------------------------------
10 Namespaces 8 6
11 STLization 10 8
12 Making code exception-friendly 8 10
13 Native RTTI 7 7
14 TRUE/true 9 1
15
16
17 C++ Features
18 ============
19
20 - Namespaces:
21 We want to have all wxWindows identifiers in "wx" namespace but provide
22 typedefs/#defines for backwards compatibility. This can be done easily
23 for the classes and the only real problem are the enums as they would
24 all have to be duplicated at both the global scope (with "wx" prefix) and
25 in wx namespace (without it)
26
27 - STLization
28 This involves providing optional wxString implementation using std::string
29 and doing the same for all our containers with the exception of wxHashMap
30 which should simply be rewritten using templates (but keeping the old
31 version for backwards compatibility -- ideally wx 3.0 would still be usable
32 without templates, even if not all of its features would be available then)
33
34 - Exceptions
35 We are not going to use exceptions in wxWindows itself but our code should
36 become exception safe. This is a very difficult task as it means that no
37 resource allocations (including memory, files, whatever) should be done
38 without using a smart pointer-like object to store the result as it is the
39 only way to prevent resource leaks in presence of exceptions
40
41 - Real RTTI
42 Optionally use the real RTTI instead of wx emulation of it. Keep the
43 current stuff for backwards compatibility.
44
45 - Complete replacing TRUE/FALSE with true/false
46 Trivial
47
48
49 Core
50 ====
51
52 - use wxEventLoop in all builds
53 wxApp and wxDialog should use wxEventLoop objects (the exact class can be
54 customized by user code by overriding some wxApp::CreateEventLoop())
55 instead of duplicating the same code
56
57 - remove wxCOMPATIBILITY (1.X)
58 At least WXWIN_COMPATIBILITY and maybe WXWIN_COMPATIBILITY_2 code should be
59 removed from the library. wxDEPRECATED() should be used with everything
60 inside WXWIN_COMPATIBILITY_2_2. The stuff inside WXWIN_COMPATIBILITY_2_4
61 probably should not be deprecated (yet?) because this would give thousands
62 of warnings for the existing code.
63
64 - Modularization/Build System
65 Candidates for components:
66 + contrib widgets (and maybe some of the ones currently in the core)
67 + wxHTML
68 + network stuff
69 + printing (?)
70 + ODBC classes
71 + ...
72
73 - Project File Generation
74 We need a (GUI) tool to generate the project/makefiles for all supported
75 platforms/compilers. Not sure if it should be used for the library itself
76 (would be nice to have something like "make menuconfig" for Linux kernel
77 which allows you to navigate easily amon all of the configure/setup.h
78 options but there is a problem with distributing such tool as it can't be
79 compiled by the user because it is needed before the library is built) but
80 we definitely need it for the users makefiles.
81
82 - Properties/Member-Metadata, 2-Step Init with virtual create
83 TODO: still unclear what do we need exactly
84
85 - Tidy code and add comments to headers (preferably in
86 Doxygen/Javadoc style)
87
88
89 Documentation
90 =============
91
92 - The possibility of moving doc into header files with tool
93 support.
94 - Detailed review of doc accuracy.
95 - wxDC : Precise definition of default/initial state.
96 - wxDC : Pixelwise definition of operations (e.g. last point of a
97 line not drawn).
98 - Events:
99 For all controls state clearly when calling a member function results in an
100 event being generated and when it doesn't.
101 - Update the coding standards guide
102
103
104 wxEvents
105 ========
106
107 - Change Idle Handling
108 Current Implementation is using too many CPU cycles
109
110 - Loose Coupling Event-Source Event-Sink
111 kind of the NextStep/C# very performant coupling, exposing events via
112 Metadata
113
114 - Add Lazy Init of Eventtables
115
116
117 Modules/Plugins
118 ===============
119
120 Architecture
121 ------------
122
123 We aim to arrive at a lazy initializiation of modules only when they are first
124 needed. Dependency information between modules is needed. Dynamic Plug-In
125 loading and unloading must be compatible with that.
126
127
128 wxUniversal
129 ===========
130
131 - Renderers within native ports.
132
133
134 wxPrinting
135 ==========
136
137 - Page preflighting capabilities in order to determine number
138 of pages.
139 - Preview UI enhancement.
140
141
142 wxStaticBox
143 ===========
144
145 Hide the platform problems (GTK: 'children' must be siblings) in encapsulation
146 in order to avoid problems on ports where the hierarchy must be
147 'correct'.
148
149
150 Removal of old code
151 ===================
152
153 In addition to wxCOMPATIBILITY code:
154
155 - wxProperty classes.
156 - All wxCOMPATIBILITY (1.X) code.
157 - contrib/src/canvas?
158 - contrib/src/mmedia
159 - contrib/src/applet?
160 - Old wxODBC code
161 - Dialog Editor
162
163 wxMiscellaneous
164 ===============
165
166 - wxDC Support for point to char-position with text rendering
167 - wxLocale Extension (eg Currency)
168 - wxStreams review
169 - wxURL?
170 - a way to tell wxWindows to check for any non-portable usage,
171 for a given set of platforms. Sometimes you want to be able
172 to get away with non-portable usage, and sometimes not.
173 This is probably way too time-consuming to implement.
174 - In headers, don't silently omit contents if the features for this
175 header is switched off. Instead, emit an error message.
176 - Implement native tree view and colour dialog in wxGTK.
177 - Better way to specify About, Preferences menu ids under wxMac.
178 - Must be able to portably specify relaying out a frame after the toolbar
179 has been destroyed or recreated. On wxMSW, this is done in
180 ~wxToolBar. On wxGTK, in SetToolBar. In wxMac, not at all,
181 but sending a wxSizeEvent will do it.
182 - Need wxRect wxToolBar::GetToolRect(int id) or similar so we can
183 align a popup menu with a toolbar button.
184 - wxMac font selector dialog is the generic font selector -
185 horrible.
186 - No Append(wxArrayString&) for wxChoice and wxComboBox in wxGTK.
187 Probably other functions too. Consider adding Insert to
188 these classes, as per the patch on SF.
189 - Rewrite wxFileHistory using wxString and wxArrayString, and
190 put in separate file.
191 - Add wxArrayString methods to wxTextValidator and any other
192 class that needs them.
193 - Add wxNotebook::GetTabRect or similar so we can estimate
194 page size better in wxNotebookBase::CalcSizeFromPage.
195 - Add function to clear all wxNotebook tabs without
196 destroying the pages.
197 - Add individual setters to wxScrollBar and other classes
198 that use a combined setter.
199 - Remove traces of old resource system from wxWizard.
200 - Have wxDirCtrl as alias for wxGenericDirCtrl.
201 - Allow instant reaction to left-up in a wxGrid cell
202 (extend editor API) to work around bad checkbox
203 behaviour (click, click, click, click away...) and
204 reduce checkbox size on non-Windows platforms.
205 - Add wxNotebook::HitTest for non-Windows platforms.
206
207 Version: $Id$