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
|
<!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">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<title>wxWidgets: wxEvtHandler Class Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
<link href="extra_stylesheet.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<div id="page_container">
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0" style="width: 100%;">
<tbody>
<tr>
<td id="projectlogo">
<a href="http://www.wxwidgets.org/" target="_new">
<img alt="wxWidgets" src="logo.png"/>
</a>
</td>
<td style="padding-left: 0.5em; text-align: right;">
<span id="projectnumber">Version: 3.0.2</span>
</td>
</tr>
</tbody>
</table>
</div>
<!-- Generated by Doxygen 1.8.2 -->
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="modules.html"><span>Categories</span></a></li>
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
</ul>
</div>
<div id="navrow2" class="tabs2">
<ul class="tablist">
<li><a href="annotated.html"><span>Class List</span></a></li>
<li><a href="classes.html"><span>Class Index</span></a></li>
<li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class Members</span></a></li>
</ul>
</div>
</div><!-- top -->
<div class="header">
<div class="summary">
<a href="#pub-methods">Public Member Functions</a> |
<a href="#pro-methods">Protected Member Functions</a> |
<a href="classwx_evt_handler-members.html">List of all members</a> </div>
<div class="headertitle">
<div class="title">wxEvtHandler Class Reference<div class="ingroups"><a class="el" href="group__group__class__events.html">Events</a></div></div> </div>
</div><!--header-->
<div class="contents">
<p><code>#include <wx/event.h></code></p>
<div id="dynsection-0" onclick="return toggleVisibility(this)" class="dynheader closed" style="cursor:pointer;">
<img id="dynsection-0-trigger" src="closed.png" alt="+"/> Inheritance diagram for wxEvtHandler:</div>
<div id="dynsection-0-summary" class="dynsummary" style="display:block;">
</div>
<div id="dynsection-0-content" class="dyncontent" style="display:none;">
<div class="center"><img src="classwx_evt_handler__inherit__graph.png" border="0" usemap="#wx_evt_handler_inherit__map" alt="Inheritance graph"/></div>
<map name="wx_evt_handler_inherit__map" id="wx_evt_handler_inherit__map">
<area shape="rect" id="node7" href="classwx_app_console.html" title="This class is essential for writing console-only or hybrid apps without having to define wxUSE_GUI=0..." alt="" coords="324,5,431,33"/><area shape="rect" id="node11" href="classwx_aui_manager.html" title="wxAuiManager is the central class of the wxAUI class framework." alt="" coords="324,55,431,83"/><area shape="rect" id="node13" href="classwx_doc_manager.html" title="The wxDocManager class is part of the document/view framework supported by wxWidgets, and cooperates with the wxView, wxDocument and wxDocTemplate classes." alt="" coords="323,106,432,134"/><area shape="rect" id="node15" href="classwx_document.html" title="The document class can be used to model an application's file-based data." alt="" coords="329,157,425,185"/><area shape="rect" id="node17" href="classwx_event_blocker.html" title="This class is a special event handler which allows to discard any event (or a set of event types) dir..." alt="" coords="321,207,433,235"/><area shape="rect" id="node19" href="classwx_file_system_watcher.html" title="The wxFileSystemWatcher class allows to receive notifications of file system changes." alt="" coords="303,258,452,286"/><area shape="rect" id="node21" href="classwx_menu.html" title="A menu is a popup (or pull down) list of items, one of which may be selected before the menu goes awa..." alt="" coords="343,309,412,337"/><area shape="rect" id="node23" href="classwx_mouse_events_manager.html" title="Helper for handling mouse input events in windows containing multiple items." alt="" coords="296,359,459,387"/><area shape="rect" id="node25" href="classwx_notification_message.html" title="This class allows to show the user a message non intrusively." alt="" coords="301,410,453,438"/><area shape="rect" id="node27" href="classwx_process.html" title="The objects of this class are used in conjunction with the wxExecute() function." alt="" coords="336,461,419,489"/><area shape="rect" id="node29" href="classwx_property_grid_page.html" title="Holder of property grid page information." alt="" coords="308,511,447,539"/><area shape="rect" id="node31" href="classwx_task_bar_icon.html" title="This class represents a taskbar icon." alt="" coords="323,562,432,590"/><area shape="rect" id="node33" href="classwx_timer.html" title="The wxTimer class allows you to execute code at specified intervals." alt="" coords="343,613,412,641"/><area shape="rect" id="node35" href="classwx_validator.html" title="wxValidator is the base class for a family of validator classes that mediate between a class of contr..." alt="" coords="335,663,420,691"/><area shape="rect" id="node47" href="classwx_view.html" title="The view class can be used to model the viewing and editing component of an application's file-based ..." alt="" coords="345,714,409,742"/><area shape="rect" id="node49" href="classwx_window.html" title="wxWindow is the base class for all windows and represents any visible object on screen." alt="" coords="336,1145,419,1173"/><area shape="rect" id="node2" href="classwx_object.html" title="This is the root class of many of the wxWidgets classes." alt="" coords="16,359,91,387"/><area shape="rect" id="node4" href="classwx_trackable.html" title="Add-on base class for a trackable object." alt="" coords="7,410,100,438"/><area shape="rect" id="node9" href="classwx_app.html" title="The wxApp class represents the application itself when wxUSE_GUI=1." alt="" coords="551,5,609,33"/><area shape="rect" id="node37" href="classwx_generic_validator.html" title="wxGenericValidator performs data transfer (but not validation or filtering) for many type of controls..." alt="" coords="515,587,645,615"/><area shape="rect" id="node39" href="classwx_num_validator.html" title="wxNumValidator is the common base class for numeric validator classes." alt="" coords="508,638,652,666"/><area shape="rect" id="node45" href="classwx_text_validator.html" title="wxTextValidator validates text controls, providing a variety of filtering behaviours." alt="" coords="524,689,636,717"/><area shape="rect" id="node41" href="classwx_floating_point_validator.html" title="Validator for text entries used for floating point numbers entry." alt="" coords="703,587,895,615"/><area shape="rect" id="node43" href="classwx_integer_validator.html" title="Validator for text entries used for integer entry." alt="" coords="720,638,877,666"/><area shape="rect" id="node51" href="classwx_banner_window.html" title="A simple banner window showing either a bitmap or text." alt="" coords="519,866,641,894"/><area shape="rect" id="node53" href="classwx_control.html" title="This is the base class for a control or "widget"." alt="" coords="541,917,619,945"/><area shape="rect" id="node77" href="classwx_g_l_canvas.html" title="wxGLCanvas is a class for displaying OpenGL graphics." alt="" coords="532,967,628,995"/><area shape="rect" id="node79" href="classwx_html_help_window.html" title="This class is used by wxHtmlHelpController to display help within a frame or dialog, but you can use it yourself to create an embedded HTML help window." alt="" coords="513,1018,647,1046"/><area shape="rect" id="node81" href="classwx_m_d_i_client_window.html" title="An MDI client window is a child of wxMDIParentFrame, and manages zero or more wxMDIChildFrame objects..." alt="" coords="511,1069,649,1097"/><area shape="rect" id="node83" href="classwx_menu_bar.html" title="A menu bar is a series of menus accessible from the top of a frame." alt="" coords="536,1119,624,1147"/><area shape="rect" id="node85" href="classwx_non_owned_window.html" title="Common base class for all non-child windows." alt="" coords="508,1170,652,1198"/><area shape="rect" id="node87" href="classwx_panel.html" title="A panel is a window on which controls are placed." alt="" coords="545,1221,615,1249"/><area shape="rect" id="node89" href="classwx_p_g_multi_button.html" title="This class can be used to have multiple buttons in a property editor." alt="" coords="519,1271,641,1299"/><area shape="rect" id="node91" href="classwx_sash_window.html" title="wxSashWindow allows any of its edges to have a sash which can be dragged to resize the window..." alt="" coords="525,1322,635,1350"/><area shape="rect" id="node93" href="classwx_splitter_window.html" title="This class manages up to two subwindows." alt="" coords="519,1373,641,1401"/><area shape="rect" id="node95" href="classwx_tip_window.html" title="Shows simple text in a popup tip window on creation." alt="" coords="531,1423,629,1451"/><area shape="rect" id="node97" href="classwx_tree_list_ctrl.html" title="A control combining wxTreeCtrl and wxListCtrl features." alt="" coords="529,1474,631,1502"/><area shape="rect" id="node55" href="classwx_active_x_container.html" title="wxActiveXContainer is a host for an ActiveX control on Windows (and as such is a platform-specific cl..." alt="" coords="731,689,867,717"/><area shape="rect" id="node57" href="classwx_animation_ctrl.html" title="This is a static control which displays an animation." alt="" coords="741,739,856,767"/><area shape="rect" id="node59" href="classwx_any_button.html" title="A class for common button functionality used as the base for the various button classes." alt="" coords="751,790,847,818"/><area shape="rect" id="node61" href="classwx_aui_tool_bar.html" title="wxAuiToolBar is a dockable toolbar, part of the wxAUI class framework." alt="" coords="748,841,849,869"/><area shape="rect" id="node63" href="classwx_book_ctrl_base.html" title="A book control is a convenient way of displaying multiple pages of information, displayed one page at..." alt="" coords="741,891,856,919"/><area shape="rect" id="node65" href="classwx_calendar_ctrl.html" title="The calendar control allows the user to pick a date." alt="" coords="745,942,852,970"/><area shape="rect" id="node67" href="classwx_check_box.html" title="A checkbox is a labelled box which by default is either on (checkmark is visible) or off (no checkmar..." alt="" coords="751,993,847,1021"/><area shape="rect" id="node69" href="classwx_choice.html" title="A choice item is used to select one of a list of strings." alt="" coords="760,1043,837,1071"/><area shape="rect" id="node71" href="classwx_collapsible_pane.html" title="A collapsible pane is a container with an embedded button-like control which can be used by the user ..." alt="" coords="735,1094,863,1122"/><area shape="rect" id="node73" href="classwx_combo_box.html" title="A combobox is like a combination of an edit control and a listbox." alt="" coords="749,1145,848,1173"/><area shape="rect" id="node75" href="classwx_combo_ctrl.html" title="A combo control is a generic combobox that allows totally custom popup." alt="" coords="749,1195,848,1223"/></map>
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<div class="textblock"><p>A class that can handle events from the windowing system. </p>
<p><a class="el" href="classwx_window.html" title="wxWindow is the base class for all windows and represents any visible object on screen.">wxWindow</a> is (and therefore all window classes are) derived from this class.</p>
<p>When events are received, <a class="el" href="classwx_evt_handler.html" title="A class that can handle events from the windowing system.">wxEvtHandler</a> invokes the method listed in the event table using itself as the object. When using multiple inheritance <b>it is imperative that the <a class="el" href="classwx_evt_handler.html" title="A class that can handle events from the windowing system.">wxEvtHandler</a>(-derived) class is the first class inherited</b> such that the <code>this</code> pointer for the overall object will be identical to the <code>this</code> pointer of the <a class="el" href="classwx_evt_handler.html" title="A class that can handle events from the windowing system.">wxEvtHandler</a> portion.</p>
<h2></h2>
<div><span class="lib">Library:</span>  <span class="lib_text"><a class="el" href="page_libs.html#page_libs_wxbase">wxBase</a></span></div><div><span class="category">Category:</span>  <span class="category_text"><a class="el" href="group__group__class__events.html">Events</a></span></div><dl class="section see"><dt>See Also</dt><dd><a class="el" href="overview_events.html#overview_events_processing">How Events are Processed</a>, <a class="el" href="classwx_event_blocker.html" title="This class is a special event handler which allows to discard any event (or a set of event types) dir...">wxEventBlocker</a>, <a class="el" href="classwx_event_loop_base.html" title="Base class for all event loop implementations.">wxEventLoopBase</a> </dd></dl>
</div><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a>
Public Member Functions</h2></td></tr>
<tr class="memitem:a3f0166c4154227d05575b01eb2c8d4be"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#a3f0166c4154227d05575b01eb2c8d4be">wxEvtHandler</a> ()</td></tr>
<tr class="memdesc:a3f0166c4154227d05575b01eb2c8d4be"><td class="mdescLeft"> </td><td class="mdescRight">Constructor. <a href="#a3f0166c4154227d05575b01eb2c8d4be"></a><br/></td></tr>
<tr class="separator:a3f0166c4154227d05575b01eb2c8d4be"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a372d2239d91521eddc8fd2715fcab584"><td class="memItemLeft" align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#a372d2239d91521eddc8fd2715fcab584">~wxEvtHandler</a> ()</td></tr>
<tr class="memdesc:a372d2239d91521eddc8fd2715fcab584"><td class="mdescLeft"> </td><td class="mdescRight">Destructor. <a href="#a372d2239d91521eddc8fd2715fcab584"></a><br/></td></tr>
<tr class="separator:a372d2239d91521eddc8fd2715fcab584"><td class="memSeparator" colspan="2"> </td></tr>
<tr><td colspan="2"><div class="groupHeader">Event queuing and processing</div></td></tr>
<tr class="memitem:acffd03bf407a856166ea71ef0318b59a"><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#acffd03bf407a856166ea71ef0318b59a">QueueEvent</a> (<a class="el" href="classwx_event.html">wxEvent</a> *event)</td></tr>
<tr class="memdesc:acffd03bf407a856166ea71ef0318b59a"><td class="mdescLeft"> </td><td class="mdescRight">Queue event for a later processing. <a href="#acffd03bf407a856166ea71ef0318b59a"></a><br/></td></tr>
<tr class="separator:acffd03bf407a856166ea71ef0318b59a"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a0737c6d2cbcd5ded4b1ecdd53ed0def3"><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#a0737c6d2cbcd5ded4b1ecdd53ed0def3">AddPendingEvent</a> (const <a class="el" href="classwx_event.html">wxEvent</a> &event)</td></tr>
<tr class="memdesc:a0737c6d2cbcd5ded4b1ecdd53ed0def3"><td class="mdescLeft"> </td><td class="mdescRight">Post an event to be processed later. <a href="#a0737c6d2cbcd5ded4b1ecdd53ed0def3"></a><br/></td></tr>
<tr class="separator:a0737c6d2cbcd5ded4b1ecdd53ed0def3"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a63c7351618fd77330d80a250b3719519"><td class="memTemplParams" colspan="2">template<typename T , typename T1 , ... > </td></tr>
<tr class="memitem:a63c7351618fd77330d80a250b3719519"><td class="memTemplItemLeft" align="right" valign="top">void </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#a63c7351618fd77330d80a250b3719519">CallAfter</a> (void(T::*method)(T1,...), T1 x1,...)</td></tr>
<tr class="memdesc:a63c7351618fd77330d80a250b3719519"><td class="mdescLeft"> </td><td class="mdescRight">Asynchronously call the given method. <a href="#a63c7351618fd77330d80a250b3719519"></a><br/></td></tr>
<tr class="separator:a63c7351618fd77330d80a250b3719519"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a910416e4d0b1f38cec02213b8a0c6a12"><td class="memTemplParams" colspan="2">template<typename T > </td></tr>
<tr class="memitem:a910416e4d0b1f38cec02213b8a0c6a12"><td class="memTemplItemLeft" align="right" valign="top">void </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#a910416e4d0b1f38cec02213b8a0c6a12">CallAfter</a> (const T &functor)</td></tr>
<tr class="memdesc:a910416e4d0b1f38cec02213b8a0c6a12"><td class="mdescLeft"> </td><td class="mdescRight">Asynchronously call the given functor. <a href="#a910416e4d0b1f38cec02213b8a0c6a12"></a><br/></td></tr>
<tr class="separator:a910416e4d0b1f38cec02213b8a0c6a12"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a65968dd27f3aac7718f2dd6b2ddd5a08"><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#a65968dd27f3aac7718f2dd6b2ddd5a08">ProcessEvent</a> (<a class="el" href="classwx_event.html">wxEvent</a> &event)</td></tr>
<tr class="memdesc:a65968dd27f3aac7718f2dd6b2ddd5a08"><td class="mdescLeft"> </td><td class="mdescRight">Processes an event, searching event tables and calling zero or more suitable event handler function(s). <a href="#a65968dd27f3aac7718f2dd6b2ddd5a08"></a><br/></td></tr>
<tr class="separator:a65968dd27f3aac7718f2dd6b2ddd5a08"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ac0f5d2cb29a04c1f7f82eb6b351f79fb"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#ac0f5d2cb29a04c1f7f82eb6b351f79fb">ProcessEventLocally</a> (<a class="el" href="classwx_event.html">wxEvent</a> &event)</td></tr>
<tr class="memdesc:ac0f5d2cb29a04c1f7f82eb6b351f79fb"><td class="mdescLeft"> </td><td class="mdescRight">Try to process the event in this handler and all those chained to it. <a href="#ac0f5d2cb29a04c1f7f82eb6b351f79fb"></a><br/></td></tr>
<tr class="separator:ac0f5d2cb29a04c1f7f82eb6b351f79fb"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a8205cb1a5a00d8b550b3ead22266b16b"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#a8205cb1a5a00d8b550b3ead22266b16b">SafelyProcessEvent</a> (<a class="el" href="classwx_event.html">wxEvent</a> &event)</td></tr>
<tr class="memdesc:a8205cb1a5a00d8b550b3ead22266b16b"><td class="mdescLeft"> </td><td class="mdescRight">Processes an event by calling <a class="el" href="classwx_evt_handler.html#a65968dd27f3aac7718f2dd6b2ddd5a08" title="Processes an event, searching event tables and calling zero or more suitable event handler function(s...">ProcessEvent()</a> and handles any exceptions that occur in the process. <a href="#a8205cb1a5a00d8b550b3ead22266b16b"></a><br/></td></tr>
<tr class="separator:a8205cb1a5a00d8b550b3ead22266b16b"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a6f643dbdcf8e914ae1c8b70dd305e6f2"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#a6f643dbdcf8e914ae1c8b70dd305e6f2">ProcessPendingEvents</a> ()</td></tr>
<tr class="memdesc:a6f643dbdcf8e914ae1c8b70dd305e6f2"><td class="mdescLeft"> </td><td class="mdescRight">Processes the pending events previously queued using <a class="el" href="classwx_evt_handler.html#acffd03bf407a856166ea71ef0318b59a" title="Queue event for a later processing.">QueueEvent()</a> or <a class="el" href="classwx_evt_handler.html#a0737c6d2cbcd5ded4b1ecdd53ed0def3" title="Post an event to be processed later.">AddPendingEvent()</a>; you must call this function only if you are sure there are pending events for this handler, otherwise a <code>wxCHECK</code> will fail. <a href="#a6f643dbdcf8e914ae1c8b70dd305e6f2"></a><br/></td></tr>
<tr class="separator:a6f643dbdcf8e914ae1c8b70dd305e6f2"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a6e7f9cf4ebd0623c1d94979855d096f8"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#a6e7f9cf4ebd0623c1d94979855d096f8">DeletePendingEvents</a> ()</td></tr>
<tr class="memdesc:a6e7f9cf4ebd0623c1d94979855d096f8"><td class="mdescLeft"> </td><td class="mdescRight">Deletes all events queued on this event handler using <a class="el" href="classwx_evt_handler.html#acffd03bf407a856166ea71ef0318b59a" title="Queue event for a later processing.">QueueEvent()</a> or <a class="el" href="classwx_evt_handler.html#a0737c6d2cbcd5ded4b1ecdd53ed0def3" title="Post an event to be processed later.">AddPendingEvent()</a>. <a href="#a6e7f9cf4ebd0623c1d94979855d096f8"></a><br/></td></tr>
<tr class="separator:a6e7f9cf4ebd0623c1d94979855d096f8"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a3c07426130d2868a5ae7fa918a251f49"><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#a3c07426130d2868a5ae7fa918a251f49">SearchEventTable</a> (wxEventTable &table, <a class="el" href="classwx_event.html">wxEvent</a> &event)</td></tr>
<tr class="memdesc:a3c07426130d2868a5ae7fa918a251f49"><td class="mdescLeft"> </td><td class="mdescRight">Searches the event table, executing an event handler function if an appropriate one is found. <a href="#a3c07426130d2868a5ae7fa918a251f49"></a><br/></td></tr>
<tr class="separator:a3c07426130d2868a5ae7fa918a251f49"><td class="memSeparator" colspan="2"> </td></tr>
<tr><td colspan="2"><div class="groupHeader">Connecting and disconnecting</div></td></tr>
<tr class="memitem:a78719e8b82c9f9c6e4056b3449df1943"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#a78719e8b82c9f9c6e4056b3449df1943">Connect</a> (int id, int lastId, <a class="el" href="group__group__funcmacro__events.html#ga6a7fd172612c0d6d9029bfa3aa91aca0">wxEventType</a> eventType, wxObjectEventFunction function, <a class="el" href="classwx_object.html">wxObject</a> *userData=NULL, <a class="el" href="classwx_evt_handler.html">wxEvtHandler</a> *eventSink=NULL)</td></tr>
<tr class="memdesc:a78719e8b82c9f9c6e4056b3449df1943"><td class="mdescLeft"> </td><td class="mdescRight">Connects the given function dynamically with the event handler, id and event type. <a href="#a78719e8b82c9f9c6e4056b3449df1943"></a><br/></td></tr>
<tr class="separator:a78719e8b82c9f9c6e4056b3449df1943"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a1e8b5fc4c7e7f6d32d40bc00d4108ba4"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#a1e8b5fc4c7e7f6d32d40bc00d4108ba4">Connect</a> (int id, <a class="el" href="group__group__funcmacro__events.html#ga6a7fd172612c0d6d9029bfa3aa91aca0">wxEventType</a> eventType, wxObjectEventFunction function, <a class="el" href="classwx_object.html">wxObject</a> *userData=NULL, <a class="el" href="classwx_evt_handler.html">wxEvtHandler</a> *eventSink=NULL)</td></tr>
<tr class="memdesc:a1e8b5fc4c7e7f6d32d40bc00d4108ba4"><td class="mdescLeft"> </td><td class="mdescRight">See the <a class="el" href="classwx_evt_handler.html#a78719e8b82c9f9c6e4056b3449df1943" title="Connects the given function dynamically with the event handler, id and event type.">Connect(int, int, wxEventType, wxObjectEventFunction, wxObject*, wxEvtHandler*)</a> overload for more info. <a href="#a1e8b5fc4c7e7f6d32d40bc00d4108ba4"></a><br/></td></tr>
<tr class="separator:a1e8b5fc4c7e7f6d32d40bc00d4108ba4"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:aa290d9b67348e74c1da8497955a4e35c"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#aa290d9b67348e74c1da8497955a4e35c">Connect</a> (<a class="el" href="group__group__funcmacro__events.html#ga6a7fd172612c0d6d9029bfa3aa91aca0">wxEventType</a> eventType, wxObjectEventFunction function, <a class="el" href="classwx_object.html">wxObject</a> *userData=NULL, <a class="el" href="classwx_evt_handler.html">wxEvtHandler</a> *eventSink=NULL)</td></tr>
<tr class="memdesc:aa290d9b67348e74c1da8497955a4e35c"><td class="mdescLeft"> </td><td class="mdescRight">See the <a class="el" href="classwx_evt_handler.html#a78719e8b82c9f9c6e4056b3449df1943" title="Connects the given function dynamically with the event handler, id and event type.">Connect(int, int, wxEventType, wxObjectEventFunction, wxObject*, wxEvtHandler*)</a> overload for more info. <a href="#aa290d9b67348e74c1da8497955a4e35c"></a><br/></td></tr>
<tr class="separator:aa290d9b67348e74c1da8497955a4e35c"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a13061cf0ed01ac10a804ac057ef4bdbc"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#a13061cf0ed01ac10a804ac057ef4bdbc">Disconnect</a> (<a class="el" href="group__group__funcmacro__events.html#ga6a7fd172612c0d6d9029bfa3aa91aca0">wxEventType</a> eventType, wxObjectEventFunction function, <a class="el" href="classwx_object.html">wxObject</a> *userData=NULL, <a class="el" href="classwx_evt_handler.html">wxEvtHandler</a> *eventSink=NULL)</td></tr>
<tr class="memdesc:a13061cf0ed01ac10a804ac057ef4bdbc"><td class="mdescLeft"> </td><td class="mdescRight">Disconnects the given function dynamically from the event handler, using the specified parameters as search criteria and returning <span class="literal">true</span> if a matching function has been found and removed. <a href="#a13061cf0ed01ac10a804ac057ef4bdbc"></a><br/></td></tr>
<tr class="separator:a13061cf0ed01ac10a804ac057ef4bdbc"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a2f171e19444b9c4034c5e11f24fa9c91"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#a2f171e19444b9c4034c5e11f24fa9c91">Disconnect</a> (int id=<a class="el" href="defs_8h.html#ac66d0a09761e7d86b2ac0b2e0c6a8cbba1f375b01ea03a713bbb7e32a36a2589c">wxID_ANY</a>, <a class="el" href="group__group__funcmacro__events.html#ga6a7fd172612c0d6d9029bfa3aa91aca0">wxEventType</a> eventType=<a class="el" href="group__group__funcmacro__events.html#ga310bc3f7977ae79ac1198c7a287dbffe">wxEVT_NULL</a>, wxObjectEventFunction function=NULL, <a class="el" href="classwx_object.html">wxObject</a> *userData=NULL, <a class="el" href="classwx_evt_handler.html">wxEvtHandler</a> *eventSink=NULL)</td></tr>
<tr class="memdesc:a2f171e19444b9c4034c5e11f24fa9c91"><td class="mdescLeft"> </td><td class="mdescRight">See the <a class="el" href="classwx_evt_handler.html#a13061cf0ed01ac10a804ac057ef4bdbc" title="Disconnects the given function dynamically from the event handler, using the specified parameters as ...">Disconnect(wxEventType, wxObjectEventFunction, wxObject*, wxEvtHandler*)</a> overload for more info. <a href="#a2f171e19444b9c4034c5e11f24fa9c91"></a><br/></td></tr>
<tr class="separator:a2f171e19444b9c4034c5e11f24fa9c91"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a16a6f823853e4b74b43dd9a2cf3abee6"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#a16a6f823853e4b74b43dd9a2cf3abee6">Disconnect</a> (int id, int lastId, <a class="el" href="group__group__funcmacro__events.html#ga6a7fd172612c0d6d9029bfa3aa91aca0">wxEventType</a> eventType, wxObjectEventFunction function=NULL, <a class="el" href="classwx_object.html">wxObject</a> *userData=NULL, <a class="el" href="classwx_evt_handler.html">wxEvtHandler</a> *eventSink=NULL)</td></tr>
<tr class="memdesc:a16a6f823853e4b74b43dd9a2cf3abee6"><td class="mdescLeft"> </td><td class="mdescRight">See the <a class="el" href="classwx_evt_handler.html#a13061cf0ed01ac10a804ac057ef4bdbc" title="Disconnects the given function dynamically from the event handler, using the specified parameters as ...">Disconnect(wxEventType, wxObjectEventFunction, wxObject*, wxEvtHandler*)</a> overload for more info. <a href="#a16a6f823853e4b74b43dd9a2cf3abee6"></a><br/></td></tr>
<tr class="separator:a16a6f823853e4b74b43dd9a2cf3abee6"><td class="memSeparator" colspan="2"> </td></tr>
<tr><td colspan="2"><div class="groupHeader">Binding and Unbinding</div></td></tr>
<tr class="memitem:a0f30c8fa5583b4a5f661897d63de3b62"><td class="memTemplParams" colspan="2">template<typename EventTag , typename Functor > </td></tr>
<tr class="memitem:a0f30c8fa5583b4a5f661897d63de3b62"><td class="memTemplItemLeft" align="right" valign="top">void </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#a0f30c8fa5583b4a5f661897d63de3b62">Bind</a> (const EventTag &eventType, Functor functor, int id=<a class="el" href="defs_8h.html#ac66d0a09761e7d86b2ac0b2e0c6a8cbba1f375b01ea03a713bbb7e32a36a2589c">wxID_ANY</a>, int lastId=<a class="el" href="defs_8h.html#ac66d0a09761e7d86b2ac0b2e0c6a8cbba1f375b01ea03a713bbb7e32a36a2589c">wxID_ANY</a>, <a class="el" href="classwx_object.html">wxObject</a> *userData=NULL)</td></tr>
<tr class="memdesc:a0f30c8fa5583b4a5f661897d63de3b62"><td class="mdescLeft"> </td><td class="mdescRight">Binds the given function, functor or method dynamically with the event. <a href="#a0f30c8fa5583b4a5f661897d63de3b62"></a><br/></td></tr>
<tr class="separator:a0f30c8fa5583b4a5f661897d63de3b62"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a03cc68ca201fb79c7e837919025be71a"><td class="memTemplParams" colspan="2">template<typename EventTag , typename Class , typename EventArg , typename EventHandler > </td></tr>
<tr class="memitem:a03cc68ca201fb79c7e837919025be71a"><td class="memTemplItemLeft" align="right" valign="top">void </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#a03cc68ca201fb79c7e837919025be71a">Bind</a> (const EventTag &eventType, void(Class::*method)(EventArg &), EventHandler *handler, int id=<a class="el" href="defs_8h.html#ac66d0a09761e7d86b2ac0b2e0c6a8cbba1f375b01ea03a713bbb7e32a36a2589c">wxID_ANY</a>, int lastId=<a class="el" href="defs_8h.html#ac66d0a09761e7d86b2ac0b2e0c6a8cbba1f375b01ea03a713bbb7e32a36a2589c">wxID_ANY</a>, <a class="el" href="classwx_object.html">wxObject</a> *userData=NULL)</td></tr>
<tr class="memdesc:a03cc68ca201fb79c7e837919025be71a"><td class="mdescLeft"> </td><td class="mdescRight">See the <a class="el" href="classwx_evt_handler.html#a0f30c8fa5583b4a5f661897d63de3b62" title="Binds the given function, functor or method dynamically with the event.">Bind<>(const EventTag&, Functor, int, int, wxObject*)</a> overload for more info. <a href="#a03cc68ca201fb79c7e837919025be71a"></a><br/></td></tr>
<tr class="separator:a03cc68ca201fb79c7e837919025be71a"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a2b7df8272075a96daea78cdd799c00da"><td class="memTemplParams" colspan="2">template<typename EventTag , typename Functor > </td></tr>
<tr class="memitem:a2b7df8272075a96daea78cdd799c00da"><td class="memTemplItemLeft" align="right" valign="top">bool </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#a2b7df8272075a96daea78cdd799c00da">Unbind</a> (const EventTag &eventType, Functor functor, int id=<a class="el" href="defs_8h.html#ac66d0a09761e7d86b2ac0b2e0c6a8cbba1f375b01ea03a713bbb7e32a36a2589c">wxID_ANY</a>, int lastId=<a class="el" href="defs_8h.html#ac66d0a09761e7d86b2ac0b2e0c6a8cbba1f375b01ea03a713bbb7e32a36a2589c">wxID_ANY</a>, <a class="el" href="classwx_object.html">wxObject</a> *userData=NULL)</td></tr>
<tr class="memdesc:a2b7df8272075a96daea78cdd799c00da"><td class="mdescLeft"> </td><td class="mdescRight">Unbinds the given function, functor or method dynamically from the event handler, using the specified parameters as search criteria and returning <span class="literal">true</span> if a matching function has been found and removed. <a href="#a2b7df8272075a96daea78cdd799c00da"></a><br/></td></tr>
<tr class="separator:a2b7df8272075a96daea78cdd799c00da"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:aa49f9c4ad4462456b4fe4bd1ab53533d"><td class="memTemplParams" colspan="2">template<typename EventTag , typename Class , typename EventArg , typename EventHandler > </td></tr>
<tr class="memitem:aa49f9c4ad4462456b4fe4bd1ab53533d"><td class="memTemplItemLeft" align="right" valign="top">bool </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#aa49f9c4ad4462456b4fe4bd1ab53533d">Unbind</a> (const EventTag &eventType, void(Class::*method)(EventArg &), EventHandler *handler, int id=<a class="el" href="defs_8h.html#ac66d0a09761e7d86b2ac0b2e0c6a8cbba1f375b01ea03a713bbb7e32a36a2589c">wxID_ANY</a>, int lastId=<a class="el" href="defs_8h.html#ac66d0a09761e7d86b2ac0b2e0c6a8cbba1f375b01ea03a713bbb7e32a36a2589c">wxID_ANY</a>, <a class="el" href="classwx_object.html">wxObject</a> *userData=NULL)</td></tr>
<tr class="memdesc:aa49f9c4ad4462456b4fe4bd1ab53533d"><td class="mdescLeft"> </td><td class="mdescRight">See the <a class="el" href="classwx_evt_handler.html#a2b7df8272075a96daea78cdd799c00da" title="Unbinds the given function, functor or method dynamically from the event handler, using the specified...">Unbind<>(const EventTag&, Functor, int, int, wxObject*)</a> overload for more info. <a href="#aa49f9c4ad4462456b4fe4bd1ab53533d"></a><br/></td></tr>
<tr class="separator:aa49f9c4ad4462456b4fe4bd1ab53533d"><td class="memSeparator" colspan="2"> </td></tr>
<tr><td colspan="2"><div class="groupHeader">User-supplied data</div></td></tr>
<tr class="memitem:ad6e543115a9405962152630138645588"><td class="memItemLeft" align="right" valign="top">void * </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#ad6e543115a9405962152630138645588">GetClientData</a> () const </td></tr>
<tr class="memdesc:ad6e543115a9405962152630138645588"><td class="mdescLeft"> </td><td class="mdescRight">Returns user-supplied client data. <a href="#ad6e543115a9405962152630138645588"></a><br/></td></tr>
<tr class="separator:ad6e543115a9405962152630138645588"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a2b3949eaba1f25cb48618163a7c0583b"><td class="memItemLeft" align="right" valign="top"><a class="el" href="classwx_client_data.html">wxClientData</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#a2b3949eaba1f25cb48618163a7c0583b">GetClientObject</a> () const </td></tr>
<tr class="memdesc:a2b3949eaba1f25cb48618163a7c0583b"><td class="mdescLeft"> </td><td class="mdescRight">Returns a pointer to the user-supplied client data object. <a href="#a2b3949eaba1f25cb48618163a7c0583b"></a><br/></td></tr>
<tr class="separator:a2b3949eaba1f25cb48618163a7c0583b"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a82c74f2cebfa02cb3c1563d459c872bf"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#a82c74f2cebfa02cb3c1563d459c872bf">SetClientData</a> (void *data)</td></tr>
<tr class="memdesc:a82c74f2cebfa02cb3c1563d459c872bf"><td class="mdescLeft"> </td><td class="mdescRight">Sets user-supplied client data. <a href="#a82c74f2cebfa02cb3c1563d459c872bf"></a><br/></td></tr>
<tr class="separator:a82c74f2cebfa02cb3c1563d459c872bf"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:af1e33a06087b8b2ddc43c7d15a91b326"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#af1e33a06087b8b2ddc43c7d15a91b326">SetClientObject</a> (<a class="el" href="classwx_client_data.html">wxClientData</a> *data)</td></tr>
<tr class="memdesc:af1e33a06087b8b2ddc43c7d15a91b326"><td class="mdescLeft"> </td><td class="mdescRight">Set the client data object. <a href="#af1e33a06087b8b2ddc43c7d15a91b326"></a><br/></td></tr>
<tr class="separator:af1e33a06087b8b2ddc43c7d15a91b326"><td class="memSeparator" colspan="2"> </td></tr>
<tr><td colspan="2"><div class="groupHeader">Event handler chaining</div></td></tr>
<tr><td colspan="2"><div class="groupText"><p><a class="el" href="classwx_evt_handler.html" title="A class that can handle events from the windowing system.">wxEvtHandler</a> can be arranged in a double-linked list of handlers which is automatically iterated by <a class="el" href="classwx_evt_handler.html#a65968dd27f3aac7718f2dd6b2ddd5a08" title="Processes an event, searching event tables and calling zero or more suitable event handler function(s...">ProcessEvent()</a> if needed. </p>
</div></td></tr>
<tr class="memitem:a533e62afcb125abf1fcc8bb53fbc2e81"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#a533e62afcb125abf1fcc8bb53fbc2e81">GetEvtHandlerEnabled</a> () const </td></tr>
<tr class="memdesc:a533e62afcb125abf1fcc8bb53fbc2e81"><td class="mdescLeft"> </td><td class="mdescRight">Returns <span class="literal">true</span> if the event handler is enabled, <span class="literal">false</span> otherwise. <a href="#a533e62afcb125abf1fcc8bb53fbc2e81"></a><br/></td></tr>
<tr class="separator:a533e62afcb125abf1fcc8bb53fbc2e81"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a4b2f853f5c7a64432ae72f9b606698f9"><td class="memItemLeft" align="right" valign="top"><a class="el" href="classwx_evt_handler.html">wxEvtHandler</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#a4b2f853f5c7a64432ae72f9b606698f9">GetNextHandler</a> () const </td></tr>
<tr class="memdesc:a4b2f853f5c7a64432ae72f9b606698f9"><td class="mdescLeft"> </td><td class="mdescRight">Returns the pointer to the next handler in the chain. <a href="#a4b2f853f5c7a64432ae72f9b606698f9"></a><br/></td></tr>
<tr class="separator:a4b2f853f5c7a64432ae72f9b606698f9"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:aad1ba7fa9ccbf12ee2d80f5f12350adb"><td class="memItemLeft" align="right" valign="top"><a class="el" href="classwx_evt_handler.html">wxEvtHandler</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#aad1ba7fa9ccbf12ee2d80f5f12350adb">GetPreviousHandler</a> () const </td></tr>
<tr class="memdesc:aad1ba7fa9ccbf12ee2d80f5f12350adb"><td class="mdescLeft"> </td><td class="mdescRight">Returns the pointer to the previous handler in the chain. <a href="#aad1ba7fa9ccbf12ee2d80f5f12350adb"></a><br/></td></tr>
<tr class="separator:aad1ba7fa9ccbf12ee2d80f5f12350adb"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a7388ae19c8657e5656471b658c320036"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#a7388ae19c8657e5656471b658c320036">SetEvtHandlerEnabled</a> (bool enabled)</td></tr>
<tr class="memdesc:a7388ae19c8657e5656471b658c320036"><td class="mdescLeft"> </td><td class="mdescRight">Enables or disables the event handler. <a href="#a7388ae19c8657e5656471b658c320036"></a><br/></td></tr>
<tr class="separator:a7388ae19c8657e5656471b658c320036"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a68e2ef2d2b7d68c4c9c18ca92933031b"><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#a68e2ef2d2b7d68c4c9c18ca92933031b">SetNextHandler</a> (<a class="el" href="classwx_evt_handler.html">wxEvtHandler</a> *handler)</td></tr>
<tr class="memdesc:a68e2ef2d2b7d68c4c9c18ca92933031b"><td class="mdescLeft"> </td><td class="mdescRight">Sets the pointer to the next handler. <a href="#a68e2ef2d2b7d68c4c9c18ca92933031b"></a><br/></td></tr>
<tr class="separator:a68e2ef2d2b7d68c4c9c18ca92933031b"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:aff0d1836464be82e2ad723ad3a58eccc"><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#aff0d1836464be82e2ad723ad3a58eccc">SetPreviousHandler</a> (<a class="el" href="classwx_evt_handler.html">wxEvtHandler</a> *handler)</td></tr>
<tr class="memdesc:aff0d1836464be82e2ad723ad3a58eccc"><td class="mdescLeft"> </td><td class="mdescRight">Sets the pointer to the previous handler. <a href="#aff0d1836464be82e2ad723ad3a58eccc"></a><br/></td></tr>
<tr class="separator:aff0d1836464be82e2ad723ad3a58eccc"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a22e5db2ec1d19c8252c056fd116975d7"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#a22e5db2ec1d19c8252c056fd116975d7">Unlink</a> ()</td></tr>
<tr class="memdesc:a22e5db2ec1d19c8252c056fd116975d7"><td class="mdescLeft"> </td><td class="mdescRight">Unlinks this event handler from the chain it's part of (if any); then links the "previous" event handler to the "next" one (so that the chain won't be interrupted). <a href="#a22e5db2ec1d19c8252c056fd116975d7"></a><br/></td></tr>
<tr class="separator:a22e5db2ec1d19c8252c056fd116975d7"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a360fdeefcf53b62fb49fb828406bb8a6"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#a360fdeefcf53b62fb49fb828406bb8a6">IsUnlinked</a> () const </td></tr>
<tr class="memdesc:a360fdeefcf53b62fb49fb828406bb8a6"><td class="mdescLeft"> </td><td class="mdescRight">Returns <span class="literal">true</span> if the next and the previous handler pointers of this event handler instance are <span class="literal">NULL</span>. <a href="#a360fdeefcf53b62fb49fb828406bb8a6"></a><br/></td></tr>
<tr class="separator:a360fdeefcf53b62fb49fb828406bb8a6"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="inherit_header pub_methods_classwx_object"><td colspan="2" onclick="javascript:toggleInherit('pub_methods_classwx_object')"><img src="closed.png" alt="-"/> Public Member Functions inherited from <a class="el" href="classwx_object.html">wxObject</a></td></tr>
<tr class="memitem:acaa378363a28af421ab56ad7b46eadf0 inherit pub_methods_classwx_object"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_object.html#acaa378363a28af421ab56ad7b46eadf0">wxObject</a> ()</td></tr>
<tr class="memdesc:acaa378363a28af421ab56ad7b46eadf0 inherit pub_methods_classwx_object"><td class="mdescLeft"> </td><td class="mdescRight">Default ctor; initializes to <span class="literal">NULL</span> the internal reference data. <a href="#acaa378363a28af421ab56ad7b46eadf0"></a><br/></td></tr>
<tr class="separator:acaa378363a28af421ab56ad7b46eadf0 inherit pub_methods_classwx_object"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a4721b4dc9b7aff0f30904ba2ea3954cf inherit pub_methods_classwx_object"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_object.html#a4721b4dc9b7aff0f30904ba2ea3954cf">wxObject</a> (const <a class="el" href="classwx_object.html">wxObject</a> &other)</td></tr>
<tr class="memdesc:a4721b4dc9b7aff0f30904ba2ea3954cf inherit pub_methods_classwx_object"><td class="mdescLeft"> </td><td class="mdescRight">Copy ctor. <a href="#a4721b4dc9b7aff0f30904ba2ea3954cf"></a><br/></td></tr>
<tr class="separator:a4721b4dc9b7aff0f30904ba2ea3954cf inherit pub_methods_classwx_object"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a2a51aa8bfbab47ca2f051bcf84b3f35b inherit pub_methods_classwx_object"><td class="memItemLeft" align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_object.html#a2a51aa8bfbab47ca2f051bcf84b3f35b">~wxObject</a> ()</td></tr>
<tr class="memdesc:a2a51aa8bfbab47ca2f051bcf84b3f35b inherit pub_methods_classwx_object"><td class="mdescLeft"> </td><td class="mdescRight">Destructor. <a href="#a2a51aa8bfbab47ca2f051bcf84b3f35b"></a><br/></td></tr>
<tr class="separator:a2a51aa8bfbab47ca2f051bcf84b3f35b inherit pub_methods_classwx_object"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ab3a0c6f723cbaddb47be4e8dd98cc8e2 inherit pub_methods_classwx_object"><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="classwx_class_info.html">wxClassInfo</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_object.html#ab3a0c6f723cbaddb47be4e8dd98cc8e2">GetClassInfo</a> () const </td></tr>
<tr class="memdesc:ab3a0c6f723cbaddb47be4e8dd98cc8e2 inherit pub_methods_classwx_object"><td class="mdescLeft"> </td><td class="mdescRight">This virtual function is redefined for every class that requires run-time type information, when using the <a class="el" href="group__group__funcmacro__rtti.html#ga20465fc7e022e29a5dacfad46e152e75" title="Used inside a class declaration to declare that the class should be made known to the class hierarchy...">wxDECLARE_CLASS</a> macro (or similar). <a href="#ab3a0c6f723cbaddb47be4e8dd98cc8e2"></a><br/></td></tr>
<tr class="separator:ab3a0c6f723cbaddb47be4e8dd98cc8e2 inherit pub_methods_classwx_object"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:aabdb4fc957226544a8408167844e4f42 inherit pub_methods_classwx_object"><td class="memItemLeft" align="right" valign="top"><a class="el" href="classwx_object_ref_data.html">wxObjectRefData</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_object.html#aabdb4fc957226544a8408167844e4f42">GetRefData</a> () const </td></tr>
<tr class="memdesc:aabdb4fc957226544a8408167844e4f42 inherit pub_methods_classwx_object"><td class="mdescLeft"> </td><td class="mdescRight">Returns the <a class="el" href="classwx_object.html#a9e31954530a0abd54982effc443ed2b8" title="Pointer to an object which is the object's reference-counted data.">wxObject::m_refData</a> pointer, i.e. the data referenced by this object. <a href="#aabdb4fc957226544a8408167844e4f42"></a><br/></td></tr>
<tr class="separator:aabdb4fc957226544a8408167844e4f42 inherit pub_methods_classwx_object"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:af40d580385cf4f8112fae7713404b01e inherit pub_methods_classwx_object"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_object.html#af40d580385cf4f8112fae7713404b01e">IsKindOf</a> (const <a class="el" href="classwx_class_info.html">wxClassInfo</a> *info) const </td></tr>
<tr class="memdesc:af40d580385cf4f8112fae7713404b01e inherit pub_methods_classwx_object"><td class="mdescLeft"> </td><td class="mdescRight">Determines whether this class is a subclass of (or the same class as) the given class. <a href="#af40d580385cf4f8112fae7713404b01e"></a><br/></td></tr>
<tr class="separator:af40d580385cf4f8112fae7713404b01e inherit pub_methods_classwx_object"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a80a1a3fda7b14396a9ddd3d7a46a88bd inherit pub_methods_classwx_object"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_object.html#a80a1a3fda7b14396a9ddd3d7a46a88bd">IsSameAs</a> (const <a class="el" href="classwx_object.html">wxObject</a> &obj) const </td></tr>
<tr class="memdesc:a80a1a3fda7b14396a9ddd3d7a46a88bd inherit pub_methods_classwx_object"><td class="mdescLeft"> </td><td class="mdescRight">Returns <span class="literal">true</span> if this object has the same data pointer as <em>obj</em>. <a href="#a80a1a3fda7b14396a9ddd3d7a46a88bd"></a><br/></td></tr>
<tr class="separator:a80a1a3fda7b14396a9ddd3d7a46a88bd inherit pub_methods_classwx_object"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a2f6f1aa51fe9fc2b1415ca4211a90e9e inherit pub_methods_classwx_object"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_object.html#a2f6f1aa51fe9fc2b1415ca4211a90e9e">Ref</a> (const <a class="el" href="classwx_object.html">wxObject</a> &clone)</td></tr>
<tr class="memdesc:a2f6f1aa51fe9fc2b1415ca4211a90e9e inherit pub_methods_classwx_object"><td class="mdescLeft"> </td><td class="mdescRight">Makes this object refer to the data in <em>clone</em>. <a href="#a2f6f1aa51fe9fc2b1415ca4211a90e9e"></a><br/></td></tr>
<tr class="separator:a2f6f1aa51fe9fc2b1415ca4211a90e9e inherit pub_methods_classwx_object"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:afab780710f2adc1bb33310e27590140b inherit pub_methods_classwx_object"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_object.html#afab780710f2adc1bb33310e27590140b">SetRefData</a> (<a class="el" href="classwx_object_ref_data.html">wxObjectRefData</a> *data)</td></tr>
<tr class="memdesc:afab780710f2adc1bb33310e27590140b inherit pub_methods_classwx_object"><td class="mdescLeft"> </td><td class="mdescRight">Sets the <a class="el" href="classwx_object.html#a9e31954530a0abd54982effc443ed2b8" title="Pointer to an object which is the object's reference-counted data.">wxObject::m_refData</a> pointer. <a href="#afab780710f2adc1bb33310e27590140b"></a><br/></td></tr>
<tr class="separator:afab780710f2adc1bb33310e27590140b inherit pub_methods_classwx_object"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:af51efc6b1ae632fc7f0cd7ebbce9fa36 inherit pub_methods_classwx_object"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_object.html#af51efc6b1ae632fc7f0cd7ebbce9fa36">UnRef</a> ()</td></tr>
<tr class="memdesc:af51efc6b1ae632fc7f0cd7ebbce9fa36 inherit pub_methods_classwx_object"><td class="mdescLeft"> </td><td class="mdescRight">Decrements the reference count in the associated data, and if it is zero, deletes the data. <a href="#af51efc6b1ae632fc7f0cd7ebbce9fa36"></a><br/></td></tr>
<tr class="separator:af51efc6b1ae632fc7f0cd7ebbce9fa36 inherit pub_methods_classwx_object"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a74b40e42d19a4b9e9bec0b57d62a5725 inherit pub_methods_classwx_object"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_object.html#a74b40e42d19a4b9e9bec0b57d62a5725">UnShare</a> ()</td></tr>
<tr class="memdesc:a74b40e42d19a4b9e9bec0b57d62a5725 inherit pub_methods_classwx_object"><td class="mdescLeft"> </td><td class="mdescRight">This is the same of <a class="el" href="classwx_object.html#a60204063f3cc3aa2fa1c7ff5bda9eb13" title="Ensure that this object's data is not shared with any other object.">AllocExclusive()</a> but this method is public. <a href="#a74b40e42d19a4b9e9bec0b57d62a5725"></a><br/></td></tr>
<tr class="separator:a74b40e42d19a4b9e9bec0b57d62a5725 inherit pub_methods_classwx_object"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a07b8f34f5afc5743195c5fed052f55d3 inherit pub_methods_classwx_object"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_object.html#a07b8f34f5afc5743195c5fed052f55d3">operator delete</a> (void *buf)</td></tr>
<tr class="memdesc:a07b8f34f5afc5743195c5fed052f55d3 inherit pub_methods_classwx_object"><td class="mdescLeft"> </td><td class="mdescRight">The <em>delete</em> operator is defined for debugging versions of the library only, when the identifier <code><b>WXDEBUG</b></code> is defined. <a href="#a07b8f34f5afc5743195c5fed052f55d3"></a><br/></td></tr>
<tr class="separator:a07b8f34f5afc5743195c5fed052f55d3 inherit pub_methods_classwx_object"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a96fa423a1dbc212c8227a5d83825971f inherit pub_methods_classwx_object"><td class="memItemLeft" align="right" valign="top">void * </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_object.html#a96fa423a1dbc212c8227a5d83825971f">operator new</a> (size_t size, const <a class="el" href="classwx_string.html">wxString</a> &filename=NULL, int lineNum=0)</td></tr>
<tr class="memdesc:a96fa423a1dbc212c8227a5d83825971f inherit pub_methods_classwx_object"><td class="mdescLeft"> </td><td class="mdescRight">The <em>new</em> operator is defined for debugging versions of the library only, when the identifier <code><b>WXDEBUG</b></code> is defined. <a href="#a96fa423a1dbc212c8227a5d83825971f"></a><br/></td></tr>
<tr class="separator:a96fa423a1dbc212c8227a5d83825971f inherit pub_methods_classwx_object"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-static-methods"></a>
Static Public Member Functions</h2></td></tr>
<tr><td colspan="2"><div class="groupHeader">Global event filters.</div></td></tr>
<tr><td colspan="2"><div class="groupText"><p>Methods for working with the global list of event filters.</p>
<p>Event filters can be defined to pre-process all the events that happen in an application, see <a class="el" href="classwx_event_filter.html" title="A global event filter for pre-processing all the events generated in the program.">wxEventFilter</a> documentation for more information. </p>
</div></td></tr>
<tr class="memitem:a7dc3c701781f4044372049de5004137e"><td class="memItemLeft" align="right" valign="top">static void </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#a7dc3c701781f4044372049de5004137e">AddFilter</a> (<a class="el" href="classwx_event_filter.html">wxEventFilter</a> *filter)</td></tr>
<tr class="memdesc:a7dc3c701781f4044372049de5004137e"><td class="mdescLeft"> </td><td class="mdescRight">Add an event filter whose FilterEvent() method will be called for each and every event processed by wxWidgets. <a href="#a7dc3c701781f4044372049de5004137e"></a><br/></td></tr>
<tr class="separator:a7dc3c701781f4044372049de5004137e"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a67a57b759c447b121bf70a7c9804c8f2"><td class="memItemLeft" align="right" valign="top">static void </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#a67a57b759c447b121bf70a7c9804c8f2">RemoveFilter</a> (<a class="el" href="classwx_event_filter.html">wxEventFilter</a> *filter)</td></tr>
<tr class="memdesc:a67a57b759c447b121bf70a7c9804c8f2"><td class="mdescLeft"> </td><td class="mdescRight">Remove a filter previously installed with <a class="el" href="classwx_evt_handler.html#a7dc3c701781f4044372049de5004137e" title="Add an event filter whose FilterEvent() method will be called for each and every event processed by w...">AddFilter()</a>. <a href="#a67a57b759c447b121bf70a7c9804c8f2"></a><br/></td></tr>
<tr class="separator:a67a57b759c447b121bf70a7c9804c8f2"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pro-methods"></a>
Protected Member Functions</h2></td></tr>
<tr class="memitem:ad4b0eac704dd005ac6a88fdb1e673c13"><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#ad4b0eac704dd005ac6a88fdb1e673c13">TryBefore</a> (<a class="el" href="classwx_event.html">wxEvent</a> &event)</td></tr>
<tr class="memdesc:ad4b0eac704dd005ac6a88fdb1e673c13"><td class="mdescLeft"> </td><td class="mdescRight">Method called by <a class="el" href="classwx_evt_handler.html#a65968dd27f3aac7718f2dd6b2ddd5a08" title="Processes an event, searching event tables and calling zero or more suitable event handler function(s...">ProcessEvent()</a> before examining this object event tables. <a href="#ad4b0eac704dd005ac6a88fdb1e673c13"></a><br/></td></tr>
<tr class="separator:ad4b0eac704dd005ac6a88fdb1e673c13"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a5e25fece1cb6cbc11fd1d41ec140319c"><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_evt_handler.html#a5e25fece1cb6cbc11fd1d41ec140319c">TryAfter</a> (<a class="el" href="classwx_event.html">wxEvent</a> &event)</td></tr>
<tr class="memdesc:a5e25fece1cb6cbc11fd1d41ec140319c"><td class="mdescLeft"> </td><td class="mdescRight">Method called by <a class="el" href="classwx_evt_handler.html#a65968dd27f3aac7718f2dd6b2ddd5a08" title="Processes an event, searching event tables and calling zero or more suitable event handler function(s...">ProcessEvent()</a> as last resort. <a href="#a5e25fece1cb6cbc11fd1d41ec140319c"></a><br/></td></tr>
<tr class="separator:a5e25fece1cb6cbc11fd1d41ec140319c"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="inherit_header pro_methods_classwx_object"><td colspan="2" onclick="javascript:toggleInherit('pro_methods_classwx_object')"><img src="closed.png" alt="-"/> Protected Member Functions inherited from <a class="el" href="classwx_object.html">wxObject</a></td></tr>
<tr class="memitem:a60204063f3cc3aa2fa1c7ff5bda9eb13 inherit pro_methods_classwx_object"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_object.html#a60204063f3cc3aa2fa1c7ff5bda9eb13">AllocExclusive</a> ()</td></tr>
<tr class="memdesc:a60204063f3cc3aa2fa1c7ff5bda9eb13 inherit pro_methods_classwx_object"><td class="mdescLeft"> </td><td class="mdescRight">Ensure that this object's data is not shared with any other object. <a href="#a60204063f3cc3aa2fa1c7ff5bda9eb13"></a><br/></td></tr>
<tr class="separator:a60204063f3cc3aa2fa1c7ff5bda9eb13 inherit pro_methods_classwx_object"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a95c6a5e4e1e03ff23c7b9efe4cff0c1a inherit pro_methods_classwx_object"><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="classwx_object_ref_data.html">wxObjectRefData</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_object.html#a95c6a5e4e1e03ff23c7b9efe4cff0c1a">CreateRefData</a> () const </td></tr>
<tr class="memdesc:a95c6a5e4e1e03ff23c7b9efe4cff0c1a inherit pro_methods_classwx_object"><td class="mdescLeft"> </td><td class="mdescRight">Creates a new instance of the wxObjectRefData-derived class specific to this object and returns it. <a href="#a95c6a5e4e1e03ff23c7b9efe4cff0c1a"></a><br/></td></tr>
<tr class="separator:a95c6a5e4e1e03ff23c7b9efe4cff0c1a inherit pro_methods_classwx_object"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a1d39f1d3650fe0982c9a1abe7f9fe7b7 inherit pro_methods_classwx_object"><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="classwx_object_ref_data.html">wxObjectRefData</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_object.html#a1d39f1d3650fe0982c9a1abe7f9fe7b7">CloneRefData</a> (const <a class="el" href="classwx_object_ref_data.html">wxObjectRefData</a> *data) const </td></tr>
<tr class="memdesc:a1d39f1d3650fe0982c9a1abe7f9fe7b7 inherit pro_methods_classwx_object"><td class="mdescLeft"> </td><td class="mdescRight">Creates a new instance of the wxObjectRefData-derived class specific to this object and initializes it copying <em>data</em>. <a href="#a1d39f1d3650fe0982c9a1abe7f9fe7b7"></a><br/></td></tr>
<tr class="separator:a1d39f1d3650fe0982c9a1abe7f9fe7b7 inherit pro_methods_classwx_object"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="inherited"></a>
Additional Inherited Members</h2></td></tr>
<tr class="inherit_header pro_attribs_classwx_object"><td colspan="2" onclick="javascript:toggleInherit('pro_attribs_classwx_object')"><img src="closed.png" alt="-"/> Protected Attributes inherited from <a class="el" href="classwx_object.html">wxObject</a></td></tr>
<tr class="memitem:a9e31954530a0abd54982effc443ed2b8 inherit pro_attribs_classwx_object"><td class="memItemLeft" align="right" valign="top"><a class="el" href="classwx_object_ref_data.html">wxObjectRefData</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classwx_object.html#a9e31954530a0abd54982effc443ed2b8">m_refData</a></td></tr>
<tr class="memdesc:a9e31954530a0abd54982effc443ed2b8 inherit pro_attribs_classwx_object"><td class="mdescLeft"> </td><td class="mdescRight">Pointer to an object which is the object's reference-counted data. <a href="#a9e31954530a0abd54982effc443ed2b8"></a><br/></td></tr>
<tr class="separator:a9e31954530a0abd54982effc443ed2b8 inherit pro_attribs_classwx_object"><td class="memSeparator" colspan="2"> </td></tr>
</table>
<h2 class="groupheader">Constructor & Destructor Documentation</h2>
<a class="anchor" id="a3f0166c4154227d05575b01eb2c8d4be"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">wxEvtHandler::wxEvtHandler </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Constructor. </p>
</div>
</div>
<a class="anchor" id="a372d2239d91521eddc8fd2715fcab584"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">virtual wxEvtHandler::~wxEvtHandler </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">virtual</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Destructor. </p>
<p>If the handler is part of a chain, the destructor will unlink itself (see <a class="el" href="classwx_evt_handler.html#a22e5db2ec1d19c8252c056fd116975d7" title="Unlinks this event handler from the chain it's part of (if any); then links the "previous" event ha...">Unlink()</a>). </p>
</div>
</div>
<h2 class="groupheader">Member Function Documentation</h2>
<a class="anchor" id="a7dc3c701781f4044372049de5004137e"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">static void wxEvtHandler::AddFilter </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classwx_event_filter.html">wxEventFilter</a> * </td>
<td class="paramname"><em>filter</em></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">static</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Add an event filter whose FilterEvent() method will be called for each and every event processed by wxWidgets. </p>
<p>The filters are called in LIFO order and <a class="el" href="classwx_app.html" title="The wxApp class represents the application itself when wxUSE_GUI=1.">wxApp</a> is registered as an event filter by default. The pointer must remain valid until it's removed with <a class="el" href="classwx_evt_handler.html#a67a57b759c447b121bf70a7c9804c8f2" title="Remove a filter previously installed with AddFilter().">RemoveFilter()</a> and is not deleted by <a class="el" href="classwx_evt_handler.html" title="A class that can handle events from the windowing system.">wxEvtHandler</a>.</p>
<dl class="section since"><dt>Since</dt><dd>2.9.3 </dd></dl>
</div>
</div>
<a class="anchor" id="a0737c6d2cbcd5ded4b1ecdd53ed0def3"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">virtual void wxEvtHandler::AddPendingEvent </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classwx_event.html">wxEvent</a> & </td>
<td class="paramname"><em>event</em></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">virtual</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Post an event to be processed later. </p>
<p>This function is similar to <a class="el" href="classwx_evt_handler.html#acffd03bf407a856166ea71ef0318b59a" title="Queue event for a later processing.">QueueEvent()</a> but can't be used to post events from worker threads for the event objects with <a class="el" href="classwx_string.html" title="String class for passing textual data to or receiving it from wxWidgets.">wxString</a> fields (i.e. in practice most of them) because of an unsafe use of the same <a class="el" href="classwx_string.html" title="String class for passing textual data to or receiving it from wxWidgets.">wxString</a> object which happens because the <a class="el" href="classwx_string.html" title="String class for passing textual data to or receiving it from wxWidgets.">wxString</a> field in the original <em>event</em> object and its copy made internally by this function share the same string buffer internally. Use <a class="el" href="classwx_evt_handler.html#acffd03bf407a856166ea71ef0318b59a" title="Queue event for a later processing.">QueueEvent()</a> to avoid this.</p>
<p>A copy of <em>event</em> is made by the function, so the original can be deleted as soon as function returns (it is common that the original is created on the stack). This requires that the <a class="el" href="classwx_event.html#a26878097a702e8d0368da150125d4158" title="Returns a copy of the event.">wxEvent::Clone()</a> method be implemented by event so that it can be duplicated and stored until it gets processed.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">event</td><td>Event to add to the pending events queue. </td></tr>
</table>
</dd>
</dl>
<p>Reimplemented in <a class="el" href="classwx_window.html#a774b5b5548a6258727b5e2099e63ae9a">wxWindow</a>.</p>
</div>
</div>
<a class="anchor" id="a0f30c8fa5583b4a5f661897d63de3b62"></a>
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename EventTag , typename Functor > </div>
<table class="memname">
<tr>
<td class="memname">void wxEvtHandler::Bind </td>
<td>(</td>
<td class="paramtype">const EventTag & </td>
<td class="paramname"><em>eventType</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">Functor </td>
<td class="paramname"><em>functor</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>id</em> = <code><a class="el" href="defs_8h.html#ac66d0a09761e7d86b2ac0b2e0c6a8cbba1f375b01ea03a713bbb7e32a36a2589c">wxID_ANY</a></code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>lastId</em> = <code><a class="el" href="defs_8h.html#ac66d0a09761e7d86b2ac0b2e0c6a8cbba1f375b01ea03a713bbb7e32a36a2589c">wxID_ANY</a></code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classwx_object.html">wxObject</a> * </td>
<td class="paramname"><em>userData</em> = <code>NULL</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Binds the given function, functor or method dynamically with the event. </p>
<p>This offers basically the same functionality as <a class="el" href="classwx_evt_handler.html#a78719e8b82c9f9c6e4056b3449df1943" title="Connects the given function dynamically with the event handler, id and event type.">Connect()</a>, but it is more flexible as it also allows you to use ordinary functions and arbitrary functors as event handlers. It is also less restrictive then <a class="el" href="classwx_evt_handler.html#a78719e8b82c9f9c6e4056b3449df1943" title="Connects the given function dynamically with the event handler, id and event type.">Connect()</a> because you can use an arbitrary method as an event handler, whereas <a class="el" href="classwx_evt_handler.html#a78719e8b82c9f9c6e4056b3449df1943" title="Connects the given function dynamically with the event handler, id and event type.">Connect()</a> requires a <a class="el" href="classwx_evt_handler.html" title="A class that can handle events from the windowing system.">wxEvtHandler</a> derived handler.</p>
<p>See <a class="el" href="overview_events.html#overview_events_bind">Dynamic Event Handling</a> for more detailed explanation of this function and the <a class="el" href="page_samples.html#page_samples_event">Event Sample</a> sample for usage examples.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">eventType</td><td>The event type to be associated with this event handler. </td></tr>
<tr><td class="paramname">functor</td><td>The event handler functor. This can be an ordinary function but also an arbitrary functor like boost::function<>. </td></tr>
<tr><td class="paramname">id</td><td>The first ID of the identifier range to be associated with the event handler. </td></tr>
<tr><td class="paramname">lastId</td><td>The last ID of the identifier range to be associated with the event handler. </td></tr>
<tr><td class="paramname">userData</td><td>Optional data to be associated with the event table entry. wxWidgets will take ownership of this pointer, i.e. it will be destroyed when the event handler is disconnected or at the program termination. This pointer can be retrieved using <a class="el" href="classwx_event.html#ae634c2eeaa94224a473de9dceb269eae" title="Return the user data associated with a dynamically connected event handler.">wxEvent::GetEventUserData()</a> later.</td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="overview_cpp_rtti_disabled.html">Caveats When Not Using C++ RTTI</a></dd></dl>
<dl class="section since"><dt>Since</dt><dd>2.9.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a03cc68ca201fb79c7e837919025be71a"></a>
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename EventTag , typename Class , typename EventArg , typename EventHandler > </div>
<table class="memname">
<tr>
<td class="memname">void wxEvtHandler::Bind </td>
<td>(</td>
<td class="paramtype">const EventTag & </td>
<td class="paramname"><em>eventType</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void(Class::*)(EventArg &) </td>
<td class="paramname"><em>method</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">EventHandler * </td>
<td class="paramname"><em>handler</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>id</em> = <code><a class="el" href="defs_8h.html#ac66d0a09761e7d86b2ac0b2e0c6a8cbba1f375b01ea03a713bbb7e32a36a2589c">wxID_ANY</a></code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>lastId</em> = <code><a class="el" href="defs_8h.html#ac66d0a09761e7d86b2ac0b2e0c6a8cbba1f375b01ea03a713bbb7e32a36a2589c">wxID_ANY</a></code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classwx_object.html">wxObject</a> * </td>
<td class="paramname"><em>userData</em> = <code>NULL</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>See the <a class="el" href="classwx_evt_handler.html#a0f30c8fa5583b4a5f661897d63de3b62" title="Binds the given function, functor or method dynamically with the event.">Bind<>(const EventTag&, Functor, int, int, wxObject*)</a> overload for more info. </p>
<p>This overload will bind the given method as the event handler.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">eventType</td><td>The event type to be associated with this event handler. </td></tr>
<tr><td class="paramname">method</td><td>The event handler method. This can be an arbitrary method (doesn't need to be from a <a class="el" href="classwx_evt_handler.html" title="A class that can handle events from the windowing system.">wxEvtHandler</a> derived class). </td></tr>
<tr><td class="paramname">handler</td><td>Object whose method should be called. It must always be specified so it can be checked at compile time whether the given method is an actual member of the given handler. </td></tr>
<tr><td class="paramname">id</td><td>The first ID of the identifier range to be associated with the event handler. </td></tr>
<tr><td class="paramname">lastId</td><td>The last ID of the identifier range to be associated with the event handler. </td></tr>
<tr><td class="paramname">userData</td><td>Optional data to be associated with the event table entry. wxWidgets will take ownership of this pointer, i.e. it will be destroyed when the event handler is disconnected or at the program termination. This pointer can be retrieved using <a class="el" href="classwx_event.html#ae634c2eeaa94224a473de9dceb269eae" title="Return the user data associated with a dynamically connected event handler.">wxEvent::GetEventUserData()</a> later.</td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="overview_cpp_rtti_disabled.html">Caveats When Not Using C++ RTTI</a></dd></dl>
<dl class="section since"><dt>Since</dt><dd>2.9.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a63c7351618fd77330d80a250b3719519"></a>
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename T , typename T1 , ... > </div>
<table class="memname">
<tr>
<td class="memname">void wxEvtHandler::CallAfter </td>
<td>(</td>
<td class="paramtype">void(T::*)(T1,...) </td>
<td class="paramname"><em>method</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">T1 </td>
<td class="paramname"><em>x1</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname"><em>...</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Asynchronously call the given method. </p>
<p>Calling this function on an object schedules an asynchronous call to the method specified as <a class="el" href="classwx_evt_handler.html#a63c7351618fd77330d80a250b3719519" title="Asynchronously call the given method.">CallAfter()</a> argument at a (slightly) later time. This is useful when processing some events as certain actions typically can't be performed inside their handlers, e.g. you shouldn't show a modal dialog from a mouse click event handler as this would break the mouse capture state – but you can call a method showing this message dialog after the current event handler completes.</p>
<p>The method being called must be the method of the object on which <a class="el" href="classwx_evt_handler.html#a63c7351618fd77330d80a250b3719519" title="Asynchronously call the given method.">CallAfter()</a> itself is called.</p>
<p>Notice that it is safe to use <a class="el" href="classwx_evt_handler.html#a63c7351618fd77330d80a250b3719519" title="Asynchronously call the given method.">CallAfter()</a> from other, non-GUI, threads, but that the method will be always called in the main, GUI, thread context.</p>
<p>Example of use: </p>
<div class="fragment"><div class="line"><span class="keyword">class </span>MyFrame : <span class="keyword">public</span> <a class="code" href="classwx_frame.html" title="A frame is a window whose size and position can (usually) be changed by the user.">wxFrame</a> {</div>
<div class="line"> <span class="keywordtype">void</span> OnClick(<a class="code" href="classwx_mouse_event.html" title="This event class contains information about the events generated by the mouse: they include mouse but...">wxMouseEvent</a>& event) {</div>
<div class="line"> <a class="code" href="classwx_evt_handler.html#a63c7351618fd77330d80a250b3719519" title="Asynchronously call the given method.">CallAfter</a>(&MyFrame::ShowPosition, event.<a class="code" href="classwx_mouse_state.html#aa3eff164b6e5407a6185e051ab26ac52" title="Returns the physical mouse position.">GetPosition</a>());</div>
<div class="line"> }</div>
<div class="line"></div>
<div class="line"> <span class="keywordtype">void</span> ShowPosition(<span class="keyword">const</span> <a class="code" href="classwx_point.html" title="A wxPoint is a useful data structure for graphics operations.">wxPoint</a>& pos) {</div>
<div class="line"> <span class="keywordflow">if</span> ( <a class="code" href="group__group__funcmacro__dialog.html#ga193c64ed4802e379799cdb42de252647" title="Show a general purpose message dialog.">wxMessageBox</a>(</div>
<div class="line"> <a class="code" href="classwx_string.html#addd9ccfa3ae2b7ab2d66bcbf034d0be0" title="This static function returns the string containing the result of calling Printf() with the passed par...">wxString::Format</a>(<span class="stringliteral">"Perform click at (%d, %d)?"</span>,</div>
<div class="line"> pos.<a class="code" href="classwx_point.html#a96cd57c992846b3338837db97836ba5c" title="x member.">x</a>, pos.<a class="code" href="classwx_point.html#a569141753bb48c51a857b7839de54b11" title="y member.">y</a>), <span class="stringliteral">""</span>, <a class="code" href="defs_8h.html#a5ba00a09cea0417a2ef7c4a4c2b0012c">wxYES_NO</a>) == <a class="code" href="defs_8h.html#ab38ccd9aa8aa47f9df32a75c96bb3000">wxYES</a> )</div>
<div class="line"> {</div>
<div class="line"> ... <span class="keywordflow">do</span> take <span class="keyword">this</span> click into account ...</div>
<div class="line"> }</div>
<div class="line"> }</div>
<div class="line">};</div>
</div><!-- fragment --><dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">method</td><td>The method to call. </td></tr>
<tr><td class="paramname">x1</td><td>The (optional) first parameter to pass to the method. Currently, 0, 1 or 2 parameters can be passed. If you need to pass more than 2 arguments, you can use the <a class="el" href="classwx_evt_handler.html#a910416e4d0b1f38cec02213b8a0c6a12" title="Asynchronously call the given functor.">CallAfter<T>(const T& fn)</a> overload that can call any functor.</td></tr>
</table>
</dd>
</dl>
<dl class="section note"><dt>Note</dt><dd>This method is not available with Visual C++ before version 8 (Visual Studio 2005) as earlier versions of the compiler don't have the required support for C++ templates to implement it.</dd></dl>
<dl class="section since"><dt>Since</dt><dd>2.9.5 </dd></dl>
</div>
</div>
<a class="anchor" id="a910416e4d0b1f38cec02213b8a0c6a12"></a>
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename T > </div>
<table class="memname">
<tr>
<td class="memname">void wxEvtHandler::CallAfter </td>
<td>(</td>
<td class="paramtype">const T & </td>
<td class="paramname"><em>functor</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Asynchronously call the given functor. </p>
<p>Calling this function on an object schedules an asynchronous call to the functor specified as <a class="el" href="classwx_evt_handler.html#a63c7351618fd77330d80a250b3719519" title="Asynchronously call the given method.">CallAfter()</a> argument at a (slightly) later time. This is useful when processing some events as certain actions typically can't be performed inside their handlers, e.g. you shouldn't show a modal dialog from a mouse click event handler as this would break the mouse capture state – but you can call a function showing this message dialog after the current event handler completes.</p>
<p>Notice that it is safe to use <a class="el" href="classwx_evt_handler.html#a63c7351618fd77330d80a250b3719519" title="Asynchronously call the given method.">CallAfter()</a> from other, non-GUI, threads, but that the method will be always called in the main, GUI, thread context.</p>
<p>This overload is particularly useful in combination with C++11 lambdas: </p>
<div class="fragment"><div class="line"><a class="code" href="group__group__funcmacro__appinitterm.html#gac387a69e740a149f9888e4992a3a4c6c" title="This function doesn't exist in wxWidgets but it is created by using the wxIMPLEMENT_APP() macro...">wxGetApp</a>().CallAfter([]{</div>
<div class="line"> <a class="code" href="group__group__funcmacro__dialog.html#ga3267f33060d2ae403862427acb758bab" title="Ring the system bell.">wxBell</a>();</div>
<div class="line">});</div>
</div><!-- fragment --><dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">functor</td><td>The functor to call.</td></tr>
</table>
</dd>
</dl>
<dl class="section note"><dt>Note</dt><dd>This method is not available with Visual C++ before version 8 (Visual Studio 2005) as earlier versions of the compiler don't have the required support for C++ templates to implement it.</dd></dl>
<dl class="section since"><dt>Since</dt><dd>3.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a78719e8b82c9f9c6e4056b3449df1943"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void wxEvtHandler::Connect </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>id</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>lastId</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__group__funcmacro__events.html#ga6a7fd172612c0d6d9029bfa3aa91aca0">wxEventType</a> </td>
<td class="paramname"><em>eventType</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">wxObjectEventFunction </td>
<td class="paramname"><em>function</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classwx_object.html">wxObject</a> * </td>
<td class="paramname"><em>userData</em> = <code>NULL</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classwx_evt_handler.html">wxEvtHandler</a> * </td>
<td class="paramname"><em>eventSink</em> = <code>NULL</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Connects the given function dynamically with the event handler, id and event type. </p>
<p>Notice that <a class="el" href="classwx_evt_handler.html#a0f30c8fa5583b4a5f661897d63de3b62" title="Binds the given function, functor or method dynamically with the event.">Bind()</a> provides a more flexible and safer way to do the same thing as <a class="el" href="classwx_evt_handler.html#a78719e8b82c9f9c6e4056b3449df1943" title="Connects the given function dynamically with the event handler, id and event type.">Connect()</a>, please use it in any new code – while <a class="el" href="classwx_evt_handler.html#a78719e8b82c9f9c6e4056b3449df1943" title="Connects the given function dynamically with the event handler, id and event type.">Connect()</a> is not formally deprecated due to its existing widespread usage, it has no advantages compared to <a class="el" href="classwx_evt_handler.html#a0f30c8fa5583b4a5f661897d63de3b62" title="Binds the given function, functor or method dynamically with the event.">Bind()</a>.</p>
<p>This is an alternative to the use of static event tables. It is more flexible as it allows to connect events generated by some object to an event handler defined in a different object of a different class (which is impossible to do directly with the event tables – the events can be only handled in another object if they are propagated upwards to it). Do make sure to specify the correct <em>eventSink</em> when connecting to an event of a different object.</p>
<p>See <a class="el" href="overview_events.html#overview_events_bind">Dynamic Event Handling</a> for more detailed explanation of this function and the <a class="el" href="page_samples.html#page_samples_event">Event Sample</a> sample for usage examples.</p>
<p>This specific overload allows you to connect an event handler to a <em>range</em> of <em>source</em> IDs. Do not confuse <em>source</em> IDs with event <em>types:</em> source IDs identify the event generator objects (typically <a class="el" href="classwx_menu_item.html" title="A menu item represents an item in a menu.">wxMenuItem</a> or <a class="el" href="classwx_window.html" title="wxWindow is the base class for all windows and represents any visible object on screen.">wxWindow</a> objects) while the event <em>type</em> identify which type of events should be handled by the given <em>function</em> (an event generator object may generate many different types of events!).</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">id</td><td>The first ID of the identifier range to be associated with the event handler function. </td></tr>
<tr><td class="paramname">lastId</td><td>The last ID of the identifier range to be associated with the event handler function. </td></tr>
<tr><td class="paramname">eventType</td><td>The event type to be associated with this event handler. </td></tr>
<tr><td class="paramname">function</td><td>The event handler function. Note that this function should be explicitly converted to the correct type which can be done using a macro called <code>wxFooEventHandler</code> for the handler for any <code>wxFooEvent</code>. </td></tr>
<tr><td class="paramname">userData</td><td>Optional data to be associated with the event table entry. wxWidgets will take ownership of this pointer, i.e. it will be destroyed when the event handler is disconnected or at the program termination. This pointer can be retrieved using <a class="el" href="classwx_event.html#ae634c2eeaa94224a473de9dceb269eae" title="Return the user data associated with a dynamically connected event handler.">wxEvent::GetEventUserData()</a> later. </td></tr>
<tr><td class="paramname">eventSink</td><td>Object whose member function should be called. It must be specified when connecting an event generated by one object to a member function of a different object. If it is omitted, <code>this</code> is used.</td></tr>
</table>
</dd>
</dl>
<p><b>wxPerl Note:</b> In wxPerl this function takes 4 arguments: <em>id</em>, <em>lastid</em>, <em>type</em>, <em>method</em>; if <em>method</em> is undef, the handler is disconnected.}</p>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="classwx_evt_handler.html#a0f30c8fa5583b4a5f661897d63de3b62" title="Binds the given function, functor or method dynamically with the event.">Bind<>()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a1e8b5fc4c7e7f6d32d40bc00d4108ba4"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void wxEvtHandler::Connect </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>id</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__group__funcmacro__events.html#ga6a7fd172612c0d6d9029bfa3aa91aca0">wxEventType</a> </td>
<td class="paramname"><em>eventType</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">wxObjectEventFunction </td>
<td class="paramname"><em>function</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classwx_object.html">wxObject</a> * </td>
<td class="paramname"><em>userData</em> = <code>NULL</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classwx_evt_handler.html">wxEvtHandler</a> * </td>
<td class="paramname"><em>eventSink</em> = <code>NULL</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>See the <a class="el" href="classwx_evt_handler.html#a78719e8b82c9f9c6e4056b3449df1943" title="Connects the given function dynamically with the event handler, id and event type.">Connect(int, int, wxEventType, wxObjectEventFunction, wxObject*, wxEvtHandler*)</a> overload for more info. </p>
<p>This overload can be used to attach an event handler to a single source ID:</p>
<p>Example: </p>
<div class="fragment"><div class="line">frame->Connect( <a class="code" href="defs_8h.html#ac66d0a09761e7d86b2ac0b2e0c6a8cbba37f548d1211c664ede962e943baad4e5">wxID_EXIT</a>,</div>
<div class="line"> <a class="code" href="group__group__funcmacro__events.html#gae74e7c2eb422fb70fba050f2204ad734">wxEVT_MENU</a>,</div>
<div class="line"> wxCommandEventHandler(MyFrame::OnQuit) );</div>
</div><!-- fragment --><p><b>wxPerl Note:</b> Not supported by wxPerl. </p>
</div>
</div>
<a class="anchor" id="aa290d9b67348e74c1da8497955a4e35c"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void wxEvtHandler::Connect </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__group__funcmacro__events.html#ga6a7fd172612c0d6d9029bfa3aa91aca0">wxEventType</a> </td>
<td class="paramname"><em>eventType</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">wxObjectEventFunction </td>
<td class="paramname"><em>function</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classwx_object.html">wxObject</a> * </td>
<td class="paramname"><em>userData</em> = <code>NULL</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classwx_evt_handler.html">wxEvtHandler</a> * </td>
<td class="paramname"><em>eventSink</em> = <code>NULL</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>See the <a class="el" href="classwx_evt_handler.html#a78719e8b82c9f9c6e4056b3449df1943" title="Connects the given function dynamically with the event handler, id and event type.">Connect(int, int, wxEventType, wxObjectEventFunction, wxObject*, wxEvtHandler*)</a> overload for more info. </p>
<p>This overload will connect the given event handler so that regardless of the ID of the event source, the handler will be called.</p>
<p><b>wxPerl Note:</b> Not supported by wxPerl. </p>
</div>
</div>
<a class="anchor" id="a6e7f9cf4ebd0623c1d94979855d096f8"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void wxEvtHandler::DeletePendingEvents </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Deletes all events queued on this event handler using <a class="el" href="classwx_evt_handler.html#acffd03bf407a856166ea71ef0318b59a" title="Queue event for a later processing.">QueueEvent()</a> or <a class="el" href="classwx_evt_handler.html#a0737c6d2cbcd5ded4b1ecdd53ed0def3" title="Post an event to be processed later.">AddPendingEvent()</a>. </p>
<p>Use with care because the events which are deleted are (obviously) not processed and this may have unwanted consequences (e.g. user actions events will be lost). </p>
</div>
</div>
<a class="anchor" id="a13061cf0ed01ac10a804ac057ef4bdbc"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool wxEvtHandler::Disconnect </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__group__funcmacro__events.html#ga6a7fd172612c0d6d9029bfa3aa91aca0">wxEventType</a> </td>
<td class="paramname"><em>eventType</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">wxObjectEventFunction </td>
<td class="paramname"><em>function</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classwx_object.html">wxObject</a> * </td>
<td class="paramname"><em>userData</em> = <code>NULL</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classwx_evt_handler.html">wxEvtHandler</a> * </td>
<td class="paramname"><em>eventSink</em> = <code>NULL</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Disconnects the given function dynamically from the event handler, using the specified parameters as search criteria and returning <span class="literal">true</span> if a matching function has been found and removed. </p>
<p>This method can only disconnect functions which have been added using the <a class="el" href="classwx_evt_handler.html#a78719e8b82c9f9c6e4056b3449df1943" title="Connects the given function dynamically with the event handler, id and event type.">Connect()</a> method. There is no way to disconnect functions connected using the (static) event tables.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">eventType</td><td>The event type associated with this event handler. </td></tr>
<tr><td class="paramname">function</td><td>The event handler function. </td></tr>
<tr><td class="paramname">userData</td><td>Data associated with the event table entry. </td></tr>
<tr><td class="paramname">eventSink</td><td>Object whose member function should be called.</td></tr>
</table>
</dd>
</dl>
<p><b>wxPerl Note:</b> Not supported by wxPerl. </p>
</div>
</div>
<a class="anchor" id="a2f171e19444b9c4034c5e11f24fa9c91"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool wxEvtHandler::Disconnect </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>id</em> = <code><a class="el" href="defs_8h.html#ac66d0a09761e7d86b2ac0b2e0c6a8cbba1f375b01ea03a713bbb7e32a36a2589c">wxID_ANY</a></code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__group__funcmacro__events.html#ga6a7fd172612c0d6d9029bfa3aa91aca0">wxEventType</a> </td>
<td class="paramname"><em>eventType</em> = <code><a class="el" href="group__group__funcmacro__events.html#ga310bc3f7977ae79ac1198c7a287dbffe">wxEVT_NULL</a></code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">wxObjectEventFunction </td>
<td class="paramname"><em>function</em> = <code>NULL</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classwx_object.html">wxObject</a> * </td>
<td class="paramname"><em>userData</em> = <code>NULL</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classwx_evt_handler.html">wxEvtHandler</a> * </td>
<td class="paramname"><em>eventSink</em> = <code>NULL</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>See the <a class="el" href="classwx_evt_handler.html#a13061cf0ed01ac10a804ac057ef4bdbc" title="Disconnects the given function dynamically from the event handler, using the specified parameters as ...">Disconnect(wxEventType, wxObjectEventFunction, wxObject*, wxEvtHandler*)</a> overload for more info. </p>
<p>This overload takes the additional <em>id</em> parameter.</p>
<p><b>wxPerl Note:</b> Not supported by wxPerl. </p>
</div>
</div>
<a class="anchor" id="a16a6f823853e4b74b43dd9a2cf3abee6"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool wxEvtHandler::Disconnect </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>id</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>lastId</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__group__funcmacro__events.html#ga6a7fd172612c0d6d9029bfa3aa91aca0">wxEventType</a> </td>
<td class="paramname"><em>eventType</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">wxObjectEventFunction </td>
<td class="paramname"><em>function</em> = <code>NULL</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classwx_object.html">wxObject</a> * </td>
<td class="paramname"><em>userData</em> = <code>NULL</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classwx_evt_handler.html">wxEvtHandler</a> * </td>
<td class="paramname"><em>eventSink</em> = <code>NULL</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>See the <a class="el" href="classwx_evt_handler.html#a13061cf0ed01ac10a804ac057ef4bdbc" title="Disconnects the given function dynamically from the event handler, using the specified parameters as ...">Disconnect(wxEventType, wxObjectEventFunction, wxObject*, wxEvtHandler*)</a> overload for more info. </p>
<p>This overload takes an additional range of source IDs.</p>
<p><b>wxPerl Note:</b> In wxPerl this function takes 3 arguments: <em>id</em>, <em>lastid</em>, <em>type</em>. </p>
</div>
</div>
<a class="anchor" id="ad6e543115a9405962152630138645588"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void* wxEvtHandler::GetClientData </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div><div class="memdoc">
<p>Returns user-supplied client data. </p>
<dl class="section remark"><dt>Remarks</dt><dd>Normally, any extra data the programmer wishes to associate with the object should be made available by deriving a new class with new data members.</dd></dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="classwx_evt_handler.html#a82c74f2cebfa02cb3c1563d459c872bf" title="Sets user-supplied client data.">SetClientData()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a2b3949eaba1f25cb48618163a7c0583b"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classwx_client_data.html">wxClientData</a>* wxEvtHandler::GetClientObject </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div><div class="memdoc">
<p>Returns a pointer to the user-supplied client data object. </p>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="classwx_evt_handler.html#af1e33a06087b8b2ddc43c7d15a91b326" title="Set the client data object.">SetClientObject()</a>, <a class="el" href="classwx_client_data.html" title="All classes deriving from wxEvtHandler (such as all controls and wxApp) can hold arbitrary data which...">wxClientData</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a533e62afcb125abf1fcc8bb53fbc2e81"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool wxEvtHandler::GetEvtHandlerEnabled </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div><div class="memdoc">
<p>Returns <span class="literal">true</span> if the event handler is enabled, <span class="literal">false</span> otherwise. </p>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="classwx_evt_handler.html#a7388ae19c8657e5656471b658c320036" title="Enables or disables the event handler.">SetEvtHandlerEnabled()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a4b2f853f5c7a64432ae72f9b606698f9"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classwx_evt_handler.html">wxEvtHandler</a>* wxEvtHandler::GetNextHandler </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div><div class="memdoc">
<p>Returns the pointer to the next handler in the chain. </p>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="classwx_evt_handler.html#a68e2ef2d2b7d68c4c9c18ca92933031b" title="Sets the pointer to the next handler.">SetNextHandler()</a>, <a class="el" href="classwx_evt_handler.html#aad1ba7fa9ccbf12ee2d80f5f12350adb" title="Returns the pointer to the previous handler in the chain.">GetPreviousHandler()</a>, <a class="el" href="classwx_evt_handler.html#aff0d1836464be82e2ad723ad3a58eccc" title="Sets the pointer to the previous handler.">SetPreviousHandler()</a>, <a class="el" href="classwx_window.html#a398c11ab9af7956067a964f560d1978c" title="Pushes this event handler onto the event stack for the window.">wxWindow::PushEventHandler</a>, <a class="el" href="classwx_window.html#ac45c1f4cf96c70779764c14cf528790b" title="Removes and returns the top-most event handler on the event handler stack.">wxWindow::PopEventHandler</a> </dd></dl>
</div>
</div>
<a class="anchor" id="aad1ba7fa9ccbf12ee2d80f5f12350adb"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classwx_evt_handler.html">wxEvtHandler</a>* wxEvtHandler::GetPreviousHandler </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div><div class="memdoc">
<p>Returns the pointer to the previous handler in the chain. </p>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="classwx_evt_handler.html#aff0d1836464be82e2ad723ad3a58eccc" title="Sets the pointer to the previous handler.">SetPreviousHandler()</a>, <a class="el" href="classwx_evt_handler.html#a4b2f853f5c7a64432ae72f9b606698f9" title="Returns the pointer to the next handler in the chain.">GetNextHandler()</a>, <a class="el" href="classwx_evt_handler.html#a68e2ef2d2b7d68c4c9c18ca92933031b" title="Sets the pointer to the next handler.">SetNextHandler()</a>, <a class="el" href="classwx_window.html#a398c11ab9af7956067a964f560d1978c" title="Pushes this event handler onto the event stack for the window.">wxWindow::PushEventHandler</a>, <a class="el" href="classwx_window.html#ac45c1f4cf96c70779764c14cf528790b" title="Removes and returns the top-most event handler on the event handler stack.">wxWindow::PopEventHandler</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a360fdeefcf53b62fb49fb828406bb8a6"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool wxEvtHandler::IsUnlinked </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div><div class="memdoc">
<p>Returns <span class="literal">true</span> if the next and the previous handler pointers of this event handler instance are <span class="literal">NULL</span>. </p>
<dl class="section since"><dt>Since</dt><dd>2.9.0</dd></dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="classwx_evt_handler.html#aff0d1836464be82e2ad723ad3a58eccc" title="Sets the pointer to the previous handler.">SetPreviousHandler()</a>, <a class="el" href="classwx_evt_handler.html#a68e2ef2d2b7d68c4c9c18ca92933031b" title="Sets the pointer to the next handler.">SetNextHandler()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a65968dd27f3aac7718f2dd6b2ddd5a08"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">virtual bool wxEvtHandler::ProcessEvent </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classwx_event.html">wxEvent</a> & </td>
<td class="paramname"><em>event</em></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">virtual</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Processes an event, searching event tables and calling zero or more suitable event handler function(s). </p>
<p>Normally, your application would not call this function: it is called in the wxWidgets implementation to dispatch incoming user interface events to the framework (and application).</p>
<p>However, you might need to call it if implementing new functionality (such as a new control) where you define new event types, as opposed to allowing the user to override virtual functions.</p>
<p>Notice that you don't usually need to override <a class="el" href="classwx_evt_handler.html#a65968dd27f3aac7718f2dd6b2ddd5a08" title="Processes an event, searching event tables and calling zero or more suitable event handler function(s...">ProcessEvent()</a> to customize the event handling, overriding the specially provided <a class="el" href="classwx_evt_handler.html#ad4b0eac704dd005ac6a88fdb1e673c13" title="Method called by ProcessEvent() before examining this object event tables.">TryBefore()</a> and <a class="el" href="classwx_evt_handler.html#a5e25fece1cb6cbc11fd1d41ec140319c" title="Method called by ProcessEvent() as last resort.">TryAfter()</a> functions is usually enough. For example, <a class="el" href="classwx_m_d_i_parent_frame.html" title="An MDI (Multiple Document Interface) parent frame is a window which can contain MDI child frames in i...">wxMDIParentFrame</a> may override <a class="el" href="classwx_evt_handler.html#ad4b0eac704dd005ac6a88fdb1e673c13" title="Method called by ProcessEvent() before examining this object event tables.">TryBefore()</a> to ensure that the menu events are processed in the active child frame before being processed in the parent frame itself.</p>
<p>The normal order of event table searching is as follows:</p>
<ol type="1">
<li><a class="el" href="classwx_app_console.html#ada7ab606e014a10d46e4b3c6f602e20c" title="Overridden wxEventFilter method.">wxApp::FilterEvent()</a> is called. If it returns anything but <code>-1</code> (default) the processing stops here.</li>
<li><a class="el" href="classwx_evt_handler.html#ad4b0eac704dd005ac6a88fdb1e673c13" title="Method called by ProcessEvent() before examining this object event tables.">TryBefore()</a> is called (this is where <a class="el" href="classwx_validator.html" title="wxValidator is the base class for a family of validator classes that mediate between a class of contr...">wxValidator</a> are taken into account for <a class="el" href="classwx_window.html" title="wxWindow is the base class for all windows and represents any visible object on screen.">wxWindow</a> objects). If this returns <span class="literal">true</span>, the function exits.</li>
<li>If the object is disabled (via a call to <a class="el" href="classwx_evt_handler.html#a7388ae19c8657e5656471b658c320036" title="Enables or disables the event handler.">wxEvtHandler::SetEvtHandlerEnabled</a>) the function skips to step (7).</li>
<li>Dynamic event table of the handlers bound using <a class="el" href="classwx_evt_handler.html#a0f30c8fa5583b4a5f661897d63de3b62" title="Binds the given function, functor or method dynamically with the event.">Bind<>()</a> is searched. If a handler is found, it is executed and the function returns <span class="literal">true</span> unless the handler used <a class="el" href="classwx_event.html#a98eb20b76106f9a933c2eb3ee119f66c" title="This method can be used inside an event handler to control whether further event handlers bound to th...">wxEvent::Skip()</a> to indicate that it didn't handle the event in which case the search continues.</li>
<li>Static events table of the handlers bound using event table macros is searched for this event handler. If this fails, the base class event table is tried, and so on until no more tables exist or an appropriate function was found. If a handler is found, the same logic as in the previous step applies.</li>
<li>The search is applied down the entire chain of event handlers (usually the chain has a length of one). This chain can be formed using <a class="el" href="classwx_evt_handler.html#a68e2ef2d2b7d68c4c9c18ca92933031b" title="Sets the pointer to the next handler.">wxEvtHandler::SetNextHandler()</a>: <div class="image">
<img src="overview_events_chain.png" alt="overview_events_chain.png"/>
</div>
(referring to the image, if <code>A->ProcessEvent</code> is called and it doesn't handle the event, <code>B->ProcessEvent</code> will be called and so on...). Note that in the case of <a class="el" href="classwx_window.html" title="wxWindow is the base class for all windows and represents any visible object on screen.">wxWindow</a> you can build a stack of event handlers (see <a class="el" href="classwx_window.html#a398c11ab9af7956067a964f560d1978c" title="Pushes this event handler onto the event stack for the window.">wxWindow::PushEventHandler()</a> for more info). If any of the handlers of the chain return <span class="literal">true</span>, the function exits.</li>
<li><a class="el" href="classwx_evt_handler.html#a5e25fece1cb6cbc11fd1d41ec140319c" title="Method called by ProcessEvent() as last resort.">TryAfter()</a> is called: for the <a class="el" href="classwx_window.html" title="wxWindow is the base class for all windows and represents any visible object on screen.">wxWindow</a> object this may propagate the event to the window parent (recursively). If the event is still not processed, <a class="el" href="classwx_evt_handler.html#a65968dd27f3aac7718f2dd6b2ddd5a08" title="Processes an event, searching event tables and calling zero or more suitable event handler function(s...">ProcessEvent()</a> on wxTheApp object is called as the last step.</li>
</ol>
<p>Notice that steps (2)-(6) are performed in <a class="el" href="classwx_evt_handler.html#ac0f5d2cb29a04c1f7f82eb6b351f79fb" title="Try to process the event in this handler and all those chained to it.">ProcessEventLocally()</a> which is called by this function.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">event</td><td>Event to process. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd><span class="literal">true</span> if a suitable event handler function was found and executed, and the function did not call <a class="el" href="classwx_event.html#a98eb20b76106f9a933c2eb3ee119f66c" title="This method can be used inside an event handler to control whether further event handlers bound to th...">wxEvent::Skip</a>.</dd></dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="classwx_evt_handler.html#a3c07426130d2868a5ae7fa918a251f49" title="Searches the event table, executing an event handler function if an appropriate one is found...">SearchEventTable()</a> </dd></dl>
<p>Reimplemented in <a class="el" href="classwx_window.html#a5ebdbd87c28644149a07f1742996df96">wxWindow</a>.</p>
</div>
</div>
<a class="anchor" id="ac0f5d2cb29a04c1f7f82eb6b351f79fb"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool wxEvtHandler::ProcessEventLocally </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classwx_event.html">wxEvent</a> & </td>
<td class="paramname"><em>event</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Try to process the event in this handler and all those chained to it. </p>
<p>As explained in <a class="el" href="classwx_evt_handler.html#a65968dd27f3aac7718f2dd6b2ddd5a08" title="Processes an event, searching event tables and calling zero or more suitable event handler function(s...">ProcessEvent()</a> documentation, the event handlers may be chained in a doubly-linked list. This function tries to process the event in this handler (including performing any pre-processing done in <a class="el" href="classwx_evt_handler.html#ad4b0eac704dd005ac6a88fdb1e673c13" title="Method called by ProcessEvent() before examining this object event tables.">TryBefore()</a>, e.g. applying validators) and all those following it in the chain until the event is processed or the chain is exhausted.</p>
<p>This function is called from <a class="el" href="classwx_evt_handler.html#a65968dd27f3aac7718f2dd6b2ddd5a08" title="Processes an event, searching event tables and calling zero or more suitable event handler function(s...">ProcessEvent()</a> and, in turn, calls <a class="el" href="classwx_evt_handler.html#ad4b0eac704dd005ac6a88fdb1e673c13" title="Method called by ProcessEvent() before examining this object event tables.">TryBefore()</a> and <a class="el" href="classwx_evt_handler.html#a5e25fece1cb6cbc11fd1d41ec140319c" title="Method called by ProcessEvent() as last resort.">TryAfter()</a>. It is not virtual and so cannot be overridden but can, and should, be called to forward an event to another handler instead of <a class="el" href="classwx_evt_handler.html#a65968dd27f3aac7718f2dd6b2ddd5a08" title="Processes an event, searching event tables and calling zero or more suitable event handler function(s...">ProcessEvent()</a> which would result in a duplicate call to <a class="el" href="classwx_evt_handler.html#a5e25fece1cb6cbc11fd1d41ec140319c" title="Method called by ProcessEvent() as last resort.">TryAfter()</a>, e.g. resulting in all unprocessed events being sent to the application object multiple times.</p>
<dl class="section since"><dt>Since</dt><dd>2.9.1</dd></dl>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">event</td><td>Event to process. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd><span class="literal">true</span> if this handler of one of those chained to it processed the event. </dd></dl>
</div>
</div>
<a class="anchor" id="a6f643dbdcf8e914ae1c8b70dd305e6f2"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void wxEvtHandler::ProcessPendingEvents </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Processes the pending events previously queued using <a class="el" href="classwx_evt_handler.html#acffd03bf407a856166ea71ef0318b59a" title="Queue event for a later processing.">QueueEvent()</a> or <a class="el" href="classwx_evt_handler.html#a0737c6d2cbcd5ded4b1ecdd53ed0def3" title="Post an event to be processed later.">AddPendingEvent()</a>; you must call this function only if you are sure there are pending events for this handler, otherwise a <code>wxCHECK</code> will fail. </p>
<p>The real processing still happens in <a class="el" href="classwx_evt_handler.html#a65968dd27f3aac7718f2dd6b2ddd5a08" title="Processes an event, searching event tables and calling zero or more suitable event handler function(s...">ProcessEvent()</a> which is called by this function.</p>
<p>Note that this function needs a valid application object (see <a class="el" href="classwx_app_console.html#a2cb953d248e41fd5bdb95ade98311ad3" title="Returns the one and only global application object.">wxAppConsole::GetInstance()</a>) because <a class="el" href="classwx_app.html" title="The wxApp class represents the application itself when wxUSE_GUI=1.">wxApp</a> holds the list of the event handlers with pending events and this function manipulates that list. </p>
</div>
</div>
<a class="anchor" id="acffd03bf407a856166ea71ef0318b59a"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">virtual void wxEvtHandler::QueueEvent </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classwx_event.html">wxEvent</a> * </td>
<td class="paramname"><em>event</em></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">virtual</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Queue event for a later processing. </p>
<p>This method is similar to <a class="el" href="classwx_evt_handler.html#a65968dd27f3aac7718f2dd6b2ddd5a08" title="Processes an event, searching event tables and calling zero or more suitable event handler function(s...">ProcessEvent()</a> but while the latter is synchronous, i.e. the event is processed immediately, before the function returns, this one is asynchronous and returns immediately while the event will be processed at some later time (usually during the next event loop iteration).</p>
<p>Another important difference is that this method takes ownership of the <em>event</em> parameter, i.e. it will delete it itself. This implies that the event should be allocated on the heap and that the pointer can't be used any more after the function returns (as it can be deleted at any moment).</p>
<p><a class="el" href="classwx_evt_handler.html#acffd03bf407a856166ea71ef0318b59a" title="Queue event for a later processing.">QueueEvent()</a> can be used for inter-thread communication from the worker threads to the main thread, it is safe in the sense that it uses locking internally and avoids the problem mentioned in <a class="el" href="classwx_evt_handler.html#a0737c6d2cbcd5ded4b1ecdd53ed0def3" title="Post an event to be processed later.">AddPendingEvent()</a> documentation by ensuring that the <em>event</em> object is not used by the calling thread any more. Care should still be taken to avoid that some fields of this object are used by it, notably any <a class="el" href="classwx_string.html" title="String class for passing textual data to or receiving it from wxWidgets.">wxString</a> members of the event object must not be shallow copies of another <a class="el" href="classwx_string.html" title="String class for passing textual data to or receiving it from wxWidgets.">wxString</a> object as this would result in them still using the same string buffer behind the scenes. For example: </p>
<div class="fragment"><div class="line"><span class="keywordtype">void</span> FunctionInAWorkerThread(<span class="keyword">const</span> <a class="code" href="classwx_string.html" title="String class for passing textual data to or receiving it from wxWidgets.">wxString</a>& str)</div>
<div class="line">{</div>
<div class="line"> <a class="code" href="classwx_command_event.html" title="This event class contains information about command events, which originate from a variety of simple ...">wxCommandEvent</a>* evt = <span class="keyword">new</span> <a class="code" href="classwx_command_event.html" title="This event class contains information about command events, which originate from a variety of simple ...">wxCommandEvent</a>;</div>
<div class="line"></div>
<div class="line"> <span class="comment">// NOT evt->SetString(str) as this would be a shallow copy</span></div>
<div class="line"> evt-><a class="code" href="classwx_command_event.html#a06ca56ac6680fe3b3178d8abd913d450" title="Sets the m_commandString member.">SetString</a>(str.<a class="code" href="classwx_string.html#a6418ec90c6d4ffe0b05702be1b35df4f" title="Returns a lightweight intermediate class which is in turn implicitly convertible to both const char* ...">c_str</a>()); <span class="comment">// make a deep copy</span></div>
<div class="line"></div>
<div class="line"> <a class="code" href="interface_2wx_2app_8h.html#a01fd2cb0a8fbaade87800e71a50e855d" title="The global pointer to the singleton wxApp object.">wxTheApp</a>-><a class="code" href="classwx_evt_handler.html#acffd03bf407a856166ea71ef0318b59a" title="Queue event for a later processing.">QueueEvent</a>( evt );</div>
<div class="line">}</div>
</div><!-- fragment --><p>Note that you can use <a class="el" href="classwx_thread_event.html" title="This class adds some simple functionality to wxEvent to facilitate inter-thread communication.">wxThreadEvent</a> instead of <a class="el" href="classwx_command_event.html" title="This event class contains information about command events, which originate from a variety of simple ...">wxCommandEvent</a> to avoid this problem: </p>
<div class="fragment"><div class="line"><span class="keywordtype">void</span> FunctionInAWorkerThread(<span class="keyword">const</span> <a class="code" href="classwx_string.html" title="String class for passing textual data to or receiving it from wxWidgets.">wxString</a>& str)</div>
<div class="line">{</div>
<div class="line"> <a class="code" href="classwx_thread_event.html" title="This class adds some simple functionality to wxEvent to facilitate inter-thread communication.">wxThreadEvent</a> evt;</div>
<div class="line"> evt-><a class="code" href="classwx_thread_event.html#a72092085fc4e0837d8e56666cb45f4d3" title="Sets the string value.">SetString</a>(str);</div>
<div class="line"></div>
<div class="line"> <span class="comment">// wxThreadEvent::Clone() makes sure that the internal wxString</span></div>
<div class="line"> <span class="comment">// member is not shared by other wxString instances:</span></div>
<div class="line"> <a class="code" href="interface_2wx_2app_8h.html#a01fd2cb0a8fbaade87800e71a50e855d" title="The global pointer to the singleton wxApp object.">wxTheApp</a>-><a class="code" href="classwx_evt_handler.html#acffd03bf407a856166ea71ef0318b59a" title="Queue event for a later processing.">QueueEvent</a>( evt.<a class="code" href="classwx_thread_event.html#af8d1c4ec499415d84680c1a52a68513a" title="Clones this event making sure that all internal members which use COW (only m_commandString for now; ...">Clone</a>() );</div>
<div class="line">}</div>
</div><!-- fragment --><p>Finally notice that this method automatically wakes up the event loop if it is currently idle by calling <a class="el" href="group__group__funcmacro__appinitterm.html#ga97206743f70b5382f9e2615217604d15" title="This function wakes up the (internal and platform dependent) idle system, i.e.">wxWakeUpIdle()</a> so there is no need to do it manually when using it.</p>
<dl class="section since"><dt>Since</dt><dd>2.9.0</dd></dl>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">event</td><td>A heap-allocated event to be queued, <a class="el" href="classwx_evt_handler.html#acffd03bf407a856166ea71ef0318b59a" title="Queue event for a later processing.">QueueEvent()</a> takes ownership of it. This parameter shouldn't be <code>NULL</code>. </td></tr>
</table>
</dd>
</dl>
<p>Reimplemented in <a class="el" href="classwx_window.html#a69e450f21b0d7013269ec1a4771f043b">wxWindow</a>.</p>
</div>
</div>
<a class="anchor" id="a67a57b759c447b121bf70a7c9804c8f2"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">static void wxEvtHandler::RemoveFilter </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classwx_event_filter.html">wxEventFilter</a> * </td>
<td class="paramname"><em>filter</em></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">static</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Remove a filter previously installed with <a class="el" href="classwx_evt_handler.html#a7dc3c701781f4044372049de5004137e" title="Add an event filter whose FilterEvent() method will be called for each and every event processed by w...">AddFilter()</a>. </p>
<p>It's an error to remove a filter that hadn't been previously added or was already removed.</p>
<dl class="section since"><dt>Since</dt><dd>2.9.3 </dd></dl>
</div>
</div>
<a class="anchor" id="a8205cb1a5a00d8b550b3ead22266b16b"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool wxEvtHandler::SafelyProcessEvent </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classwx_event.html">wxEvent</a> & </td>
<td class="paramname"><em>event</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Processes an event by calling <a class="el" href="classwx_evt_handler.html#a65968dd27f3aac7718f2dd6b2ddd5a08" title="Processes an event, searching event tables and calling zero or more suitable event handler function(s...">ProcessEvent()</a> and handles any exceptions that occur in the process. </p>
<p>If an exception is thrown in event handler, <a class="el" href="classwx_app_console.html#aca806b41cf74fd6166e4fb2e2708e9bf" title="This function is called if an unhandled exception occurs inside the main application event loop...">wxApp::OnExceptionInMainLoop</a> is called.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">event</td><td>Event to process.</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd><span class="literal">true</span> if the event was processed, <span class="literal">false</span> if no handler was found or an exception was thrown.</dd></dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="classwx_window.html#a665731bbfa46a72c215b04df60216ef1" title="Shorthand for:">wxWindow::HandleWindowEvent</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a3c07426130d2868a5ae7fa918a251f49"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">virtual bool wxEvtHandler::SearchEventTable </td>
<td>(</td>
<td class="paramtype">wxEventTable & </td>
<td class="paramname"><em>table</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classwx_event.html">wxEvent</a> & </td>
<td class="paramname"><em>event</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">virtual</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Searches the event table, executing an event handler function if an appropriate one is found. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">table</td><td>Event table to be searched. </td></tr>
<tr><td class="paramname">event</td><td>Event to be matched against an event table entry.</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd><span class="literal">true</span> if a suitable event handler function was found and executed, and the function did not call <a class="el" href="classwx_event.html#a98eb20b76106f9a933c2eb3ee119f66c" title="This method can be used inside an event handler to control whether further event handlers bound to th...">wxEvent::Skip</a>.</dd></dl>
<dl class="section remark"><dt>Remarks</dt><dd>This function looks through the object's event table and tries to find an entry that will match the event. An entry will match if: <ul>
<li>The event type matches, and </li>
<li>the identifier or identifier range matches, or the event table entry's identifier is zero.</li>
</ul>
If a suitable function is called but calls <a class="el" href="classwx_event.html#a98eb20b76106f9a933c2eb3ee119f66c" title="This method can be used inside an event handler to control whether further event handlers bound to th...">wxEvent::Skip</a>, this function will fail, and searching will continue.</dd></dl>
<dl class="todo"><dt><b><a class="el" href="todo.html#_todo000016">Todo:</a></b></dt><dd>this function in the header is listed as an "implementation only" function; are we sure we want to document it?</dd></dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="classwx_evt_handler.html#a65968dd27f3aac7718f2dd6b2ddd5a08" title="Processes an event, searching event tables and calling zero or more suitable event handler function(s...">ProcessEvent()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a82c74f2cebfa02cb3c1563d459c872bf"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void wxEvtHandler::SetClientData </td>
<td>(</td>
<td class="paramtype">void * </td>
<td class="paramname"><em>data</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Sets user-supplied client data. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">data</td><td>Data to be associated with the event handler.</td></tr>
</table>
</dd>
</dl>
<dl class="section remark"><dt>Remarks</dt><dd>Normally, any extra data the programmer wishes to associate with the object should be made available by deriving a new class with new data members. You must not call this method and SetClientObject on the same class - only one of them.</dd></dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="classwx_evt_handler.html#ad6e543115a9405962152630138645588" title="Returns user-supplied client data.">GetClientData()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="af1e33a06087b8b2ddc43c7d15a91b326"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void wxEvtHandler::SetClientObject </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classwx_client_data.html">wxClientData</a> * </td>
<td class="paramname"><em>data</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Set the client data object. </p>
<p>Any previous object will be deleted.</p>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="classwx_evt_handler.html#a2b3949eaba1f25cb48618163a7c0583b" title="Returns a pointer to the user-supplied client data object.">GetClientObject()</a>, <a class="el" href="classwx_client_data.html" title="All classes deriving from wxEvtHandler (such as all controls and wxApp) can hold arbitrary data which...">wxClientData</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a7388ae19c8657e5656471b658c320036"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void wxEvtHandler::SetEvtHandlerEnabled </td>
<td>(</td>
<td class="paramtype">bool </td>
<td class="paramname"><em>enabled</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Enables or disables the event handler. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">enabled</td><td><span class="literal">true</span> if the event handler is to be enabled, <span class="literal">false</span> if it is to be disabled.</td></tr>
</table>
</dd>
</dl>
<dl class="section remark"><dt>Remarks</dt><dd>You can use this function to avoid having to remove the event handler from the chain, for example when implementing a dialog editor and changing from edit to test mode.</dd></dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="classwx_evt_handler.html#a533e62afcb125abf1fcc8bb53fbc2e81" title="Returns true if the event handler is enabled, false otherwise.">GetEvtHandlerEnabled()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a68e2ef2d2b7d68c4c9c18ca92933031b"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">virtual void wxEvtHandler::SetNextHandler </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classwx_evt_handler.html">wxEvtHandler</a> * </td>
<td class="paramname"><em>handler</em></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">virtual</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Sets the pointer to the next handler. </p>
<dl class="section remark"><dt>Remarks</dt><dd>See <a class="el" href="classwx_evt_handler.html#a65968dd27f3aac7718f2dd6b2ddd5a08" title="Processes an event, searching event tables and calling zero or more suitable event handler function(s...">ProcessEvent()</a> for more info about how the chains of event handlers are internally used. Also remember that <a class="el" href="classwx_evt_handler.html" title="A class that can handle events from the windowing system.">wxEvtHandler</a> uses double-linked lists and thus if you use this function, you should also call <a class="el" href="classwx_evt_handler.html#aff0d1836464be82e2ad723ad3a58eccc" title="Sets the pointer to the previous handler.">SetPreviousHandler()</a> on the argument passed to this function: <div class="fragment"><div class="line">handlerA->SetNextHandler(handlerB);</div>
<div class="line">handlerB->SetPreviousHandler(handlerA);</div>
</div><!-- fragment --></dd></dl>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">handler</td><td>The event handler to be set as the next handler. Cannot be <span class="literal">NULL</span>.</td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="overview_events.html#overview_events_processing">How Events are Processed</a> </dd></dl>
<p>Reimplemented in <a class="el" href="classwx_window.html#aeab905f61df7004c1b76a3351dca9e96">wxWindow</a>.</p>
</div>
</div>
<a class="anchor" id="aff0d1836464be82e2ad723ad3a58eccc"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">virtual void wxEvtHandler::SetPreviousHandler </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classwx_evt_handler.html">wxEvtHandler</a> * </td>
<td class="paramname"><em>handler</em></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">virtual</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Sets the pointer to the previous handler. </p>
<p>All remarks about <a class="el" href="classwx_evt_handler.html#a68e2ef2d2b7d68c4c9c18ca92933031b" title="Sets the pointer to the next handler.">SetNextHandler()</a> apply to this function as well.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">handler</td><td>The event handler to be set as the previous handler. Cannot be <span class="literal">NULL</span>.</td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="overview_events.html#overview_events_processing">How Events are Processed</a> </dd></dl>
<p>Reimplemented in <a class="el" href="classwx_window.html#a07f5f7ed3f78e0ef7b3dee3f4da81001">wxWindow</a>.</p>
</div>
</div>
<a class="anchor" id="a5e25fece1cb6cbc11fd1d41ec140319c"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">virtual bool wxEvtHandler::TryAfter </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classwx_event.html">wxEvent</a> & </td>
<td class="paramname"><em>event</em></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Method called by <a class="el" href="classwx_evt_handler.html#a65968dd27f3aac7718f2dd6b2ddd5a08" title="Processes an event, searching event tables and calling zero or more suitable event handler function(s...">ProcessEvent()</a> as last resort. </p>
<p>This method can be overridden to implement post-processing for the events which were not processed anywhere else.</p>
<p>The base class version handles forwarding the unprocessed events to <a class="el" href="classwx_app.html" title="The wxApp class represents the application itself when wxUSE_GUI=1.">wxApp</a> at <a class="el" href="classwx_evt_handler.html" title="A class that can handle events from the windowing system.">wxEvtHandler</a> level and propagating them upwards the window child-parent chain at <a class="el" href="classwx_window.html" title="wxWindow is the base class for all windows and represents any visible object on screen.">wxWindow</a> level and so should usually be called when overriding this method: </p>
<div class="fragment"><div class="line"><span class="keyword">class </span>MyClass : <span class="keyword">public</span> BaseClass <span class="comment">// inheriting from wxEvtHandler</span></div>
<div class="line">{</div>
<div class="line">...</div>
<div class="line">protected:</div>
<div class="line"> <span class="keyword">virtual</span> <span class="keywordtype">bool</span> <a class="code" href="classwx_evt_handler.html#a5e25fece1cb6cbc11fd1d41ec140319c" title="Method called by ProcessEvent() as last resort.">TryAfter</a>(<a class="code" href="classwx_event.html" title="An event is a structure holding information about an event passed to a callback or member function...">wxEvent</a>& event)</div>
<div class="line"> {</div>
<div class="line"> <span class="keywordflow">if</span> ( BaseClass::TryAfter(event) )</div>
<div class="line"> <span class="keywordflow">return</span> <span class="keyword">true</span>;</div>
<div class="line"></div>
<div class="line"> <span class="keywordflow">return</span> MyPostProcess(event);</div>
<div class="line"> }</div>
<div class="line">};</div>
</div><!-- fragment --><dl class="section see"><dt>See Also</dt><dd><a class="el" href="classwx_evt_handler.html#a65968dd27f3aac7718f2dd6b2ddd5a08" title="Processes an event, searching event tables and calling zero or more suitable event handler function(s...">ProcessEvent()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="ad4b0eac704dd005ac6a88fdb1e673c13"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">virtual bool wxEvtHandler::TryBefore </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classwx_event.html">wxEvent</a> & </td>
<td class="paramname"><em>event</em></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">protected</span><span class="mlabel">virtual</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Method called by <a class="el" href="classwx_evt_handler.html#a65968dd27f3aac7718f2dd6b2ddd5a08" title="Processes an event, searching event tables and calling zero or more suitable event handler function(s...">ProcessEvent()</a> before examining this object event tables. </p>
<p>This method can be overridden to hook into the event processing logic as early as possible. You should usually call the base class version when overriding this method, even if <a class="el" href="classwx_evt_handler.html" title="A class that can handle events from the windowing system.">wxEvtHandler</a> itself does nothing here, some derived classes do use this method, e.g. <a class="el" href="classwx_window.html" title="wxWindow is the base class for all windows and represents any visible object on screen.">wxWindow</a> implements support for <a class="el" href="classwx_validator.html" title="wxValidator is the base class for a family of validator classes that mediate between a class of contr...">wxValidator</a> in it.</p>
<p>Example: </p>
<div class="fragment"><div class="line"><span class="keyword">class </span>MyClass : <span class="keyword">public</span> BaseClass <span class="comment">// inheriting from wxEvtHandler</span></div>
<div class="line">{</div>
<div class="line">...</div>
<div class="line">protected:</div>
<div class="line"> <span class="keyword">virtual</span> <span class="keywordtype">bool</span> <a class="code" href="classwx_evt_handler.html#ad4b0eac704dd005ac6a88fdb1e673c13" title="Method called by ProcessEvent() before examining this object event tables.">TryBefore</a>(<a class="code" href="classwx_event.html" title="An event is a structure holding information about an event passed to a callback or member function...">wxEvent</a>& event)</div>
<div class="line"> {</div>
<div class="line"> <span class="keywordflow">if</span> ( MyPreProcess(event) )</div>
<div class="line"> <span class="keywordflow">return</span> <span class="keyword">true</span>;</div>
<div class="line"></div>
<div class="line"> <span class="keywordflow">return</span> BaseClass::TryBefore(event);</div>
<div class="line"> }</div>
<div class="line">};</div>
</div><!-- fragment --><dl class="section see"><dt>See Also</dt><dd><a class="el" href="classwx_evt_handler.html#a65968dd27f3aac7718f2dd6b2ddd5a08" title="Processes an event, searching event tables and calling zero or more suitable event handler function(s...">ProcessEvent()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a2b7df8272075a96daea78cdd799c00da"></a>
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename EventTag , typename Functor > </div>
<table class="memname">
<tr>
<td class="memname">bool wxEvtHandler::Unbind </td>
<td>(</td>
<td class="paramtype">const EventTag & </td>
<td class="paramname"><em>eventType</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">Functor </td>
<td class="paramname"><em>functor</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>id</em> = <code><a class="el" href="defs_8h.html#ac66d0a09761e7d86b2ac0b2e0c6a8cbba1f375b01ea03a713bbb7e32a36a2589c">wxID_ANY</a></code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>lastId</em> = <code><a class="el" href="defs_8h.html#ac66d0a09761e7d86b2ac0b2e0c6a8cbba1f375b01ea03a713bbb7e32a36a2589c">wxID_ANY</a></code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classwx_object.html">wxObject</a> * </td>
<td class="paramname"><em>userData</em> = <code>NULL</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Unbinds the given function, functor or method dynamically from the event handler, using the specified parameters as search criteria and returning <span class="literal">true</span> if a matching function has been found and removed. </p>
<p>This method can only unbind functions, functors or methods which have been added using the <a class="el" href="classwx_evt_handler.html#a0f30c8fa5583b4a5f661897d63de3b62" title="Binds the given function, functor or method dynamically with the event.">Bind<>()</a> method. There is no way to unbind functions bound using the (static) event tables.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">eventType</td><td>The event type associated with this event handler. </td></tr>
<tr><td class="paramname">functor</td><td>The event handler functor. This can be an ordinary function but also an arbitrary functor like boost::function<>. </td></tr>
<tr><td class="paramname">id</td><td>The first ID of the identifier range associated with the event handler. </td></tr>
<tr><td class="paramname">lastId</td><td>The last ID of the identifier range associated with the event handler. </td></tr>
<tr><td class="paramname">userData</td><td>Data associated with the event table entry.</td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="overview_cpp_rtti_disabled.html">Caveats When Not Using C++ RTTI</a></dd></dl>
<dl class="section since"><dt>Since</dt><dd>2.9.0 </dd></dl>
</div>
</div>
<a class="anchor" id="aa49f9c4ad4462456b4fe4bd1ab53533d"></a>
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename EventTag , typename Class , typename EventArg , typename EventHandler > </div>
<table class="memname">
<tr>
<td class="memname">bool wxEvtHandler::Unbind </td>
<td>(</td>
<td class="paramtype">const EventTag & </td>
<td class="paramname"><em>eventType</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void(Class::*)(EventArg &) </td>
<td class="paramname"><em>method</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">EventHandler * </td>
<td class="paramname"><em>handler</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>id</em> = <code><a class="el" href="defs_8h.html#ac66d0a09761e7d86b2ac0b2e0c6a8cbba1f375b01ea03a713bbb7e32a36a2589c">wxID_ANY</a></code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>lastId</em> = <code><a class="el" href="defs_8h.html#ac66d0a09761e7d86b2ac0b2e0c6a8cbba1f375b01ea03a713bbb7e32a36a2589c">wxID_ANY</a></code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classwx_object.html">wxObject</a> * </td>
<td class="paramname"><em>userData</em> = <code>NULL</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>See the <a class="el" href="classwx_evt_handler.html#a2b7df8272075a96daea78cdd799c00da" title="Unbinds the given function, functor or method dynamically from the event handler, using the specified...">Unbind<>(const EventTag&, Functor, int, int, wxObject*)</a> overload for more info. </p>
<p>This overload unbinds the given method from the event..</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">eventType</td><td>The event type associated with this event handler. </td></tr>
<tr><td class="paramname">method</td><td>The event handler method associated with this event. </td></tr>
<tr><td class="paramname">handler</td><td>Object whose method was called. </td></tr>
<tr><td class="paramname">id</td><td>The first ID of the identifier range associated with the event handler. </td></tr>
<tr><td class="paramname">lastId</td><td>The last ID of the identifier range associated with the event handler. </td></tr>
<tr><td class="paramname">userData</td><td>Data associated with the event table entry.</td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="overview_cpp_rtti_disabled.html">Caveats When Not Using C++ RTTI</a></dd></dl>
<dl class="section since"><dt>Since</dt><dd>2.9.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a22e5db2ec1d19c8252c056fd116975d7"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void wxEvtHandler::Unlink </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Unlinks this event handler from the chain it's part of (if any); then links the "previous" event handler to the "next" one (so that the chain won't be interrupted). </p>
<p>E.g. if before calling <a class="el" href="classwx_evt_handler.html#a22e5db2ec1d19c8252c056fd116975d7" title="Unlinks this event handler from the chain it's part of (if any); then links the "previous" event ha...">Unlink()</a> you have the following chain: </p>
<div class="image">
<img src="evthandler_unlink_before.png" alt="evthandler_unlink_before.png"/>
</div>
<p> then after calling <code>B-><a class="el" href="classwx_evt_handler.html#a22e5db2ec1d19c8252c056fd116975d7" title="Unlinks this event handler from the chain it's part of (if any); then links the "previous" event ha...">Unlink()</a></code> you'll have: </p>
<div class="image">
<img src="evthandler_unlink_after.png" alt="evthandler_unlink_after.png"/>
</div>
<dl class="section since"><dt>Since</dt><dd>2.9.0 </dd></dl>
</div>
</div>
</div><!-- contents -->
<address class="footer">
<small>
Generated on Thu Nov 27 2014 13:46:47 for wxWidgets by <a href="http://www.doxygen.org/index.html" target="_new">Doxygen</a> 1.8.2
</small>
</address>
<script src="wxwidgets.js" type="text/javascript"></script>
</div><!-- #page_container -->
</body>
</html>
|
