1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
1660
1661
1662
1663
1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679
1680
1681
1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
1703
1704
1705
1706
1707
1708
1709
1710
1711
1712
1713
1714
1715
1716
1717
1718
1719
1720
1721
1722
1723
1724
1725
1726
1727
1728
1729
1730
1731
1732
1733
1734
1735
1736
1737
1738
1739
1740
1741
1742
1743
1744
1745
1746
1747
1748
1749
1750
1751
1752
1753
1754
1755
1756
1757
1758
1759
1760
1761
1762
1763
1764
1765
1766
1767
1768
1769
1770
1771
1772
1773
1774
1775
1776
1777
1778
1779
1780
1781
1782
1783
1784
1785
1786
1787
1788
1789
1790
1791
1792
1793
1794
1795
1796
1797
1798
1799
1800
1801
1802
1803
1804
1805
1806
1807
1808
1809
1810
1811
1812
1813
1814
1815
1816
1817
1818
1819
1820
1821
1822
1823
1824
1825
1826
1827
1828
1829
1830
1831
1832
1833
1834
1835
1836
1837
1838
1839
1840
1841
1842
1843
1844
1845
1846
1847
1848
1849
1850
1851
1852
1853
1854
1855
1856
1857
1858
1859
1860
1861
1862
1863
1864
1865
1866
1867
1868
1869
1870
1871
1872
1873
1874
1875
1876
1877
1878
1879
1880
1881
1882
1883
1884
1885
1886
1887
1888
1889
1890
1891
1892
1893
1894
1895
1896
1897
1898
1899
1900
1901
1902
1903
1904
1905
1906
1907
1908
1909
1910
1911
1912
1913
1914
1915
1916
1917
1918
1919
1920
1921
1922
1923
1924
1925
1926
1927
1928
1929
1930
1931
1932
1933
1934
1935
1936
1937
1938
1939
1940
1941
1942
1943
1944
1945
1946
1947
1948
1949
1950
1951
1952
1953
1954
1955
1956
1957
1958
1959
1960
1961
1962
1963
1964
1965
1966
1967
1968
1969
1970
1971
1972
1973
1974
1975
1976
1977
1978
1979
1980
1981
1982
1983
1984
1985
1986
1987
1988
1989
1990
1991
1992
1993
1994
1995
1996
1997
1998
1999
2000
2001
2002
2003
2004
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
2027
2028
2029
2030
2031
2032
2033
2034
2035
2036
2037
2038
2039
2040
2041
2042
2043
2044
2045
2046
2047
2048
2049
2050
2051
2052
2053
2054
2055
2056
2057
2058
2059
2060
2061
2062
2063
2064
2065
2066
2067
2068
2069
2070
2071
2072
2073
2074
2075
2076
2077
2078
2079
2080
2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
<title>Wt: Wt::WApplication Class Reference</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
</head><body>
<!-- Generated by Doxygen 1.5.6 -->
<div class="navigation" id="top">
<div class="tabs">
<ul>
<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>Modules</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
</ul>
</div>
<div class="tabs">
<ul>
<li><a href="annotated.html"><span>Class List</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 class="navpath"><a class="el" href="namespaceWt.html">Wt</a>::<a class="el" href="classWt_1_1WApplication.html">WApplication</a>
</div>
</div>
<div class="contents">
<h1>Wt::WApplication Class Reference</h1><!-- doxytag: class="Wt::WApplication" --><!-- doxytag: inherits="Wt::WObject" -->Represents an application instance for a single session.
<a href="#_details">More...</a>
<p>
<code>#include <Wt/WApplication></code>
<p>
<div class="dynheader">
Inheritance diagram for Wt::WApplication:</div>
<div class="dynsection">
<p><center><img src="classWt_1_1WApplication__inherit__graph.png" border="0" usemap="#Wt_1_1WApplication__inherit__map" alt="Inheritance graph"></center>
<map name="Wt_1_1WApplication__inherit__map">
<area shape="rect" href="classWt_1_1WObject.html" title="A base class for objects that participate in the signal/slot system." alt="" coords="17,5,113,32"></map>
<center><font size="2">[<a href="graph_legend.html">legend</a>]</font></center></div>
<p>
<a href="classWt_1_1WApplication-members.html">List of all members.</a><table border="0" cellpadding="0" cellspacing="0">
<tr><td></td></tr>
<tr><td colspan="2"><br><h2>Public Types</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#102e3adfb4eb058288861c06dfd6a12a">AjaxMethod</a> { <a class="el" href="classWt_1_1WApplication.html#102e3adfb4eb058288861c06dfd6a12a9dc5b270e2b5c180556fb688cd8f06c2">XMLHttpRequest</a>,
<a class="el" href="classWt_1_1WApplication.html#102e3adfb4eb058288861c06dfd6a12a66ad42375422870da68e3666a1712d39">DynamicScriptTag</a>
}</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Enumeration that indicates the method for dynamic (AJAX-alike) updates. <a href="classWt_1_1WApplication.html#102e3adfb4eb058288861c06dfd6a12a">More...</a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">typedef Wt::ApplicationCreator </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#28b5dd3d1272f46fbacbfb21a0846d07">ApplicationCreator</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Typedef for a function that creates <a class="el" href="classWt_1_1WApplication.html" title="Represents an application instance for a single session.">WApplication</a> objects. <a href="#28b5dd3d1272f46fbacbfb21a0846d07"></a><br></td></tr>
<tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#e29a843f4d50159b17abfa9503c389db">WApplication</a> (const <a class="el" href="classWt_1_1WEnvironment.html">WEnvironment</a> &environment)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Creates a new application instance. <a href="#e29a843f4d50159b17abfa9503c389db"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#d0d9408ddc0fda917235d8416da3777f">~WApplication</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Destructor. <a href="#d0d9408ddc0fda917235d8416da3777f"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">const <a class="el" href="classWt_1_1WEnvironment.html">WEnvironment</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#19f3b913f4bc2f69761d9a3738bf142b">environment</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the environment information. <a href="#19f3b913f4bc2f69761d9a3738bf142b"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classWt_1_1WContainerWidget.html">WContainerWidget</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#17e118a04d962459484a12989a80bc05">root</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the root container. <a href="#17e118a04d962459484a12989a80bc05"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classWt_1_1WCssStyleSheet.html">WCssStyleSheet</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#6a9a20d65ce9e7c2f62b27387c94e10d">styleSheet</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns a reference to the inline style sheet. <a href="#6a9a20d65ce9e7c2f62b27387c94e10d"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#f377d541443b4bcea5fcc40be7c70173">useStyleSheet</a> (const std::string &url)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Adds an external style sheet. <a href="#f377d541443b4bcea5fcc40be7c70173"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#639e400a7aeb3d6a3a6229c572966da2">useStyleSheet</a> (const std::string &url, const std::string &condition)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Adds an external style sheet, conditional to specific Internet Explorer browser. <a href="#639e400a7aeb3d6a3a6229c572966da2"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#a316b2b30a6191085f265974b66e55bb">setCssTheme</a> (const std::string &theme)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the theme. <a href="#a316b2b30a6191085f265974b66e55bb"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">std::string </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#0e09381079f67501e38652087232969d">cssTheme</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the theme. <a href="#0e09381079f67501e38652087232969d"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#71a3f7da5abb9a76df94fab69ba61670">setTitle</a> (const <a class="el" href="classWt_1_1WString.html">WString</a> &title)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the window title. <a href="#71a3f7da5abb9a76df94fab69ba61670"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">const <a class="el" href="classWt_1_1WString.html">WString</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#86aefff2a3438fecdfde3e0e7dd6e5da">title</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the window title. <a href="#86aefff2a3438fecdfde3e0e7dd6e5da"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classWt_1_1WLocalizedStrings.html">WLocalizedStrings</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#a140cb3c65451413939010d704e9a58a">localizedStrings</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the resource object that provides localized strings. <a href="#a140cb3c65451413939010d704e9a58a"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#1039775b5a73ff2efc34a482ebd112a8">setLocalizedStrings</a> (<a class="el" href="classWt_1_1WLocalizedStrings.html">WLocalizedStrings</a> *stringResolver)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the resource object that provides localized strings. <a href="#1039775b5a73ff2efc34a482ebd112a8"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classWt_1_1WMessageResourceBundle.html">WMessageResourceBundle</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#5386565e35a58c94ccbbfab48f2212a4">messageResourceBundle</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the message resource bundle. <a href="#5386565e35a58c94ccbbfab48f2212a4"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#5c9cc1350019d69f154a2b44cdaf2596">setLocale</a> (const std::string &locale)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Changes the locale. <a href="#5c9cc1350019d69f154a2b44cdaf2596"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">std::string </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#6e782f1f38a6f56e2024aab1a917a80b">locale</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the current locale. <a href="#6e782f1f38a6f56e2024aab1a917a80b"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#02b9d8aa1b6c2d0dc9edc1b9c63f86dc">refresh</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Refreshes the application. <a href="#02b9d8aa1b6c2d0dc9edc1b9c63f86dc"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#ba49e1b9e696ac7244f5e2b63ca07de5">bindWidget</a> (<a class="el" href="classWt_1_1WWidget.html">WWidget</a> *widget, const std::string &domId)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Binds a top-level widget for a WidgetSet deployment. <a href="#ba49e1b9e696ac7244f5e2b63ca07de5"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">std::string </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#455fe732c1dd087ed507bc5975420828">url</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns a URL for the current session. <a href="#455fe732c1dd087ed507bc5975420828"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">std::string </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#37b4cf44f393688785ed3b34f53fead1">bookmarkUrl</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns a bookmarkable URL for the current internal path. <a href="#37b4cf44f393688785ed3b34f53fead1"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">std::string </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#c99ee110fd00d89de51e6e90ad166626">bookmarkUrl</a> (const std::string &internalPath) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns a bookmarkable URL for a given internal path. <a href="#c99ee110fd00d89de51e6e90ad166626"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#2c1a10aadc0d7ed877b5715b42ca4911">setInternalPath</a> (const std::string &path, bool emitChange=false)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Change the internal path. <a href="#2c1a10aadc0d7ed877b5715b42ca4911"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">std::string </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#ab6320ecdd0e8e4026e9ef1aca710ca5">internalPath</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the current internal path. <a href="#ab6320ecdd0e8e4026e9ef1aca710ca5"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">std::string </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#95e6b5e4dc9084d45e166264b10b3c46">internalPathNextPart</a> (const std::string &path) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns a part of the current internal path. <a href="#95e6b5e4dc9084d45e166264b10b3c46"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#ed54bd83339bc80b3cffba9067ab1e39">internalPathMatches</a> (const std::string &path) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Checks if the internal path matches a given path. <a href="#ed54bd83339bc80b3cffba9067ab1e39"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classWt_1_1Signal.html">Signal</a>< std::string > & </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#3e68c4b6bb387f27a614e7962e11967b">internalPathChanged</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Signal which indicates that the user changes the internal path. <a href="#3e68c4b6bb387f27a614e7962e11967b"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#4dcbf69c8b09c301577b5b6aa8a4da18">redirect</a> (const std::string &url)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Redirects the application to another location. <a href="#4dcbf69c8b09c301577b5b6aa8a4da18"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">std::string </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#b55c625a3197fec416544be8ad1529af">sessionId</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the unique identifier for the current session. <a href="#b55c625a3197fec416544be8ad1529af"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#d9631ca64e68d30d40cb49c90e55223d">enableUpdates</a> (bool enabled=true)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Enables server-initiated updates. <a href="#d9631ca64e68d30d40cb49c90e55223d"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#5a8e6970e9123fb1c23aa43711093135">updatesEnabled</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns whether server-initiated updates are enabled. <a href="#5a8e6970e9123fb1c23aa43711093135"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#51f50e0641a6d702a7c6ab7f8dd5946a">triggerUpdate</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Propagates server-initiated updates. <a href="#51f50e0641a6d702a7c6ab7f8dd5946a"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classWt_1_1WApplication_1_1UpdateLock.html">UpdateLock</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#c7582c37defc49b5e8d6ccbda3b68d45">getUpdateLock</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Grabs and returns the lock for manipulating widgets outside the event loop. <a href="#c7582c37defc49b5e8d6ccbda3b68d45"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#8b03a693a8277b7d5e0775a9b9581803">attachThread</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Attach an auxiliary thread to this application. <a href="#8b03a693a8277b7d5e0775a9b9581803"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#2a92457b9212cef4057cb54e56183967">doJavaScript</a> (const std::string &javascript, bool afterLoaded=true)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Executes some JavaScript code. <a href="#2a92457b9212cef4057cb54e56183967"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#412bcf9c269b097e7c372515e27b88ba">addAutoJavaScript</a> (const std::string &javascript)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Adds JavaScript statements that should be run continuously. <a href="#412bcf9c269b097e7c372515e27b88ba"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#3456e2bd2eec561abb90ae19ae42be02">declareJavaScriptFunction</a> (const std::string &name, const std::string &function)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Declares an application-wide JavaScript function. <a href="#3456e2bd2eec561abb90ae19ae42be02"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#e88546224ed32cade783da188b145138">require</a> (const std::string &url, const std::string &symbol=std::string())</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Loads a JavaScript library. <a href="#e88546224ed32cade783da188b145138"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#48ceb7972ef7ec0e557adf441f660f2f">processEvents</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Processes UI events. <a href="#48ceb7972ef7ec0e557adf441f660f2f"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#f2b590f865a4a6a6b144c45682b4bc1a">setAjaxMethod</a> (<a class="el" href="classWt_1_1WApplication.html#102e3adfb4eb058288861c06dfd6a12a">AjaxMethod</a> method)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the Ajax communication method. <a href="#f2b590f865a4a6a6b144c45682b4bc1a"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classWt_1_1WApplication.html#102e3adfb4eb058288861c06dfd6a12a">AjaxMethod</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#10cd5e55a610b7f6587c881a2c35188c">ajaxMethod</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the Ajax communication method. <a href="#10cd5e55a610b7f6587c881a2c35188c"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">std::string </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#6e0963307eb9367a3a4a3f4e35ae3abe">javaScriptClass</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the name of the application JavaScript class. <a href="#6e0963307eb9367a3a4a3f4e35ae3abe"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#42fc7f65116073d4032573f1e42c1173">initialize</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Initializes the application, post-construction. <a href="#42fc7f65116073d4032573f1e42c1173"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#10317a8a50dc95db9b27ad54409ab39f">finalize</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Finalizes the application, pre-destruction. <a href="#10317a8a50dc95db9b27ad54409ab39f"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#63d991e268c9af8898329217a1242563">setTwoPhaseRenderingThreshold</a> (int size)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Changes the threshold for two-phase rendering. <a href="#63d991e268c9af8898329217a1242563"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#0aa2703da36531cf1773d3e756791bf6">setCookie</a> (const std::string &name, const std::string &value, int maxAge, const std::string &domain="", const std::string &path="")</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets a new cookie. <a href="#0aa2703da36531cf1773d3e756791bf6"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#781ae50d1941783913de98d4d4d08a97">maximumRequestSize</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the current maximum size of a request to the application. <a href="#781ae50d1941783913de98d4d4d08a97"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classWt_1_1WLogEntry.html">WLogEntry</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#75067771ba8fcc56e174f2e741ce278f">log</a> (const std::string &type) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Adds an entry to the application log. <a href="#75067771ba8fcc56e174f2e741ce278f"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#080d01aa8e92ae57ef9c9491d33a7fca">setLoadingIndicator</a> (<a class="el" href="classWt_1_1WLoadingIndicator.html">WLoadingIndicator</a> *indicator)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the loading indicator. <a href="#080d01aa8e92ae57ef9c9491d33a7fca"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classWt_1_1WLoadingIndicator.html">WLoadingIndicator</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#435c81aaee5f9d0993b329d2541ee21a">loadingIndicator</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the loading indicator. <a href="#435c81aaee5f9d0993b329d2541ee21a"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#5231d54ed34982f4366058eb6440c8f7">quit</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Quits the application. <a href="#5231d54ed34982f4366058eb6440c8f7"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#ca61c7262e83de25c276021b26b53074">isQuited</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns whether the application is quited. <a href="#ca61c7262e83de25c276021b26b53074"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classWt_1_1Signal.html">Signal</a>< int > & </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#ef3a8fa2a7825ed7439707d8a90b08aa">requestTooLarge</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Signal which indicates that too a large request was received. <a href="#ef3a8fa2a7825ed7439707d8a90b08aa"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#a8fe83406981a556da61a843bb691674">setBodyClass</a> (const std::string &styleClass)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets a style class to the entire page <body>. <a href="#a8fe83406981a556da61a843bb691674"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">std::string </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#4e87d8f55211eb7f2fcea01ad956ea63">bodyClass</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the style class set for the entire page <body>. <a href="#4e87d8f55211eb7f2fcea01ad956ea63"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#28867ea48711f9290de496c2ed42fdbf">setHtmlClass</a> (const std::string &styleClass)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets a style class to the entire page <html>. <a href="#28867ea48711f9290de496c2ed42fdbf"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">std::string </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#1324d7dd9b83e075d78a65ca8cde8c9b">htmlClass</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the style class set for the entire page <html>. <a href="#1324d7dd9b83e075d78a65ca8cde8c9b"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classWt_1_1EventSignal.html">EventSignal</a>< <a class="el" href="classWt_1_1WKeyEvent.html">WKeyEvent</a> > & </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#0a9652fc0d0cbebca7966f98454b078a">globalKeyWentDown</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Event signal emitted when a keyboard key is pushed down. <a href="#0a9652fc0d0cbebca7966f98454b078a"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classWt_1_1EventSignal.html">EventSignal</a>< <a class="el" href="classWt_1_1WKeyEvent.html">WKeyEvent</a> > & </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#7d8f807eee7191ae6b7f6f7fe2ab2fae">globalKeyPressed</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Event signal emitted when a "character" was entered. <a href="#7d8f807eee7191ae6b7f6f7fe2ab2fae"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classWt_1_1EventSignal.html">EventSignal</a>< <a class="el" href="classWt_1_1WKeyEvent.html">WKeyEvent</a> > & </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#a2a569eabc35162f4b2a72c36a24cd80">globalKeyWentUp</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Event signal emitted when a keyboard key is released. <a href="#a2a569eabc35162f4b2a72c36a24cd80"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classWt_1_1EventSignal.html">EventSignal</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#60c1defb57949f6f78c6c1373a18e74e">globalEnterPressed</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Event signal emitted when enter was pressed. <a href="#60c1defb57949f6f78c6c1373a18e74e"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classWt_1_1EventSignal.html">EventSignal</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#b4d42f698c48bf84fcc807cb597a0509">globalEscapePressed</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Event signal emitted when escape was pressed. <a href="#b4d42f698c48bf84fcc807cb597a0509"></a><br></td></tr>
<tr><td colspan="2"><br><h2>Static Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static <a class="el" href="classWt_1_1WApplication.html">WApplication</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#38d922da0a0d83395519f3eaab85d0f6">instance</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the current application instance. <a href="#38d922da0a0d83395519f3eaab85d0f6"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#c0f5599ed35eb159fa6912aa0ff3c75c">readConfigurationProperty</a> (const std::string &name, std::string &value)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Reads a configuration property. <a href="#c0f5599ed35eb159fa6912aa0ff3c75c"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static std::string </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#c0fa2857a600cc34b3443a04d9ed5c5c">resourcesUrl</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the URL at which the resources are deployed. <a href="#c0fa2857a600cc34b3443a04d9ed5c5c"></a><br></td></tr>
<tr><td colspan="2"><br><h2>Protected Member Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#4a6f167bea94aefa8ba24f914c2fbee5">notify</a> (const WEvent &e)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Notifies an event to the application. <a href="#4a6f167bea94aefa8ba24f914c2fbee5"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#17e25e84fab304664baab5b0c748b802">isExposed</a> (<a class="el" href="classWt_1_1WWidget.html">WWidget</a> *w) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns whether a widget is exposed in the interface. <a href="#17e25e84fab304664baab5b0c748b802"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#78016406c4746c56b2c2ffce7c5e181f">enableAjax</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Progresses to an Ajax-enabled user interface. <a href="#78016406c4746c56b2c2ffce7c5e181f"></a><br></td></tr>
<tr><td colspan="2"><br><h2>Related Functions</h2></td></tr>
<tr><td colspan="2">(Note that these are not member functions.) <br><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">typedef <a class="el" href="classWt_1_1WApplication.html">WApplication</a> *(* </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication.html#aa9f20bdeb8ebcbb3ec5d633b010511f">ApplicationCreator</a> )(const <a class="el" href="classWt_1_1WEnvironment.html">WEnvironment</a> &env)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Typedef for a function that creates <a class="el" href="classWt_1_1WApplication.html" title="Represents an application instance for a single session.">WApplication</a> objects. <a href="#aa9f20bdeb8ebcbb3ec5d633b010511f"></a><br></td></tr>
<tr><td colspan="2"><br><h2>Classes</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="classWt_1_1WApplication_1_1UpdateLock.html">UpdateLock</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">A synchronisation lock for manipulating and updating the application and its widgets outside of the event loop. <a href="classWt_1_1WApplication_1_1UpdateLock.html#_details">More...</a><br></td></tr>
</table>
<hr><a name="_details"></a><h2>Detailed Description</h2>
Represents an application instance for a single session.
<p>
Each user session of your application has a corresponding WApplication instance. You need to create a new instance and return it as the result of the callback function passed to <a class="el" href="classWt_1_1WServer.html#bca6890dab44d87bd3af64705ac072d3" title="Runs the Wt application server.">WRun()</a>. The instance is the main entry point to session information, and holds a reference to the <a class="el" href="classWt_1_1WApplication.html#17e118a04d962459484a12989a80bc05" title="Returns the root container.">root()</a> of the widget tree.<p>
The recipe for a Wt web application, which allocates new <a class="el" href="classWt_1_1WApplication.html" title="Represents an application instance for a single session.">WApplication</a> instances for every user visiting the application is thus:<p>
<div class="fragment"><pre class="fragment"> <a class="code" href="classWt_1_1WApplication.html#e29a843f4d50159b17abfa9503c389db" title="Creates a new application instance.">WApplication</a> *createApplication(<span class="keyword">const</span> WEnvironment WEnvironment& env)
{
<span class="comment">//</span>
<span class="comment">// Optionally, check the environment and redirect to an error page.</span>
<span class="comment">//</span>
<span class="keywordtype">bool</span> valid = ...;
<a class="code" href="classWt_1_1WApplication.html#e29a843f4d50159b17abfa9503c389db" title="Creates a new application instance.">WApplication</a> *app;
<span class="keywordflow">if</span> (!valid) {
app = <span class="keyword">new</span> <a class="code" href="classWt_1_1WApplication.html#e29a843f4d50159b17abfa9503c389db" title="Creates a new application instance.">WApplication</a>(env);
app->redirect(<span class="stringliteral">"error.html"</span>);
app->quit();
} <span class="keywordflow">else</span> {
<span class="comment">// usually you will specialize your application class</span>
app = <span class="keyword">new</span> <a class="code" href="classWt_1_1WApplication.html#e29a843f4d50159b17abfa9503c389db" title="Creates a new application instance.">WApplication</a>(env);
<span class="comment">//</span>
<span class="comment">// Add widgets to app->root() and return the application object.</span>
<span class="comment">//</span>
}
<span class="keywordflow">return</span> app;
}
</pre></div><p>
Throughout the session, the instance is available through <a class="el" href="classWt_1_1WApplication.html#38d922da0a0d83395519f3eaab85d0f6" title="Returns the current application instance.">WApplication::instance()</a> (or through wApp). The application may be quited either using the method <a class="el" href="classWt_1_1WApplication.html#5231d54ed34982f4366058eb6440c8f7" title="Quits the application.">quit()</a>, or because of a timeout after the user has closed the window, but not because the user does not interact: keep-alive messages in the background will keep the session around as long as the user has the page opened. In either case, the application object is deleted, allowing for cleanup of the entire widget tree, and any other resources.<p>
The WApplication object provides access to session-wide settings, including:<p>
<ul>
<li>circumstancial information through <a class="el" href="classWt_1_1WApplication.html#19f3b913f4bc2f69761d9a3738bf142b" title="Returns the environment information.">environment()</a>, which gives details about the user, start-up arguments, and user agent capabilities.</li><li>the application title with <a class="el" href="classWt_1_1WApplication.html#71a3f7da5abb9a76df94fab69ba61670" title="Sets the window title.">setTitle()</a>.</li><li>inline and external style sheets using <a class="el" href="classWt_1_1WApplication.html#6a9a20d65ce9e7c2f62b27387c94e10d" title="Returns a reference to the inline style sheet.">styleSheet()</a> and <a class="el" href="classWt_1_1WApplication.html#f377d541443b4bcea5fcc40be7c70173" title="Adds an external style sheet.">useStyleSheet()</a>.</li><li>inline and external JavaScript using <a class="el" href="classWt_1_1WApplication.html#2a92457b9212cef4057cb54e56183967" title="Executes some JavaScript code.">doJavaScript()</a> and <a class="el" href="classWt_1_1WApplication.html#e88546224ed32cade783da188b145138" title="Loads a JavaScript library.">require()</a>.</li><li>the top-level widget in <a class="el" href="classWt_1_1WApplication.html#17e118a04d962459484a12989a80bc05" title="Returns the root container.">root()</a>, representing the entire browser window, or multiple top-level widgets using <a class="el" href="classWt_1_1WApplication.html#ba49e1b9e696ac7244f5e2b63ca07de5" title="Binds a top-level widget for a WidgetSet deployment.">bindWidget()</a> when deployed in WidgetSet mode to manage a number of widgets within a 3rd party page.</li><li>definition of cookies using <a class="el" href="classWt_1_1WApplication.html#0aa2703da36531cf1773d3e756791bf6" title="Sets a new cookie.">setCookie()</a> to persist information across sessions, which may be read using <a class="el" href="classWt_1_1WEnvironment.html#f39745ca2c6c6fc00c0f78bc7d064e3a" title="Checks for existence and returns specified argument.">WEnvironment::getCookie()</a> in a future session.</li><li>management of the internal path (that enables browser history and bookmarks) using <a class="el" href="classWt_1_1WApplication.html#2c1a10aadc0d7ed877b5715b42ca4911" title="Change the internal path.">setInternalPath()</a> and related methods.</li><li>support for server-initiated updates with <a class="el" href="classWt_1_1WApplication.html#d9631ca64e68d30d40cb49c90e55223d" title="Enables server-initiated updates.">enableUpdates()</a></li></ul>
<p>
<ul>
<li>localization information and message resources bundles using <a class="el" href="classWt_1_1WApplication.html#5c9cc1350019d69f154a2b44cdaf2596" title="Changes the locale.">setLocale()</a> and <a class="el" href="classWt_1_1WApplication.html#5386565e35a58c94ccbbfab48f2212a4" title="Returns the message resource bundle.">messageResourceBundle()</a>. </li></ul>
<hr><h2>Member Typedef Documentation</h2>
<a class="anchor" name="28b5dd3d1272f46fbacbfb21a0846d07"></a><!-- doxytag: member="Wt::WApplication::ApplicationCreator" ref="28b5dd3d1272f46fbacbfb21a0846d07" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef Wt::ApplicationCreator <a class="el" href="classWt_1_1WApplication.html#aa9f20bdeb8ebcbb3ec5d633b010511f">Wt::WApplication::ApplicationCreator</a> </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Typedef for a function that creates <a class="el" href="classWt_1_1WApplication.html" title="Represents an application instance for a single session.">WApplication</a> objects.
<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WServer.html#bca6890dab44d87bd3af64705ac072d3" title="Runs the Wt application server.">WRun()</a> </dd></dl>
</div>
</div><p>
<hr><h2>Member Enumeration Documentation</h2>
<a class="anchor" name="102e3adfb4eb058288861c06dfd6a12a"></a><!-- doxytag: member="Wt::WApplication::AjaxMethod" ref="102e3adfb4eb058288861c06dfd6a12a" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="classWt_1_1WApplication.html#102e3adfb4eb058288861c06dfd6a12a">Wt::WApplication::AjaxMethod</a> </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Enumeration that indicates the method for dynamic (AJAX-alike) updates.
<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WApplication.html#f2b590f865a4a6a6b144c45682b4bc1a" title="Sets the Ajax communication method.">setAjaxMethod()</a> </dd></dl>
<dl compact><dt><b>Enumerator: </b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" name="102e3adfb4eb058288861c06dfd6a12a9dc5b270e2b5c180556fb688cd8f06c2"></a><!-- doxytag: member="XMLHttpRequest" ref="102e3adfb4eb058288861c06dfd6a12a9dc5b270e2b5c180556fb688cd8f06c2" args="" -->XMLHttpRequest</em> </td><td>
Using the XMLHttpRequest object (real AJAX). </td></tr>
<tr><td valign="top"><em><a class="anchor" name="102e3adfb4eb058288861c06dfd6a12a66ad42375422870da68e3666a1712d39"></a><!-- doxytag: member="DynamicScriptTag" ref="102e3adfb4eb058288861c06dfd6a12a66ad42375422870da68e3666a1712d39" args="" -->DynamicScriptTag</em> </td><td>
Using dynamic script tags (for cross-domain AJAX). </td></tr>
</table>
</dl>
</div>
</div><p>
<hr><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" name="e29a843f4d50159b17abfa9503c389db"></a><!-- doxytag: member="Wt::WApplication::WApplication" ref="e29a843f4d50159b17abfa9503c389db" args="(const WEnvironment &environment)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Wt::WApplication::WApplication </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classWt_1_1WEnvironment.html">WEnvironment</a> & </td>
<td class="paramname"> <em>environment</em> </td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Creates a new application instance.
<p>
The <code>environment</code> provides information on the initial request, user agent, and deployment-related information.
</div>
</div><p>
<a class="anchor" name="d0d9408ddc0fda917235d8416da3777f"></a><!-- doxytag: member="Wt::WApplication::~WApplication" ref="d0d9408ddc0fda917235d8416da3777f" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Wt::WApplication::~WApplication </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Destructor.
<p>
The destructor deletes the <a class="el" href="classWt_1_1WApplication.html#17e118a04d962459484a12989a80bc05" title="Returns the root container.">root()</a> container, and as a consequence the entire widget tree.
</div>
</div><p>
<hr><h2>Member Function Documentation</h2>
<a class="anchor" name="38d922da0a0d83395519f3eaab85d0f6"></a><!-- doxytag: member="Wt::WApplication::instance" ref="38d922da0a0d83395519f3eaab85d0f6" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classWt_1_1WApplication.html">WApplication</a> * Wt::WApplication::instance </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns the current application instance.
<p>
This is the same as the global define wApp. In a multi-threaded server, this method uses thread-specific storage to fetch the current session.
</div>
</div><p>
<a class="anchor" name="19f3b913f4bc2f69761d9a3738bf142b"></a><!-- doxytag: member="Wt::WApplication::environment" ref="19f3b913f4bc2f69761d9a3738bf142b" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const <a class="el" href="classWt_1_1WEnvironment.html">WEnvironment</a> & Wt::WApplication::environment </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns the environment information.
<p>
This method returns the environment object that was used when constructing the application. The environment provides information on the initial request, user agent, and deployment-related information.<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WApplication.html#455fe732c1dd087ed507bc5975420828" title="Returns a URL for the current session.">url()</a>, <a class="el" href="classWt_1_1WApplication.html#b55c625a3197fec416544be8ad1529af" title="Returns the unique identifier for the current session.">sessionId()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="17e118a04d962459484a12989a80bc05"></a><!-- doxytag: member="Wt::WApplication::root" ref="17e118a04d962459484a12989a80bc05" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classWt_1_1WContainerWidget.html">WContainerWidget</a>* Wt::WApplication::root </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td> const<code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns the root container.
<p>
This is the top-level widget container of the application, and corresponds to entire browser window. The user interface of your application is represented by the content of this container.<p>
The root() widget is only defined when the application manages the entire window. When deployed as a <a class="el" href="namespaceWt.html#f4b6ed5fd28b4f5fa141b153c1107349932eaa79ae0d1f31e3cb240cf5ff0826">WidgetSet</a> application, there is no root() container, and <code>0</code> is returned. Instead, use <a class="el" href="classWt_1_1WApplication.html#ba49e1b9e696ac7244f5e2b63ca07de5" title="Binds a top-level widget for a WidgetSet deployment.">bindWidget()</a> to bind one or more root widgets to existing HTML <div> (or other) elements on the page.
</div>
</div><p>
<a class="anchor" name="6a9a20d65ce9e7c2f62b27387c94e10d"></a><!-- doxytag: member="Wt::WApplication::styleSheet" ref="6a9a20d65ce9e7c2f62b27387c94e10d" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classWt_1_1WCssStyleSheet.html">WCssStyleSheet</a>& Wt::WApplication::styleSheet </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns a reference to the inline style sheet.
<p>
Widgets may allow configuration of their look and feel through style classes. These may be defined in this inline stylesheet, or in external style sheets.<p>
It is usually preferable to use external stylesheets (and consider more accessible). Still, the internal stylesheet has as benefit that style rules may be dynamically updated, and it is easier to manage logistically.<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WApplication.html#f377d541443b4bcea5fcc40be7c70173" title="Adds an external style sheet.">useStyleSheet()</a> <p>
<a class="el" href="classWt_1_1WWidget.html#4be23ecf48d5968efb5d926e38e01708" title="Sets (one or more) CSS style classes.">WWidget::setStyleClass()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="f377d541443b4bcea5fcc40be7c70173"></a><!-- doxytag: member="Wt::WApplication::useStyleSheet" ref="f377d541443b4bcea5fcc40be7c70173" args="(const std::string &url)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WApplication::useStyleSheet </td>
<td>(</td>
<td class="paramtype">const std::string & </td>
<td class="paramname"> <em>url</em> </td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Adds an external style sheet.
<p>
Widgets may allow configuration of their look and feel through style classes. These may be defined in an inline stylesheet, or in external style sheets.<p>
The <code>url</code> indicates a relative or absolute URL to the stylesheet.<p>
External stylesheets are inserted after the internal style sheet, and can therefore override default styles set by widgets in the internal style sheet.<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WApplication.html#6a9a20d65ce9e7c2f62b27387c94e10d" title="Returns a reference to the inline style sheet.">styleSheet()</a>, <a class="el" href="classWt_1_1WApplication.html#639e400a7aeb3d6a3a6229c572966da2" title="Adds an external style sheet, conditional to specific Internet Explorer browser.">useStyleSheet(const std::string&, const std::string&)</a> <p>
<a class="el" href="classWt_1_1WWidget.html#4be23ecf48d5968efb5d926e38e01708" title="Sets (one or more) CSS style classes.">WWidget::setStyleClass()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="639e400a7aeb3d6a3a6229c572966da2"></a><!-- doxytag: member="Wt::WApplication::useStyleSheet" ref="639e400a7aeb3d6a3a6229c572966da2" args="(const std::string &url, const std::string &condition)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WApplication::useStyleSheet </td>
<td>(</td>
<td class="paramtype">const std::string & </td>
<td class="paramname"> <em>url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const std::string & </td>
<td class="paramname"> <em>condition</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Adds an external style sheet, conditional to specific Internet Explorer browser.
<p>
<code>condition</code> is a string that is used to apply the stylesheet to specific versions of IE. Only a limited subset of the IE conditional comments syntax is supported (since these are in fact interpreted server-side instead of client-side). Examples are:<ul>
<li>"IE gte 6": only for IE version 6 or later.</li><li>"!IE gte 6": only for IE versions prior to IE6.</li><li>"IE lte 7": only for IE versions prior to IE7.</li></ul>
<p>
The <code>url</code> indicates a relative or absolute URL to the stylesheet.<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WApplication.html#f377d541443b4bcea5fcc40be7c70173" title="Adds an external style sheet.">useStyleSheet()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="a316b2b30a6191085f265974b66e55bb"></a><!-- doxytag: member="Wt::WApplication::setCssTheme" ref="a316b2b30a6191085f265974b66e55bb" args="(const std::string &theme)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WApplication::setCssTheme </td>
<td>(</td>
<td class="paramtype">const std::string & </td>
<td class="paramname"> <em>theme</em> </td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Sets the theme.
<p>
The theme provides the look and feel of several built-in widgets, using CSS style rules. Rules for each theme are defined in the <code>resources/themes/</code><em>theme</em><code>/</code> folder.<p>
The default theme is "default". When setting "", the external style sheets related to the theme are not loaded.
</div>
</div><p>
<a class="anchor" name="0e09381079f67501e38652087232969d"></a><!-- doxytag: member="Wt::WApplication::cssTheme" ref="0e09381079f67501e38652087232969d" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">std::string Wt::WApplication::cssTheme </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td> const<code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns the theme.
<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WApplication.html#a316b2b30a6191085f265974b66e55bb" title="Sets the theme.">setCssTheme()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="71a3f7da5abb9a76df94fab69ba61670"></a><!-- doxytag: member="Wt::WApplication::setTitle" ref="71a3f7da5abb9a76df94fab69ba61670" args="(const WString &title)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WApplication::setTitle </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classWt_1_1WString.html">WString</a> & </td>
<td class="paramname"> <em>title</em> </td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Sets the window title.
<p>
Sets the browser window title to <code>title</code>.<p>
The default title is "".<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WApplication.html#86aefff2a3438fecdfde3e0e7dd6e5da" title="Returns the window title.">title()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="86aefff2a3438fecdfde3e0e7dd6e5da"></a><!-- doxytag: member="Wt::WApplication::title" ref="86aefff2a3438fecdfde3e0e7dd6e5da" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const <a class="el" href="classWt_1_1WString.html">WString</a>& Wt::WApplication::title </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td> const<code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns the window title.
<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WApplication.html#71a3f7da5abb9a76df94fab69ba61670" title="Sets the window title.">setTitle(const WString&)</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="a140cb3c65451413939010d704e9a58a"></a><!-- doxytag: member="Wt::WApplication::localizedStrings" ref="a140cb3c65451413939010d704e9a58a" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classWt_1_1WLocalizedStrings.html">WLocalizedStrings</a>* Wt::WApplication::localizedStrings </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns the resource object that provides localized strings.
<p>
The default value is a <a class="el" href="classWt_1_1WMessageResourceBundle.html" title="Support for localized strings using XML files.">WMessageResourceBundle</a> instance, which uses XML files to resolve localized strings, but you can set a custom class using <a class="el" href="classWt_1_1WApplication.html#1039775b5a73ff2efc34a482ebd112a8" title="Sets the resource object that provides localized strings.">setLocalizedStrings()</a>.<p>
<a class="el" href="classWt_1_1WString.html#0afc7dc0f9897456d71b569a86ca26c1" title="Creates a localized string from a key.">WString::tr()</a> is used to create localized strings, whose localized translation is looked up through this object, using a key.<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WString.html#0afc7dc0f9897456d71b569a86ca26c1" title="Creates a localized string from a key.">WString::tr()</a>, <a class="el" href="classWt_1_1WApplication.html#5386565e35a58c94ccbbfab48f2212a4" title="Returns the message resource bundle.">messageResourceBundle()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="1039775b5a73ff2efc34a482ebd112a8"></a><!-- doxytag: member="Wt::WApplication::setLocalizedStrings" ref="1039775b5a73ff2efc34a482ebd112a8" args="(WLocalizedStrings *stringResolver)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WApplication::setLocalizedStrings </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classWt_1_1WLocalizedStrings.html">WLocalizedStrings</a> * </td>
<td class="paramname"> <em>stringResolver</em> </td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Sets the resource object that provides localized strings.
<p>
The <code>translator</code> resolves localized strings within the current application locale.<p>
The previous resource is deleted, and ownership of the new resource passes to the application.<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WApplication.html#a140cb3c65451413939010d704e9a58a" title="Returns the resource object that provides localized strings.">localizedStrings()</a>, <a class="el" href="classWt_1_1WString.html#0afc7dc0f9897456d71b569a86ca26c1" title="Creates a localized string from a key.">WString::tr(const char *key)</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="5386565e35a58c94ccbbfab48f2212a4"></a><!-- doxytag: member="Wt::WApplication::messageResourceBundle" ref="5386565e35a58c94ccbbfab48f2212a4" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classWt_1_1WMessageResourceBundle.html">WMessageResourceBundle</a> & Wt::WApplication::messageResourceBundle </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns the message resource bundle.
<p>
The message resource bundle defines the list of external XML files that are used to lookup localized strings.<p>
The default <a class="el" href="classWt_1_1WApplication.html#a140cb3c65451413939010d704e9a58a" title="Returns the resource object that provides localized strings.">localizedStrings()</a> is a <a class="el" href="classWt_1_1WMessageResourceBundle.html" title="Support for localized strings using XML files.">WMessageResourceBundle</a> object, and this method returns <a class="el" href="classWt_1_1WApplication.html#a140cb3c65451413939010d704e9a58a" title="Returns the resource object that provides localized strings.">localizedStrings()</a> upcasted to this type.<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WString.html#0afc7dc0f9897456d71b569a86ca26c1" title="Creates a localized string from a key.">WString::tr(const char *key)</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="5c9cc1350019d69f154a2b44cdaf2596"></a><!-- doxytag: member="Wt::WApplication::setLocale" ref="5c9cc1350019d69f154a2b44cdaf2596" args="(const std::string &locale)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WApplication::setLocale </td>
<td>(</td>
<td class="paramtype">const std::string & </td>
<td class="paramname"> <em>locale</em> </td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Changes the locale.
<p>
The locale is used by the localized strings resource to resolve localized strings.<p>
By passing an empty <code>locale</code>, the default locale is chosen.<p>
When the locale is changed, <a class="el" href="classWt_1_1WApplication.html#02b9d8aa1b6c2d0dc9edc1b9c63f86dc" title="Refreshes the application.">refresh()</a> is called, which will resolve the strings of the current user-interface in the new locale.<p>
The default locale is copied from the environment (<a class="el" href="classWt_1_1WEnvironment.html#42b10cde31c3df634dc753b5dbd1e800" title="Returns the preferred language indicated in the request header.">WEnvironment::locale()</a>), and this is the locale that was configured by the user in his browser preferences, and passed using an HTTP request header.<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WApplication.html#a140cb3c65451413939010d704e9a58a" title="Returns the resource object that provides localized strings.">localizedStrings()</a>, <a class="el" href="classWt_1_1WString.html#0afc7dc0f9897456d71b569a86ca26c1" title="Creates a localized string from a key.">WString::tr()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="6e782f1f38a6f56e2024aab1a917a80b"></a><!-- doxytag: member="Wt::WApplication::locale" ref="6e782f1f38a6f56e2024aab1a917a80b" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">std::string Wt::WApplication::locale </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td> const<code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns the current locale.
<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WApplication.html#5c9cc1350019d69f154a2b44cdaf2596" title="Changes the locale.">setLocale(const std::string&)</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="02b9d8aa1b6c2d0dc9edc1b9c63f86dc"></a><!-- doxytag: member="Wt::WApplication::refresh" ref="02b9d8aa1b6c2d0dc9edc1b9c63f86dc" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WApplication::refresh </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Refreshes the application.
<p>
This lets the application to refresh its data, including strings from message-resource bundles. This done by propagating <a class="el" href="classWt_1_1WWidget.html#15e1efb1c2e1030a3ad9565ef7fb0e15" title="Refresh the widget.">WWidget::refresh()</a> through the widget hierarchy.<p>
This method is also called when the user hits the refresh (or reload) button, if this can be caught within the current session.<p>
The reload button may only be caught when Wt is configured so that reload should not spawn a new session. When URL rewriting is used for session tracking, this will cause an ugly session ID to be added to the URL. See <a class="el" href="overview.html#config_session">9.1 Session management (wt_config.xml)</a> for configuring the reload behavior ("<reload-is-new-session>").<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WWidget.html#15e1efb1c2e1030a3ad9565ef7fb0e15" title="Refresh the widget.">WWidget::refresh()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="ba49e1b9e696ac7244f5e2b63ca07de5"></a><!-- doxytag: member="Wt::WApplication::bindWidget" ref="ba49e1b9e696ac7244f5e2b63ca07de5" args="(WWidget *widget, const std::string &domId)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WApplication::bindWidget </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classWt_1_1WWidget.html">WWidget</a> * </td>
<td class="paramname"> <em>widget</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const std::string & </td>
<td class="paramname"> <em>domId</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Binds a top-level widget for a WidgetSet deployment.
<p>
This method binds a <code>widget</code> to an existing element with DOM id <code>domId</code> on the page. The element type should correspond with the widget type (e.g. it should be a <div> for a <a class="el" href="classWt_1_1WContainerWidget.html" title="A widget that holds and manages child widgets.">WContainerWidget</a>, or a <table> for a <a class="el" href="classWt_1_1WTable.html" title="A container widget which provides layout of children in a table grid.">WTable</a>).<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WApplication.html#17e118a04d962459484a12989a80bc05" title="Returns the root container.">root()</a> <p>
<a class="el" href="namespaceWt.html#f4b6ed5fd28b4f5fa141b153c1107349932eaa79ae0d1f31e3cb240cf5ff0826" title="Specifies an application that manages one or more widgets.">Wt::WidgetSet</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="455fe732c1dd087ed507bc5975420828"></a><!-- doxytag: member="Wt::WApplication::url" ref="455fe732c1dd087ed507bc5975420828" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">std::string Wt::WApplication::url </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns a URL for the current session.
<p>
Returns the (relative) URL for this application session (including the session ID if necessary). The URL includes the full application path, and is expanded by the browser into a full URL.<p>
For example, for an application deployed at <div class="fragment"><pre class="fragment"> http:<span class="comment">//www.mydomain.com/stuff/app.wt</span>
</pre></div> this method would return <code>"/stuff/app.wt?wtd=AbCdEf"</code>, when using URL rewriting for session-tracking or <code>"/stuff/app.wt?a=a"</code> when using cookies for session-tracking<p>
(see also <a class="el" href="overview.html#config_session">9.1 Session management (wt_config.xml)</a> for configuring the session-tracking method)<p>
. As in each case, a query is appended at the end of the URL, additional query parameters can be appended in the form of <code>"&param1=value&param2=value"</code>.<p>
To obtain a URL that is suitable for bookmarking the current application state, to be used across sessions, use <a class="el" href="classWt_1_1WApplication.html#37b4cf44f393688785ed3b34f53fead1" title="Returns a bookmarkable URL for the current internal path.">bookmarkUrl()</a> instead.<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WApplication.html#4dcbf69c8b09c301577b5b6aa8a4da18" title="Redirects the application to another location.">redirect()</a>, <a class="el" href="classWt_1_1WEnvironment.html#d798f03cb67b859cc42ed2e1ced82fcd" title="Returns the server host name that is used by the client.">WEnvironment::hostName()</a>, <a class="el" href="classWt_1_1WEnvironment.html#5dd3ea667a61c3bbc2c6e1e3a879dc2f" title="Returns the URL scheme used for the current request ("http" or "https")...">WEnvironment::urlScheme()</a> <p>
<a class="el" href="classWt_1_1WApplication.html#37b4cf44f393688785ed3b34f53fead1" title="Returns a bookmarkable URL for the current internal path.">bookmarkUrl()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="37b4cf44f393688785ed3b34f53fead1"></a><!-- doxytag: member="Wt::WApplication::bookmarkUrl" ref="37b4cf44f393688785ed3b34f53fead1" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">std::string Wt::WApplication::bookmarkUrl </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns a bookmarkable URL for the current internal path.
<p>
Is equivalent to <code>bookmarkUrl(<a class="el" href="classWt_1_1WApplication.html#ab6320ecdd0e8e4026e9ef1aca710ca5" title="Returns the current internal path.">internalPath()</a>)</code>, see <a class="el" href="classWt_1_1WApplication.html#c99ee110fd00d89de51e6e90ad166626" title="Returns a bookmarkable URL for a given internal path.">bookmarkUrl(const std::string&) const</a>.<p>
To obtain a URL that is refers to the current session of the application, use <a class="el" href="classWt_1_1WApplication.html#455fe732c1dd087ed507bc5975420828" title="Returns a URL for the current session.">url()</a> instead.<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WApplication.html#455fe732c1dd087ed507bc5975420828" title="Returns a URL for the current session.">url()</a>, <a class="el" href="classWt_1_1WApplication.html#c99ee110fd00d89de51e6e90ad166626" title="Returns a bookmarkable URL for a given internal path.">bookmarkUrl(const std::string&) const</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="c99ee110fd00d89de51e6e90ad166626"></a><!-- doxytag: member="Wt::WApplication::bookmarkUrl" ref="c99ee110fd00d89de51e6e90ad166626" args="(const std::string &internalPath) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">std::string Wt::WApplication::bookmarkUrl </td>
<td>(</td>
<td class="paramtype">const std::string & </td>
<td class="paramname"> <em>internalPath</em> </td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns a bookmarkable URL for a given internal path.
<p>
Returns the (relative) URL for this application that includes the internal path <code>internalPath</code>, usable across sessions. The URL is relative and expanded into a full URL by the browser.<p>
For example, for an application with current URL: <div class="fragment"><pre class="fragment"> http:<span class="comment">//www.mydomain.com/stuff/app.wt#/project/internal/</span>
</pre></div> when called with <code>"/project/external"</code>, this method would return:<ul>
<li><code>"app.wt/project/external/"</code> when JavaScript is available, or the agent is a web spider, or</li><li><code>"app.wt/project/external/?wtd=AbCdEf"</code> when no JavaScript is available and URL rewriting is used for session-tracking</li></ul>
<p>
(see also <a class="el" href="overview.html#config_session">9.1 Session management (wt_config.xml)</a> for configuring the session-tracking method).<p>
When the application is deployed at a folder (ending with '/'), this style of URLs is not possible, and URLs are of the form:<ul>
<li><code>"?_=/project/external/"</code> when JavaScript is available, or the agent is a web spider, or</li><li><code>"?_=/project/external/&wtd=AbCdEf"</code> when no JavaScript is available and URL rewriting is used for session-tracking.</li></ul>
<p>
You can use <a class="el" href="classWt_1_1WApplication.html#37b4cf44f393688785ed3b34f53fead1" title="Returns a bookmarkable URL for the current internal path.">bookmarkUrl()</a> as the destination for a <a class="el" href="classWt_1_1WAnchor.html" title="A widget that represents an HTML anchor (to link to other documents).">WAnchor</a>, and listen to a click event is attached to a slot that switches to the internal path <code>internalPath</code> (see <a class="el" href="classWt_1_1WAnchor.html#e3ea26646f135bf133871564f5d6798d" title="Sets the destination URL as an internal path.">WAnchor::setRefInternalPath()</a>). In this way, an anchor can be used to switch between internal paths within an application regardless of the situation (browser with or without Ajax support, or a web spider bot), but still generates suitable URLs across sessions, which can be used for bookmarking, opening in a new window/tab, or indexing.<p>
To obtain a URL that refers to the current session of the application, use <a class="el" href="classWt_1_1WApplication.html#455fe732c1dd087ed507bc5975420828" title="Returns a URL for the current session.">url()</a> instead.<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WApplication.html#455fe732c1dd087ed507bc5975420828" title="Returns a URL for the current session.">url()</a>, <a class="el" href="classWt_1_1WApplication.html#37b4cf44f393688785ed3b34f53fead1" title="Returns a bookmarkable URL for the current internal path.">bookmarkUrl()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="2c1a10aadc0d7ed877b5715b42ca4911"></a><!-- doxytag: member="Wt::WApplication::setInternalPath" ref="2c1a10aadc0d7ed877b5715b42ca4911" args="(const std::string &path, bool emitChange=false)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WApplication::setInternalPath </td>
<td>(</td>
<td class="paramtype">const std::string & </td>
<td class="paramname"> <em>path</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>emitChange</em> = <code>false</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Change the internal path.
<p>
A Wt application may manage multiple virtual paths. The virtual path is appended to the application URL. Depending on the situation, the path is directly appended to the application URL or it is appended using a name anchor (#).<p>
For example, for an application deployed at: <div class="fragment"><pre class="fragment"> http:<span class="comment">//www.mydomain.com/stuff/app.wt</span>
</pre></div> for which an <code>internalPath</code> <code>"/project/z3cbc/details/"</code> is set, the two forms for the application URL are: <ul>
<li>
in an AJAX session: <div class="fragment"><pre class="fragment"> http:<span class="comment">//www.mydomain.com/stuff/app.wt#/project/z3cbc/details/</span>
</pre></div> </li>
<li>
in a plain HTML session: <div class="fragment"><pre class="fragment"> http:<span class="comment">//www.mydomain.com/stuff/app.wt/project/z3cbc/details/</span>
</pre></div> This has as major consequence that from the browser stand point, the application now serves many different URLs. As a consequence, relative URLs will break. Still, you can specify relative URLs within your application (in for example <a class="el" href="classWt_1_1WAnchor.html#cf0206a2ac91ea67d68ba10e3a951ba3" title="Sets the destination URL.">WAnchor::setRef()</a> or <a class="el" href="classWt_1_1WImage.html#cea9ce518f4eec6b19fd4bacc44a52e8" title="Sets the image URL.">WImage::setImageRef()</a>) since Wt will transform them to absolute URLs when needed. But, this in turn may break deployments behind reverse proxies when the context paths differ. For the same reason, you will need to use absolute URLs in any XHTML or CSS you write manually. <br>
This type of URLs are only used when the your application is deployed at a location that does not end with a '/'. Otherwise, Wt will generate URLS like: <div class="fragment"><pre class="fragment"> http:<span class="comment">//www.mydomain.com/stuff/?_=/project/z3cbc/details/</span>
</pre></div> </li>
</ul>
<p>
When the internal path is changed, an entry is added to the browser history. When the user navigates back and forward through this history (using the browser back/forward buttons), an <a class="el" href="classWt_1_1WApplication.html#3e68c4b6bb387f27a614e7962e11967b" title="Signal which indicates that the user changes the internal path.">internalPathChanged()</a> event is emitted. You should listen to this signal to switch the application to the corresponding state. When <code>emitChange</code> is <code>true</code>, this signal is also emitted by setting the path.<p>
A url that includes the internal path may be obtained using <a class="el" href="classWt_1_1WApplication.html#37b4cf44f393688785ed3b34f53fead1" title="Returns a bookmarkable URL for the current internal path.">bookmarkUrl()</a>.<p>
The <code>internalPath</code> must start with a '/'. In this way, you can still use normal anchors in your HTML. Internal path changes initiated in the browser to paths that do not start with a '/' are ignored.<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WApplication.html#37b4cf44f393688785ed3b34f53fead1" title="Returns a bookmarkable URL for the current internal path.">bookmarkUrl()</a>, <a class="el" href="classWt_1_1WApplication.html#ab6320ecdd0e8e4026e9ef1aca710ca5" title="Returns the current internal path.">internalPath()</a>, <a class="el" href="classWt_1_1WApplication.html#3e68c4b6bb387f27a614e7962e11967b" title="Signal which indicates that the user changes the internal path.">internalPathChanged()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="ab6320ecdd0e8e4026e9ef1aca710ca5"></a><!-- doxytag: member="Wt::WApplication::internalPath" ref="ab6320ecdd0e8e4026e9ef1aca710ca5" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">std::string Wt::WApplication::internalPath </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns the current internal path.
<p>
When the application is just created, this is equal to <a class="el" href="classWt_1_1WEnvironment.html#cb2ba1f1f88e9cd6b7a57a2e51518ec6" title="Returns the initial internal path.">WEnvironment::internalPath()</a>.<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WApplication.html#2c1a10aadc0d7ed877b5715b42ca4911" title="Change the internal path.">setInternalPath()</a>, <a class="el" href="classWt_1_1WApplication.html#95e6b5e4dc9084d45e166264b10b3c46" title="Returns a part of the current internal path.">internalPathNextPart()</a>, <a class="el" href="classWt_1_1WApplication.html#ed54bd83339bc80b3cffba9067ab1e39" title="Checks if the internal path matches a given path.">internalPathMatches()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="95e6b5e4dc9084d45e166264b10b3c46"></a><!-- doxytag: member="Wt::WApplication::internalPathNextPart" ref="95e6b5e4dc9084d45e166264b10b3c46" args="(const std::string &path) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">std::string Wt::WApplication::internalPathNextPart </td>
<td>(</td>
<td class="paramtype">const std::string & </td>
<td class="paramname"> <em>path</em> </td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns a part of the current internal path.
<p>
This is a convenience method which returns the next <code>folder</code> in the internal path, after the given <code>path</code>.<p>
For example, when the current internal path is <code>"/project/z3cbc/details"</code>, this method returns <code>"details"</code> when called with <code>"/project/z3cbc/"</code> as <code>path</code> argument.<p>
The <code>path</code> must start with a '/', and <a class="el" href="classWt_1_1WApplication.html#ed54bd83339bc80b3cffba9067ab1e39" title="Checks if the internal path matches a given path.">internalPathMatches()</a> should evaluate to <code>true</code> for the given <code>path</code>. If not, an empty string is returned and an error message is logged.<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WApplication.html#ab6320ecdd0e8e4026e9ef1aca710ca5" title="Returns the current internal path.">internalPath()</a>, <a class="el" href="classWt_1_1WApplication.html#3e68c4b6bb387f27a614e7962e11967b" title="Signal which indicates that the user changes the internal path.">internalPathChanged()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="ed54bd83339bc80b3cffba9067ab1e39"></a><!-- doxytag: member="Wt::WApplication::internalPathMatches" ref="ed54bd83339bc80b3cffba9067ab1e39" args="(const std::string &path) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Wt::WApplication::internalPathMatches </td>
<td>(</td>
<td class="paramtype">const std::string & </td>
<td class="paramname"> <em>path</em> </td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Checks if the internal path matches a given path.
<p>
Returns whether the current <a class="el" href="classWt_1_1WApplication.html#ab6320ecdd0e8e4026e9ef1aca710ca5" title="Returns the current internal path.">internalPath()</a> starts with <code>path</code> (or is equal to <code>path</code>). You will typically use this method within a slot conneted to the <a class="el" href="classWt_1_1WApplication.html#3e68c4b6bb387f27a614e7962e11967b" title="Signal which indicates that the user changes the internal path.">internalPathChanged()</a> signal, to check that an internal path change affects the widget. It may also be useful before changing <code>path</code> using <a class="el" href="classWt_1_1WApplication.html#2c1a10aadc0d7ed877b5715b42ca4911" title="Change the internal path.">setInternalPath()</a> if you do not intend to remove sub paths when the current internal path already matches <code>path</code>.<p>
The <code>path</code> must start with a '/'.<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WApplication.html#2c1a10aadc0d7ed877b5715b42ca4911" title="Change the internal path.">setInternalPath()</a>, <a class="el" href="classWt_1_1WApplication.html#ab6320ecdd0e8e4026e9ef1aca710ca5" title="Returns the current internal path.">internalPath()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="3e68c4b6bb387f27a614e7962e11967b"></a><!-- doxytag: member="Wt::WApplication::internalPathChanged" ref="3e68c4b6bb387f27a614e7962e11967b" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classWt_1_1Signal.html">Signal</a><std::string>& Wt::WApplication::internalPathChanged </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Signal which indicates that the user changes the internal path.
<p>
This signal indicates a change to the internal path, which is usually triggered by the user using the browser back/forward buttons.<p>
The argument contains the new internal path.<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WApplication.html#2c1a10aadc0d7ed877b5715b42ca4911" title="Change the internal path.">setInternalPath()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="4dcbf69c8b09c301577b5b6aa8a4da18"></a><!-- doxytag: member="Wt::WApplication::redirect" ref="4dcbf69c8b09c301577b5b6aa8a4da18" args="(const std::string &url)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WApplication::redirect </td>
<td>(</td>
<td class="paramtype">const std::string & </td>
<td class="paramname"> <em>url</em> </td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Redirects the application to another location.
<p>
The client will be redirected to a new location identified by <code>url</code>. Use this in conjunction with <a class="el" href="classWt_1_1WApplication.html#5231d54ed34982f4366058eb6440c8f7" title="Quits the application.">quit()</a> if you want to the application to be terminated as well.<p>
Calling redirect() does not imply quit() since it may be useful to switch between a non-secure and secure (SSL) transport connection.
</div>
</div><p>
<a class="anchor" name="b55c625a3197fec416544be8ad1529af"></a><!-- doxytag: member="Wt::WApplication::sessionId" ref="b55c625a3197fec416544be8ad1529af" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">std::string Wt::WApplication::sessionId </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns the unique identifier for the current session.
<p>
The session id is a string that uniquely identifies the current session. Note that the actual contents has no particular meaning and client applications should in no way try to interpret its value.
</div>
</div><p>
<a class="anchor" name="d9631ca64e68d30d40cb49c90e55223d"></a><!-- doxytag: member="Wt::WApplication::enableUpdates" ref="d9631ca64e68d30d40cb49c90e55223d" args="(bool enabled=true)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WApplication::enableUpdates </td>
<td>(</td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>enabled</em> = <code>true</code> </td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Enables server-initiated updates.
<p>
By default, updates to the user interface are possible only at startup, during any event (in a slot), or at regular time points using <a class="el" href="classWt_1_1WTimer.html" title="A utility class which provides timer signals and single-shot timers.">WTimer</a>. This is the normal Wt event loop.<p>
In some cases, one may want to modify the user interface from a second thread, outside the event loop. While this may be worked around by the <a class="el" href="classWt_1_1WTimer.html" title="A utility class which provides timer signals and single-shot timers.">WTimer</a>, in some cases, there are bandwidth and processing overheads associated which may be unnecessary, and which create a trade-off with time resolution of the updates.<p>
When <code>enabled</code> is <code>true</code>, this enables "server push" (what is called 'comet' in AJAX terminology). Widgets may then be modified, created or deleted outside of the event loop (e.g. in response to execution of another thread), and these changes are propagated by calling <a class="el" href="classWt_1_1WApplication.html#51f50e0641a6d702a7c6ab7f8dd5946a" title="Propagates server-initiated updates.">triggerUpdate()</a>.<p>
Note that you need to grab the application's update lock to avoid concurrency problems, whenever you modify the application's state from another thread.<p>
An example of how to modify the widget tree outside the event loop and propagate changes is:<p>
<div class="fragment"><pre class="fragment"> <span class="comment">// You need to have a reference to the application whose state</span>
<span class="comment">// you are about to manipulate.</span>
<span class="comment">// You should prevent the application from being deleted somehow,</span>
<span class="comment">// before you could grab the application lock.</span>
<a class="code" href="classWt_1_1WApplication.html" title="Represents an application instance for a single session.">Wt::WApplication</a> *app = ...;
{
<span class="comment">// Grab the application lock. It is a scoped lock.</span>
<a class="code" href="classWt_1_1WApplication_1_1UpdateLock.html" title="A synchronisation lock for manipulating and updating the application and its widgets...">Wt::WApplication::UpdateLock</a> lock = app-><a class="code" href="classWt_1_1WApplication.html#c7582c37defc49b5e8d6ccbda3b68d45" title="Grabs and returns the lock for manipulating widgets outside the event loop.">getUpdateLock</a>();
<span class="comment">// We now have exclusive access to the application: we can safely modify the widget tree for example.</span>
app-><a class="code" href="classWt_1_1WApplication.html#17e118a04d962459484a12989a80bc05" title="Returns the root container.">root</a>()->addWidget(<span class="keyword">new</span> <a class="code" href="classWt_1_1WText.html" title="A widget that renders (XHTML) text.">Wt::WText</a>(<span class="stringliteral">"Something happened!"</span>));
<span class="comment">// Push the changes to the browser</span>
app-><a class="code" href="classWt_1_1WApplication.html#51f50e0641a6d702a7c6ab7f8dd5946a" title="Propagates server-initiated updates.">triggerUpdate</a>();
}
</pre></div><p>
<dl class="note" compact><dt><b>Note:</b></dt><dd>This works only if JavaScript is available on the client.</dd></dl>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WApplication.html#51f50e0641a6d702a7c6ab7f8dd5946a" title="Propagates server-initiated updates.">triggerUpdate()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="5a8e6970e9123fb1c23aa43711093135"></a><!-- doxytag: member="Wt::WApplication::updatesEnabled" ref="5a8e6970e9123fb1c23aa43711093135" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Wt::WApplication::updatesEnabled </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td> const<code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns whether server-initiated updates are enabled.
<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WApplication.html#d9631ca64e68d30d40cb49c90e55223d" title="Enables server-initiated updates.">enableUpdates()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="51f50e0641a6d702a7c6ab7f8dd5946a"></a><!-- doxytag: member="Wt::WApplication::triggerUpdate" ref="51f50e0641a6d702a7c6ab7f8dd5946a" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WApplication::triggerUpdate </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Propagates server-initiated updates.
<p>
Propagate changes made to the user interface outside of the main event loop. This is only possible after a call to <a class="el" href="classWt_1_1WApplication.html#d9631ca64e68d30d40cb49c90e55223d" title="Enables server-initiated updates.">enableUpdates()</a>, and must be done while holding the <a class="el" href="classWt_1_1WApplication_1_1UpdateLock.html" title="A synchronisation lock for manipulating and updating the application and its widgets...">UpdateLock</a> (or from within a socket event, see <a class="el" href="classWt_1_1WSocketNotifier.html" title="A utility class for asynchronous notification of socket activity.">WSocketNotifier</a>).<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WApplication.html#d9631ca64e68d30d40cb49c90e55223d" title="Enables server-initiated updates.">enableUpdates()</a>, <a class="el" href="classWt_1_1WApplication.html#c7582c37defc49b5e8d6ccbda3b68d45" title="Grabs and returns the lock for manipulating widgets outside the event loop.">getUpdateLock()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="c7582c37defc49b5e8d6ccbda3b68d45"></a><!-- doxytag: member="Wt::WApplication::getUpdateLock" ref="c7582c37defc49b5e8d6ccbda3b68d45" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classWt_1_1WApplication_1_1UpdateLock.html">WApplication::UpdateLock</a> Wt::WApplication::getUpdateLock </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Grabs and returns the lock for manipulating widgets outside the event loop.
<p>
You need to keep this lock in scope while manipulating widgets outside of the event loop. In normal cases, inside the Wt event loop, you do not need to care about it.<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WApplication.html#d9631ca64e68d30d40cb49c90e55223d" title="Enables server-initiated updates.">enableUpdates()</a>, <a class="el" href="classWt_1_1WApplication.html#51f50e0641a6d702a7c6ab7f8dd5946a" title="Propagates server-initiated updates.">triggerUpdate()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="8b03a693a8277b7d5e0775a9b9581803"></a><!-- doxytag: member="Wt::WApplication::attachThread" ref="8b03a693a8277b7d5e0775a9b9581803" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WApplication::attachThread </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Attach an auxiliary thread to this application.
<p>
In a multi-threaded environment, <a class="el" href="classWt_1_1WApplication.html#38d922da0a0d83395519f3eaab85d0f6" title="Returns the current application instance.">WApplication::instance()</a> uses thread-local data to retrieve the application object that corresponds to the session currently being handled by the thread. This is set automatically by the library whenever an event is delivered to the application, or when you use the <a class="el" href="classWt_1_1WApplication.html#c7582c37defc49b5e8d6ccbda3b68d45" title="Grabs and returns the lock for manipulating widgets outside the event loop.">getUpdateLock()</a> to modify the application from an auxiliary thread outside the normal event loop.<p>
When you want to manipulate the widget tree inside the main event loop, but from within an auxiliary thread, then you cannot use the <a class="el" href="classWt_1_1WApplication.html#c7582c37defc49b5e8d6ccbda3b68d45" title="Grabs and returns the lock for manipulating widgets outside the event loop.">getUpdateLock()</a> since this will create an immediate dead lock. Instead, you may attach the auxiliary thread to the application, by calling this method from the auxiliary thread, and in this way you can modify the application from within that thread without needing the update lock.
</div>
</div><p>
<a class="anchor" name="2a92457b9212cef4057cb54e56183967"></a><!-- doxytag: member="Wt::WApplication::doJavaScript" ref="2a92457b9212cef4057cb54e56183967" args="(const std::string &javascript, bool afterLoaded=true)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WApplication::doJavaScript </td>
<td>(</td>
<td class="paramtype">const std::string & </td>
<td class="paramname"> <em>javascript</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>afterLoaded</em> = <code>true</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Executes some JavaScript code.
<p>
This method may be used to call some custom <code>javaScript</code> code as part of an event response.<p>
This function does not wait until the JavaScript is run, but returns immediately. The JavaScript will be run after the normal event handling, unless <code>afterLoaded</code> is set to <code>false</code>.<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WApplication.html#412bcf9c269b097e7c372515e27b88ba" title="Adds JavaScript statements that should be run continuously.">addAutoJavaScript()</a>, <a class="el" href="classWt_1_1WApplication.html#3456e2bd2eec561abb90ae19ae42be02" title="Declares an application-wide JavaScript function.">declareJavaScriptFunction()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="412bcf9c269b097e7c372515e27b88ba"></a><!-- doxytag: member="Wt::WApplication::addAutoJavaScript" ref="412bcf9c269b097e7c372515e27b88ba" args="(const std::string &javascript)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WApplication::addAutoJavaScript </td>
<td>(</td>
<td class="paramtype">const std::string & </td>
<td class="paramname"> <em>javascript</em> </td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Adds JavaScript statements that should be run continuously.
<p>
This is an internal method.<p>
It is used by for example layout managers to adjust the layout whenever the DOM tree is manipulated.<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WApplication.html#2a92457b9212cef4057cb54e56183967" title="Executes some JavaScript code.">doJavaScript()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="3456e2bd2eec561abb90ae19ae42be02"></a><!-- doxytag: member="Wt::WApplication::declareJavaScriptFunction" ref="3456e2bd2eec561abb90ae19ae42be02" args="(const std::string &name, const std::string &function)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WApplication::declareJavaScriptFunction </td>
<td>(</td>
<td class="paramtype">const std::string & </td>
<td class="paramname"> <em>name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const std::string & </td>
<td class="paramname"> <em>function</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Declares an application-wide JavaScript function.
<p>
This is an internal method.
</div>
</div><p>
<a class="anchor" name="e88546224ed32cade783da188b145138"></a><!-- doxytag: member="Wt::WApplication::require" ref="e88546224ed32cade783da188b145138" args="(const std::string &url, const std::string &symbol=std::string())" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Wt::WApplication::require </td>
<td>(</td>
<td class="paramtype">const std::string & </td>
<td class="paramname"> <em>url</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const std::string & </td>
<td class="paramname"> <em>symbol</em> = <code>std::string()</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Loads a JavaScript library.
<p>
Loads a JavaScript library located at the URL <code>url</code>. Wt keeps track of libraries (with the same URL) that already have been loaded, and will load a library only once. In addition, you may provide a <code>symbol</code> which if already defined will also indicate that the library was already loaded (possibly outside of Wt when in WidgetSet mode).<p>
This method returns <code>true</code> only when the library is loaded for the first time.<p>
JavaScript libraries may be loaded at any point in time. Any JavaScript code is deferred until the library is loaded, except for JavaScript that was defined to load before, passing <code>false</code> as second parameter to <a class="el" href="classWt_1_1WApplication.html#2a92457b9212cef4057cb54e56183967" title="Executes some JavaScript code.">doJavaScript()</a>.
</div>
</div><p>
<a class="anchor" name="48ceb7972ef7ec0e557adf441f660f2f"></a><!-- doxytag: member="Wt::WApplication::processEvents" ref="48ceb7972ef7ec0e557adf441f660f2f" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WApplication::processEvents </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Processes UI events.
<p>
You may call this method during a long operation to:<ul>
<li>propagate widget changes to the client.</li><li>process UI events.</li></ul>
<p>
This method starts a recursive event loop, blocking the current thread, and resumes when all pending user interface events have been processed.<p>
Because a thread is blocked, this may affect your application scalability.
</div>
</div><p>
<a class="anchor" name="c0f5599ed35eb159fa6912aa0ff3c75c"></a><!-- doxytag: member="Wt::WApplication::readConfigurationProperty" ref="c0f5599ed35eb159fa6912aa0ff3c75c" args="(const std::string &name, std::string &value)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Wt::WApplication::readConfigurationProperty </td>
<td>(</td>
<td class="paramtype">const std::string & </td>
<td class="paramname"> <em>name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">std::string & </td>
<td class="paramname"> <em>value</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Reads a configuration property.
<p>
Tries to read a configured value for the property <code>name</code>. The method returns whether a value is defined for the property, and sets it to <code>value</code>.
</div>
</div><p>
<a class="anchor" name="f2b590f865a4a6a6b144c45682b4bc1a"></a><!-- doxytag: member="Wt::WApplication::setAjaxMethod" ref="f2b590f865a4a6a6b144c45682b4bc1a" args="(AjaxMethod method)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WApplication::setAjaxMethod </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classWt_1_1WApplication.html#102e3adfb4eb058288861c06dfd6a12a">AjaxMethod</a> </td>
<td class="paramname"> <em>method</em> </td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Sets the Ajax communication method.
<p>
You may change the communication method only from within the application constructor.<p>
The default method depends on your application deployment type.<p>
For <a class="el" href="namespaceWt.html#f4b6ed5fd28b4f5fa141b153c11073496688bf68bd3aeee4cca7e75a68dee7f1">plain</a> applications, <a class="el" href="classWt_1_1WApplication.html#102e3adfb4eb058288861c06dfd6a12a9dc5b270e2b5c180556fb688cd8f06c2">XMLHttpRequest</a> is used, while for <a class="el" href="namespaceWt.html#f4b6ed5fd28b4f5fa141b153c1107349932eaa79ae0d1f31e3cb240cf5ff0826">widget set</a> applications, <a class="el" href="classWt_1_1WApplication.html#102e3adfb4eb058288861c06dfd6a12a66ad42375422870da68e3666a1712d39">DynamicScriptTag</a> is used. The latter is less efficient, but has the benefit to allow serving the application from a different server than the page that hosts the embedded widgets.
</div>
</div><p>
<a class="anchor" name="10cd5e55a610b7f6587c881a2c35188c"></a><!-- doxytag: member="Wt::WApplication::ajaxMethod" ref="10cd5e55a610b7f6587c881a2c35188c" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classWt_1_1WApplication.html#102e3adfb4eb058288861c06dfd6a12a">AjaxMethod</a> Wt::WApplication::ajaxMethod </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td> const<code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns the Ajax communication method.
<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WApplication.html#f2b590f865a4a6a6b144c45682b4bc1a" title="Sets the Ajax communication method.">setAjaxMethod()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="6e0963307eb9367a3a4a3f4e35ae3abe"></a><!-- doxytag: member="Wt::WApplication::javaScriptClass" ref="6e0963307eb9367a3a4a3f4e35ae3abe" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">std::string Wt::WApplication::javaScriptClass </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns the name of the application JavaScript class.
<p>
This JavaScript class encapsulates all JavaScript methods specific to this application instance. The method is foreseen to allow multiple applications to run simultaneously on the same page in WidgtSet mode, without interfering.
</div>
</div><p>
<a class="anchor" name="c0fa2857a600cc34b3443a04d9ed5c5c"></a><!-- doxytag: member="Wt::WApplication::resourcesUrl" ref="c0fa2857a600cc34b3443a04d9ed5c5c" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">std::string Wt::WApplication::resourcesUrl </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns the URL at which the resources are deployed.
<p>
This returns the value of the 'resources' property set in the configuration file.
</div>
</div><p>
<a class="anchor" name="42fc7f65116073d4032573f1e42c1173"></a><!-- doxytag: member="Wt::WApplication::initialize" ref="42fc7f65116073d4032573f1e42c1173" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WApplication::initialize </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Initializes the application, post-construction.
<p>
This method is invoked by the Wt library after construction of a new application. You may reimplement this method to do additional initialization that is not possible from the constructor (e.g. which uses virtual methods).
</div>
</div><p>
<a class="anchor" name="10317a8a50dc95db9b27ad54409ab39f"></a><!-- doxytag: member="Wt::WApplication::finalize" ref="10317a8a50dc95db9b27ad54409ab39f" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WApplication::finalize </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Finalizes the application, pre-destruction.
<p>
This method is invoked by the Wt library before destruction of a new application. You may reimplement this method to do additional finalization that is not possible from the destructor (e.g. which uses virtual methods).
</div>
</div><p>
<a class="anchor" name="63d991e268c9af8898329217a1242563"></a><!-- doxytag: member="Wt::WApplication::setTwoPhaseRenderingThreshold" ref="63d991e268c9af8898329217a1242563" args="(int size)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WApplication::setTwoPhaseRenderingThreshold </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"> <em>size</em> </td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Changes the threshold for two-phase rendering.
<p>
This changes the threshold for the <code>size</code> of a JavaScript response (in bytes) to render invisible changes in one go. If the bandwidth for rendering the invisible changes exceed the threshold, they will be fetched in a second communication, after the visible changes have been rendered.<p>
The value is a trade-off: setting it smaller will always use two-phase rendering, increasing the total render time but reducing the latency for the visible changes. Setting it too large will increase the latency to render the visible changes, since first also all invisible changes need to be computed and received in the browser.<p>
The initial value is read from the configuration file, see <a class="el" href="overview.html#config_general">9.2 General application settings (wt_config.xml)</a>.
</div>
</div><p>
<a class="anchor" name="0aa2703da36531cf1773d3e756791bf6"></a><!-- doxytag: member="Wt::WApplication::setCookie" ref="0aa2703da36531cf1773d3e756791bf6" args="(const std::string &name, const std::string &value, int maxAge, const std::string &domain="", const std::string &path="")" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WApplication::setCookie </td>
<td>(</td>
<td class="paramtype">const std::string & </td>
<td class="paramname"> <em>name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const std::string & </td>
<td class="paramname"> <em>value</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>maxAge</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const std::string & </td>
<td class="paramname"> <em>domain</em> = <code>""</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const std::string & </td>
<td class="paramname"> <em>path</em> = <code>""</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Sets a new cookie.
<p>
Use cookies to transfer information across different sessions (e.g. a user name). In a subsequent session you will be able to read this cookie using <a class="el" href="classWt_1_1WEnvironment.html#f39745ca2c6c6fc00c0f78bc7d064e3a" title="Checks for existence and returns specified argument.">WEnvironment::getCookie()</a>. You cannot use a cookie to store information in the current session.<p>
The name must be a valid cookie name (of type 'token': no special characters or separators, see RFC2616 page 16). The value may be anything. Specify the maximum age (in seconds) after which the client must discard the cookie. To delete a cookie, use a value of '0'.<p>
By default the cookie only applies to the current path on the current domain. To set a proper value for domain, see also RFC2109.<p>
<dl class="note" compact><dt><b>Note:</b></dt><dd>Wt provides session tracking automatically, and may be configured to use a cookie for this. You only need to use cookies yourself if you want to remember information <em>across sessions</em>.</dd></dl>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WEnvironment.html#bf06c6d85be1b482c037f80e63890f3a" title="Returns whether the browser has enabled support for cookies.">WEnvironment::supportsCookies()</a>, <a class="el" href="classWt_1_1WEnvironment.html#f39745ca2c6c6fc00c0f78bc7d064e3a" title="Checks for existence and returns specified argument.">WEnvironment::getCookie()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="781ae50d1941783913de98d4d4d08a97"></a><!-- doxytag: member="Wt::WApplication::maximumRequestSize" ref="781ae50d1941783913de98d4d4d08a97" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int Wt::WApplication::maximumRequestSize </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns the current maximum size of a request to the application.
<p>
The maximum request size is configured in the configuration file, see <a class="el" href="overview.html#config_general">9.2 General application settings (wt_config.xml)</a>.<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WApplication.html#ef3a8fa2a7825ed7439707d8a90b08aa" title="Signal which indicates that too a large request was received.">requestTooLarge()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="75067771ba8fcc56e174f2e741ce278f"></a><!-- doxytag: member="Wt::WApplication::log" ref="75067771ba8fcc56e174f2e741ce278f" args="(const std::string &type) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classWt_1_1WLogEntry.html">WLogEntry</a> Wt::WApplication::log </td>
<td>(</td>
<td class="paramtype">const std::string & </td>
<td class="paramname"> <em>type</em> </td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Adds an entry to the application log.
<p>
Starts a new log entry of the given <code>type</code> in the Wt application log file. This method returns a stream-like object to which the message may be streamed.<p>
A typical usage would be: <div class="fragment"><pre class="fragment"> wApp->log(<span class="stringliteral">"notice"</span>) << <span class="stringliteral">"User "</span> << userName << <span class="stringliteral">" logged in successfully."</span>;
</pre></div><p>
This would create a log entry that looks like: <div class="fragment"><pre class="fragment">
[2008-Jul-13 14:01:17.817348] 16879 [/app.wt Z2gCmSxIGjLHD73L] [notice] "User bart logged in successfully." </pre></div><p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="overview.html#config_general">9.2 General application settings (wt_config.xml)</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="080d01aa8e92ae57ef9c9491d33a7fca"></a><!-- doxytag: member="Wt::WApplication::setLoadingIndicator" ref="080d01aa8e92ae57ef9c9491d33a7fca" args="(WLoadingIndicator *indicator)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WApplication::setLoadingIndicator </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classWt_1_1WLoadingIndicator.html">WLoadingIndicator</a> * </td>
<td class="paramname"> <em>indicator</em> </td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Sets the loading indicator.
<p>
The loading indicator is shown to indicate that a response from the server is pending or JavaScript is being evaluated.<p>
The default loading indicator is a <a class="el" href="classWt_1_1WDefaultLoadingIndicator.html" title="A default loading indicator.">WDefaultLoadingIndicator</a>.<p>
When setting a new loading indicator, the previous one is deleted.
</div>
</div><p>
<a class="anchor" name="435c81aaee5f9d0993b329d2541ee21a"></a><!-- doxytag: member="Wt::WApplication::loadingIndicator" ref="435c81aaee5f9d0993b329d2541ee21a" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classWt_1_1WLoadingIndicator.html">WLoadingIndicator</a>* Wt::WApplication::loadingIndicator </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td> const<code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns the loading indicator.
<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WApplication.html#080d01aa8e92ae57ef9c9491d33a7fca" title="Sets the loading indicator.">setLoadingIndicator()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="5231d54ed34982f4366058eb6440c8f7"></a><!-- doxytag: member="Wt::WApplication::quit" ref="5231d54ed34982f4366058eb6440c8f7" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WApplication::quit </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Quits the application.
<p>
The method returns immediately, but has as effect that the application will be terminated after the current event is completed.<p>
The current widget tree (including any modifications still pending and applied during the current event handling) will still be rendered, after which the application is terminated.<p>
You might want to make sure no more events can be received from the user, by not having anything clickable, for example by displaying only text. Even better is to <a class="el" href="classWt_1_1WApplication.html#4dcbf69c8b09c301577b5b6aa8a4da18" title="Redirects the application to another location.">redirect()</a> the user to another, static, page in conjunction with quit().<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WApplication.html#4dcbf69c8b09c301577b5b6aa8a4da18" title="Redirects the application to another location.">redirect()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="ca61c7262e83de25c276021b26b53074"></a><!-- doxytag: member="Wt::WApplication::isQuited" ref="ca61c7262e83de25c276021b26b53074" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Wt::WApplication::isQuited </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td> const<code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns whether the application is quited.
<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WApplication.html#5231d54ed34982f4366058eb6440c8f7" title="Quits the application.">quit()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="ef3a8fa2a7825ed7439707d8a90b08aa"></a><!-- doxytag: member="Wt::WApplication::requestTooLarge" ref="ef3a8fa2a7825ed7439707d8a90b08aa" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classWt_1_1Signal.html">Signal</a><int>& Wt::WApplication::requestTooLarge </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Signal which indicates that too a large request was received.
<p>
The integer parameter is the request size that was received in bytes.
</div>
</div><p>
<a class="anchor" name="a8fe83406981a556da61a843bb691674"></a><!-- doxytag: member="Wt::WApplication::setBodyClass" ref="a8fe83406981a556da61a843bb691674" args="(const std::string &styleClass)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WApplication::setBodyClass </td>
<td>(</td>
<td class="paramtype">const std::string & </td>
<td class="paramname"> <em>styleClass</em> </td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Sets a style class to the entire page <body>.
<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WApplication.html#28867ea48711f9290de496c2ed42fdbf" title="Sets a style class to the entire page <html>.">setHtmlClass()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="4e87d8f55211eb7f2fcea01ad956ea63"></a><!-- doxytag: member="Wt::WApplication::bodyClass" ref="4e87d8f55211eb7f2fcea01ad956ea63" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">std::string Wt::WApplication::bodyClass </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td> const<code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns the style class set for the entire page <body>.
<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WApplication.html#a8fe83406981a556da61a843bb691674" title="Sets a style class to the entire page <body>.">setBodyClass()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="28867ea48711f9290de496c2ed42fdbf"></a><!-- doxytag: member="Wt::WApplication::setHtmlClass" ref="28867ea48711f9290de496c2ed42fdbf" args="(const std::string &styleClass)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WApplication::setHtmlClass </td>
<td>(</td>
<td class="paramtype">const std::string & </td>
<td class="paramname"> <em>styleClass</em> </td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Sets a style class to the entire page <html>.
<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WApplication.html#a8fe83406981a556da61a843bb691674" title="Sets a style class to the entire page <body>.">setBodyClass()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="1324d7dd9b83e075d78a65ca8cde8c9b"></a><!-- doxytag: member="Wt::WApplication::htmlClass" ref="1324d7dd9b83e075d78a65ca8cde8c9b" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">std::string Wt::WApplication::htmlClass </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td> const<code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns the style class set for the entire page <html>.
<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WApplication.html#28867ea48711f9290de496c2ed42fdbf" title="Sets a style class to the entire page <html>.">setHtmlClass()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="0a9652fc0d0cbebca7966f98454b078a"></a><!-- doxytag: member="Wt::WApplication::globalKeyWentDown" ref="0a9652fc0d0cbebca7966f98454b078a" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classWt_1_1EventSignal.html">EventSignal</a>< <a class="el" href="classWt_1_1WKeyEvent.html">WKeyEvent</a> > & Wt::WApplication::globalKeyWentDown </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Event signal emitted when a keyboard key is pushed down.
<p>
The application receives key events when no widget currently has focus. Otherwise, key events are handled by the widget in focus, and its ancestors.<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd>See <a class="el" href="classWt_1_1WInteractWidget.html#8669f2d35aad5091837b97bd00f25223" title="Event signal emitted when a keyboard key is pushed down.">WInteractWidget::keyWentDown()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="7d8f807eee7191ae6b7f6f7fe2ab2fae"></a><!-- doxytag: member="Wt::WApplication::globalKeyPressed" ref="7d8f807eee7191ae6b7f6f7fe2ab2fae" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classWt_1_1EventSignal.html">EventSignal</a>< <a class="el" href="classWt_1_1WKeyEvent.html">WKeyEvent</a> > & Wt::WApplication::globalKeyPressed </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Event signal emitted when a "character" was entered.
<p>
The application receives key events when no widget currently has focus. Otherwise, key events are handled by the widget in focus, and its ancestors.<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd>See <a class="el" href="classWt_1_1WInteractWidget.html#6d4c957a92eb6ffec59a638dd384c6c9" title="Event signal emitted when a "character" was entered.">WInteractWidget::keyPressed()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="a2a569eabc35162f4b2a72c36a24cd80"></a><!-- doxytag: member="Wt::WApplication::globalKeyWentUp" ref="a2a569eabc35162f4b2a72c36a24cd80" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classWt_1_1EventSignal.html">EventSignal</a>< <a class="el" href="classWt_1_1WKeyEvent.html">WKeyEvent</a> > & Wt::WApplication::globalKeyWentUp </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Event signal emitted when a keyboard key is released.
<p>
The application receives key events when no widget currently has focus. Otherwise, key events are handled by the widget in focus, and its ancestors.<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd>See <a class="el" href="classWt_1_1WInteractWidget.html#7602bfbe38090d4acca674afc02f15c8" title="Event signal emitted when a keyboard key is released.">WInteractWidget::keyWentUp()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="60c1defb57949f6f78c6c1373a18e74e"></a><!-- doxytag: member="Wt::WApplication::globalEnterPressed" ref="60c1defb57949f6f78c6c1373a18e74e" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classWt_1_1EventSignal.html">EventSignal</a> & Wt::WApplication::globalEnterPressed </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Event signal emitted when enter was pressed.
<p>
The application receives key events when no widget currently has focus. Otherwise, key events are handled by the widget in focus, and its ancestors.<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd>See <a class="el" href="classWt_1_1WInteractWidget.html#38f06d1ad95e7599b055f49931236c10" title="Event signal emitted when enter was pressed.">WInteractWidget::enterPressed()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="b4d42f698c48bf84fcc807cb597a0509"></a><!-- doxytag: member="Wt::WApplication::globalEscapePressed" ref="b4d42f698c48bf84fcc807cb597a0509" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classWt_1_1EventSignal.html">EventSignal</a> & Wt::WApplication::globalEscapePressed </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Event signal emitted when escape was pressed.
<p>
The application receives key events when no widget currently has focus. Otherwise, key events are handled by the widget in focus, and its ancestors.<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd>See <a class="el" href="classWt_1_1WInteractWidget.html#b581bba7f0ce02380e9339198bac2f78" title="Event signal emitted when escape was pressed.">WInteractWidget::escapePressed()</a> </dd></dl>
</div>
</div><p>
<a class="anchor" name="4a6f167bea94aefa8ba24f914c2fbee5"></a><!-- doxytag: member="Wt::WApplication::notify" ref="4a6f167bea94aefa8ba24f914c2fbee5" args="(const WEvent &e)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WApplication::notify </td>
<td>(</td>
<td class="paramtype">const WEvent & </td>
<td class="paramname"> <em>e</em> </td>
<td> ) </td>
<td><code> [protected, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Notifies an event to the application.
<p>
This method is called by the event loop for propagating an event to the application. It provides a single point of entry for events to the application, besides the application constructor.<p>
You may want to reimplement this method for two reasons:<p>
<ul>
<li>for having a single point for exception handling: while you may want to catch recoverable exceptions in a more appropriate place, general (usually fatal) exceptions may be caught here. You will in probably also want to catch the same exceptions in the application constructor in the same way.</li><li>you want to manage resource usage during requests. For example, at the end of request handling, you want to return a database session back to the pool. Since notify() is also used for rendering right after the application is created, this will also clean up resources after application construction.</li></ul>
<p>
In either case, you will need to call the base class implementation of notify(), as otherwise no events will be delivered to your application.<p>
The following shows a generic template for reimplementhing this method for both managing request resources and generic exception handling.<p>
<div class="fragment"><pre class="fragment"> MyApplication::notify(<span class="keyword">const</span> WEvent& event)
{
<span class="comment">// Grab resources for during request handling</span>
<span class="keywordflow">try</span> {
WApplication::notify(event);
} <span class="keywordflow">catch</span> (MyException& exception) {
<span class="comment">// handle this exception in a central place</span>
}
<span class="comment">// Free resources used during request handling</span>
}
</pre></div><p>
Note that any uncaught exception throw during event handling terminates the session.
</div>
</div><p>
<a class="anchor" name="17e25e84fab304664baab5b0c748b802"></a><!-- doxytag: member="Wt::WApplication::isExposed" ref="17e25e84fab304664baab5b0c748b802" args="(WWidget *w) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Wt::WApplication::isExposed </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classWt_1_1WWidget.html">WWidget</a> * </td>
<td class="paramname"> <em>w</em> </td>
<td> ) </td>
<td> const<code> [protected, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns whether a widget is exposed in the interface.
<p>
The default implementation simply returns <code>true</code>, unless a modal dialog is active, in which case it returns <code>true</code> only for widgets that are inside the dialog.<p>
You may want to reimplement this method if you wish to disallow events from certain widgets even when they are inserted in the widget hierachy.
</div>
</div><p>
<a class="anchor" name="78016406c4746c56b2c2ffce7c5e181f"></a><!-- doxytag: member="Wt::WApplication::enableAjax" ref="78016406c4746c56b2c2ffce7c5e181f" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Wt::WApplication::enableAjax </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td><code> [protected, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Progresses to an Ajax-enabled user interface.
<p>
This method is called when the progressive bootstrap method is used, and support for AJAX has been detected. The default behavior will propagate the <a class="el" href="classWt_1_1WWidget.html#919a4eaf68ff52f06f6a726d55dfb768" title="Progresses to an Ajax-enabled widget.">WWidget::enableAjax()</a> method through the widget hierarchy.<p>
You may want to reimplement this method if you want to make changes to the user-interface when AJAX is enabled. You should always call the base implementation.<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WWidget.html#919a4eaf68ff52f06f6a726d55dfb768" title="Progresses to an Ajax-enabled widget.">WWidget::enableAjax()</a> </dd></dl>
</div>
</div><p>
<hr><h2>Friends And Related Function Documentation</h2>
<a class="anchor" name="aa9f20bdeb8ebcbb3ec5d633b010511f"></a><!-- doxytag: member="Wt::WApplication::ApplicationCreator" ref="aa9f20bdeb8ebcbb3ec5d633b010511f" args=")(const WEnvironment &env)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef <a class="el" href="classWt_1_1WApplication.html">WApplication</a>*(* <a class="el" href="classWt_1_1WApplication.html#aa9f20bdeb8ebcbb3ec5d633b010511f">ApplicationCreator</a>)(const <a class="el" href="classWt_1_1WEnvironment.html">WEnvironment</a> &env)<code> [related]</code> </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Typedef for a function that creates <a class="el" href="classWt_1_1WApplication.html" title="Represents an application instance for a single session.">WApplication</a> objects.
<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classWt_1_1WServer.html#bca6890dab44d87bd3af64705ac072d3" title="Runs the Wt application server.">WRun()</a> </dd></dl>
</div>
</div><p>
</div>
<hr size="1"><address style="align: right;"><small>
Generated on Fri Mar 26 17:12:06 2010 for <a href="http://www.webtoolkit.eu/wt/">Wt</a> by <a href="http://www.doxygen.org/index.html"><img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.6</small></address>
</body>
</html>
|
