File: CHANGES.html

package info (click to toggle)
wxwidgets2.6 2.6.3.2.1.5%2Betch1
  • links: PTS
  • area: main
  • in suites: etch
  • size: 83,228 kB
  • ctags: 130,941
  • sloc: cpp: 820,043; ansic: 113,030; python: 107,485; makefile: 42,996; sh: 10,305; lex: 194; yacc: 128; xml: 95; pascal: 74
file content (2406 lines) | stat: -rw-r--r-- 122,985 bytes parent folder | download | duplicates (4) 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
1660
1661
1662
1663
1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679
1680
1681
1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
1703
1704
1705
1706
1707
1708
1709
1710
1711
1712
1713
1714
1715
1716
1717
1718
1719
1720
1721
1722
1723
1724
1725
1726
1727
1728
1729
1730
1731
1732
1733
1734
1735
1736
1737
1738
1739
1740
1741
1742
1743
1744
1745
1746
1747
1748
1749
1750
1751
1752
1753
1754
1755
1756
1757
1758
1759
1760
1761
1762
1763
1764
1765
1766
1767
1768
1769
1770
1771
1772
1773
1774
1775
1776
1777
1778
1779
1780
1781
1782
1783
1784
1785
1786
1787
1788
1789
1790
1791
1792
1793
1794
1795
1796
1797
1798
1799
1800
1801
1802
1803
1804
1805
1806
1807
1808
1809
1810
1811
1812
1813
1814
1815
1816
1817
1818
1819
1820
1821
1822
1823
1824
1825
1826
1827
1828
1829
1830
1831
1832
1833
1834
1835
1836
1837
1838
1839
1840
1841
1842
1843
1844
1845
1846
1847
1848
1849
1850
1851
1852
1853
1854
1855
1856
1857
1858
1859
1860
1861
1862
1863
1864
1865
1866
1867
1868
1869
1870
1871
1872
1873
1874
1875
1876
1877
1878
1879
1880
1881
1882
1883
1884
1885
1886
1887
1888
1889
1890
1891
1892
1893
1894
1895
1896
1897
1898
1899
1900
1901
1902
1903
1904
1905
1906
1907
1908
1909
1910
1911
1912
1913
1914
1915
1916
1917
1918
1919
1920
1921
1922
1923
1924
1925
1926
1927
1928
1929
1930
1931
1932
1933
1934
1935
1936
1937
1938
1939
1940
1941
1942
1943
1944
1945
1946
1947
1948
1949
1950
1951
1952
1953
1954
1955
1956
1957
1958
1959
1960
1961
1962
1963
1964
1965
1966
1967
1968
1969
1970
1971
1972
1973
1974
1975
1976
1977
1978
1979
1980
1981
1982
1983
1984
1985
1986
1987
1988
1989
1990
1991
1992
1993
1994
1995
1996
1997
1998
1999
2000
2001
2002
2003
2004
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
2027
2028
2029
2030
2031
2032
2033
2034
2035
2036
2037
2038
2039
2040
2041
2042
2043
2044
2045
2046
2047
2048
2049
2050
2051
2052
2053
2054
2055
2056
2057
2058
2059
2060
2061
2062
2063
2064
2065
2066
2067
2068
2069
2070
2071
2072
2073
2074
2075
2076
2077
2078
2079
2080
2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
2204
2205
2206
2207
2208
2209
2210
2211
2212
2213
2214
2215
2216
2217
2218
2219
2220
2221
2222
2223
2224
2225
2226
2227
2228
2229
2230
2231
2232
2233
2234
2235
2236
2237
2238
2239
2240
2241
2242
2243
2244
2245
2246
2247
2248
2249
2250
2251
2252
2253
2254
2255
2256
2257
2258
2259
2260
2261
2262
2263
2264
2265
2266
2267
2268
2269
2270
2271
2272
2273
2274
2275
2276
2277
2278
2279
2280
2281
2282
2283
2284
2285
2286
2287
2288
2289
2290
2291
2292
2293
2294
2295
2296
2297
2298
2299
2300
2301
2302
2303
2304
2305
2306
2307
2308
2309
2310
2311
2312
2313
2314
2315
2316
2317
2318
2319
2320
2321
2322
2323
2324
2325
2326
2327
2328
2329
2330
2331
2332
2333
2334
2335
2336
2337
2338
2339
2340
2341
2342
2343
2344
2345
2346
2347
2348
2349
2350
2351
2352
2353
2354
2355
2356
2357
2358
2359
2360
2361
2362
2363
2364
2365
2366
2367
2368
2369
2370
2371
2372
2373
2374
2375
2376
2377
2378
2379
2380
2381
2382
2383
2384
2385
2386
2387
2388
2389
2390
2391
2392
2393
2394
2395
2396
2397
2398
2399
2400
2401
2402
2403
2404
2405
2406
 
<?xml version="1.0" encoding="iso-8859-1" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
<meta name="generator" content="Docutils 0.3.7: http://docutils.sourceforge.net/" />
<title>Recent Changes for wxPython</title>
<link rel="stylesheet" href="default.css" type="text/css" />
</head>
<body>
<div class="document" id="recent-changes-for-wxpython">
<h1 class="title">Recent Changes for wxPython</h1>
<div class="section" id="id1">
<h1><a name="id1">2.6.3.0</a></h1>
<ul class="simple">
<li>27-March-2006</li>
</ul>
<p>Change the wx.ListCtrl InsertStringItem wrapper to use the form that
takes an imageIndex, and set the default to -1.  This ensures that on
wxMSW that if there is an image list but they don't specify an image,
the native control doesn't use one anyway.</p>
<p>wxMSW: wx.ListCtrl in report mode is now able to support images in
other columns besides the first one.  Simply pass an image index to
SetStringItem.  For virtual list controls you can specify the image to
use on the extra columns by overriding OnGetItemColumnImage in your
derived class.  It is passed the item number and the column number as
parameters, and the default version simply calls OnGetItemImage for
column zero, or returns -1 for other columns.</p>
<p>Switched to using SWIG 1.3.27 for generating the wrapper code.  There
are some small changes needed to SWIG to work around some bugs that
wxPython exposes, and to be able to generate code that matches that
which wxPython is using.  If you are building wxPython yourself and
need to modify any of the *.i files or to add your own, then you will
want to be sure to use a matching SWIG.  See wxPython/SWIG/README.txt
in the source tarball for details.</p>
<p>wx.Image.Copy now also copies the alpha channel.</p>
<p>wxMSW: Fixed problem in wx.TextCtrl where using SetValue and
wx.TE_RICH2 would cause the control to be shown if it was hidden.</p>
<p>wxMSW: Numpad special keys are now distinguished from normal keys in
key events.</p>
<p>wxMSW: Multiline notebook tab label change now resizes the control
correctly if an extra row is removed or added.</p>
<p>wxMSW: On XP fall back to unthemed wxNotebook if specified orientation
not available in the themed version.</p>
<p>Added wx.Toolbar.GetToolsCount.</p>
<p>Added wx.GridSizer.CalcRowsCols.</p>
<p>Added wx.OutputStream.LastWrite.</p>
<p>wxGTK: EVT_SET_CURSOR is now sent.</p>
<p>wxGTK: Fix RequestMore for idle events.</p>
<p>wxGTK: Implement user dashes for PS and GNOME printing.</p>
<p>wxGTK: Correct update region code. Don't always invalidate the whole
window upon resize. Reenable support for thewx.NO_FULL_REPAINT_ON_RESIZE 
flag.  Also disable refreshing custom controls when focusing in and out.</p>
<p>wx.lib.pubsub: Publisher is now able to parse a dotted notation string
into a topic tuple.  For example: subscribing to &quot;timer.clock.seconds&quot;
is the same as subscribing to (&quot;timer&quot;, &quot;clock&quot;, &quot;seconds&quot;).</p>
<p>Applied patch #1441370: lib.plot - allow passing in wx.Colour()</p>
<p>Added wx.CommandEvent.GetClientData.</p>
<p>Updated wxStyledTextCtrl to use version 1.67 of Scintilla.  
NOTE: The STC_LEX_ASP and STC_LEX_PHP lexers have been deprecated,
you should use STC_LEX_HTML instead.</p>
<p>wxSTC: Implemented Fix for SF Bug #1436503.  Delay the start of the
DnD operation in case the user just intended to click, not drag.</p>
<p>Updated the analogclock.py module to the new analogclock package from
E. A. Tacao.</p>
<p>Added the wx.lib.mixins.listctrl.CheckListCtrlMixin class from Bruce
Who, which makes it easy to put checkboxes on list control items.</p>
<p>Applied a patch from Christian Kristukat to wx.lib.plot that adds
scrollbars when the plot is zoomed in, and also the ability to grab a
zoomed plot and move it around with a mouse drag.</p>
<p>XRCed updated to allow wxMenuBar to be created inside a wxFrame.</p>
</div>
<div class="section" id="id2">
<h1><a name="id2">2.6.2.1</a></h1>
<ul class="simple">
<li>10-Jan-2006</li>
</ul>
<p>wxMSW: Fix for bug #1211907, popup menu indenting inconsistent with
bitmaps.</p>
<p>wxMac: Don't send an event for wx.RadioButton deselections, just the
selections.  This was done to make it consistent with the other
platforms.</p>
<p>wxMSW: Always set flat toolbar style, even under XP with themes: this
is necessary or separators aren't shown at all.</p>
<p>Fixes for bug #1217872, pydocview.DocService not correctly initialized.</p>
<p>Fix for bug #1217874, Error in parameter name in DocManager.CreateView.</p>
<p>Added wrappers for the wx.RendererNative class.</p>
<p>Added the wx.lib.splitter module, which contains the
MultiSplitterWindow class.  This class is much like the standard
wx.SplitterWindow class, except it allows more than one split, so it
can manage more than two child windows.</p>
<p>Docview and IDE patch from Morgan Hua with fix for bug #1217890
&quot;Closing view crashes Python&quot; plus some new features:</p>
<blockquote>
New feature added to the IDE is 'Extensions'.  Under
Tools|Options|Extensions, you can add calls to external programs.
For example you can add a &quot;Notepad&quot; extension (under windows) that
will exec Notepad on the currently open file.  A new &quot;Notepad&quot;
menu item will appear under the Tools menu.</blockquote>
<p>Some fixes to XRCed to make encoding errors a bit more user friendly.</p>
<p>XRCed changes from Roman Rolinsky:</p>
<blockquote>
<ul class="simple">
<li>Added new controls (Choicebook, Listbook, StatusBar,
DatePicker), and completed style flags. Test window is opened
for an available parent control if no specific view
defined. Better handling of exceptions (highlighting does not
'stick' anymore).</li>
<li>Use system clipboard for Copy/Paste.</li>
<li>Improved some dialogs (window styles, growable cols). Changed
the range for wxSpinCtrl min/max to all integers (default 0/100
is not always good).</li>
</ul>
</blockquote>
<p>Updates for wx.lib.foldpanelbar and wx.lib.hyperlink from Andrea
Gavana.</p>
<p>Fix for Bug #1283496: wxPython TheClipboard class causes problems for
pychecker.  Ensure the app has been created before initializing
wx.TheClipboard.</p>
<p>Fix for Bug #1352602: FileBrowseButtonWithHistory can't type in Value.</p>
<p>wxHTML: Added space after list item number.</p>
<p>wx.lib.printout:  Applied patch #1384440.</p>
<p>wxMSW:  Fix for Bug #1293225 Window_FromHWND crashes if parent is
None.</p>
<p>Fix for Bug #1261669, use a wx.TE_RICH2 style for the Process demo so
it doesn't fill up too soon.</p>
<p>Applied Patch #1354389: wxPython MenuItem SetBitmaps fix.</p>
<p>Applied Patch #1239456: wxPython wx.DataObject.GetAllFormats fix.</p>
<p>Applied Patch # #1230107 which allows image handlers to be written in
Python by deriving from wx.PyImageHandler.</p>
<p>Applied patch #1072210: generalize printout.py to allow text printing.</p>
<p>Applied patch #1243907: Give Throbber much more flexibility by
allowing the user to set the rest image, the direction, the current
index, custom sequence.  Allows user to manually step through the
sequence with Next(), Previous(), Increment(), Decrement() &amp;
SetCurrent(). Very handy if you have multiple throbbers that you want
to synchronize with a single timer.</p>
<p>Fix for bug #1336711: wx.lib.calendar.CalenDlg can yield incorrect
result.</p>
<p>Applied patch from Morgan Hua for updates to ActiveGrid code
(pydocview, ActiveGrid IDE, etc.)</p>
<p>Applied patch #1326241: Supporting &quot;setup.py install --install-headers=path&quot;</p>
<p>Applied patch from Morgan Hua to fix bug #1219423: CommandManager
should not repeat old commands after a branch.</p>
<p>Applied patch #1238825 adding search backward capabilities to the
demo.  Modified to use the up/down options in the wx.FindReplaceDialog
instead of a separate menu item.</p>
<p>Fix for bug #1266745 and #1387725 in the wx.FindReplaceDialog on MSW.
Actually check we are using MSLU before doing the hack designed to
workaround a bug in MSLU!</p>
<p>wxMSW: wx.lib.iewin.IEHtmlWindow now properly handles tabbing, return
and other special keys properly.</p>
<p>Lots of PyCrust enhancments started by Franz Steinaeusler, Adi Sieker,
and Sebastian Haase, and which in turn were further enhanced, fixed
tweaked and finished up by me.  The changes include the following:</p>
<blockquote>
<ul class="simple">
<li>The Autocomplete and Calltip windows can now be opened manually
with Ctrl-Space and Ctrl-Shift-Space.</li>
<li>In the stand alone PyCrust app the various option settings,
window size and position, and etc. are saved and restored at the
next run.</li>
<li>Added a help dialog bound to the F1 key that shows the key
bindings.</li>
<li>Added a new text completion function that suggests words from
the history.  Bound to Shift-Return.</li>
<li>F11 will toggle the maximized state of the frame.</li>
<li>switched to Bind() from wx.EVT_*().</li>
<li>Display of line numbers can be toggled.</li>
<li>F12 toggles a &quot;free edit&quot; mode of the shell buffer.  This mode
is useful, for example, if you would like to remove some output
or errors or etc. from the buffer before doing a copy/paste.
The free edit mode is designated by the use of a red,
non-flashing caret.</li>
<li>Ctrl-Shift-F will fold/unfold (hide/show) the selected lines.</li>
<li>General code cleanup and fixes.</li>
<li>Use wx.StandardPaths to determine the location of the config
files.</li>
<li>Use wx.SP_LIVE_UPDATE on crust and filling windows.</li>
<li>Extended the saving of the config info and other new features to
the PyShell app too.  Additionally, other apps that embed a
PyCrust or a PyShell can pass their own wx.Config object and
have the Py code save/restore its settings to/from there.</li>
<li>All of the classes with config info get an opportunity to
save/load their own settings instead of putting all the
save/load code in one place that then has to reach all over the
place to do anything.</li>
<li>Enable editing of the startup python code, which will either be
the file pointed to by PYTHONSTARTUP or a file in the config dir
if PYTHONSTARTUP is not set in the environment.</li>
<li>Added an option to skip the running of the startup code when
PyShell or PyCrust starts.</li>
<li>PyCrust adds a pp(item) function to the shell's namespace that
pretty prints the item in the Display tab of the notebook.
Added code to raise that tab when pp() is called.</li>
<li>Added an option for whether to insert text for function
parameters when popping up the call tip.</li>
<li>Added Find and Find-Next functions that use the
wx.FindReplaceDialog.</li>
</ul>
</blockquote>
<p>Applied patches from Will Sadkin for wx.lib.masked modules:</p>
<blockquote>
<ul class="simple">
<li>Now ignores kill focus events when being destroyed.</li>
<li>Added missing call to set insertion point on changing fields.</li>
<li>Modified SetKeyHandler() to accept None as means of removing
one.</li>
<li>Fixed keyhandler processing for group and decimal character
changes.</li>
<li>Fixed a problem that prevented input into the integer digit of a
integerwidth=1 numctrl, if the current value was 0.</li>
<li>Fixed logic involving processing of &quot;_signOk&quot; flag, to remove
default sign key handlers if false, so that
SetAllowNegative(False) in the NumCtrl works properly.</li>
<li>Fixed selection logic for numeric controls so that if
selectOnFieldEntry is true, and the integer portion of an
integer format control is selected and the sign position is
selected, the sign keys will always result in a negative value,
rather than toggling the previous sign.</li>
</ul>
</blockquote>
<p>wx.FontMapper.SetConfig is deprecated.  You should instead just set an
application-wide config object with wx.Config.Set, which wx.FontMapper
will use by default.</p>
<p>Added wx.GetMouseState which returns the current state of the mouse.
It returns an instance of a wx.MouseState object that contains the
current position of the mouse pointer in screen coordinants, as well
as boolean values indicating the up/down status of the mouse buttons
and the modifier keys.</p>
<p>Added wx.SizerItem.SetUserData</p>
<p>A variety of updates to wx.lib.floatcanvas, including Added
DrawObjects, including a ScaledTextBox, with auto-wrapping, etc, and
Scaled and Unscaled Bitmap Objects.</p>
<blockquote>
WARNING: Changed all DrawObjects to take an (x,y) pair rather
than individual x,y parameters. Also changed rectangles and
ellipses to take (w,h) pair. This is an API change, but should
be easy to accommodate, all you need to do is add a parenthesis
pair:  (...x, y, ...) ---&gt;  (...(x,y), ...)</blockquote>
</div>
<div class="section" id="id3">
<h1><a name="id3">2.6.1.0</a></h1>
<ul class="simple">
<li>4-June-2005</li>
</ul>
<p>wx.ListCtrl: patch #1210352, fixes editing in generic wx.ListCtrl with
wx.LC_EDIT_LABELS.</p>
<p>Applied patch #208286, MediaCtrl DirectShow rewrite.</p>
<p>DocView patches from Morgan Hua: bug fixes, and additional SVN
commands, also added a default template that uses the text editor for
any unknown file type.</p>
<p>wxMSW: Use the system IDC_HAND cursor for wx.CURSOR_HAND and only fallback
to the strange wxWidgets version if the system one is not available.</p>
<p>wx.grid.Grid: Merge the cell size attribute the same way that other
attributes are merged, e.g., if it is already set to a non-default
value in the current GridCellAttr object then don't merge from the
other.</p>
<p>wx.lib.evtmgr: Fixed to use wx._core._wxPyDeadObject</p>
<p>wx.lib.gridmovers: Don't scroll when the mouse is dragged outside of
the grid, unless the mouse is kept in motion.</p>
<p>wxMSW:  Applied patch #1213290 incorrect logic in
wx.TopLevelWindow.ShowFullScreen.</p>
<p>Applied patch #1213066 correct device names for Joystick in Linux.</p>
<p>wxGTK: Applied patch #1207162 wx.TextCtrl.SetStyle fix for overlapping
calls.</p>
<p>wx.FileConfig: fixed DeleteEntry to set the dirty flag properly so the
change will get written at the next flush.</p>
</div>
<div class="section" id="id4">
<h1><a name="id4">2.6.0.1</a></h1>
<ul class="simple">
<li>30-May-2005</li>
</ul>
<p>Added wx.BrushFromBitmap to create a stippled brush in a single step.
Also added missing brysh style flags: wx.STIPPLE_MASK
wx.STIPPLE_MASK_OPAQUE.</p>
<p>wxMSW: Fix for default control colours when the system text fg colour
is not black.</p>
<p>wxGTK: Patch #1171754, It is now possible to have a menu item that
both has an icon and is a submenu.</p>
<p>wxMSW: Patch #1197009, better refreshes when windows are moved and
resized.</p>
<p>wxMSW: Patch #1197468.  Keeps track of pending size/position changes
in case there is more than one adjustment for a window in a single
DeferWindowPos set, then the pending values can be used for defaults
instead of current values.</p>
<p>Fixed the typemap that converts a Python list of strings to a
wxArrayString so it uses the wxPython default encoding.</p>
<p>Several docstrings added and updated.  Lots more to go.</p>
<p>wxMac: Strings added to the clipboard or used in DnD no longer have an
extra null character at the end.</p>
<p>Added wx.GetXDisplay that returns a raw swigified pointer for the X11
Display, or None for the non-X11 platforms.</p>
<p>wxMenu: Don't send an event when selecting an already selected radio
item.</p>
<p>Added wx.LaunchDefaultBrowser.</p>
<p>wxMSW: Fixed erroneous selection of content in wx.ComboBox when within
a wx.StaticBox.</p>
<p>wxMSW: Fixed alpha blitting to take into account source position.</p>
<p>Ensure that Python is still in an initialized state before doing any
locking or unlocking in wxPyBeginBlockThreads and wxPyEndBlockThreads
as these can be triggered after Python has been finalized in embedding
situations.</p>
<p>Added alternate constructors for wx.Font: wx.FontFromPixelSize,
wx.FFont, wx.FFontFromPixelSize.  See the docstrings or new api docs
for details.</p>
<p>Added wx.lib.hyperlink from Andrea Gavana.  It is a control like
static text that acts like a hyper-link, launching the system's
default browser in response to the clicks.</p>
<p>Added an optional parameter to wxversion.select that allows you to
specify that the extra components specified in the version string are
required.  For example, if you ask for &quot;2.6-unicode&quot; but only the ansi
version is installed then by default the ansi version will be selected
as it considered close enough since the version numbers match.  If you
want to force the options to be required then you can just add a True
parameter, like this:</p>
<pre class="literal-block">
import wxversion
wxversion.select(&quot;2.6-unicode&quot;, True)
import wx
</pre>
<p>Tweaked wx.lib.buttons such that flat buttons (e.g. have no bevel and
a wx.BORDER_NONE style flag) paint themed backgrounds if there are
transparent areas and the parent is displaying a theme.</p>
<p>wxMSW:  Fix for wrong sash colour of wx.SplitterWindow in the silver
theme on XP.</p>
<p>Added a wx.xrc.XmlResourceHandler for the Ticker class.  See
wx/lib/ticker_xrc.py</p>
<p>wxSTC: Fixed CmdKeyAssign key bindings for Ctrl-Backspace.</p>
<p>wxMSW: Fixed a bug in wx.TextCtrl where all the lines were being used
to calculate the best size, instead of using a reasonable limit.</p>
<p>XRCed: Use wx.GetDefaultPyEncoding/wx.SetDefaultPyEncoding for
changing active encoding.  Fixed pasting siblings (Ctrl key pressed
while pasting).</p>
<p>wx.lib.filebrowsebutton: Bug fix from Chad Netzer for when
self.history is None.</p>
<p>wx.ogl: Patch from Davide Salomoni that adds an optional point
parameter to LineShape.InsertLineControlPoint allowing one to
optionally specify where the new control point has to be drawn.</p>
<p>wxMSW: setting foreground colour for wx.CheckBox now works when using
XP themes.</p>
<p>More updates to the docview library modules and sample apps from the
ActiveGrid folks.  Their sample IDE is now able to integrate with
Subversion.</p>
<p>wx.grid.Grid:  Ensure that the grid gets the focus when it is
left-clicked.  Note that if you have custom widgets that handle the
EVT_LEFT_DOWN event but do not call event.Skip() then you will
probably want to add a call to self.SetFocus in the event handler.</p>
<p>wxGTK:  Add wxSTAY_ON_TOP support [Patch 1206023]</p>
<p>wx.TreeCtrl:  wx.EVT_TREE_ITEM_MENU event made consistent on all
platforms.  The location of the click or the item is included in the
event as well.</p>
<p>wxGTK: Setting background colour of a window now only affects the
window itself, not the borders, scrollbars, etc.  (Bug #1204069)</p>
<p>Print framework:  Add more paper sizes and code to fallback to an
explicit paper size if a known paper size is not found for the
printer.</p>
<p>wxMac: Applied patch for bug #1206181 Option-key decodes are wrong,
also applied patch for bug #1205691 Modified Fn keys don't work.</p>
<p>wx.Image: Fixed to preserve alpha channel in Rotate90 method.</p>
<p>wxMSW: Fixed incorrect background colour on wx.CheckListBox.</p>
<p>wxMSW: Fixed drawing of owner drawn buttons with multiline labels</p>
<p>Removed a bunch of unnecessary files, and removed or replaced images
that we're not sure of their origin or license.</p>
<p>The default DoGetBestSize is updated to not always return the current
size if the window has no sizer, children, or minsize set.  Instead
the current size is set as the minsize.  This solves the occasional
problem where a sizer may cause a childless panel to grow but never
shrink.</p>
<p>wxMSW: When converting a wx.Icon to a bitmap check if the icon has an
alpha channel and set the bitmap to use it.</p>
<p>Fixed the wrong class name used in wx.PyScrolledWindow's call to
_setCallbackInfo.</p>
<p>wxMSW: patch #1207202, Fixes GDI leak when using stock cursors.</p>
<p>wx.calendar.CalendarCtrl: Patch #1207531, Keeps the CalendarCtrl wide
enough even when the weekday names for the locale are shorter than
usual.</p>
<p>Made GridCellNumberEditor.StartingKey also insert the typed char when
there is a range of allowed values (so a wx.SpinCtrl is used instead
of a wx.TextCtrl.)</p>
</div>
<div class="section" id="id5">
<h1><a name="id5">2.6.0.0</a></h1>
<ul class="simple">
<li>26-Apr-2005</li>
</ul>
<p>wxMSW: Fixed wx.TransientPopupWindow (and therefore wx.TipWindow) to
auto-dismiss when the mouse is clicked outside of the popup like it is
supposed to.</p>
<p>wxMSW: Fixed bug #1167891 wx.Notebook display problem with wx.NB_MULTILINE.</p>
<p>wxMSW: Fixed bad cliping of hidden windows inside of wx.StaticBox.</p>
<p>wxGTK:  The configure flags for selecting GTK+ 1.2.x or 2.x has
changed slightly.  It is now --with-gtk[=VERSION] where VERSION is
either '1', '2' or 'any'.  The default is '2'.</p>
<p>wx.stc.StyledTextCtrl: Added the following methods for alternate ways
to set and fetch text from the document buffer.  They work similarly
to the existing methods of the same name, except that they don't go
through the same string/unicode &lt;--&gt; wxString conversions.  The &quot;Raw&quot;
methods will do no conversions at all and in a unicode build of
wxPython the strings will be in the utf-8 encoding and in an ansi
build no assumption is made about the encoding.  The &quot;UTF8&quot; functions
will attempt to always get/set utf-8 text, which it will always be
able to do in a unicode build, and in an ansi build it will depend on
the content of the utf-8 used being compatible with the current
encoding, (you'll get an exception otherwise.)</p>
<blockquote>
<table border="1" class="docutils">
<colgroup>
<col width="49%" />
<col width="51%" />
</colgroup>
<tbody valign="top">
<tr><td>AddTextRaw</td>
<td>AddTextUTF8</td>
</tr>
<tr><td>InsertTextRaw</td>
<td>InsertTextUTF8</td>
</tr>
<tr><td>GetCurLineRaw</td>
<td>GetCurLineUTF8</td>
</tr>
<tr><td>GetLineRaw</td>
<td>GetLineUTF8</td>
</tr>
<tr><td>GetSelectedTextRaw</td>
<td>GetSelectedTextUTF8</td>
</tr>
<tr><td>GetTextRangeRaw</td>
<td>GetTextRangeUTF8</td>
</tr>
<tr><td>SetTextRaw</td>
<td>SetTextUTF8</td>
</tr>
<tr><td>GetTextRaw</td>
<td>GetTextUTF8</td>
</tr>
<tr><td>AppendTextRaw</td>
<td>AppendTextUTF8</td>
</tr>
</tbody>
</table>
</blockquote>
<p>wx.stc.StyledTextCtrl:  Added the StyleSetFontEncoding(style, enc)
method that allows you to set the encoding to be used by the font for
a particular style.</p>
<p>wxMac: Fixed wx.ComboBox to forward the EVT_CHAR, EVT_KEY_DOWN,
EVT_KEY_UP and EVT_TEXT events from its embedded text control.</p>
<p>wxMac: Corrected refresh bugs in wxGrid.</p>
<dl class="docutils">
<dt>XRCed: Updated to version 0.1.5.</dt>
<dd><ul class="first last simple">
<li>Added wxWizard, wxWizardPageSimple (only from pull-down menu).</li>
<li>Hide command for test window.</li>
<li>Replacing classes works better.</li>
<li>Added Locate tool.</li>
</ul>
</dd>
</dl>
</div>
<div class="section" id="id6">
<h1><a name="id6">2.5.5.1</a></h1>
<ul class="simple">
<li>8-Apr-2005</li>
</ul>
<p>wxMSW: Fixed bug #1022383, 'several ComboBoxes appear selected'</p>
<p>wx.grid.Grid: Fixed bug #1163384.  Moved the code that handles
activating the cell editors to a EVT_CHAR event handler.  This is done
so the character inserted into the editor will be the &quot;cooked&quot; char
value (including accented or composed keys) rather than the raw code
provided by the EVT_KEY_DOWN event.</p>
<p>Added orient parameter to wx.MDIParentFrame.Tile()</p>
<p>wxMSW: wxTextCtrl with wx.TE_RICH2 style now uses RichEdit 4.1 if
available.</p>
<p>Added GetCount, GetCountRGB, and GetCountColour methods to
wx.ImageHistogram.</p>
<p>wxMSW: wx.Window.Refresh changed to explicitly refresh all children as
well as the parent.  Previously it was implicitly done because parents
did not clip their children by default.  Now that they always clip
children then Refresh needed to be fixed to do a recursive refresh.
This also fixes the Freeze/Thaw problems that some people had with
2.5.4.1.</p>
<p>wx.SplitterWindow: Send EVT_SPLITTER_SASH_POS_CHANGED only once after
end of dragging and not after each CHANGING event (modified patch
#1076226)</p>
<p>wx.glcanvas.GLCanvas: applied patch fixing problems with X server
crash when using nVidia cards (patch 1155132)</p>
<dl class="docutils">
<dt>wx.lib.mixins.listctrl: Patches from Toni Brkic:</dt>
<dd><ul class="first last simple">
<li>Bugfix for TextEditMixin when the view can't be scrolled</li>
<li>Enhancement for ListCtrlAutoWidthMixin, allowing it to manage
the width of any column.</li>
</ul>
</dd>
</dl>
<p>wxMac: removal and reusing toolbar tools like the other platforms is
now possible.</p>
<p>wxMac: Correct radio tool selection after calling Realize a 2nd time.</p>
<p>wxMSW: Applied patch #1166587, removes all flicker from wx.StaticBox</p>
<p>Added wx.lib.foldpanelbar, Andrea Gavana's port of Jorgen Bodde's C++
wxFoldPanelBar classes to Python.</p>
<p>wxGTK: Applied patch #1173802, reimplementation of GtkFileChooser
wxFileDialog by Mart Raudsepp.  Note that this new file dialog is only
used on GTK2 &gt;= 2.4.  For earlier GTK2 versions and GTK1 then the
older generic file dialog is used.</p>
<p>wxMSW: fixes to static box borders calculations (finalizes patch
#1166587)</p>
<p>wx.Image: Use Python's buffer interface API for all image data and
alpha Set/Get methods and the ImageFromData* constructors.  They all
still copy the buffer except for SetDataBuffer and SetAlphaBuffer, but
this gives more flexibility on where the data can come from.</p>
<p>Added MDI support to XRC</p>
<p>Added wx.animate module and a demo.  The wx.animate module provides a
control that is able to display an animated GIF file.</p>
<p>wx.lib.plot.py: Applied patch from Werner F. Bruhin that allows either
vertical and/or horizontal gridlines.</p>
<p>wxMSW: Extra space given for top border of wx.StaticBoxSizer so the
upper line is not cliped when there is no label.</p>
<p>wxMSW: Restored old behaviour of wx.StaticBox.SetBackgroundColour only
affecting the label.</p>
<p>wxMSW: Fixed missing EVT_RIGHT_DOWN and EVT_TREE_ITEM_RIGHT_CLICK
events in a wx.TreeCtrl.</p>
<p>Added wx.GetTopLevelWindows() function which returns a copy of the
list of top-level windows that currently exist in the application.</p>
<p>Updated docview library modules and sample apps from the ActiveGrid
folks.</p>
<p>Added the ActiveGrid IDE as a sample application.</p>
</div>
<div class="section" id="id7">
<h1><a name="id7">2.5.4.1</a></h1>
<ul class="simple">
<li>16-Mar-2005</li>
</ul>
<p>wx.Sizer Add, Insert, and Prepend functions now return a reference to the
wx.SizerItem that was added to the sizer, and the wx.SizerItem has a
GetRect accessor to give the position of the item on the parent window.</p>
<p>Added wx.Sizer.GetItem method which returns the wx.SizerItem for the given
wx.Window, wx.Sizer or position index.</p>
<p>wxMSW: wx.RadioButtons in the same group no longer have to be
consecutive (there may be intervening controls). Without this fix, an
out-of-sync assert is generated when clicking on a radio button and
then calling GetValue().</p>
<dl class="docutils">
<dt>Some XRC changes:</dt>
<dd><ul class="first last simple">
<li>Added 'icon' property to wxFrame and wxDialog</li>
<li>No longer ignores menu bitmaps on non-MSW platforms</li>
<li>Notebook page bitmaps are now supported</li>
<li>added system colours and fonts support (based on patch #1038207)</li>
</ul>
</dd>
</dl>
<p>wxMSW: fix for [ 1052989 ] TextCtrl.SetBackgroundColour(wx.NullColour)
bug.</p>
<p>Added wx.PasswordEntryDialog analagous to wx.TextEntryDialog, allows
detecting entering an empty string vs. cancel unlike the
wx.GetPasswordFromUser dialog function.</p>
<p>OGL patch from Shane Holloway:</p>
<blockquote>
<p>Two simple problems found in the new python ogl code.  First is
the patch for _canvas.py.  Essentially:</p>
<pre class="literal-block">
dx = abs(dc.LogicalToDeviceX(x - self._firstDragX))
dy = abs(dc.LogicalToDeviceY(y - self._firstDragY))
</pre>
<p>was incorrect because (x,y) and (self._firstDragX,
self._firstDragY) are both already in Logical coordinates.
Therefore the difference between the two is also in logical
coordinates, and the conversion call is an error.  This bug
surfaces when you have OGL on a scrollwin, and you are far from
the origin of the canvas.</p>
<p>The second change in _composit.py basically removes the assumption
that the child is in both self._children and self._divisions.
Causes many problems when it's not.  ;)</p>
</blockquote>
<p>Fixed GetSaveData and SetSaveData in wx.lib.multisash to not depend on
the default way that class objectss are converted to strings.</p>
<p>Fixed problem in StyledTextCtrl.Set[HV]ScrollBar that could leave the
internal scrollbar visible.</p>
<p>Added wx.StandardPaths which provides methods for determining standard
system paths for each platform.</p>
<p>wxMSW: The window background is now only erased by default if the
background colour or background mode has been changed.  This better
allows the default system themed behaviour to show through for
uncustomized windows.  Explicit support added for using the correct
theme texture for wx.Notebook pages and their children.</p>
<p>wx.Image: Added support for alpha channels in interpolated and
non-interpolated image rotation.  Added ConvertAlphaToMask helper
method for turning shades of grey into shades of alpha and a colour.</p>
<p>wxGTK2: Reimplemented DoDrawRotatedText() by way of a rotation of an
alpha blended text bitmap.  It would be better if Pango could draw
directly into an wxImage (as FreeType can,) but that is for later...</p>
<p>Added wrappers and a demo for the wx.MediaCtrl class, which can play
various forms of audio/video media using native codecs install on the
system.  So far it is only implemented for Windows and OSX.</p>
<p>wxGTK: Patch applied for Freeze()/Thaw() for wxTextCtrtl.</p>
<p>Added &quot;gravity&quot; for splitter window (patch 1046105). Gravity is a
floating-point factor between 0.0 and 1.0 which controls position of
sash while resizing the wx.SplitterWindow.  The gravity specifies
how much the left/top window will grow while resizing.</p>
<p>wxMSW: wx.Slider's C++ implementation rewritten to be more
maintainable and hopefully less buggy.  The position of the labels has
also been changed in order to better comply with Microsoft's examples
of how to use the control.</p>
<p>wxMSW:  Fix wx.TreeCtrl to end label editing if the control loses
focus (a slightly modified patch 1084592.)</p>
<p>Added wx.EXEC_NODISABLE flag for wx.Execute, which will prevent all
the app's windows being disabled while a synchronous child process is
running.</p>
<p>wxMSW: Much work to correct painting (or leaving transparent) of
control backgrounds, properly using background themes on XP, etc.</p>
<p>Fixed a circular reference problem with wx.Timer.  It will now
completely cleanup after itself when the last reference to the timer
is removed.  If you were previously using timer.Destroy() to cleanup
your timers it will no longer work.  Instead you should hold a
reference to the timer and then del the reference when you are
finished with the timer.</p>
<p>Updated to 1.3.24 of SWIG.  All of my big patches have been applied to
the main SWIG source tree, but unfortunatly there were also some bugs
added that affected the wxPython build and a few details in my
original patch were changed/removed, so we are still not free of
patches.  A new patch for SWIG is located in the wxPython/SWIG
directory of the wxPython source tree.  SWIG 1.3.24 plus this patch
should be used by anyone who is making custom modifications to
wxPython's .i files, or building their own extension modules or
etc. that need to interact with the wxPython swigged types.  For the
morbidly curious, here are a few more details:</p>
<blockquote>
<ul class="simple">
<li>Since it is now possible easily and simply share the SWIG type
tables across modules I reverted to always using the stock SWIG
runtime instead of my slightly hacked up version of it exported
via the wxPython C API.</li>
<li>The %name directive is now deprecated so I replaced most uses of
it with a custom %Rename macro that uses %rename internally.
These will evetually need to be replaced with a DocDecl macro
when docstrings are added for those items.</li>
<li>The &quot;this&quot; attribute of all SWIGged classes is no longer a
string containing a &quot;swigified pointer&quot;, but rather a custom
built-in type that holds the real C pointer to the object and
the type info.  It can be converted to a string like the old
value using str() or to the long integer value of the pointer
using long().</li>
</ul>
</blockquote>
<p>Added SetDefaultPyEncoding and GetDefaultPyEncoding functions which
will set/get the encoding used by wxPython to convert string or
unicode objects to/from wxString objects.  Previously the default
Python encoding was always used, but unless the user had tweaked their
sitecustomize.py file it is always &quot;ascii&quot;, which would result in
errors if the strings contained character codes &gt;= 128.
SetDefaultPyEncoding will now allow you to control which encoding will
be used to do those conversions.  The default encoding is set to the
value of <cite>locale.getdefaultlocale()[1]</cite> when wxPython is first
imported.  Please see <a class="reference" href="http://www.alanwood.net/demos/charsetdiffs.html">http://www.alanwood.net/demos/charsetdiffs.html</a>
for information on the differences between the common latin/roman
encodings.</p>
<p>Added wxStdDialogButtonSizer, which is a a special sizer that knows
how to order and position standard buttons in order to conform to the
current platform's standards.  You simply need to add each <cite>wx.Button</cite>
to the sizer, and be sure to create the buttons using the standard
ID's.  Then call <cite>Realize</cite> and the sizer will take care of the rest.</p>
<p>wxMSW Toolbar: pass correct tool id (and not always -1) to the
EVT_TOOL_RCLICKED handler</p>
<p>wxGTK: Applied patch for combo box SELECTED events (no longer get
lots of surplus events)</p>
<p>wxGTK: Applied patch for proper menu highlight colour detection in
wx.SystemSettings.</p>
<p>wxGTK: Commited scrollbar patch #1093339 which sends lineup, linedown
events based on intercepting the mouse down events.</p>
<p>wxGTK: Applied patch #1102789 which solved conflicts between wxWidgets
and GTK+'s context menu code.</p>
<p>wxGTK: Applied patch #1100327 for correct feedback from DND actions
(not all actions are allowed).</p>
<p>Fixed memory leak in wxGrid::UpdateAttr[Rows][Or][Cols] (patch 1104355)</p>
<p>For efficiency reasons, text controls no longer set the string for
each text updated event, but rather query for the string value only
when GetString is called from an event handler.</p>
<p>Added wx.SL_INVERSE style which will cause wx.Slider to invert the min
and max ends of the slider.</p>
<p>Several patches applied, such as #1111174, #1110252 and others, that
make the generic wx.TreeCtrl (used on wxGTK and wxMac) be more
conistent with the wxMSW native wx.TreeCtrl.</p>
<dl class="docutils">
<dt>XRCed:</dt>
<dd><ul class="first last simple">
<li>Edit-&gt;Locate command (Ctrl-L) for quick selection of items.
Works with event-handling controls (buttons, text fields) but
not with labels/sizers.</li>
<li>Some improvements: relative paths for files supplied as command-
line argument work correctly, notebook panels are highlighted
better.</li>
</ul>
</dd>
</dl>
<p>wxMac: Fixed a long-standing issue where wxSlider controls with a
hardcoded size would misplace their labels behind the slider control.</p>
<p>wx.HtmlListBox fixed so calling RefreshLine(s) will cause the data for
that line to be refetched from the overridden methods in the derived
class.</p>
<p>The default DoGetBestSize now includes the difference (if any) between
the client size and total size of the window, (such as the size of
borders.)  Code that sets the client size using the best size, or that
added extra space to sizers to compensate for this bug may need to be
changed.</p>
<p>Can suppress themed notebook pages with the wxNB_NOPAGETHEME style or
setting system option msw.notebook.themed-background to 0.</p>
<p>wxSyledTextCtrl updated to use Scintilla 1.62.</p>
<p>Can now set the msw.window.no-clip-children system option to 1 to
eliminate weird refresh behaviour (delays between a window being
erased and repainted, giving a ghostly gradual-redraw effect). May be
a temporary 'fix' until properly fixed before 2.6.</p>
<p>wxMac:  Toolbar is now more native looking with borderless toolbar
buttons.</p>
<p>wxMac: Switched wx.Bitmap to use newer Quartz object types and APIs
internally.  This results in faster display and better alpha support.</p>
<p>Added wx.DatePickerCtrl.</p>
<p>wx.html.HtmlWindow now supports background images.</p>
<p>Added wx.lib.gestures module from Daniel Pozmanter which supports
using Mouse Gestures in an application.</p>
<p>wxGTK2: ENTER and LEAVE mouse events are now sent for multi-line text
controls.</p>
<p>wxMSW:  &quot;Alt&quot; key (VK_MENU) now results in WXK_ALT keyboard event, not
WXK_MENU</p>
<p>Added modules from Peter Yared and Morgan Hua that implement the wx
Doc/View framework in pure Python code.  See wx.lib.docview for the
base implementation and wx.lib.pydocview for Python-specific
extensions.  There are also a couple sample applications located in
samples/docview.</p>
<p>Added GetBitmap, GetIcon to wx.ImageList.</p>
<p>wxGTK wx.Button.SetLabel no longer invalidates/resets the font.</p>
<p>wx.Sizer.AddWindow, AddSizer, AddSpacer and etc. have now been
undeprecated at the request of Riaan Booysen, the Boa Constructor team
lead.  Boa needs them to help keep track of what kind of item is being
managed by the sizer.  They are now just simple compatibility aliases
for Add, and etc.</p>
<p>The old C++ version of the OGL lib is no longer built by default.  Use
the Python version in the wx.lib.ogl package instead.</p>
<p>The wx.iewin module is no longer built by default.  You can use the
wx.lib.iewin version instead.</p>
<p>Fixed wx.BufferedPaintDC for scrolled windows to work whether the
buffer is covering only the client area or the full virtual area of
the scrolled window.  By default it will assume that only the client
area is covered.  This is different than the old behavior so to
indicate that the entire virtual area is covered simply add a
style=wx.BUFFER_VIRTUAL_AREA parameter.</p>
<p>wx.gizmos.TreeListCtrl:  Add support for the EVT_TREE_ITEM_GETTOOLTIP
event.</p>
<p>Added Resize, SetRGBRect, Size, and GetOrFindMaskColour methods to
wx.Image.</p>
<p>Added wx.Rect.IsEmpty</p>
<dl class="docutils">
<dt>wxGTK:</dt>
<dd><ul class="first last simple">
<li>Corrected wx.ListBox selection handling</li>
<li>Corrected default button size handling for different themes</li>
<li>Corrected splitter sash size and look for different themes</li>
<li>Fixed keyboard input for dead-keys</li>
</ul>
</dd>
</dl>
</div>
<div class="section" id="id8">
<h1><a name="id8">2.5.3.1</a></h1>
<ul class="simple">
<li>9-Nov-2004</li>
</ul>
<p>wxMac focus and border refreshes corrected.</p>
<p>Updated internal PNG library.</p>
<p>wxMac fix for metal appearance on wx.ToolBar.</p>
<p>wx.grid.Grid fix allowing DoGetBestSize to be called before CreateGrid
(which means that a min size doesn't need to be specified.)</p>
<p>wxMac fix for not sending a native click to a control if it is not
enabled (does an enable itself)</p>
<p>Added wx.lib.ogl.DrawnShape, and fixed various little bugs in the new
OGL.</p>
<p>Added support to XRC and XRCed for the 3-state checkbox flags and also
for wx.ToggleButton.  Updated the generic window styles supported by
XRCed.</p>
<p>It is now possible to create &quot;stock&quot; buttons.  Basically this means
that you only have to provide one of the stock IDs (and either an
empty label or a label that matches the stock label) when creating the
button and wxWidgets will choose the stock label to go with it
automatically.  Additionally on the platforms that have a native
concept of a stock button (currently only GTK2) then the native stock
button will be used.  For example, the following will result in a
button with &quot;Cancel&quot; as the label and if run on wxGTK2 then there will
also be an image of a red X:</p>
<pre class="literal-block">
b = wx.Button(parent, wx.ID_CANCEL)
</pre>
<p>Added wx.lib.ticker.Ticker class from Chris Mellon.</p>
<p>Fix some incorrect clipping regions in wxSTC on wxGTK.</p>
<p>Added wrapper for wx.grid.Grid.GetOrCreateCellAttr.</p>
<p>Removed my copy of distutils from the wxPython source tree.  Now that
I am no longer doing builds on Python 2.1 the newest distutils is no
longer needed.  (There is still one small bug in Python 2.2 distutils
on win32, but it is easily worked around.) This sovles the problem of
incorrect builds on some systems where the system installed distutils
has been patched to behave slightly differently, for example SuSE on
x86_64 or Chandler's build.</p>
<p>Updated to SWIG 1.3.22 (plus my patch.)  See wxPython/SWIG/README.txt
in the source tree if you need to use SWIG when building your own copy
of wxPython, or other extension modules that need to integrate with
the wxPython modules.</p>
<p>Added wx.Frame.RequestUserAttention which, if the platform suports it,
will do something (such as flash the task bar item) to suggest to the
user that they should look at that window.</p>
<p>&quot;Fixed&quot; wx.grid.Grid.SetDefaultEditor and SetDefaultRenderer by making
them register the editor or renderer for the &quot;string&quot; data type.</p>
<p>Added depth param to wx.Image.ConvertToBitmap.</p>
<p>Extended the wx.calendar.CalendarCtrl class with methods that get/set
a Python datetime or date object.  (These will only work with Python
2.3+) The methods are PySetDate, PyGetDate, PySetLowerDateLimit,
PySetUpperDateLimit, PySetDateRange, PyGetLowerDateLimit, and
PyGetUpperDateLimit.  Also, CalendarEvent was extended with PySetDate
and PyGetDate methods.</p>
<p>wxMSW: SetBackgroundColour on a wx.Choice or a wx.ComboBox will now
also set the colour of the dropdown.</p>
<p>wxMac: MessageDialog now supports wx.NO_DEFAULT style</p>
<p>wxMSW: added AssociateHandle and DissociateHandle to wx.Window</p>
<p>wxMac: fix for toolbar tooltips</p>
<p>wx.Sizer.Show (and Hide) now take an optional parameter specifying if
the item to be shown should be searched for recursivly in subsizers,
and return a boolean value indicating if the item was found.</p>
<p>wxMSW: fixed MaximizeEvent generation in wx.Frame</p>
<p>wxMSW: fixed sending duplicate EVT_COMBOBOX events</p>
<p>Smoother time estimation updates in wx.ProgressDialog (patch 992813)</p>
<p>Made wx.Listbook events more consistent with wx.Notebook ones (patch
1001271)</p>
<p>Fixed rounding errors in variable status bar panes widths computation
(patch 1030021)</p>
<p>Added possibility to specify printer bin (patch 910272)</p>
<p>wxMSW: fixed wx.ListCtrl's SetWindowStyleFlag() to not remove
WS_VISIBLE; also refresh the control automatically (closes bug
1019440)</p>
<p>Added wx.Choicebook, yet another notebook-like control.</p>
<p>wxMSW: Make radiobutton tab behaviour the same on MSW as in standard
MSW app, i.e. tab into the activated, not necessarily the first radio
button.</p>
<p>Added limited support for wxEventLoop (you can't derive from a
wx.PyEventLoop version yet...)  Updated and moved the sample showing
how to replace the MainLoop to samples/mainloop/mainloop.py.</p>
<p>The C++ xrc lib has been moved out of contrib and into the core, so it
is always built by default.  wxPython's build has also changed
accordingly and will build the xrc module as part of the core set of
modules built by default.  If you were axplicitly using BUILD_XRC then
it will no longer be recognized as a build option, otherwise you
should notice no difference.</p>
<p>wxMac: Fixed radio toolbar buttons to correctly untoggle the others
when a new one is selected.</p>
<p>wxMac: Fixed GetLineLength and GetLineText for MLTE text controls</p>
<p>wxMac: wx.TaskBarIcon is implemented by allowing you to change the
app's icon on the Dock and also specifying a menu that should be
merged with the normal dock popup menu.  See the MigrationGuide for
more details and a warning.</p>
<p>Added wx.TopLevelWindow.IsActive() which tells you if the frame or
dialog is or containts the active window with the keyboard focus.</p>
<p>Added ability to create a font based on pixel size rather than point
size via the FontFromPixelSize constructor.</p>
<p>Updated the Scintilla used by StyledTextCtrl to version 1.61</p>
<p>Improved image HitTest for TreeListCtrl.</p>
<p>Added wx.App.IsMainLoopRunning.</p>
<p>wxGTK: Make wxComboBox spit out a bit fewer surplus events when
holding down the mouse button.</p>
<p>wxGTK: Enable key based navigation through notebook tabs as in the
native control with Left and right keys. Support for vetoing.</p>
<p>FloatCanvas updates from Chris Barker</p>
<dl class="docutils">
<dt>PyPlot updates from Gordon Williams:</dt>
<dd><ul class="first last simple">
<li>Added bar graph demo</li>
<li>Modified line end shape from round to square.</li>
<li>Removed FloatDCWrapper for conversion to ints and ints in
arguments</li>
<li>Imported modules given leading underscore to name.</li>
<li>Added Cursor Line Tracking and User Point Labels.</li>
<li>Demo for Cursor Line Tracking and Point Labels.</li>
<li>Size of plot preview frame adjusted to show page better.</li>
<li>Added helper functions PositionUserToScreen and
PositionScreenToUser in PlotCanvas.</li>
<li>Added functions GetClosestPoints (all curves) and GetClosestPoint
(only closest curve) can be in either user coords or screen
coords.</li>
</ul>
</dd>
<dt>MaskedEdit updates from Will Sadkin:</dt>
<dd><ul class="first last simple">
<li>Added '*' mask char that means &quot;all ansii chars&quot; (ords 32-255)</li>
<li>Added proper unicode support to masked controls and wx.tools.dbg</li>
<li>Fixed two reported missing import bugs introduced by package
creation</li>
<li>Converted masked package doc strings to reST format for better
epydoc support</li>
<li>lots of doc string improvements and function hiding to better
reflect package's public contents.</li>
</ul>
</dd>
</dl>
<p>Restructured the installer packages slightly to help facilitate having
multiple versions of wxPython installed at the same time.  See the
Migrarion Guide for more information.</p>
<dl class="docutils">
<dt>Applied patch from Pim Van Heuven that modifies 4 files:</dt>
<dd><ul class="first last simple">
<li>wxPython/demo/ListCtrl_edit.py (new demo)</li>
<li>wxPython/demo/Main.py (include new demo in demo app)</li>
<li>wxPython/wx/lib/mixins/listctrl.py (several improvements to
TextEditMixin)</li>
<li>wxPython/wx/lib/wxpTag.py (some small fixes)</li>
</ul>
</dd>
</dl>
<p>Added (thanks to Kevin Ollivier!) wrappers for wx.WebKitCtrl for the
OSX build.  Other platforms will raise an exception if you try to use
it.</p>
<p>wxPython on OSX can now be built in Unicode mode, can support multiple
version installs, and comes with an uninstaller script.</p>
</div>
<div class="section" id="id9">
<h1><a name="id9">2.5.2.8</a></h1>
<ul class="simple">
<li>27-Aug-2004</li>
</ul>
<p>Predominantly a bug-fix release.</p>
<blockquote>
<ul class="simple">
<li>Fixed fatal error due to improper wrapping of wx.FSFile.</li>
<li>Fixed return type of EditableListBox.GetListCtrl</li>
<li>Give generic tree and list controls a DoGetBestSize so they play
nicer with sizers when there is no minimal size.</li>
<li>Some tweaks in the demo and samples to correct layout, some
flicker problems, and namespace use.</li>
<li>Add wx.Image.ConvertAlphaToMask</li>
<li>Minor corrections in wx.lib.dialogs</li>
<li>wx.FileHistory constructor now accepts the documented 2nd
parameter.</li>
<li>Corrections for exceptions in the new ogl</li>
<li>Fixed XRCed to not use reparenting of windows to implement caching
of property panels, since Reparent on wxMac is not implemented.</li>
<li>Add support for wxTAB_TRAVERSAL to the XRC handler for
wxScrolledWindow.</li>
<li>Add support for all wxListBox styles to the XRC handler for
wxCheckListBox.</li>
<li>Fix for wx.Listbook.DeleteAllPages to really delete everything.</li>
<li>wxGTK2 now supports alpha blended bitmap drawing</li>
<li>Made wx.grid.Grid play nicer with sizers.</li>
<li>etc.</li>
</ul>
</blockquote>
</div>
<div class="section" id="id10">
<h1><a name="id10">2.5.2.7</a></h1>
<ul class="simple">
<li>14-Aug-2004</li>
</ul>
<p>wx.ADJUST_MINSIZE is now the default behaviour for window items in
sizers.  This means that the item's GetMinSize and/or GetBestSize will
be called when calculating layout and the return value from that will
be used for the minimum size used by the sizer.  The wx.FIXED_MINSIZE
flag was added that will cause the sizer to use the old behaviour in
that it will <em>not</em> call the window's methods to determine the new best
size, instead the minsize that the window had when added to the sizer
(or the size the window was created with) will always be used.  Please
see the Sizers section in the Migration Guide for more details.</p>
<p>Added new MaskedEditControl code from Will Sadkin.  The modules are
now locaed in their own sub-package, wx.lib.masked.  Demos updated.</p>
<p>The changes that implemented the incompatible wx.DC methods in 2.5.1.5
have been reverted.  The wx.DC methods are now compatible with the 2.4
implemetation.  In addition a set of renamed methods have been added
that take wx.Point and/or wx.Size objects instead of individual
parameters.</p>
<p>Added wx.lib.mixins.listctrl.TextEditMixin, a mixin class that allows
all columns of a wx.ListCtrl in report mode to be edited.</p>
<p>Deprecated the wx.iewin module.</p>
<p>Deprecated the wx.Sizer.AddWindow, AddSizer, AddSpacer methods as well
as their Insert* and Prepend* counterparts.</p>
<p>Added a generic StaticBitmap class in wx.lib.statbmp for the same
reasons that stattext was created, so it could be mouse sensitive on
all platforms like normal windows.  Also updated stattext.py and
buttons.py to handle attribute (font &amp; colour) defaults and
inheritance the new way.  If you have custom controls of your own you
should review stattxt.py or one of the others to see how it is to be
done.</p>
<p>wx.InitAllImageHandlers is now an empty function that does nothing but
exist for backwards compatibility.  The C++ version is now called
automatically when wxPython is initialized.  Since all the handlers
are included in the wxWidgets shared library anyway, this imposes only
a very small amount of overhead and removes several unneccessary
problems.</p>
<p>Replaced wx/lib/pubsub.py with a version that uses weak references to
track the subscribers, plus other fixes/additions.  Thanks go to
Oliver Schoenborn and Robb Shecter.</p>
<p>wxGTK now uses gtk_init_check so wxPython can raise an exception if
there is no DISPLAY available or other initializaion problem.</p>
<p>wx.GetKeyState now has an implementation for wxGTK and is able to
detect the up/down or toggle state of modifier and toggle keys.</p>
<p>The LC_NUMERIC locale is now reset back to &quot;C&quot; (compatibility) when
running on wxGTK to work around the fact that GTK requires the locale
to be set to the system settings but Python depends on LC_NUMERIC
remaining compatible with &quot;C&quot;.</p>
<p>Switched gizmos.TreeListCtrl to the newer version of the code from the
wxCode project.</p>
<p>OGL is dead! LONG LIVE OGL!  (Oops, sorry.  A bit of my dramatic side
leaked out there...)  The wx.ogl module has been deprecated in favor
of the new Python port of the OGL library located at wx.lib.ogl
contributed by Pierre Hjlm.  This will hopefully greatly extend the
life of OGL within wxPython by making it more easily maintainable and
less prone to getting rusty as there seems to be less and less
interest in maintaining the C++ version.  At this point there are just
a couple minor known compatibility differences, please see the
<a class="reference" href="MigrationGuide.html">MigrationGuide</a> file for details.</p>
<p>EVT_STC_POSCHANGED has been removed as it has been deprecated in
Scintilla for several releases now.</p>
<p>All the Window and GDI (pen, bitmap, etc.) class constructors and also
many toplevel functions and static methods will now check that a
wx.App object has already been created and will raise a
wx.PyNoAppError exception if not.</p>
<p>Added more default args as needed to allow most window types to be
constructed with only the parent window arg.  In some cases other args
may be required for normal operation, but they can usually be set
after construction.</p>
<p>Removed the deprecated ErrorDialogs and PythonBitmaps modules.  If you
were using these in your apps then please join wxPython-dev and assist
with a more modern reimplementation.</p>
<p>Added a new version (0.8.3) of FloatCanvas from Chris Barker.  It's now
in a subpackage of wx.lib.</p>
<p>It is now possible to change the tab traversal order of controls on a
panel or dialog.  For details see the new MoveAfterInTabOrder and
MoveBeforeInTabOrder methods of wx.Window.</p>
<p>Applied (and heavily modified) a patch from Eugene
&lt;<a class="reference" href="mailto:svip123&#64;fastmail.fm">svip123&#64;fastmail.fm</a>&gt; that allows the sample modules in the demo to be
edited and reloaded, all from within the demo.  You can switch back
and forth between the default and your edited version, and any errors
ocurring upon the reload are reported on the Demo tab.</p>
<p>Added a menu item in the demo that will open a PyShell window that has
the app and demo frame preloaded in the namespace.  This is another
good way to explore and play with the objects in the currently running
sample.  For example, load the Button sample and then do the following
in the PyShell:</p>
<pre class="literal-block">
&gt;&gt;&gt; b = frame.demoPage.GetChildren()[0]
&gt;&gt;&gt; for x in range(0, 500, 10):
...     b.Move((x, 50))
...     app.Yield(True)
...     wx.MilliSleep(10)
</pre>
<p>wxGTK: Applied wxNO_BORDER patch (#1098374) for text control and combo
box.</p>
</div>
<div class="section" id="the-this-is-not-a-joke-release">
<h1><a name="the-this-is-not-a-joke-release">2.5.1.5    (the 'this is <em>not</em> a joke' release)</a></h1>
<ul class="simple">
<li>2-Apr-2004</li>
</ul>
<p>(See also the <a class="reference" href="MigrationGuide.html">MigrationGuide</a> file for details about some of the
big changes that have happened in this release and how you should
adapt your code.)</p>
<p>The wxWindows project and library is now known as wxWidgets.  Please
see <a class="reference" href="http://www.wxwindows.org/name.htm">http://www.wxwindows.org/name.htm</a> for more details.  This won't
really affect wxPython all that much, other than the fact that the
wxwindows.org domain name will be changing to wxwidgets.org, so mail
list, CVS, and etc. addresses will be changing.  We're going to try
and smooth the transition as much as possible, but I wanted you all to
be aware of this change if you run into any issues.</p>
<p>Many, many little fixes, changes and additions done as part of the move
to wxWidgets 2.5 that I have forgotten about.</p>
<p>Added wxMirrorDC.</p>
<p>Added wxIconLocation</p>
<p>Added Python wrappers and demos for the new wxVScrolledWindow,
wxVListBox, and wxHtmlListBox classes.</p>
<p>Added wrappers for wxBookCtrl and wxListbook.  wxNotebook now derives
from wxBookCtrl.</p>
<p>Added Gordon Williams' PyPlot module to the library, available as the
wx.lib.plot module.</p>
<p>I made a small but important change in the code that aquires the
Python Global Interpreter Lock to try and prevent deadlocks that can
happen when there are nested attempts to aquire the GIL.</p>
<p>The RPMs will now install menu items on Mandrake Linux in
Applications/Development/Tools for PyCrust, XRCed, etc.  The RPMs are
also installing icons and <tt class="docutils literal"><span class="pre">*.desktop</span></tt> items in the generic KDE and
GNOME locations, but I don't know yet if they are resulting in menu
items on non-Mandrake systems.  (It didn't automatically do it on my
RH-9 build box but I didn't chase it very far...)  If you have ideas
for how to improve the .spec file to work better and/or on more
distros please send me a patch.</p>
<p>The RPMs are now built on a fairly generic RH-9 box, and I have tested
installing them also on my main Mandrake 9.2 box.</p>
<p>There are some big changes in the OS X disk image.  The actual
Installer package now <em>only</em> installs the wxMac dynlibs, wxPython
extension modules and Python packages, and also the command-line tool
scripts. The remaining items (demo, samples, and application bundles
for the Demo, PyCrust and XRCed) are now top-level items in the disk
image (.dmg file) that users can just drag and drop to wherever they
want to put them.</p>
<p>The wxWave class has been renamed to wxSound, and now has a slightly
different API.</p>
<p>Updated the AnalogClockWindow with many enhancements from E. A. Taco.</p>
<p>wxMac now has wx.ToggleButton!</p>
<p>wx.stc.StyledTextCtrl has been updated to version 1.58 of Scintilla.</p>
<p>To help with the wx.stc.StyledTextCtrl performance issues on wxMac
I've added a SetUseAntiAliasing method (and GetUseAntiAliasing too)
that will turn off the use of antialiased fonts in the wxSTC, allowing
it to bypass the slow text measuring routines and use the fast and
simple one instead.  By default the setting is turned off (on wxMac
only.)  When run on OSX the Py* apps have a new item on the Options
menu for controlling this setting if you would like to experiment with
it.</p>
<p>Updated wx.lib.calendar with many fixes and enhancements from Joerg
&quot;Adi&quot; Sieker.</p>
<p>Added wx.Display and wx.VideoMode.</p>
<p>AppleEvents can be handled by overriding wx.App methods MacOpenFile,
MacPrintFile, MacNewFile, and MacReopenApp.</p>
<p>Added wx.PlatformInfo which is a tuple containing strings that
describe the platform and build options of wxPython.  See the
MigrationGuide for more details.</p>
<p>Created a new extension module &quot;activex&quot; from Lindsay Mathieson's
newest <a class="reference" href="http://members.optusnet.com.au/~blackpaw1/wxactivex.html">wxActiveX</a> class.  (The existing iewin module used an older
version of this code, but only exposed the wxIEHtmlWin class.)  This
new module will (in theory ;-) ) allow you to host arbitrary ActiveX
controls in a wx.Window, <strong>without</strong> requiring the use of the win32com
and other PyWin32 modules!  This should eliminate the cronic problems
that have resulted from minor mismatches in how PyWin32 handles the
GIL and tstate when making callbacks, etc.  The older iewin module
will be left in this release as the new stuff is not fully backwards
compatible, but you should migrate your code to the new IEHtmlWindow
in wx.lib.iewin, so the old one can be eventually removed.
Additionally, I've always considered that the wx.lib.activexwrapper
module is an ugly hack that I only included in the lib because I
couldn't figure out anything better.  Well now we have something that,
if it isn't already, has the potential to be better.  So consider
migrating away from using activexwrapper as well.  Please see the
MigrationGuide for more details on using the new module.</p>
<p>Floats are allowed again as function parameters where ints are expected.</p>
</div>
<div class="section" id="id12">
<h1><a name="id12">2.4.2.4</a></h1>
<ul class="simple">
<li>1-Oct-2003</li>
</ul>
<p>Use wxSTC in the demo for displaying the soucre code of the samples.</p>
<p>Lots of bug fixes and such from the wxWindows folks.</p>
<p>Added wxPython.lib.newevent from Miki Tebeka.  Its usage is
demonstrated in the Threads sample in the demo.</p>
<p>Updates to wxMaskedEditCtrl.</p>
<p>Added wxMaskedNumCtrl.</p>
<p>Added Chris Barker's FloatCanvas.</p>
</div>
<div class="section" id="id13">
<h1><a name="id13">2.4.1.2</a></h1>
<ul class="simple">
<li>19-Jun-2003</li>
</ul>
<p>Added wxScrolledPanel from Will Sadkin</p>
<p>Added SetShape method to top level windows (e.g. wxFrame.)</p>
<p>Changed wxSWIG to not generate Python code using apply, (since it will
be deprecated in the future) wxSWIG will use <tt class="docutils literal"><span class="pre">spam(*args,</span> <span class="pre">**kw)</span></tt> syntax
instead.  Also changed the generated __repr__ methods to be a bit more
informative.</p>
<p>Made the version number information more robust and uh, informative.
Also added asserts to check that the major.minor versions of wxPython
and wxWindows match.</p>
<p>Added the new wx &quot;renamer&quot; package that will dynamically import from
the wxPython package and rename wxFooBar --&gt; FooBar.  That means that
people can do imports without <tt class="docutils literal"><span class="pre">&quot;import</span> <span class="pre">*&quot;</span></tt> and can use names like
wx.Frame instead of wx.wxFrame.  This is phase 1 of a full transition
to the new namespace.</p>
<p>Updated Scintilla to 1.52.  I also changed it to use wxListCtrl
instead of wxListBox for the AutoComplete window, added the ability to
use custom bitmaps in the margin and in the AutoComplete windows, and
worked out how to do proper clipping of child windows on wxGTK.</p>
<p>Patrick O'Brien's PyCrust package has been renamed to Py and now
includes several new tools.  As part of the change the location of the
pacakge has changed as well, it is now accessible as &quot;from wxPython
import py&quot; (or &quot;from wx import py&quot; using the new namespace.)  There
are still some transition modules in the wxPython.lib.PyCrust package
that will issue a warning and then import what is needed from the new
package.  These will be removed in a future release.</p>
<p>Added __nonzero__ method to wxTreeItemId, wxBitmap, wxImage, wxFont,
and most other classes that have an Ok or IsOK method.  This allows
code like &quot;if obj: ...&quot; to be the same as &quot;if obj.IsOk(): ...&quot;</p>
<p>Toolbars on wxMac can now have controls on them.</p>
<p>Added wxPython.lib.analogclock module based on samples that were
passed back and forth on wxPython-users a while back.</p>
<p>Added masked edit controls (wxPython.lib.maskededit) by Jeff Childers
and Will Sadkin.  Updated wxTimeCtrl to use MaskedEdit.</p>
<p>When the __class__ of a dead object is replaced with _wxPyDeadObject
the __del__ of the original class is now called first.</p>
<p>Added wxTreeListCtrl.  (Looks like a wxTreeCtrl embedded in a
wxListCtrl, but actually is just giving multiple columns to a
wxTreeCtrl.)</p>
<p>Added wxFutureCall, a subclass of wxTimer that makes it easy to delay
a call to any Python callable object.</p>
<p>Added wxPy versions of wxPrintPreview, wxPreviewFrame, and
wxPreviewControlBar so they can be derived from in Python and be able
to override the C++ virtual methods.</p>
<p>Simplified how the wxSizer methods are wrapped, changed the name of
the &quot;option&quot; parameter to &quot;proportion&quot; to match the docs (&quot;option&quot; is
still accepted for compatibility, but this will go away in a future
release,) SetItemMinSize can now take a wxSize (or 2-tuple) parameter,
and Spacers can be specified with a wxSize (or 2-tuple) parameter</p>
<p>Added wxCursorFromBits.</p>
</div>
<div class="section" id="id14">
<h1><a name="id14">2.4.0.7</a></h1>
<ul class="simple">
<li>24-Mar-2003</li>
</ul>
<p>Gave up on generating a warning upon the use of the old true/false or
TRUE/FALSE values.</p>
<p>Fixed wxGenericTreeCtrl (used on wxGTK and wxMac for wxTreeCtrl) so
that it can successfully handle lots of nodes instead of overflowing
when the virtual height of the widget overflowed a 16-bit value.</p>
<p>Fixed the typemap that converts strings to wxColours to also accept
unicode.</p>
<p>Fixed problem where the wrong class name could sometimes be used for
OOR.</p>
<p>Fixed an interpreter lock problem in the __eq__ and __ne__ methods in
wxSize and etc.</p>
<p>Updated PyCrust to version 0.9</p>
<p>Instead of always logging C++ assertions, added wxPYAPP_ASSERT_LOG
flag to turn it on.  In most cases turning it into an exception (the
default behavior) is enough.  See below in the 2.3.4.1 notes for more
details.</p>
</div>
<div class="section" id="a-k-a-the-i-m-so-stupid-release">
<h1><a name="a-k-a-the-i-m-so-stupid-release">2.4.0.6 (a.k.a. the I'm so stupid release)</a></h1>
<ul class="simple">
<li>11-Mar-2003</li>
</ul>
<p>The new deprecation class for the old true/false symbols can now be
returned from OnInit.  And I promise to be sure I am testing what I
think I am testing in the future...</p>
</div>
<div class="section" id="a-k-a-the-blame-it-on-kevin-release">
<h1><a name="a-k-a-the-blame-it-on-kevin-release">2.4.0.5 (a.k.a. the blame it on Kevin release)</a></h1>
<ul class="simple">
<li>7-Mar-2003</li>
</ul>
<p>A few little but annoying bug fixes.</p>
<p>Updated pycolourchooser.</p>
<p>Updated to 0.9b of PyCrust.</p>
</div>
<div class="section" id="id15">
<h1><a name="id15">2.4.0.4</a></h1>
<ul class="simple">
<li>7-Mar-2003</li>
</ul>
<p>Added missing wxRect methods</p>
<p>Add OOR support for wxApp objects too.</p>
<p>Added wxCursorFromImage, which works on wxMSW and wxGTK so far.</p>
<p>All platforms now send EVT_DESTROY_WINDOW.  Be warned that at the time
the event is sent the window is in the process of being deconstructed,
and so calling some (most?) methods of the window itself may cause
problems.</p>
<p>Fixed SF Bug #689481, a method in the OGL wrappers was using the wrong
return type.</p>
<p>Fixed SF Bug #689958, an endless loop in printout.py.</p>
<p>Added EVT_WINDOW_CREATE_ID and EVT_WINDOW_DESTROY_ID so these events
can be associated with a specific window ID and more easily caught by
the parent window.</p>
<p>Fixed copy-paste error in wxListCtrl.GetFirstSelected.</p>
<p>Added missing Init method (and an overloading wrapper) to wxLocale
wrapper.</p>
<p>Added a wxBitmap.SetMaskColour convenience method.</p>
<p>Changed how the dynamic event tables (used for all Python wx classes,
C++ wx classes typically use static event tables) are searched such
that they behave from a Python perspective more like the static tables
in C++.  Namely that if there are identical event bindings in a base
Python class and a derived Python class that the one in the derived
class will be found first and that if Skip is called that the one in
the base class will still be found instead of skipping directly to the
static stable in the C++ class.</p>
<p>Switched to using True/False in the wxPython lib and demo instead of
true/false or TRUE/FALSE to prepare for the new boolean type and
constants being added to Python.  Added code to wx.py to test for the
existence of the new constants and to create suitable values if not
present.</p>
<p>Added some static wxApp functions that help with integration with the
Mac UI.  They are no-ops on other platforms so it doesn't hurt to
always call them.  The functions are:</p>
<pre class="literal-block">
wxApp_GetMacDefaultEncodingIsPC
wxApp_GetMacSupportPCMenuShortcuts
wxApp_GetMacAboutMenuItemId
wxApp_GetMacPreferencesMenuItemId
wxApp_GetMacExitMenuItemId
wxApp_GetMacHelpMenuTitleName
wxApp_SetMacDefaultEncodingIsPC
wxApp_SetMacSupportPCMenuShortcuts
wxApp_SetMacAboutMenuItemId
wxApp_SetMacPreferencesMenuItemId
wxApp_SetMacExitMenuItemId
wxApp_SetMacHelpMenuTitleName
</pre>
<p>Refactored, enhanced and added capabilities for the DrawXXXList
functions, inspired by code from Chris Barker.</p>
<p>The wxWindows .mo language catalog files are now installed in a
subdirectory of the wxPython package dir on MSW since that platform
doesn't have a standard place for them.</p>
<p>Added missing deselect methods for wxGrid.</p>
<p>Fixed typemaps for wxGridCellCoordsArray.</p>
<p>Updated to the 0.9a version of PyCrust</p>
</div>
<div class="section" id="id16">
<h1><a name="id16">2.4.0.2</a></h1>
<ul class="simple">
<li>23-Jan-2003</li>
</ul>
<p>Several bug fixes.</p>
<p>Added wxIntCtrl from Will Sadkin.</p>
<p>Added wxPyColourChooser by Michael Gilfix.</p>
</div>
<div class="section" id="id17">
<h1><a name="id17">2.4.0.1</a></h1>
<ul class="simple">
<li>10-Jan-2003</li>
</ul>
<p>No major new features since 2.3.4.2, mostly bug fixes and minor
enhancements.</p>
<p>Added function wrappers for the common dialogs from Kevin Altis.  See
wxPython/lib/dialogs.py for more details.</p>
</div>
<div class="section" id="id18">
<h1><a name="id18">2.3.4.2</a></h1>
<ul class="simple">
<li>21-Dec-2002</li>
</ul>
<p>Various bug fixes.</p>
</div>
<div class="section" id="id19">
<h1><a name="id19">2.3.4.1</a></h1>
<ul class="simple">
<li>18-Dec-2002</li>
</ul>
<p>Updated XRCed and wxTimeCtrl contribs.</p>
<p>Show a couple new wxGrid features in the demo.</p>
<p>Several bug fixes in wxWindows.</p>
<p>Added wxHtmlFilter.</p>
<p>wxASSERT and related C++ runtime diagnostics are now converted to
Python exceptions.  When an assert happens a wxPyAssertionError
(which derives from AssertionError) exception is created and when
control returns back to the Python code that invoked the C++ API it
will be raised.  The same exception restrictions are in place as
before, namely that exceptions can't cross from one Python layer
through C++ to another Python layer.  That simply means that if you
want to catch wxPyAssertionError or any other exception that you need
to do it before control returns to C++ at the end of your event
handler or callback code.  There is some test code in demo/wxButton.py
you can use to play with this new feature.</p>
<p>Added some methods to wxApp (SetAssertMode and GetAssertMode) that let
you control how C++ assertions are processed.  Valid modes are:
wxPYAPP_ASSERT_SUPPRESS, wxPYAPP_ASSERT_EXCEPTION, and
wxPYAPP_ASSERT_DIALOG.  Using _SUPPRESS will give you behavior like
the old &quot;final&quot; builds and the assert will be ignored, _EXCEPTION is
the new default described above, and _DIALOG is like the default in
2.3.3.1 and prior &quot;hybrid&quot; builds.  You can also combine _EXCEPTION
and _DIALOG if you wish, although I don't know why you would.</p>
<p>You can now overload OnInitGui, OnExit and OnAssert in your classes
derived from wxApp.</p>
<p>Added GetSelectedCells, GetSelectionBlockTopLeft,
GetSelectionBlockBottomRight, GetSelectedRows, GetSelectedCols nethods
to wxGrid.</p>
<p>Added Python == and != operators for some basic classes</p>
<p>Fixed the Python wrappers for wxInputStream so they no longer block
when reading from a wxProcess on wxGTK.  They now work more or less as
they did before 2.3.3.1 but the dual meaning of eof() has been
removed.  There is now a CanRead() method that lets you know if there
is data waiting to be read from the pipe.</p>
<p>Fixed method name clash in wxIEHtmlWin, renamed Refresh to RefreshPage.</p>
<p>Added Throbber from Cliff Wells to the library and the demo.</p>
<p>Windows installer prompts to uninstall old version first.</p>
<p>Added wxPython.lib.evtmgr by Robb Shecter, which is an easier, more
&quot;Pythonic&quot; and more OO method of registering handlers for wxWindows
events using the Publish/Subscribe pattern.</p>
<p>Added wxPython.lib.popupctl by Gerrit van Dyk which is a combobox-like
gizmo for poping up arbitrary controls.  It is currently using
wxDialog because of some issues with wxPopupWindow...</p>
<p>Added wxPython.lib.gridmovers by Gerrit van Dyk which facilitates the
dragging of columns and/or rows in a wxGrid.</p>
<p>Added wxPython.lib.multisash by Gerrit van Dyk which is a nice
implementation of allowing the user to split a window any number of
times either horizontally or vertically, and to close the split off
windows when desired.</p>
<p>Added helpviewer tool that displays HTML books similarly to how MS
HTMLHelp viewer does.  Changed how the wxPythonDocs tarball is built
and added a script to launch the doc viewer.</p>
</div>
<div class="section" id="id20">
<h1><a name="id20">2.3.3.1</a></h1>
<ul class="simple">
<li>19-Sep-2002</li>
</ul>
<p>Added wxSplashScreen.</p>
<p>Added wxGenericDirCtrl.</p>
<p>Added wxMultiChoiceDialog.</p>
<p>The calltip window and autocomplete window in wxSTC will now use a
wxPopupWindow if available on the platform (and functioning correctly)
so they can extend beyond the client area of the STC if needed.</p>
<p>Finished wrapping and providing typemaps for wxInputStream and also
added the stream ctor and other methods for wxImage so images can now
be loaded from any Python &quot;file-like&quot; object.</p>
<p>Changed the img2py tool to use PNG instead of XPM for embedding image
data in Python source code, and the generated code now uses streams to
convert the image data to wxImage, wxBitmap, or wxIcon.</p>
<p>Added the wxPython.lib.rcsizer module which contains RowColSizer.
This sizer is based on code from Niki Spahiev and lets you specify a
row and column for each item, as well as optional column or row
spanning.  Cells with no item assigned to it are just left blank.
Stretchable rows or columns are specified and work the same as in
wxFlexGridSizer.</p>
<p>Updated XRCed from Roman Rolinsky</p>
<p>Added wxBufferedDC.</p>
<p>Upgraded wxSTC from Scintilla 1.40 to Scintilla 1.45, and then again
to version 1.47, and one more time to 1.48! &lt;wink&gt;</p>
<dl class="docutils">
<dt>UNICODE!</dt>
<dd><p class="first">wxWindows/wxPython can be compiled with unicode support enabled or
disabled.  Previous to wxPython 2.3.3 non-unicode mode was always
used.  Starting with 2.3.3 either mode is supported, but only if
it is also available in wxWindows on the platform.  Currently
wxWindows only supports unicode on MS Windows platforms, but with
the recent release of GTK+ 2.0 it is only a matter of time until
it can be done on wxGTK (Linux and other unixes) as well.</p>
<p>Unicode works best on platforms in the NT branch of the Windows
family tree (NT, win2k, XP) but it is now also possible to use the
same unicode binaries on win95/98/ME platforms as well!  This is
done by using a special library and DLL with the application
called MSLU, (Microsoft Layer for Unicode).  It simply gets out of
the way if the app is run on an NT box, otherwise if run on a
win9x box it loads a special DLL that provides the unicode
versions of the windows API.  So far I have not been able to get
this to work perfectly on win9x.  Most things work fine but
wxTaskBarIcon for example will cause a crash if used with the
unicode build on win95.</p>
<p class="last">So how do you use it?  It's very simple.  When unicode is enabled,
then all functions and methods in wxPython that return a wxString
from the C++ function will return a Python unicode object, and
parameters to C++ functions/methods that expect a wxString can
accept either a Python string or unicode object.  If a string
object is passed then it will be decoded into unicode using the
converter pointed to by wxConvCurrent, which will use the default
system encoding.  If you need to use a string in some other
encoding then you should convert it to unicode using the Python
codecs first and then pass the unicode string to the wxPython
method.</p>
</dd>
</dl>
<p>Added wxListCtrlAutoWidthMixin from Erik Westra.</p>
<p>Added wxIconBundle and wxTopLevelWindow.SetIcons.</p>
<p>Added wxLocale and wxEncodingConverter.</p>
<p>A little black magic...  When the C++ object (for a window or
whatever) is deleted there is no way to force the Python shadow object
to also be destroyed and clean up all references to it.  This leads to
crashes if the shadow object tries to call a method with the old C++
pointer.  The black magic I've done is to replace the __class__ in the
Python instance object with a class that raises an exception whenever
a method call (or other attribute access) is attempted.  This works
for any class that is OOR aware.</p>
<p>Added OOR support for wxGridCellRenderer, wxGridCellEditor,
wxGridCellAttr, wxGridCellAttrProvider, wxGridTableBase and their
derived classes.</p>
<p>Added wxImage.GetDataBuffer which returns an in-place edit buffer of
the image data.  (Patch #546009)</p>
<p>Added a sample that shows how to embed wxPython in a wxWindows C++
application.</p>
<p>Added wxPyWindow, wxPyPanel and wxPyControl which are just like their
wx counterparts except they allow some of the more common C++ virtual
methods to be overridden in Python derived classes.  The methods
supported are:</p>
<blockquote>
<p>DoMoveWindow
DoSetSize
DoSetClientSize
DoSetVirtualSize
DoGetSize
DoGetClientSize
DoGetPosition
DoGetVirtualSize
DoGetBestSize
InitDialog
TransferDataFromWindow
TransferDataToWindow
Validate
AcceptsFocus
AcceptsFocusFromKeyboard
GetMaxSize
AddChild
RemoveChild</p>
<p>If there are other methods that you think should be supported
please let me know.</p>
</blockquote>
<p>Changed wxGenButton to derive from wxPyControl and overload
DoGetBestSize and AcceptsFocus.</p>
<p>Added wxArtProvider.</p>
<p>Added wxCallAfter which is a helper function that registers a function
(or any callable Python object) to be called once the next time there
are no pending events.  This is useful for when you need to do
something but it can't be done during the current event handler.  The
implementation is very simple, see wxPython/wx.py.</p>
<p>Fixed a boatload of reference leaks.</p>
<p>Added a demo of using a sizer in a wxScrolledWindow, in effect
creating a ScrolledPanel.</p>
<p>Added a sample to the demo that shows how to use radio menu items, and
other menu stuff.</p>
<p>Added wxIEHtmlWin.  This is essentially the same as using IE with the
ActiveXWrapper already in the library, but it is implemented all in
C++ and therefore does not need any of the modules from win32all and
so it is less fragile in the face of changes.</p>
<p>Fixed the ActiveXWrapper problem.  Looks like when the win32com
modules make a &quot;callback&quot; that they (incorrectly, IMHO) allocate a
transient thread state structure.  Since wxPython is now saving
tstates for it's own callbacks it ended up using garbage after
win32com got rid of the temporary tstate...</p>
<p>Added a generic static text control to wxPython.lib.stattext.  This is
so things like Boa and PythonCard can have a static text that can
respond to mouse events and etc.</p>
<p>Changed the wxDateTime.Parse* methods to return an int that will be -1
on failure, and the index where parsing stopped otherwise.</p>
<p>Moved tools to be a Python package in wxPython.tools, added scripts to
import and launch each tool.  This will let you import and use the
tools in your own scripts or apps as needed.  On Linux and OS X the
tool scripts are installed to {prefix}/bin so you should be able to
easily launch them from the command line.  For example, PyCrust can be
started with just the &quot;pycrust&quot; command.</p>
<p>Added a sample to the demo that catches various key events and
displays the details of the event.</p>
<p>Added wxWizard, wxWizardPage, wxWizardPageSimple and wxPyWizardPage.</p>
<p>Added wxXmlResourceHandler which allows you to create custom handlers
for nonstandard class types in XRC resources.  See the demo for an
example.</p>
<p>Added wxPython.lib.mixins.rubberband module from Robb Shecter.</p>
<p>Added wxTimeCtrl from Will Sadkin.</p>
</div>
<div class="section" id="id21">
<h1><a name="id21">2.3.2.1</a></h1>
<ul class="simple">
<li>20-Dec-2001</li>
</ul>
<p>Changed (again) how the Python global interpreter lock is handled as
well as the Python thread state.  This time it works on SMP machines
without barfing and is also still compatible with Python debuggers.</p>
<p>Added some patches from library contributors.</p>
</div>
<div class="section" id="id22">
<h1><a name="id22">2.3.2</a></h1>
<ul class="simple">
<li>11-Dec-2001</li>
</ul>
<p>Added EVT_HELP, EVT_HELP_RANGE, EVT_DETAILED_HELP,
EVT_DETAILED_HELP_RANGE, EVT_CONTEXT_MENU, wxHelpEvent,
wxContextMenuEvent, wxContextHelp, wxContextHelpButton, wxTipWindow,
and a demo to show them in action.</p>
<p>Deprecated PyShell and PyShellWindow, added a snapshot of PyCrust (see
<a class="reference" href="http://sourceforge.net/projects/pycrust/">http://sourceforge.net/projects/pycrust/</a>. )</p>
<p>Added the new virtual list capabilities to wxListCtrl.</p>
<p>Added a wxSTC style editor from Riaan Booysen to the sample apps.</p>
<p>Added XRCed to the wxPython Tools directory, contributed by Roman
Rolinsky.</p>
<p>Added a new &quot;constructor&quot; to most of the window classes that calls the
default C++ constructor, (the one with no parameters) and also added the
corresponding  Create(...) method.  This allows you to do a 2-step
creation of windows which is sometimes required for doing things such
as setting extended style flags before the window is created, or for
passing the object to the XRC resource system to be created from the
resource.  The name of the new &quot;constructor&quot; is the original name of
the class with a &quot;Pre&quot; in it.  For example, wxPreWindow, wxPreFrame,
etc.</p>
<p>Updated to version 1.40 of Scintilla and updated wxStyledTextCtrl
accordingly.  While doing this update I dropped the wxLB_SORT style
from the wxListBox created for the AutoComplete functionality.  This
means that you will have to sort the keyword lists yourself, but you
are free to do case sensitive or case insensitive sorts and set the
wxSTC flag accordingly.</p>
<p>Updated wxColumnSorterMixin to also be able to place sort icons on the
column headers, and updated the wxListCtrl demo to show it off by
using wxColumnSorterMixin.</p>
<p>Added wxGenBitmapTextButton, TablePrint, etc. contribs from Lorne White.</p>
<p>Added wxNativeFontInfo and wxFontMapper.</p>
<p>Added pySketch to the samples.</p>
<p>Significantly changed how the Python interpreter lock and thread state
are managed, which should fix the problem of running on a
multi-processor machine.</p>
<p>Added wxPyLog so log targets can be created in Python to handle log
messages however is wished.  See demo/Main.py for an example.</p>
<p>Added wxFindReplaceDialog.</p>
<p>The second phase of OOR is implemented for wxEvtHandler, wxSizer,
wxShape and derived classes.  This means that functions and methods
that return an object derived from wxEvtHandler that was originally
created in Python, will return the original Python object (if it still
exists) instead of letting SWIG wrap a new shadow object around the
original C++ pointer.</p>
<p>Added some optimization methods to wxDC: GetBoundingBox, DrawLineList,
DrawPointList.</p>
<p>Added a set of sophisticated Error Dialogs from Chris Fama.</p>
<p>Added wxRightTextCtrl from Josu Oyanguren to wxPython.lib for aligning
text in a wxTextCtrl to the right side.</p>
<p>Added wxURLDataObject and an example showing drag and drop of URLs to
and from web browsers.  It's still not 100% bullet-proof for all types
of browsers, but it works for the majority of cases with the popular
browsers on Windows.  On wxGTK it seems that only Netscape 4.x works,
if anybody has any suggestions about this please bring it up on the
wx-dev list.</p>
<p>Added wxStopWatch.</p>
<p>Added wxMimeTypesManager and wxFileType.</p>
<p>Passing None for the handler parameter to one of the EVT_** functions
will now Disconnect the event.</p>
<p>Added wxPopupWindow and wxPopupTransientWindow.</p>
<p>Added wxFileHistory.</p>
<p>Added wxDynamicSashWindow, which allows you to endlessly split windows
by dragging a little tab next to the scrollbars.  Added a demo to show
this and also the ability of multiple wxStyledTextCtrls to share the
same document.</p>
<p>Added wxEditableListBox gizmo.</p>
<p>Updated wxEditor with lots of enhancements from Steve Howell and Adam
Feuer.</p>
<p>Added the &quot;SplitTree gizmos&quot; which are a collection of classes that
were designed to operate together and provide a tree control with
additional columns for each item.  The classes are
wxRemotelyScrolledTreeCtrl, wxTreeCompanionWindow,
wxThinSplitterWindow, and wxSplitterScrolledWindow, some of which may
also be useful by themselves.</p>
<p>Added wxDllWidget from Vaclav Slavik which allows wx widgets derived
from wxWindow to be loaded from a C++ .dll (or .so) and be used in a
wxPython program, without the widget having to be SWIGged first.  The
visible API of the widget is limited to wxWindow methods plus a
SendCommand method, but it is still quite powerful.  See
wxPython/contrib/dllwidget and wxPython/demo/dllwidget for more
details.</p>
</div>
<div class="section" id="id23">
<h1><a name="id23">2.3.1</a></h1>
<ul class="simple">
<li>10-Jul-2001</li>
</ul>
<p>Added EVT_GRID_EDITOR_CREATED and wxGridEditorCreatedEvent so the user
code can get access to the edit control when it is created, (to push
on a custom event handler for example.)</p>
<p>Added wxTextAttr class and SetStyle, SetDefaultStyle and
GetDefaultStyle methods to wxTextCtrl.</p>
<p>Added ability to use xml resource files.  Still need to add ability to
subclass wxXmlResourceHandler, etc...</p>
<p>Added wxGridAutoEditMixin to the mixins library package.</p>
<p>Made ColourSelect be derived from wxButton.</p>
<p>Fixed img2py to work correctly with Python 2.1.</p>
<p>Added enhanced wxVTKRenderWindow by Prabhu Ramachandran</p>
</div>
<div class="section" id="id24">
<h1><a name="id24">2.3.0</a></h1>
<ul class="simple">
<li>22-May-2001</li>
</ul>
<p>Removed initial startup dependency on the OpenGL DLLs so only the
glcanvasc.pyd depends on them, (on wxMSW.)</p>
<p>Changed wxFont, wxPen, wxBrush to not implicitly use the
wxThe[Font|Pen|Brush]List objects behind the scenes, but to use normal
ctor and dtors.</p>
<p>Exposed the wxThe[Font|Pen|Brush]List to wxPython.</p>
<p>Also added wxTheColourDatabase and added a library module (in the
wxPython.lib.colourdb module) to load LOTS more colour names into the
colour database.</p>
<p>Added wxWakeUpMainThread, wxMutexGuiEnter, wxMutexGuiLeave,
wxMutexGuiLocker and wxThread_IsMain to assist with dealing with GUI
access from non-GUI threads.</p>
<p>wxPyOnDemandOutputWindow is now (more) thread safe if non-GUI threads
use print, sys.stdout.write, etc.</p>
<p>Added CreateTextSizer and CreateButtonSizer to wxDialog</p>
<p>Added wxPython/lib/infoframe.py from Chris Fama.  It contains a class
that can be used in place of wxPyOnDemandOutputWindow.</p>
<p>Added colourselect.py, imagebrowser.py and an updated calendar.py to
wxPython/lib from Lorne White.</p>
<p>Added patch to wxPoint_LIST_helper from Tim Hochberg that should make
it gobs faster in certain situations.</p>
<p>Added tools that will take an image file in a wx supported format and
convert it to data embedded in a Python source file.  The image is
converted to XPM format which is essentially a list of strings
containing info about each pixel.  The image's transparency mask is
included, if there is one, or a mask can be added if a mask colour is
specified on the command line.  It is then pickled and optionally
compressed and written to a Python source file along with functions to
convert it to either a wxBitmap or a wxImage.  See
wxPython/demo/images.py for examples, and wxPython/Tools/img2py.py for
the implementation.</p>
<p>Fixed wxStyledTextCtrl to be much faster on wxGTK.  There was some
experimental code that got left in place that ended up causing way too
many refreshes.</p>
<p>A couple more hacks in my_distutils.py so wxPython can be built with
the distutils that comes with Python 2.1.</p>
<p>Added a ton of missing methods for wxPrintData.</p>
<p>Switched to InnoSetup for MSW distributions.</p>
<p>Added wxToggleButton.</p>
<p>Fixed bug that prevented wxTreeCtrl.OnCompareItems from being called.</p>
<dl class="docutils">
<dt>Added some methods to wxGrid:</dt>
<dd>GetCellHighlightPenWidth
GetCellHighlightROPenWidth
SetCellHighlightPenWidth
SetCellHighlightROPenWidth
GetGridWindow
GetGridRowLabelWindow
GetGridColLabelWindow
GetGridCornerLabelWindow</dd>
</dl>
<p>Added wxGetClientDisplayRect which on wxMSW returns a wxRect
representing the area on screen not occupied by the taskbar and such.
On other platforms it is equivallent to wxGetDisplaySize.</p>
<dl class="docutils">
<dt>OOR:</dt>
<dd><p class="first">Implemented the first phase of OOR (Original Object Return).  See
the text in the demo for more details of what this means, but in a
nutshell methods such as wxWindow.GetParent or FindWindowById will
now return a shadow object of the proper type if it can.  By
&quot;proper type&quot; I mean that if the wxWindow pointer returned from
FindWindowById really points to a wxButton then the Python object
constructed will be of a wxButtonPtr class instead of wxWindowPtr
as before.  This should reduce or eliminiate the need for
wxPyTypeCast.  (Woo Hoo!)  The objects returned are still not the
original Python object, but that is the next step.  (Although it
will probably only work on Python 2.1 and beyond because it will
use weak references.)</p>
<p class="last">This first phase of the OOR plan is fairly significant and has
required a lot of changes all over wxPython, most of which should
be transparent to you, however I'm not 100% sure that it didn't
introduce any new bugs that are hiding somewhere and didn't get
stomped on during my testing.  So please be sure to test everything
thoroughly when you install this version and be sure to report any
object-type related oddities to me.</p>
</dd>
</dl>
<p>There is now a wxObject class that most other classes derive from like
in C++, but the methods provided don't really match but are wxPython
specific.  It could have been added long ago but OOR required it so it
finally got done.</p>
<p>Finally added wxPyLineShape.GetLineControlPoints, which has been on my
list for a while.  The above OOR modification made this easier.</p>
<p>Fixed the __cmp__ methods for wxPoint and others.</p>
<p>Added wxWave.</p>
<p>Added the wxPython.lib.mixins package to the library, it is where
useful mix-in classes can be placed.  Currently there is one to help
make the columns in a wxListCtrl sortable, and the MagicIMageList from
Mike Fletcher.  If you have any custom code that can be factored out
of existing classes into a mix-in that would be useful to others
please send it to me for inclusion in this package.</p>
<p>Added a few little sample applications to help newbies to get started
by having smaller functional apps to play with.  They can be found in
wxPython/samples.</p>
</div>
<div class="section" id="id25">
<h1><a name="id25">2.2.7</a></h1>
<ul class="simple">
<li>19-Jun-2001</li>
</ul>
<p>No changes happened in the Python wrappers for this release, only
changes and fixes in the wxWindows library.</p>
</div>
<div class="section" id="id26">
<h1><a name="id26">2.2.5</a></h1>
<ul class="simple">
<li>30-Jan-2001</li>
</ul>
<p>New typemaps for wxString when compiling for Python 2.0 and beyond
that allow Unicode objects to be passed as well as String objects.  If
a Unicode object is passed PyString_AsStringAndSize is used to convert
it to a wxString using the default encoding.</p>
<p>Fixed the generic buttons so tool tips work for them.</p>
<p>Fixed a bug in the demo's tree control.</p>
<p>Added a listbox to the listbox demo that shows how to find items with
a matching prefix as keys are typed.</p>
<p>Added code to the wxListCtrl demo to show how to get text from a
column in report mode.</p>
<p>Added code to the toolbar demo to clear the long help from the status
bar after 2 seconds.</p>
<p>Added wxJoystick.</p>
<p>Fixed wxTimer so it can be used as described in the docs, either with
a Notify method in a subclass, or sending an event to a wxEvtHandler
object, (usually a window.)</p>
<p>Added wxNotifyEvent.Allow()</p>
<p>Fixed GOBS of reference leaks.</p>
<p>Massive code changes and cleanup to allow wxPython to be split into
multiple extension modules again.  A Python CObject is used to allow
the &quot;export&quot; of SWIG functions and other common helper functions from
the wxc module to other modules, even if they are in separate shared
libraries.  Should also be usable from 3rd party code, just include
wxPython/src/export.h</p>
<p>Changed the default setup so the following are built as separate
extension modules:  calendar, glcanvas, grid, html, ogl, stc, and
utils.  Will probably add more later.</p>
<p>Changed the wxPrinterDC to use the new constructor taking a
wxPrintData object.  The old ctor is still there using the
wxPrinterDC2 name.</p>
<p>Added wxPython.lib.anchors.py from Riaan Booysen.  It contains a class
that implements Delphi's Anchors with wxLayoutConstraints.</p>
<p>Added wxPython.lib.fancytext from Timothy Hochberg.</p>
<p>Changed the GenericButtons to send their event in idle time, so the
mouse won't be captured when the event handler is called.</p>
<p>Added wxPython.lib.rpcMixin from Greg Landrum, although it's not
integrated with the demo yet.  It allows a wxPython GUI to be an
XML-RPC server.</p>
</div>
<div class="section" id="new-in-2-2-2">
<h1><a name="new-in-2-2-2">New in 2.2.2</a></h1>
<ul class="simple">
<li>26-Oct-2000</li>
</ul>
<p>Significantly changed how the wxStyledtextCtrl code that wraps
Scintilla is implemented.  Most of it is now automatically generated
from an interface definition file provided by Scintilla.  This means
that it will be much easier to stay in sync with new Scintilla
releases, but also means that some of the method and identifier names
have changed.  See wxPython/demo/data/stc.h for a copy of the C++
interface from which the Python interface is generated.  There is now
some inline documentation in that file that should really help explain
how things work.</p>
<p>I am now using the Python Distutils to build wxPython and to make some
of the distribution files.  (See <a class="reference" href="http://www.python.org/sigs/distutils-sig/">http://www.python.org/sigs/distutils-sig/</a>)
This means no more messing with my kludgy build.py/Makefile hack,
builds will be more consistent with other Python extensions that also
use Distutils, and will hopefully make wxPython easier to build for
platforms where there have been troubles before.  If you are building
wxPython for Python 1.5.2 or for 1.6, then you will need to get and
install version 1.0 of Distutils from the website above.  If you are
using Python 2.0 then you already have it.</p>
<p>Added wxInputStream and the wxFileSystem family of classes,
contributed by Joerg Baumann.</p>
<p>Added wxProcess and support for it to wxExecute.  wxProcess lets you
get notified when an asyncronous child process terminates, and also to
get input/output streams for the child process's stdout, stderr and
stdin.</p>
<p>Removed the old python sizers.</p>
<p>Added __add__, __sub__ and __cmp__ (equality check only) for wxPoint
and wxRealPoint.</p>
<p>Changed the build to make one big extension module instead of one for
the core and each contrib.  This allowed me to do away with the
libwxPyHelpers.so on unix systems.</p>
<p>Lots of little fixes here and there.</p>
<p>Some hacks on wxGTK to try and make the AutoComplete listbox in the
wxStyledTextCtrl to behave better.  It's still not as nice as on
wxMSW, but at least it's a bit more usable now.</p>
</div>
<div class="section" id="new-in-2-2-1">
<h1><a name="new-in-2-2-1">New in 2.2.1</a></h1>
<ul class="simple">
<li>22-Aug-2000</li>
</ul>
<p>Various tweaks, fixes, missing methods, etc.</p>
<p>Added example use of wxTaskBarIcon to the demo.</p>
</div>
<div class="section" id="new-in-2-2-0">
<h1><a name="new-in-2-2-0">New in 2.2.0</a></h1>
<ul class="simple">
<li>17-Jul-2000</li>
</ul>
<p>Added wxLog and friends.</p>
<p>Added wxFrame.ShowFullScreen for MSW.</p>
<p>Added PyShellWindow to the wxPython.lib package.</p>
</div>
<div class="section" id="new-in-2-1-16">
<h1><a name="new-in-2-1-16">New in 2.1.16</a></h1>
<ul class="simple">
<li>12-Jun-2000</li>
</ul>
<p>Added an attribute named labelDelta to the generic buttons that
specifies how far to offset the label when the button is in the
depressed state.</p>
<p>Added wxTipProvider and friends.  See the demo for an example.</p>
<p>wxGrid can now change the cell highlight colour.</p>
<p>Added wxDragImage.</p>
<p>Fixed printing on wxGTK.</p>
<p>Added wxDateTime, wxTimeSpan, and wxDateSpan to wxPython.utils.</p>
<p>Added wxCalendarCtrl.</p>
<p>WARNING: A while back I asked what should be done about the Magic
Method Names.  (Methods that are automatically turned into event
handlers by virtue of their name.)  The consensus was that it is more
confusing to have them than to try and expand them to have greater
coverage.  I am finally getting around to removing the code that
generates the event binding.  This means that if you are using any of
the following method names without a EVT_* call that you need to
modify your code to add the EVT_* to hook the event to the method.</p>
<blockquote>
OnChar
OnSize
OnEraseBackground
OnSysColourChanged
OnInitDialog
OnPaint
OnIdle
OnActivate
OnMenuHighlight
OnCloseWindow
OnScroll</blockquote>
<p>Added wxSpinCtrl.</p>
</div>
<div class="section" id="new-in-2-1-15">
<h1><a name="new-in-2-1-15">New in 2.1.15</a></h1>
<ul class="simple">
<li>25-Apr-2000</li>
</ul>
<p>Fixed wxTreeCtrl.HitTest to return both the tree item as well as the
flags that clairify where the click was in relation to the item.</p>
<p>Fixed thread state problem in wxTreeCtrl.GetBoundingBox and
GetSelections.</p>
<p>Fixed some problems in OGL.  Also wxShape.SetClientData and
.GetClientData can now deal with Python objects.</p>
<p>Added wxListCtrl.SortItems and changed the demo to show how to use it.</p>
<p>Plugged a memory leak.</p>
<p>Wrapped the new wxGrid and friends.  The old wxGrid class is no longer
available.  There are some incompatibilities, and unfortunately the
new classes are not documented yet, (however the methods are more
consistent with each other now so you may be able to guess pretty
good...)</p>
<p>Updated filebrowsebutton.py and calendar.py with changes from their
authors.  There is now a FileBrowseButtonWithHistory class (what a
mouthful!) and wxCalendar has printing support.</p>
<p>Added ActiveXWrapper to the library, and some good demos of it too.
It works great for embedding a COM (a.k.a OCX, a.k.a ActiveX) control
in a window and calling its methods.  It actually creates a new class
on the fly that derives from wxWindow, the COM CoClass and others
needed to make it all work.  The resulting class can be instantiated
just like wxWindow, used in sizers, etc.  It also responds to all COM
method calls, properties, etc., and if the class or a mix-in has
matching method names, then the COM events will be propogated back to
them.</p>
<p>Created a typemap that allows a string to be used for parameters
expecting a wxColour type.  The string is either a colour name as
defined in the wxColourDatabase, or a colour spec of the form
&quot;#RRGGBB&quot;.  See the wxStyledTextCtrl demo for an example.</p>
<p>I almost forgot to mention the wxStyledTextCtrl!  Yes, the
wxStyledTextCtrl is finally in wxPython!!  (And the crowd goes
wild...)   There's no documentaTion yet (the crowd boos and hisses...)
but I've included a very readable source file in the
wxPython/demo/data directory, a couple fairly good examples, and you
can also refer to the Scintilla documentaion at
<a class="reference" href="http://www.scintilla.org/ScintillaDoc.html">http://www.scintilla.org/ScintillaDoc.html</a> to help fill in the gaps
until the docs are done.  (The croud murmers contentedly as the tool
provider smiles convincingly and removes his flame-proof suit.)</p>
</div>
<div class="section" id="what-s-new-in-2-1-13">
<h1><a name="what-s-new-in-2-1-13">What's new in 2.1.13</a></h1>
<ul class="simple">
<li>3-Feb-2000</li>
</ul>
<p>Skipped a version number to match what has been released for wxGTK.</p>
<p>Updated wxMVCTree and added a demo for it, also fixed layout on GTK
and some flicker problems.</p>
<p>Added a wrapper class for the Visualization ToolKit (or VTK) in the
wxPython.lib.vtk module.  (<a class="reference" href="http://www.kitware.com/">http://www.kitware.com/</a>)</p>
<p>Fixed wxTreeCtrl.SetItemImage and GetItemImage to recognise the new
&quot;which&quot; parameter.</p>
<p>Added wxPython.lib.spashscreen from Mike Fletcher.</p>
<p>Added wxPython.lib.filebrowsebutton also from Mike Fletcher.</p>
<p>Renamed wxTreeCtrl.GetParent to GetItemParent to avoid a name clash
with wxWindow.GetParent.</p>
<p>Added wxIntersectRect to compute the intersection of two wxRect's.
It is used like this:</p>
<blockquote>
intersect = wxIntersectRect(rect1, rect2)</blockquote>
<p>If r1 and r2 don't intersect then None is returned, otherwise the
rectangle representing the intersection is returned.</p>
<p>Some bug fixes for Clipboard and Drag-n-Drop.</p>
<p>Rotated text!!!  WooHoo!  (See wxDC.DrawRotatedText())</p>
<p>Added a set of Generic Buttons to the library.  These are simple
window classes that look and act like native buttons, but you can have
a bit more control over them.  The bezel width can be set in addition
to colours, fonts, etc.  There is a ToggleButton as well as Bitmap
versions too.  They should also serve as a good example of how to
create your own classes derived from wxControl.</p>
<p>The C++ wxToolBar classes have been redone, and so have the wxPython
wrappers.  There have been slight modifications to some of the methods
but shouldn't impact anybody too much.  I took the opportunity to add
support for setting user data on each toolbar tool.  The new AddTool
methods look like this:</p>
<blockquote>
<dl class="docutils">
<dt>def AddTool(ID,</dt>
<dd>bitmap,
pushedBitmap = wxNullBitmap,
toggle = FALSE,
clientData = NULL,
shortHelpString = &quot;&quot;,
longHelpString = &quot;&quot;)</dd>
<dt>def AddSimpleTool(ID,</dt>
<dd>bitmap,
shortHelpString = &quot;&quot;,
longHelpString = &quot;&quot;,
toggle=FALSE)</dd>
</dl>
</blockquote>
<p>There are also corresponding InsertTool and InsertSimpleTool methods
that additionally take an integer position as the first parameter.</p>
<p>Added a wrapper for the new PCX and TIFF ImageHandlers.</p>
<p>wxRect now simulates attributes named left, right, top and bottom.</p>
<p>Removed all non wx stuff from the glcanvas module since DA's PyOpenGL
is better and compatible with the wxGLCanvas.  You can get it at
<a class="reference" href="http://starship.python.net:9673/crew/da/Code/PyOpenGL">http://starship.python.net:9673/crew/da/Code/PyOpenGL</a>.</p>
<p>Added some missing EVT functions.</p>
<p>Added Dirk Holtwic's editor classes to the wxPython.lib.editor
package.</p>
<p>Changed all the &quot;LIST&quot; parameter names to &quot;choices&quot; to match the docs.</p>
<p>More fixes for the wxFloatBar, and it now works on wxGTK even better
than wxMSW!  (The feat is accomplished by using the wxTB_DOCKABLE
style flag instead of trying to float it ourselves.)</p>
</div>
<div class="section" id="what-s-new-in-2-1-11">
<h1><a name="what-s-new-in-2-1-11">What's new in 2.1.11</a></h1>
<ul class="simple">
<li>13-Nov-1999</li>
</ul>
<p>Skipped a few version numbers so wxMSW, wxGTK and wxPython are all
syncronized.</p>
<p>wxImage.SetData now makes a copy of the image data before giving it to
wxImage.  I mistakenly thought that wxImage would copy the data
itself.</p>
<p>Fixed wxMSW's notebook so the pages get their size set as they are
being added.  This should remove the need for our
wxNotebook.ResizeChildren hack.</p>
<p>wxPanels now support AutoLayout, and wxNotebooks and wxSplitterWindows
no longer tell their children to Layout() themselves.  This will
probably only effect you if you have a wxWindow with AutoLayout inside
a notebook or splitter.  If so, either change it to a wxPanel or add
an EVT_SIZE handler that calls Layout().</p>
<p>Fixed deadlock problem that happened when using threads.</p>
<p>Added new HTML printing classes.</p>
<p>Added wxWindow.GetHandle</p>
<p>Apparently wxMouseEvent.Position has been deprecated in wxWindows as
it is no longer available by default.  You can use GetPositionTuple
(returning a tuple with x,y) instead, or GetPosition (returning a
wxPoint.)</p>
<p>Added wxPostEvent function that allows events to be posted and then
processed later.  This is a thread-safe way to interact with the GUI
thread from other threads.</p>
<p>Added Clipboard and Drag-and-Drop classes.</p>
<p>Added wxFontEnumerator.</p>
<p>Many updates to wxMenu, wxMenuBar.</p>
<p>wxPyEvent and wxPyCommandEvent derived classes now give you the actual
Python object in the event handler instead of a new shadow.</p>
<p>Added a Calendar widget from Lorne White to the library.</p>
<p>Made some fixes to the wxFloatbar.  It still has some troubles on
wxGTK...</p>
<p>Added an MVC tree control from Bryn Keller to the library.</p>
</div>
<div class="section" id="what-s-new-in-2-1-5">
<h1><a name="what-s-new-in-2-1-5">What's new in 2.1.5</a></h1>
<ul class="simple">
<li>12-Oct-1999</li>
</ul>
<p>This is a quick bug-fix release to take care of a few nasties that
crept in at the last minute before 2.1.4 was called done.  No new
major features.</p>
</div>
<div class="section" id="what-s-new-in-2-1-4">
<h1><a name="what-s-new-in-2-1-4">What's new in 2.1.4</a></h1>
<ul class="simple">
<li>7-Oct-1999</li>
</ul>
<p>This release is NOT syncronized with a snapshot release of wxGTK or
wxMSW.  For MSW this isn't much of a problem since you can get the
binaries from the web site.  For other platforms you'll have to build
wxGTK from CVS.  (See <a class="reference" href="http://web.ukonline.co.uk/julian.smart/wxwin/cvs.htm">http://web.ukonline.co.uk/julian.smart/wxwin/cvs.htm</a>)
To get the same set of sources from CVS that I used, checkout using
the wxPy-2-1-4 tag.</p>
<p>Now back to what's new...</p>
<p>Much more support for event-less callbacks and add-on modules.</p>
<p>Created add-on module with wxOGL classes.</p>
<p>Added wxWindow.GetChildren().  Be careful of this.  It returns a <em>copy</em>
of the list of the window's children.  While you are using the list if
anything changes in the real list (a child is deleted, etc.) then the
list you are holding will suddenly have window references to garbage
memory and your app will likely crash.  But if you are careful it works
great!</p>
<p>Added a bunch of new and missing methods to wxTreeCrtl.  The
SortChildren method is now supported, but currently only for the
default sort order.</p>
<p>Added typemaps for wxSize, wxPoint, wxRealPoint, and wxRect that allow
either the actual objects or Python sequence values to be used.  For
example, the following are equivallent:</p>
<pre class="literal-block">
win = wxWindow(parent, size = wxSize(100, 100))
win = wxWindow(parent, size = (100, 100))
</pre>
<p>Super-charged the wxHtml module.  You can now create your own tag
handlers and also have access to the parser and cell classes.  There
is a tag handler in the library at wxPython.lib.wxpTag that
understands the WXP tag and is able to place wxPython windows on HTML
pages.  See the demo for an example.</p>
<p>A bunch of the methods of wxMenuBar were previously ifdef'd out for
wxGTK.  Added them back in since the methods exist now.</p>
<p>Wrapped the wxHtmlHelpController and related classes.</p>
<p>Wrapped the C++ versions of wxSizer and friends.  The Python-only
versions are still in the library, but deprecated.  (You will get a
warning message if you try to use them, but the warning can be
disabled.) The usage of the C++ versions is slightly different, and
the functionality of wxBorderSizer is now part of wxBoxSizer.  I have
added a few methods to wxSizer to try and make the transition as
smooth as possible, I combined all Add methods into a single method
that handles all cases, added an AddMany method, etc.  One step I did
not take was to make the default value of flag in the Add method be
wxGROW.  This would have made it more backward compatible, but less
portable to and from wxWin C++ code.  Please see the docs and demo for
further details.</p>
<p>Added wxPyEvent and wxPyCommandEvent classes, derived from wxEvent and
wxCommandEvent.  Each of them has SetPyData and GetPyData methods that
accept or return a single Python object.  You can use these classes
directly or derive from them to create your own types of event objects
that can pass through the wxWindows event system without loosing their
Python parts (as long as they are stored with SetPyData.)  Stay tuned
for more info and examples in future releases.</p>
<p>Added wxPython.lib.grids as an example of how to derive a new sizer
from the C++ sizers.  In this module you will find wxGridSizer and
wxFlexGridSizer.  wxGridSizer arrainges its items in a grid in which
all the widths and heights are the same.  wxFlexgridSizer allows
different widths and heights, and you can also specify rows and/or
columns that are growable.  See the demo for a couple examples for how
to use them.</p>
<p>Added the wxValidator class, and created a class named wxPyValidator
that should be used for the base class of any Python validators.  See
the demo for an example.  Please note that you MUST implement a Clone
method in your validator classes because of the way some things work
in the underlying C++ library.  I did not add wxTextValidator because
of some issues of how it transfers data to and from a wxString, which
in wxPython is automatically translated to and from Python strings, so
there would never be a concrete wxString that would hang around long
enough for the validator to do its job.  On the other hand, it should
be real easy to duplicate the functionality of wxTextValidator in a
pure Python class derived from wxPyValidator.</p>
<p>I've finally added a feature that has been on my list for close to two
years!  Ever wondered what that zero is for when you create your app
object?  Well now you can leave it out or explicitly set it to a true
value.  This value now controls what is to be done with sys.stdout and
sys.stderr.  A false value leaves them alone, and a true value sets
them to an instance of wxPyOnDemandOutputWindow.  (On windows the
default is true, on unix platforms the default is false.)  This class
creates a frame containing a wxTextCtrl as soon as anything is written
to sys.stdout or sys.stderr.  If you close the window it will come
back again the next time something is written.  (You can call
app.RestoreStdio to turn this off.)  If you would rather that the stdio be
redirected to a file, you can provide a second parameter to your app
object's constructor that is a filename.  If you want to use your own
class instead of wxPyOnDemandOutputWindow you can either implement
RedirectStdio() in you app class or change the value of
wxApp.outputWindowClass like this:</p>
<pre class="literal-block">
class MyApp(wxApp):
    outputWindowClass = MyClass

    def OnInit(self):
        frame = MyFrame()
        self.SetTopWindow(frame)
        return true
</pre>
<p>Please see the implementation of wxPyOnDemandOutputWindow and wxApp in
wx.py for more details.  A few words of caution:  if you are running
your app in a debugger, changing sys.stdout and sys.stderr is likely
to really screw things up.</p>
<p>Added wxCaret.  Unfortunately it's author has still not documented it
in the wxWindows docs...</p>
<p>Some new 3rd party contributions in wxPython.lib.  PyShell, in
shell.py is an interesting implementaion of an interactive Python
shell in wxWindows.  floatbar.py has a class derived from wxToolBar
that can sense mouse drags and then reparent itself into another
frame. Moving the new frame close to where it came from puts the tool
bar back into the original parent.  (Unfortunately there is currently
a bug in wxGTK's wxFrame.SetToolBar so the FloatBar has some
problems...)</p>
</div>
<div class="section" id="what-s-new-in-2-1b3">
<h1><a name="what-s-new-in-2-1b3">What's new in 2.1b3</a></h1>
<ul class="simple">
<li>1-Sep-1999</li>
</ul>
<p>This release is syncronized with release 2.1 snapshot 9 of wxWindows.</p>
<p>Switched to using SWIG from CVS (see <a class="reference" href="http://swig.cs.uchicago.edu/cvs.html">http://swig.cs.uchicago.edu/cvs.html</a>)
for some of the new features and such.  Also they have encorporated my
patches so there is really no reason to stick with the current (very
old) release...  This version of SWIG gives the following new
features:</p>
<blockquote>
<ol class="arabic">
<li><p class="first">Keyword arguments.  You no longer have to specify all the
parameters with defaults to a method just to specify a
non-default value on the end.  You can now do this instead:</p>
<blockquote>
<p>win = wxWindow(parent, -1, style = mystyle)</p>
</blockquote>
</li>
<li><p class="first">There is now an an equivalence between Python's None and C++'s
NULL.  This means that any methods that might return NULL will
now return None and you can use none where wxWindows might be
expecting NULL.  This makes things much more snake-ish.</p>
</li>
</ol>
</blockquote>
<p>There is a new build system based on a new Python program instead of
raw makefiles.  Now wxPython builds are virtually the same on MSW or
Unix systems.  See the end of this file for new build instructions and
see distrib/build.py for more details.</p>
<p>wxDC.Bilt now includes the useMask parameter, and has been split into
two different versions.  wxDC.BlitXY is like what was there before and
takes raw coordinants and sizes, and the new wxDC.Blit is for the new
interface using wxPoints and a wxSize.</p>
</div>
<div class="section" id="what-s-new-in-2-1b2">
<h1><a name="what-s-new-in-2-1b2">What's new in 2.1b2</a></h1>
<ul class="simple">
<li>6-Aug-1999</li>
</ul>
<p>Added the missing wxWindow.GetUpdateRegion() method.</p>
<p>Made a new change in SWIG (update your patches everybody) that
provides a fix for global shadow objects that get an exception in
their __del__ when their extension module has already been deleted.
It was only a 1 line change in .../SWIG/Modules/pycpp.cxx at about
line 496 if you want to do it by hand.</p>
<p>It is now possible to run through MainLoop more than once in any one
process.  The cleanup that used to happen as MainLoop completed (and
prevented it from running again) has been delayed until the wxc module
is being unloaded by Python.</p>
<p>I fixed a bunch of stuff in the C++ version of wxGrid so it wouldn't
make wxPython look bad.</p>
<p>wxWindow.PopupMenu() now takes a wxPoint instead of  x,y.  Added
wxWindow.PopupMenuXY to be consistent with some other methods.</p>
<p>Added wxGrid.SetEditInPlace and wxGrid.GetEditInPlace.</p>
<p>You can now provide your own app.MainLoop method.  See
wxPython/demo/demoMainLoop.py for an example and some explaination.</p>
<p>Got the in-place-edit for the wxTreeCtrl fixed and added some demo
code to show how to use it.</p>
<p>Put the wxIcon constructor back in for GTK as it now has one that
matches MSW's.</p>
<p>Added wxGrid.GetCells</p>
<p>Added wxSystemSettings static methods as functions with names like
wxSystemSettings_GetSystemColour.</p>
<p>Removed wxPyMenu since using menu callbacks have been deprecated in
wxWindows.  Use wxMenu and events instead.</p>
<dl class="docutils">
<dt>Added alternate wxBitmap constructor (for MSW only) as</dt>
<dd>wxBitmapFromData(data, type, width, height, depth = 1)</dd>
</dl>
<p>Added a helper function named wxPyTypeCast that can convert shadow
objects of one type into shadow objects of another type.  (Like doing
a down-cast.)  See the implementation in wx.py for some docs.</p>
<p>Fixed wxImage GetData and SetData to properly use String objects for
data transfer.</p>
<p>Added access methods to wxGridEvent.</p>
<p>New Makefile/Setup files supporting multiple dynamic extension modules
for unix systems.</p>
<p>Fixes for the wxGLCanvas demo to work around a strange bug in gtk.</p>
<p>SWIG support routines now compiled separately instead of being bundled
in wx.cpp.</p>
</div>
<div class="section" id="what-s-new-in-2-1b1">
<h1><a name="what-s-new-in-2-1b1">What's new in 2.1b1</a></h1>
<ul class="simple">
<li>28-Jun-1999</li>
</ul>
<p>Fixed wxComboBox.SetSelection so that it actually sets the selected
item.  (Actually just removed it from wxPython and let it default to
wxChoice.SetSelection which was already doing the right thing.)</p>
<p>Added the Printing Framework.</p>
<p>Switched back to using the wxWindows DLL for the pre-built Win32
version.  The problem was needing to reinitialize static class info
data after loading each extension module.</p>
<p>Lots of little tweaks and additions to reflect changes to various
wxWindows classes.</p>
<p>Fixed a bug with attaching objects to tree items.  Actually was a
symptom of a larger problem with not obtaining the interpreter lock
when doing any Py_DECREFs.</p>
<p>wxSizer and friends.  Sizers are layout tools that manage a colection
of windows and sizers.  Different types of sizers apply different
types of layout algorithms.  You saw it here first!  These classes are
not even in the wxWindows C++ library yet!</p>
</div>
<div class="section" id="what-s-new-in-2-0b9">
<h1><a name="what-s-new-in-2-0b9">What's new in 2.0b9</a></h1>
<ul class="simple">
<li>1-May-1999</li>
</ul>
<p>Bug fix for ListCtrl in test4.py (Was a missing file...  DSM!)</p>
<p>Bug fix for occassional GPF on Win32 systems upon termination of a
wxPython application.</p>
<p>Added wxListBox.GetSelections returning selections as a Tuple.</p>
<p>Added a wxTreeItemData that is able to hold any Python object and be
associated with items in a wxTreeCtrl.  Added test pytree.py to show
this feature off.</p>
<p>Added wxSafeYield function.</p>
<p>OpenGL Canvas can be optionally compiled in to wxPython.</p>
<p>Awesome new Demo Framework for showing off wxPython and for learning
how it all works.</p>
<p>The pre-built Win32 version is no longer distributing the wxWindows
DLL.  It is statically linked with the wxWindows library instead.</p>
<p>Added a couple missing items from the docs.</p>
<p>Added wxImage, wxImageHandler, wxPNGHandler, wxJPEGHandler,
wxGIFHandler and wxBMPHandler.</p>
<p>Added new methods to wxTextCtrl.</p>
<p>Fixed some problems with how SWIG was wrapping some wxTreeCtrl
methods.</p>
</div>
<div class="section" id="what-s-new-in-2-0b8">
<h1><a name="what-s-new-in-2-0b8">What's new in 2.0b8</a></h1>
<ul class="simple">
<li>28-Mar-1999</li>
</ul>
<p>Support for using Python threads in wxPython apps.</p>
<p>Several missing methods from various classes.</p>
<p>Various bug fixes.</p>
</div>
<div class="section" id="what-s-new-in-2-0b7">
<h1><a name="what-s-new-in-2-0b7">What's new in 2.0b7</a></h1>
<ul class="simple">
<li>15-Mar-1999</li>
</ul>
<p>Added DLG_PNT and DLG_SZE convienience methods to wxWindow class.</p>
<p>Added missing constructor and other methods for wxMenuItem.</p>
</div>
<div class="section" id="what-s-new-in-2-0b6">
<h1><a name="what-s-new-in-2-0b6">What's new in 2.0b6</a></h1>
<ul class="simple">
<li>4-Mar-1999</li>
</ul>
<p>Just a quickie update to fix the self-installer to be compatible with
Python 1.5.2b2's Registry settings.</p>
</div>
<div class="section" id="what-s-new-in-2-0b5">
<h1><a name="what-s-new-in-2-0b5">What's new in 2.0b5</a></h1>
<ul class="simple">
<li>25-Feb-1999</li>
</ul>
<p>Well obviously the numbering scheme has changed.  I did this to
reflect the fact that this truly is the second major revision of
wxPython, (well the third actually if you count the one I did for
wxWindows 1.68 and then threw away...) and also that it is associated
with the 2.0 version of wxWindows.</p>
<p>I have finally started documenting wxPython.  There are several pages
in the wxWindows documentation tree specifically about wxPython, and I
have added notes within the class references about where and how wxPython
diverges from wxWindows.</p>
<p>Added wxWindow_FromHWND(hWnd) for wxMSW to construct a wxWindow from a
window handle.  If you can get the window handle into the python code,
it should just work...  More news on this later.</p>
<p>Added wxImageList, wxToolTip.</p>
<p>Re-enabled wxConfig.DeleteAll() since it is reportedly fixed for the
wxRegConfig class.</p>
<p>As usual, some bug fixes, tweaks, etc.</p>
</div>
<div class="section" id="what-s-new-in-0-5-3">
<h1><a name="what-s-new-in-0-5-3">What's new in 0.5.3</a></h1>
<ul class="simple">
<li>30-Jan-1999</li>
</ul>
<p>Added wxSashWindow, wxSashEvent, wxLayoutAlgorithm, etc.</p>
<p>Various cleanup, tweaks, minor additions, etc. to maintain
compatibility with the current wxWindows.</p>
</div>
<div class="section" id="what-s-new-in-0-5-0">
<h1><a name="what-s-new-in-0-5-0">What's new in 0.5.0</a></h1>
<p>Changed the import semantics from <tt class="docutils literal"><span class="pre">&quot;from</span> <span class="pre">wxPython</span> <span class="pre">import</span> <span class="pre">*&quot;</span></tt> to
<tt class="docutils literal"><span class="pre">&quot;from</span> <span class="pre">wxPython.wx</span> <span class="pre">import</span> <span class="pre">*&quot;</span></tt>  This is for people who are worried about
namespace pollution, they can use &quot;from wxPython import wx&quot; and then
prefix all the wxPython identifiers with &quot;wx.&quot;</p>
<p>Added wxTaskbarIcon for wxMSW.</p>
<p>Made the events work for wxGrid.</p>
<p>Added wxConfig.</p>
<p>Added wxMiniFrame for wxGTK.</p>
<p>Changed many of the args and return values that were pointers to gdi
objects to references to reflect changes in the wxWindows API.</p>
<p>Other assorted fixes and additions.</p>
</div>
<div class="section" id="what-s-new-in-0-4-2">
<h1><a name="what-s-new-in-0-4-2">What's new in 0.4.2</a></h1>
<ul class="simple">
<li>21-Oct-1998</li>
</ul>
<p>wxPython on wxGTK works!!!  Both dynamic and static on Linux and
static on Solaris have been tested.  Many thanks go to Harm van der
Heijden for his astute detective work on tracking down a nasty DECREF
bug.  Okay so I have to confess that it was just a DSM (Dumb Stupid
Mistake) on my part but it was nasty none the less because the
behavior was so different on different platforms.</p>
<p>The dynamicly loaded module on Solaris is still segfaulting, so it
must have been a different issue all along...</p>
</div>
<div class="section" id="what-s-new-in-0-4">
<h1><a name="what-s-new-in-0-4">What's New in 0.4</a></h1>
<ul class="simple">
<li>2-Oct-1998</li>
</ul>
<p>1. Worked on wxGTK compatibility.  It is partially working.  On a
Solaris/Sparc box wxPython is working but only when it is statically
linked with the Python interpreter.  When built as a dyamically loaded
extension module, things start acting weirdly and it soon seg-faults.
And on Linux both the statically linked and the dynamically linked
version segfault shortly after starting up.</p>
<ol class="arabic simple" start="2">
<li>Added Toolbar, StatusBar and SplitterWindow classes.</li>
<li>Varioius bug fixes, enhancements, etc.</li>
</ol>
</div>
<div class="section" id="wxpython-0-3">
<h1><a name="wxpython-0-3">wxPython 0.3</a></h1>
<ul class="simple">
<li>9-Aug-1998</li>
</ul>
<p>The first &quot;modern&quot; version of wxPython.  See
<a class="reference" href="http://wiki.wxpython.org/index.cgi/WxPythonHistory">http://wiki.wxpython.org/index.cgi/WxPythonHistory</a></p>
</div>
</div>
</body>
</html>