summaryrefslogtreecommitdiffstats
path: root/tde-i18n-sv/docs/tdevelop/kdearch/index.docbook
blob: ab89916bd9990422f6205bc29d183ab3877404a9 (plain)
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
<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY % addindex "INCLUDE">
  <!ENTITY % Swedish "INCLUDE"> <!-- change language only here -->
]>

<book lang="&language;">

<bookinfo>
<title>Översikt över KDE:s arkitektur</title>

<date></date>
<releaseinfo></releaseinfo>

<authorgroup>
<author><firstname>Bernd</firstname> <surname>Gehrmann</surname> <affiliation><address><email>bernd@kdevelop.org</email></address></affiliation>
</author>
</authorgroup>

<copyright>
<year>2001</year>
<year>2002</year>
<holder>Bernd Gehrmann</holder>
</copyright>

<legalnotice>&FDLNotice;</legalnotice>

<abstract>
<para>Den här dokumentationen ger en översikt över KDE-utvecklingsmiljön.</para>
</abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>arkitektur</keyword>
<keyword>utveckling</keyword>
<keyword>programmering</keyword>
</keywordset>

</bookinfo>

<chapter id="structure">
<title>Biblioteksstruktur</title>

<simplesect id="structure-byname">
<title>Bibliotek ordnade efter namn</title>

<variablelist>

<varlistentry>
<term><ulink url="kdeapi:tdecore/index.html">tdecore</ulink></term>
<listitem><para>Biblioteket tdecore är det grundläggande programramverket för alla KDE-baserade program. Det ger tillgång till konfigurationssystemet, hantering av kommandoraden, laddning och hantering av ikoner, vissa särskilda sorters interprocesskommunikation, filhantering och diverse andra verktyg. </para></listitem>
</varlistentry>

<varlistentry>
<term><ulink url="kdeapi:tdeui/index.html">tdeui</ulink></term>
<listitem><para>Biblioteket <literal>tdeui</literal> tillhandahåller många grafiska komponenter och standarddialogrutor som Qt inte har eller som har fler funktioner än motsvarande i Qt. Det innehåller också flera grafiska komponenter som är delklasser av de i Qt, men är bättre integrerade med KDE-skrivbordet genom att de respekterar användarinställningar. </para></listitem>
</varlistentry>

<varlistentry>
<term><ulink url="kdeapi:tdeio/index.html">tdeio</ulink></term>
<listitem><para>Biblioteket <literal>tdeio</literal> innehåller funktioner för asynkron, nätverkstransparent I/O och åtkomst till hantering av Mime-typer. Det tillhandahåller också KDE:s fildialogruta och dess hjälpklasser. </para></listitem>
</varlistentry>

<varlistentry>
<term><ulink url="kdeapi:kjs/index.html">kjs</ulink></term>
<listitem><para>Biblioteket <literal>kjs</literal> tillhandahåller en implementering av Javaskript. </para></listitem>
</varlistentry>

<varlistentry>
<term><ulink url="kdeapi:tdehtml/index.html">tdehtml</ulink></term>
<listitem><para>Biblioteket <literal>tdehtml</literal> innehåller TDEHTML-delen, en HTML-bläddringskomponent, DOM-gränssnitt och tolk, inklusive gränssnitt till Java och Javaskript. </para></listitem>
</varlistentry>

</variablelist>

</simplesect>


<simplesect id="structure-grouped">
<title>Grupperade klasser</title>

<para>Centralt programskelett: klasser som behövs av nästan alla program. </para>

<itemizedlist>

<listitem><formalpara>
<title><ulink url="kdeapi:tdecore/TDEApplication">TDEApplication</ulink></title>
<para>Initierar och styr ett KDE-program. </para>
</formalpara></listitem>

<listitem><formalpara>
<title><ulink url="kdeapi:tdecore/KUniqueApplication">KUniqueApplication</ulink></title>
<para>Försäkrar att bara en instans av ett program kan köra samtidigt. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdecore/TDEAboutData">TDEAboutData</ulink></title>
<para>Innehåller information för dialogrutan Om. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdecore/TDECmdLineArgs">TDECmdLineArgs</ulink></title>
<para>Behandling av kommandoradsväljare. </para>
</formalpara></listitem>

</itemizedlist>

<para>Konfigurationsinställningar: åtkomst till KDE:s hierarkiska konfigurationsdatabas, globala inställningar och programresurser. </para>

<itemizedlist>

<listitem><formalpara><title><ulink url="kdeapi:tdecore/TDEConfig">TDEConfig</ulink></title>
<para>Ger tillgång till KDE:s konfigurationsdatabas. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdecore/KSimpleConfig">KSimpleConfig</ulink></title>
<para>Åtkomst av enkla, icke-hierarkiska konfigurationsfiler. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdecore/KDesktopFile">KDesktopFile</ulink></title>
<para>Åtkomst till <literal>.desktop</literal>-filer. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdecore/TDEGlobalSettings">TDEGlobalSettings</ulink></title>
<para>Bekväm åtkomst till inställningar som inte är programspecifika. </para>
</formalpara></listitem>

</itemizedlist>

<para>Fil- och webbadresshantering: avkodning av webbadresser, tillfälliga filer, etc. </para>

<itemizedlist>

<listitem><formalpara><title><ulink url="kdeapi:tdecore/KURL">KURL</ulink></title>
<para>Representerar och tolkar webbadresser. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdecore/KTempFile">KTempFile</ulink></title>
<para>Skapar unika filer för tillfällig data. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdecore/KSaveFile">KSaveFile</ulink></title>
<para>Tillåter att filer sparas odelbart. </para>
</formalpara></listitem>

</itemizedlist>

<para>Interprocesskommunikation: DCOP-hjälpklasser och start av underprocesser. </para>

<itemizedlist>

<listitem><formalpara><title><ulink url="kdeapi:tdecore/TDEProcess">TDEProcess</ulink></title>
<para>Startar och styr underprocesser. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdecore/KShellProcess">KShellProcess</ulink></title>
<para>Startar underprocesser via ett skal. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdesu/PtyProcess">PtyProcess</ulink></title>
<para>Kommunikation med underprocesser via en pseudoterminal. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdecore/KIPC">KIPC</ulink></title>
<para>Enkel IPC-mekanism som använder X11-klientmeddelanden. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:dcop/DCOPClient">DCOPClient</ulink></title>
<para>DCOP-meddelanden. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdecore/KDCOPPropertyProxy">KDCOPPropertyProxy</ulink></title>
<para>En proxyklass som offentliggör Qt-egenskaper via DCOP. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdeui/KDCOPActionProxy">KDCOPActionProxy</ulink></title>
<para>En proxyklass som offentliggör ett DCOP-gränssnitt för åtgärder. </para>
</formalpara></listitem>

</itemizedlist>

<para>Verktygsklasser: minneshantering, reguljära uttryck, stränghantering, slumptal. </para>

<itemizedlist>

<listitem><formalpara><title><ulink url="kdeapi:tdecore/KRegExp">KRegExp</ulink></title>
<para>Matchning av POSIX reguljära uttryck. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdecore/KStringHandler">KStringHandler</ulink></title>
<para>Ett överdådigt gränssnitt för stränghantering. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdecore/TDEZoneAllocator">TDEZoneAllocator</ulink></title>
<para>Effektiv minnestilldelning för stora grupper av små objekt. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdecore/KRandomSequence">KRandomSequence</ulink></title>
<para>Skapa pseudoslumptal. </para>
</formalpara></listitem>

</itemizedlist>

<para>Snabbtangenter: klasser som hjälper till att skapa överensstämmande tangentbindningar över hela skrivbordet. </para>

<itemizedlist>

<listitem><formalpara><title><ulink url="kdeapi:tdecore/TDEAccel">TDEAccel</ulink></title>
<para>Samling av snabbtangenter. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdecore/TDEStdAccel">TDEStdAccel</ulink></title>
<para>Lätt åtkomst till de vanliga snabbtangenterna. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdecore/TDEGlobalAccel"></ulink></title>
<para>Samling av snabbtangenter som gäller för hela systemet. </para>
</formalpara></listitem>

</itemizedlist>

<para>Bildbehandling: ikonladdning och -hantering. </para>

<itemizedlist>

<listitem><formalpara><title><ulink url="kdeapi:tdecore/TDEIconLoader">TDEIconLoader</ulink></title>
<para>Laddar ikoner som överensstämmer med teman. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdecore/TDEIconTheme">TDEIconTheme</ulink></title>
<para>Hjälpklasser för TDEIconLoader. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdecore/KPixmap">KPixmap</ulink></title>
<para>En pixmapp-klass med utökade gittermöjligheter. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdeui/KPixmapEffect">KPixmapEffect</ulink></title>
<para>Pixmappeffekter som toning och mönster. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdeui/KPixmapIO">KPixmapIO</ulink></title>
<para>Snabb konvertering mellan <classname>TQImage</classname> och <classname>QPixmap</classname>. </para>
</formalpara></listitem>

</itemizedlist>

<para>Drag och släpp: dra objekt för färger och webbadresser. </para>

<itemizedlist>

<listitem><formalpara><title><ulink url="kdeapi:tdecore/KURLDrag">KURLDrag</ulink></title>
<para>Dragobjekt för webbadresser. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdeui/KColorDrag">KColorDrag</ulink></title>
<para>Dragobjekt för färger. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdecore/KMultipleDrag">KMultipleDrag</ulink></title>
<para>Tillåter att dragobjekt skapas från flera andra. </para>
</formalpara></listitem>

</itemizedlist>

<para>Automatisk komplettering </para>

<itemizedlist>

<listitem><formalpara><title><ulink url="kdeapi:tdecore/TDECompletion">TDECompletion</ulink></title>
<para>Generell automatisk komplettering av strängar. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdeio/KURLCompletion">KURLCompletion</ulink></title>
<para>Automatisk komplettering av webbadresser. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdeio/KShellCompletion">KShellCompletion</ulink></title>
<para>Automatisk komplettering för körbara program. </para>
</formalpara></listitem>

</itemizedlist>

<para>Grafiska komponenter: klasser för listvyer, linjaler, färgval, etc. </para>

<itemizedlist>

<listitem><formalpara><title><ulink url="kdeapi:tdeui/TDEListView">TDEListView</ulink></title>
<para>En version av <classname>QListView</classname> som följer KDE:s systeminställningar. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdeui/TDEListView">TDEListBox</ulink></title>
<para>En version av <classname>QListBox</classname> som följer KDE:s systeminställningar. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdeui/TDEListView">TDEIconView</ulink></title>
<para>En version av <classname>QIconView</classname> som följer KDE:s systeminställningar. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdeui/TDEListView">KLineEdit</ulink></title>
<para>En version av <classname>QLineEdit</classname> med stöd för komplettering. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdeui/KComboBox">KComboBox</ulink></title>
<para>En version av <classname>QComboBox</classname> med stöd för komplettering. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdeui/TDEFontCombo">TDEFontCombo</ulink></title>
<para>En kombinationsruta för att välja teckensnitt. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdeui/KColorCombo">KColorCombo</ulink></title>
<para>En kombinationsruta för att välja färger. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdeui/KColorButton">KColorButton</ulink></title>
<para>En knapp för att välja färger. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdeui/KURLCombo">KURLCombo</ulink></title>
<para>En kombinationsruta för att välja filnamn och webbadresser. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdefile/KURLRequester">KURLRequester</ulink></title>
<para>En radeditor för att välja filnamn och webbadresser. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdeui/KRuler">KRuler</ulink></title>
<para>En linjalkomponent. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink
url="kdeapi:tdeui/KAnimWidget">KAnimWidget</ulink></title>
<para>Animeringar. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdeui/KNumInput">KNumInput</ulink></title>
<para>En komponent för att mata in tal. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdeui/KPasswordEdit">KPasswordEdit</ulink></title>
<para>En komponent för att mata in lösenord. </para>
</formalpara></listitem>

</itemizedlist>

<para>Dialogrutor: dialogrutor med fullständig funktion för val av filer, färger och teckensnitt. </para>

<itemizedlist>

<listitem><formalpara><title><ulink url="kdeapi:tdefile/KFileDialog">KFileDialog</ulink></title>
<para>En dialogruta för val av filer. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdeui/KColorDialog">KColorDialog</ulink></title>
<para>En dialogruta för val av färger. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdeui/TDEFontDialog">TDEFontDialog</ulink></title>
<para>En dialogruta för val av teckensnitt. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdefile/TDEIconDialog">TDEIconDialog</ulink></title>
<para>En dialogruta för val av ikoner. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdeui/KKeyDialog">KKeyDialog</ulink></title>
<para>En dialogruta för att redigera tangentbordsbindningar. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdeui/KEditToolBar">KEditToolBar</ulink></title>
<para>En dialogruta för att redigera verktygsrader. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdeui/KTipDialog">KTipDialog</ulink></title>
<para>En dialogruta med dagens tips. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdeui/TDEAboutDialog">TDEAboutDialog</ulink></title>
<para>En dialogruta om ett program. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdeui/KLineEditDlg">KLineEditDlg</ulink></title>
<para>En enkel dialogruta för att mata in text. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdefile/KURLRequesterDlg">KURLRequesterDlg</ulink></title>
<para>En enkel dialogruta för att mata in webbadresser. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdeui/KMessageBox">KMessageBox</ulink></title>
<para>En dialogruta för att meddela fel och varningar. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdeui/KPasswordDialog">KPasswordDialog</ulink></title>
<para>En dialogruta för att mata in lösenord. </para>
</formalpara></listitem>

</itemizedlist>

<para>Åtgärder och grafiskt XML-gränssnitt </para>

<itemizedlist>

<listitem><formalpara><title><ulink url="kdeapi:tdeui/TDEAction">TDEAction</ulink></title>
<para>En abstraktion av en åtgärd som kan anslutas till menyrader och verktygsrader. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdeui/TDEActionCollection">TDEActionCollection</ulink></title>
<para>En samling åtgärder. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdeui/KXMLGUIClient">KXMLGUIClient</ulink></title>
<para>Ett fragment av ett grafiskt gränssnitt som består av en åtgärd och ett DOM-träd som motsvarar dess plats i det grafiska gränssnittet. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdeparts/KPartManager">KPartManager</ulink></title>
<para>Hanterar aktivering av klienter till det grafiska XML-gränssnittet. </para>
</formalpara></listitem>

</itemizedlist>

<para>Insticksprogram och komponenter </para>

<itemizedlist>

<listitem><formalpara><title><ulink url="kdeapi:tdecore/KLibrary">KLibrary</ulink></title>
<para>Representerar ett dynamiskt laddat bibliotek. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdecore/KLibrary">KLibLoader</ulink></title>
<para>Laddning av delade bibliotek. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdecore/KLibFactory">KLibFactory</ulink></title>
<para>Tillverkning av objekt för Insticksprogram. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdeio/KServiceType">KServiceType</ulink></title>
<para>Representerar en tjänsttyp. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdeio/KService">KService</ulink></title>
<para>Representerar en tjänst. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdeio/KMimeType">KMimeType</ulink></title>
<para>Representerar en Mime-typ. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdeio/KServiceTypeProfile">KServiceTypeProfile</ulink></title>
<para>Användarinställningar för tilldelningar av Mime-typer. </para>
</formalpara></listitem>

<listitem><formalpara><title><ulink url="kdeapi:tdeio/KServiceTypeProfile">TDETrader</ulink></title>
<para>Förfrågningar om tjänster. </para>
</formalpara></listitem>

</itemizedlist>

</simplesect>

</chapter>



<chapter id="graphics">
<title>Grafik</title>

<sect1 id="graphics-qpainter">
<title>Lågnivågrafik med QPainter.</title>

<simplesect id="qpainter-rendering">
<title>Uppritning med QPainter</title>

<para>Qt:s lågnivåritmodell är baserad på de möjligheter som erbjuds av X11 och andra fönstersystem där en version av Qt finns. Men den utökar också dem genom att implementera ytterligare funktioner som godtyckliga affina omvandlingar för text och pixmappar. </para>

<para>Den centrala grafiska klassen för att rita tvådimensionellt med Qt är <ulink url="kdeapi:qt/QPainter">QPainter</ulink>. Den kan rita på en <ulink url="kdeapi:qt/QPaintDevice">QPaintDevice</ulink>. Det finns tre möjliga ritenheter implementerade: En är <ulink url="kdeapi:qt/TQWidget">TQWidget</ulink>, som representerar en grafisk komponent på skärmen. Den andra är <ulink url="kdeapi:qt/QPrinter">QPrinter</ulink>, som representerar en skrivare, och producerar Postskript-utmatning. Den tredje är klassen <ulink url="kdeapi:qt/QPicture">QPicture</ulink>, som spelar in ritkommandon och kan spara dem till disk, och sedan spela upp dem. Ett möjligt lagringsformat för ritkommandon är W3C-standarden SVG. </para>

<para>Alltså är det möjligt att återanvända uppritningskoden som du använder för att visa en grafisk komponent för utskrift, med stöd för samma funktioner. Naturligtvis används koden i praktiken i ett något annorlunda sammanhang. Rita på en grafisk komponent görs nästan enbart i metoden paintEvent() i en komponentklass. </para>

<programlisting>void MinKomponent::paintEvent()
{
    QPainter p(this);
    // Ställ in
    // Använd
}
</programlisting>

<para>Vid ritning på en skrivare, måste du försäkra dig om att använda QPrinter::newPage() för att avsluta en sida, och börja på en ny: något som inte är relevant för att rita grafiska komponenter. Vid utskrift vill du kanske också använda <ulink url="kdeapi:qt/QPaintDeviceMetrics">enhetsmått</ulink> för att beräkna koordinater. </para>

</simplesect>


<simplesect id="qpainter-transformations">
<title>Omvandlingar</title>

<para>Normalt när QPainter används, ritar den i det naturliga koordinatsystemet som används av enheten. Det betyder att om du ritar en linje med längden 10 enheter, ritas den som en horisontell linje på skärmen med längden 10 bildpunkter. Dock kan QPainter använda godtyckliga affina omvandlingar innan former och kurvor verkligen ritas upp. En affin omvandling överför x- och y-koordinater linjärt till x' och y' enligt: </para>

<mediaobject>
<imageobject><imagedata fileref="affine-general.png"/></imageobject>
</mediaobject>

<para>QPainter::setWorldMatrix() kan användas för att ange den här 3x3 matrisen i ekvationen, som har typen <ulink url="kdeapi:qt/QWMatrix">QWMatrix</ulink>. Normalt är detta identitetsmatrisen, dvs. m11 och m22 är ett, och övriga värden är noll. Det finns i grunden tre olika grupper av omvandlingar: </para>

<itemizedlist>

<listitem><formalpara>
<title>Förflyttningar</title>
<para>Dessa flyttar ett objekts alla punkter med ett fast värde i någon riktning. En förflyttningsmatris kan erhållas genom att anropa metoden m.translate(dx, dy) med en QWMatrix. Det motsvarar matrisen: </para>
</formalpara>

<mediaobject>
<imageobject><imagedata fileref="affine-translate.png"/></imageobject>
</mediaobject>

</listitem>

<listitem><formalpara>
<title>Skalning</title>
<para>Dessa förstorar eller förminskar ett objekts koordinater, och gör det större eller mindre utan att förvränga det. En skalningsomvandling kan göras för en QWMatrix genom att anropa m.scale(sx, sy). Det motsvarar matrisen: </para>
</formalpara>

<mediaobject>
<imageobject><imagedata fileref="affine-scale.png"/></imageobject>
</mediaobject>

<para>Genom att ge en av parametrarna ett negativt värde, kan man åstadkomma spegling av koordinatsystemet. </para>

</listitem>

<listitem><formalpara>
<title>Skjuvning</title>
<para>En förvrängning av koordinatsystemet med två parametrar. En skjuvningsomvandling kan göras genom att anropa m.shear(sh, sv), vilket motsvarar matrisen: </para>
</formalpara>

<mediaobject>
    <imageobject><imagedata fileref="affine-shear.png"/></imageobject>
</mediaobject>

</listitem>

<listitem><formalpara>
<title>Rotation</title>
<para>Detta roterar ett objekt. En rotationsomvandling kan göras genom att anropa m.rotate(alfa). Observera att vinkeln måste anges i grader, inte som en matematisk vinkel! Motsvarande matris är: </para>
</formalpara>

<mediaobject>
<imageobject><imagedata fileref="affine-rotate.png"/></imageobject>
</mediaobject>

<para>Observera att rotation är ekvivalent med en kombination av skalning och skjuvning. </para>

</listitem>

</itemizedlist>

<para>Här är några bilder som visar effekten av de grundläggande omvandlingarna för vår maskot: </para>

<informaltable frame="none">
<tgroup cols="3">
<tbody>
<row>
<entry><mediaobject>
    <imageobject><imagedata fileref="konqi-normal.png"/></imageobject>
</mediaobject></entry>
<entry><mediaobject>
    <imageobject><imagedata fileref="konqi-rotated.png"/></imageobject>
</mediaobject></entry>
<entry><mediaobject>
    <imageobject><imagedata fileref="konqi-sheared.png"/></imageobject>
</mediaobject></entry>
<entry><mediaobject>
   <imageobject><imagedata fileref="konqi-mirrored.png"/></imageobject>
</mediaobject></entry>
</row>
<row>
<entry>a) Normal</entry>
<entry>b) Roterad 30 grader</entry>
<entry>c) Skjuvad med 0,4</entry>
<entry>d) Speglad</entry>
</row>
</tbody>
</tgroup>
</informaltable>

<para>Omvandlingar kan kombineras genom att multiplicera grundläggande matriser. Observera att matrisoperationer inte i allmänhet är kommutativa, och därför beror den kombinerade effekten av en sammansättning på ordningen som matriserna multipliceras med. </para>

</simplesect>


<simplesect id="qpainter-strokeattributes">
<title>Ange streckegenskaper</title>

<para>Uppritning av linjer, kurvor och polygonkanter kan ändras genom att ange en särskild penna med QPainter::setPen(). Argumentet till den här funktionen är ett <ulink url="kdeapi:qt/QPen">QPen</ulink>-objekt. Egenskaperna som lagras i det är en stil, en färg, en sammanfogningsstil och en ändstil. </para>

<para>Pennstilen är en medlem av uppräkningstypen <ulink url="kdeapi:qt/Qt#PenStyle-enum">TQt::PenStyle</ulink>. och kan ha något av följande värden: </para>

<mediaobject>
    <imageobject><imagedata fileref="penstyles.png"/></imageobject>
</mediaobject>

<para>Sammanfogningsstilen är en medlem av uppräkningstypen <ulink url="kdeapi:qt/Qt#PenJoinStyle-enum">TQt::PenJoinStyle</ulink>. Den anger hur förbindelsen mellan flera linjer som sätts samman ritas. Den kan ha något av följande värden: </para>

<informaltable frame="none">
<tgroup cols="3">
<tbody>
<row>
<entry><mediaobject>
    <imageobject><imagedata fileref="joinmiter.png"/></imageobject>
</mediaobject></entry>
<entry><mediaobject>
    <imageobject><imagedata fileref="joinbevel.png"/></imageobject>
</mediaobject></entry>
<entry><mediaobject>
    <imageobject><imagedata fileref="joinround.png"/></imageobject>
</mediaobject></entry>
</row>
<row>
<entry>a) MiterJoin</entry>
<entry>c) BevelJoin</entry>
<entry>b) RoundJoin</entry>
</row>
</tbody>
</tgroup>
</informaltable>

<para>Ändstilen är en medlem av uppräkningstypen <ulink url="kdeapi:qt/Qt#PenCapStyle-enum">TQt::PenCapStyle</ulink> och anger hur linjernas ändpunkter ritas. Den antar något värde från följande tabell: </para>

<informaltable frame="none">
<tgroup cols="3">
<tbody>
<row>
<entry><mediaobject>
    <imageobject><imagedata fileref="capflat.png"/></imageobject>
</mediaobject></entry>
<entry><mediaobject>
    <imageobject><imagedata fileref="capsquare.png"/></imageobject>
</mediaobject></entry>
<entry><mediaobject>
    <imageobject><imagedata fileref="capround.png"/></imageobject>
</mediaobject></entry>
</row>
<row>
<entry>a) FlatCap</entry>
<entry>b) SquareCap</entry>
<entry>c) RoundCap</entry>
</row>
</tbody>
</tgroup>
</informaltable>

</simplesect>


<simplesect id="qpainter-fillattributes">
<title>Ange fyllnadsegenskaper</title>

<para>Fyllnadsstilen för polygoner, cirklar eller rektanglar kan ändras genom att ange en särskild borste med QPainter::setBrush(). Den här funktionens argument är ett <ulink url="kdeapi:qt/QBrush">QBrush</ulink>-objekt. Borstar kan skapas på fyra olika sätt: </para>

<itemizedlist>
<listitem>
<para>QBrush::QBrush(): detta skapar en borste som inte fyller i former.</para>
</listitem>
<listitem>
<para>QBrush::QBrush(BrushStyle): detta skapar en svart borste, med ett av de fördefinierade mönstren som visas nedan.</para>
</listitem>
<listitem>
<para>QBrush::QBrush(const TQColor &amp;, BrushStyle): detta skapar en färgad borste, med ett av de fördefinierade mönstren som visas nedan.</para>
</listitem>
<listitem>
<para>QBrush::QBrush(const TQColor &amp;, const QPixmap): detta skapar en färgad borste, med det egna mönstret som anges som andra parameter.</para>
</listitem>
</itemizedlist>

<para>En standardborststil från uppräkningstypen <ulink url="kdeapi:qt/Qt#BrushStyle-enum">TQt::BrushStyle</ulink>. Här är en bild av alla fördefinierade mönster: </para>

<mediaobject>
    <imageobject><imagedata fileref="brushstyles.png"/></imageobject>
</mediaobject>

<para>Ytterligare ett sätt att anpassa en borstes beteende är att använda funktionen QPainter::setBrushOrigin(). </para>

</simplesect>


<simplesect id="qpainter-color">
<title>Färg</title>

<para>Färger har betydelse både när kurvor ritas, och när former fylls i. Färger representeras av klassen <ulink url="kdeapi:qt/TQColor">TQColor</ulink> i Qt. Qt stöder inte avancerade grafikfunktioner som ICC-färgprofiler och färgkorrektion. Färger skapas oftast genom att ange deras röda, gröna och bläa komponenter, eftersom RGB-modellen är sättet som bildpunkter sätts samman på en bildskärm. </para>

<para>Det är också möjligt att använda färgton, färgmättnad och värde. Den här HSV-representationen är den som används i GTK:s färgdialogruta, t.ex. i GIMP. Där motsvarar färgtonen en vinkel i färghjulet, medan färgmättnaden motsvarar avståndet från cirkelns mitt. Värdet väljs med ett särskilt skjutreglage. </para>

</simplesect>


<simplesect id="qpainter-paintsettings">
<title>Övriga inställningar</title>

<para>Normalt när du ritar på en ritenhet, så ersätter bildpunkterna de som tidigare fanns där. Det betyder om du fyller ett visst område med röd färg, och sedan fyller samma område med blå färg, så är bara den blåa färgen synlig. Qt:s bildmodell tillåter inte genomskinlighet, dvs. ett sätt att blanda förgrunden som ritas med bakgrunden. Det finns dock ett enkelt sätt att kombinera bakgrund och förgrund med Booleska operationer. Metoden QPainter::setRasterOp() anger operationen som används, som kommer från uppräkningstypen <ulink url="kdeapi:qt/Qt#RasterOp-enum">RasterOp</ulink>. </para>

<para>Standardvärdet är CopyROP, som ignorerar bakgrunden. Ett annat populärt val är XorROP. Om du ritar en svart linje med den operationen på en färgad bild, så inverteras området som täcks. Den här effekten används till exempel för att skapa gummibandsmarkeringar i bildbehandlingsprogram, som är kända under namnet "vandrande myror". </para>

</simplesect>


<simplesect id="qpainter-primitives">
<title>Rita grafiska primitiver</title>

<para>I det följande listar vi de grundläggande grafiska elementen som stöds av QPainter. De flesta av dem finns i flera överlastade versioner som har olika antal argument. Metoder som hanterar rektanglar, har till exempel oftast en <ulink url="kdeapi:qt/QRect">QRect</ulink> som argument, eller en uppsättning med fyra heltal. </para>

<itemizedlist>
<listitem>
<para>Rita en ensam punkt: drawPoint().</para>
</listitem>
<listitem>
<para>Rita linjer: drawLine(), drawLineSegments() och drawPolyLine().</para>
</listitem>
<listitem>
<para>Rita och fylla i rektanglar: drawRect(), drawRoundRect(), fillRect() och eraseRect().</para>
</listitem>
<listitem>
<para>Rita och fylla i cirklar, ellipser och delar av dem: drawEllipse(), drawArc(), drawPie och drawChord().</para>
</listitem>
<listitem>
<para>Rita och fylla i generella polygoner: drawPolygon().</para>
</listitem>
<listitem>
<para>Rita Bezierkurvor: drawQuadBezier() [drawCubicBezier i Qt 3.0].</para>
</listitem>
</itemizedlist>

</simplesect>


<simplesect id="qpainter-pixmaps">
<title>Rita pixmappar och bilder</title>

<para>Qt tillhandahåller två mycket olika klasser för att representera bilder. </para>

<para><ulink url="kdeapi:qt/QPixmap">QPixmap</ulink> motsvarar direkt pixmappsobjekt i X11. En pixmapp är ett objekt på serversidan och kan, med ett modernt grafikkort, till och med lagras direkt i kortets minne. Det gör det <emphasis>mycket</emphasis> effektivt att överföra en pixmapp till skärmen. En pixmapp fungerar också som en motsvarighet till grafiska komponenter utanför skärmen. QPixmap-klassen är en delklass till QPaintDevice, så det går att rita på den med en QPainter. Elementära ritoperationer accelereras ofta av modern grafik. Därför är ett vanligt användningsmönster att använda en pixmapp för dubbelbuffring. Detta betyder att istället för att rita direkt på en grafisk komponent, ritar man på ett tillfälligt pixmappsobjekt och använder funktionen <ulink url="kdeapi:qt/QPaintDevice#bitBlt-1">bitBlt</ulink> för att överföra det till komponenten. För komplexa omritningar, hjälper detta till att undvika flimmer. </para>

<para>I motsats till detta, finns <ulink url="kdeapi:qt/TQImage">TQImage</ulink>-objekt på klientsidan. Deras huvuduppgift är att ge direkt åtkomst till bildpunkterna i bilden. Det gör dem användbara för bildhantering, och saker som att ladda och spara till disk (Metoden load() för QPixmap använder TQImage som ett mellansteg). Å andra sidan, så blir uppritning av en bild på en grafisk komponent en ganska krävande åtgärd, eftersom det innebär en överföring till X-servern, vilket kan ta en viss tid, särskilt för stora bilder och fjärrservrar. Beroende på färgdjupet, kan konvertering från TQImage till QPixmap också kräva användning av gitter. </para>

</simplesect>


<simplesect id="qpainter-drawingtext">
<title>Rita text</title>

<para>Text kan ritas med en av de överlastade varianterna av metoden QPainter::drawText(). De ritar en TQString, antingen vid en given punkt eller inne i en given rektangel, med teckensnittet som ställts in med QPainter::setFont(). Det finns också en parameter som tar en ELLER-kombination av vissa flaggor från uppräkningstyperna <ulink url="kdeapi:qt/Qt#AlignmentFlags-enum">TQt::AlignmentFlags</ulink> och <ulink url="kdeapi:qt/Qt#TextFlags-enum">TQt::TextFlags</ulink>. </para>

<para>Med början i version 3.0, hanterar Qt fullständig textlayout också för språk som skrivs från höger till vänster. </para>

<para>Ett mer avancerat sätt att visa text med taggar, är klassen <ulink url="kdeapi:qt/QSimpleRichText">QSimpleRichText</ulink>. Objekt från klassen kan skapas med ett textstycke som använder en delmängd av HTML-taggarna, som är ganska omfattande och till och med erbjuder tabeller. Textstilen kan anpassas genom att använda <ulink url="kdeapi/qt/QStyleSheet">QStyleSheet</ulink> (taggarnas dokumentation finns också här). Så fort textobjektet har skapats, kan det ritas upp på en grafisk komponent eller en annan ritenhet med metoden QSimpleRichText::draw(). </para>

</simplesect>

</sect1>


<sect1 id="graphics-qcanvas">
<title>Strukturerad grafik med QCanvas</title>

<para>QPainter erbjuder en kraftfull ritmodell för att rita på grafikska komponenter och pixmappar. Dock kan den vara omständlig att använda. Varje gång komponenten tar emot en rithändelse, måste den analysera QPaintEvent::region() eller QPaintEvent::rect() för det som måste ritas om. Därefter måste den ställa in en QPainter, och rita alla objekt som överlappar det området. Tänk dig till exempel ett vektorritprogram som tillåter att objekt som polygoner, cirklar och grupper av dem att dras omkring. Varje gång objekten flyttas lite grand, aktiverar komponentens mushändelsehantering en rithändelse för hela området som täcks av objektens gamla plats och deras nya plats. Att räkna ut nödvändiga omritningar, och att göra dem på ett effektivt sätt, kan vara svårt, och kan också vara i konflikt med programkodens objektorienterade struktur. </para>

<para>Som alternativ innehåller Qt klassen <ulink url="kdeapi:qt/QCanvas">QCanvas</ulink>, där man lägger till grafiska objekt, som polygoner, text eller pixmappar. Man kan också skapa ytterligare objekt genom att skapa en delklass av <ulink url="kdeapi:qt/QCanvasItem">QCanvasItem</ulink> eller någon av dess mer specialiserade delklasser. En duk kan visas på skärmen genom en eller flera komponenter från klassen <ulink url="kdeapi:qt/QCanvas">QCanvasView</ulink>, som man måste skapa en delklass av för att hantera interaktion med användaren. Qt tar hand om all omritning av objekt i vyn, vare sig de orsakas av att komponenten visas, nya objekt skapas eller ändras, eller andra orsaker. Genom att använda dubbelbuffring, kan detta göras på ett effektivt och flimmerfritt sätt. </para>

<para>Objekt på duken kan överlappa varandra. I detta fall, så beror vilken som syns på z-ordningen, som kan tilldelas med QCanvasItem::setZ(). Objekt kan också göras synliga eller osynliga. Man kan också tillhandahålla en bakgrund som ska ritas "bakom" alla objekt, och en förgrund. För att associera mushändelser med objekt på duken, finns metoden QCanvas::collisions(), som returnerar en lista med objekt som överlappar med en given punkt. Här visar vi en skärmbild av en dukvy i arbete: </para>

<mediaobject>
<imageobject><imagedata fileref="canvas.png"/></imageobject>
</mediaobject>

<para>Här ritas rutmönstret upp i bakgrunden. Dessutom finns ett QCanvasText-objekt och en violett QCanvasPolygon. Fjärilen är en QCanvasPixmap. Den har genomskinliga områden, så du kan se underliggande objekt genom den. </para>

<para>En handledning om hur QCanvas används för att skriva spel baserade på småfigurer finns <ulink url="http://zez.org/article/articleview/2/1/">här</ulink>. </para>

</sect1>


<sect1 id="graphics-qglwidget">
<title>3D-grafik med OpenGL</title>

<simplesect id="qglwidget-lowlevel">
<title>Lågnivågränssnitt</title>

<para>De-facto standarden för att rita upp 3D-grafik nu för tiden är <ulink url="http://www.opengl.org">OpenGL</ulink>. Implementeringar av standarden levereras med Microsoft Windows, Mac OS X och XFree86, och de stöder ofta funktioner för hårdvaruacceleration som erbjuds av moderna grafikkort. OpenGL själv hanterar bara uppritning på ett angivet område i rambuffern genom ett <emphasis>GL-sammanhang</emphasis>, och har ingen interaktion med verktygslådan eller miljön. </para>

<para>Qt erbjuder den grafiska komponenten <ulink url="kdeapi:qt/QGLWidget">QGLWidget</ulink>, som kapslar in ett fönster med tillhörande GL-sammanhang. I grunden används det genom att skapa en delklass av det och implementera om några metoder. </para>

<itemizedlist>

<listitem><para>Istället för att implementera om paintEvent(), och använda QPainter för att rita komponentens innehåll, överskrider man paintGL() och använder GL-kommandon för att rita upp en scen. QGLWidget tar hand om att göra sitt GL-sammanhang det aktuella innan paintGL() anropas, och tömmer det efteråt. </para></listitem>

<listitem><para>Den virtuella metoden initializeGL() anropas en gång innan den första gången innan resizeGL() eller paintGL() anropas. Det kan användas för att skapa visningslistor för objekt, och göra alla initieringar. </para></listitem>

<listitem><para>Istället för att implementera om resizeEvent(), överskrider man resizeGL(). Detta kan användas för att ställa in vyområdet på ett lämpligt sätt. </para></listitem>

<listitem><para>Istället för att anropa update() när scenens tillstånd har ändrats, till exempel om du animerar det med ett tidur, ska man anropa updateGL(). Då aktiveras en omritning. </para></listitem>

</itemizedlist>

<para>I allmänhet beter sig QGLWidget som vilken annan grafisk komponent som helst, dvs. man kan till exempel hantera mushändelser som vanligt, ändra storlek på komponenten och kombinera den med andra i en layout. </para>

<mediaobject>
<imageobject><imagedata fileref="opengl.png"/></imageobject>
</mediaobject>

<para>Qt innehåller några exempel på användning av QGLWidget i <literal>demo</literal>-exemplen. En samling handledningar finns <ulink url="http://www.libsdl.org/opengl/intro.html">här</ulink>, och mer information samt en OpenGL-referens finns på <ulink url="http://www.opengl.org">OpenGL:s hemsida</ulink>. </para>

</simplesect>


<simplesect id="qglwidget-highlevel">
<title>Högnivågränssnitt</title>

<para>OpenGL är ett gränssnitt på ganska låg nivå för att rita 3D-grafik. På samma sätt som QCanvas ger programmeraren ett gränssnitt på högre nivå som hanterar objekt och deras egenskaper, finns det också gränssnitt på högre nivå för 3D-grafik. Ett av de mest populära är Open Inventor. Ursprungligen var det en teknologi som utvecklades av SGI, men idag finns också en implementering med öppen källkod, <ulink url="http://www.coin3d.org">Coin</ulink>, som åtföljs av en verktygsanpassning till Qt, som heter SoQt. </para>

<para>Det grundläggande konceptet i Open Inventor är en <emphasis>scen</emphasis>. En scen kan laddas från disk, och sparas med ett särskilt format, nära besläktat med <ulink url="http://www.vrml.org">VRML</ulink>. En scen består av en samling objekt som kallas <emphasis>noder</emphasis>. Inventor tillhandahåller redan en omfattande samling med återanvändbara noder, som kuber, cylindrar och rutnät. Dessutom finns ljuskällor, material, kameror, etc. Noder representeras av C++ klasser, och kan kombineras och delklasser kan skapas. </para>

<para>En introduktion till Inventor finns <ulink url="http://www.motifzone.com/tmd/articles/OpenInventor/OpenInventor.html">här</ulink> (i allmänhet kan du ersätta alla SoXt som omnämns i artikeln med SoQt). </para>

</simplesect>

</sect1>

</chapter>



<chapter id="userinterface">
<title>Användargränssnitt</title>

<sect1 id="userinterface-actionpattern">
<title>Åtgärdsmönstret</title>

<para></para>

</sect1>


<sect1 id="userinterface-xmlgui">
<title>Definiera menyer och verktygsrader i XML</title>

<simplesect id="xmlgui-intro">
<title>Inledning</title>

<para>Medan <link linkend="userinterface-actionpattern">åtgärdsmönster</link> tillåter att åtgärder som aktiveras av användaren kapslas in i ett objekt, som kan "anslutas" någonstans i menyraderna eller verktygsraderna, löser det inte ensamt problemet med att skapa själva menyerna. I synnerhet måste du bygga alla sammanhangsberoende menyer i C++ kod, och uttryckligen infoga åtgärderna i en viss ordning, med hänsyn taget till stilguiden för standardåtgärder. Det gör det rätt svårt att låta användaren anpassa menyerna eller ändra snabbtangenter så att de passar hans behov, utan att ändra källkoden. </para>

<para>Det här problemet löses med en samling klasser som kallas <literal>grafiskt XML-gränssnitt</literal>. I grunden skiljer de åtgärderna (kodade i C++) från deras utseende i menyrader och verktygsrader (kodade i XML). Utan att ändra någon källkod, kan menyer enkelt anpassas genom att justera en XML-fil. Dessutom hjälper det till att försäkra att standardåtgärder (som <menuchoice><guimenu>Arkiv</guimenu> <guimenuitem>Öppna</guimenuitem></menuchoice> eller <menuchoice><guimenu>Hjälp</guimenu> <guimenuitem>Om</guimenuitem></menuchoice>) visas på platserna som föreslås av stilguiden. Grafiska XML-gränssnitt är särskilt viktiga för modulära program, där alternativen i menyraderna kan komma från många olika insticksprogram eller delar. </para>

<para>KDE:s klass för toppnivåfönster, <ulink url="kdeapi:tdeui/TDEMainWindow.html">TDEMainWindow</ulink>, ärver <ulink url="kdeapi:tdeui/KXMLGUIClient.html">KXMLGUIClient</ulink>, och stöder därför grafiska XML-gränssnitt från början. Alla åtgärder som skapas inne i det måste ha klientens <literal>actionCollection()</literal> som förälder. Ett anrop till <literal> createGUI()</literal> bygger sedan hela uppsättningen menyer och verktygsrader som definieras av programmets XML-fil (vanligtvis med ändelsen <literal>ui.rc</literal>). </para>

</simplesect>


<simplesect id="xmlgui-kviewexample">
<title>Ett exempel: Menyn i Kview</title>

<para>I det följande använder vi KDE:s bildvisare <application>Kview</application> som exempel. Den har en <literal>ui.rc</literal>-fil som heter <filename>kviewui.rc</filename>, som installeras med ett fragment från <filename>Makefile.am</filename> </para>

<programlisting>rcdir = $(kde_datadir)/kview
rc_DATA = kviewui.rc
</programlisting>

<para>Här är ett utdrag ur filen <filename>kviewui.rc</filename>. För enkelhetens skull, visar vi bara definitionen för menyn <guimenu>View</guimenu>. </para>

<programlisting>&lt;!DOCTYPE kpartgui&gt;
&lt;kpartgui name="kview"&gt;
  &lt;MenuBar&gt;
    &lt;Menu name="view" &gt;
      &lt;Action name="zoom50" /&gt;
      &lt;Action name="zoom100" /&gt;
      &lt;Action name="zoom200" /&gt;
      &lt;Action name="zoomMaxpect" /&gt;
      &lt;Separator/&gt;
      &lt;Action name="fullscreen" /&gt;
    &lt;/Menu&gt;
  &lt;/MenuBar&gt;
&lt;/kpartgui&gt;
</programlisting>

<para>Motsvarande del av att skapa detta i C++ är: </para>

<programlisting>KStdAction::zoomIn    ( this, TQ_SLOT(slotZoomIn()), actionCollection() );
  KStdAction::zoomOut   ( this, TQ_SLOT(slotZoomOut()), actionCollection() );
  KStdAction::zoom      ( this, TQ_SLOT(slotZoom()), actionCollection() );
  new TDEAction           ( i18n("&amp;Half size"), ALT+Key_0, 
                          this, TQ_SLOT(slotHalfSize()), 
                          actionCollection(), "zoom50" );
  new TDEAction           ( i18n("&amp;Normal size"), ALT+Key_1,
                          this, TQ_SLOT(slotDoubleSize()), 
                          actionCollection(), "zoom100" );
  new TDEAction           ( i18n("&amp;Double size"), ALT+Key_2, 
                          this, TQ_SLOT(slotDoubleSize()), 
                          actionCollection(), "zoom200" );
  new TDEAction           ( i18n("&amp;Fill Screen"), ALT+Key_3, 
                          this, TQ_SLOT(slotFillScreen()), 
                          actionCollection(), "zoomMaxpect" );
  new TDEAction           ( i18n("Fullscreen &amp;Mode"), CTRL+SHIFT+Key_F, 
                          this, TQ_SLOT(slotFullScreen()), 
                          actionCollection(), "fullscreen" );
</programlisting>

<para>Menyn <guimenu>View</guimenu> som skapas av den här definitionen av det grafiska gränssnittet ser ut som visas av den här skärmbilden: </para>

<mediaobject>
<imageobject><imagedata fileref="kview-menu.png"/></imageobject>
</mediaobject>

<para>XML-filen börjar med en dokumenttypdeklaration. DTD:n för kpartgui finns i tdelibs-källkoden i <filename>tdeui/kpartgui.dtd</filename>. Det yttersta elementet i filen innehåller programmets instansnamn som en egenskap. Det kan också innehålla ett versionsnummer på formen "version=2". Det är användbart när du ger ut nya versioner av ett program med ändrad menystruktur, t.ex. med flera funktioner. Om du räknar upp versionsnumret i filen <literal>ui.rc</literal>, ser KDE till att alla anpassade versioner av filen slängs och att den nya filen används istället. </para>

<para>Nästa rad, <literal>&lt;MenuBar&gt;</literal>, innehåller en deklaration av en menyrad. Du kan också infoga hur många <literal>&lt;ToolBar&gt;</literal>-deklarationer som helst, för att skapa några verktygsrader. Menyn innehåller en undermeny, med namnet "view". Det namnet är redan fördefinierat, och därför skulle den översatta versionen av ordet "View" kunna visas. Om du deklarerar undermenyer, måste du uttryckligen lägga till rubriken. <application>Kview</application> har till exempel en undermeny med rubriken "Image", som deklareras enligt följande: </para>

<programlisting>&lt;Menu name="image" &gt;
   &lt;text&gt;&amp;amp;Image&lt;/text&gt;
   ...
&lt;/Menu&gt;
</programlisting>

<para>I KDE:s automatiska byggramverk, plockas sådana rubriker automatiskt ut och placeras i programmets <ulink url="tde-i18n-howto.html"><literal>.po</literal></ulink>-fil, så att det hanteras av översättare. Observera att du måste skriva markeringen av snabbtangenten "&amp;" på en form som följer XML-syntaxen "&amp;amp;". </para>

<para>Låt oss återvända till exemplet. <application>Kview</application>s meny <guimenu>Visa</guimenu> innehåller ett antal egna åtgärder <literal>zoom50</literal>, <literal>zoom100</literal>, <literal>zoom200</literal>, <literal>zoomMaxpect</literal> och <literal>fullscreen</literal>, deklarerade med elementet <literal>&lt;Action&gt;</literal>. Skiljelinjen i skärmbilderna motsvarar elementet <literal>&lt;Separator&gt;</literal>. </para>

<para>Du märker att vissa menyalternativ inte har ett motsvarande element i XML-filen. De är <emphasis>standardåtgärder</emphasis>. Standardåtgärder skapas av klassen <ulink url="kdeapi:tdeui/KStdAction.html">KStdAction</ulink>. När du skapar sådana åtgärder i ditt program (som i C++ exemplet ovan), infogas de automatiskt på en föreskriven plats, och möjligen med en ikon och en snabbtangent. Du kan slå upp de här platserna i filen <filename>tdeui/ui_standards.rc</filename> i tdelibs-källkoden. </para>

</simplesect>


<simplesect id="xmlgui-konqexample">
<title>Ett exempel: Verktygsrader i Konqueror</title>

<para>För beskrivningen av verktygsrader, byter vi till <application>Konquerors</application> definition av grafiskt gränssnitt. Det här utdraget definierar platsraden, som innehåller inmatningsfältet för webbadresser. </para>

<programlisting>&lt;ToolBar name="locationToolBar" fullWidth="true" newline="true" &gt;
  &lt;text&gt;Location Toolbar&lt;/text&gt;
  &lt;Action name="clear_location" /&gt;
  &lt;Action name="location_label" /&gt;
  &lt;Action name="toolbar_url_combo" /&gt;
  &lt;Action name="go_url" /&gt;
&lt;/ToolBar&gt;
</programlisting>

<para>Det första vi märker är att det finns många fler egenskaper än för menyrader. De omfattar: </para>

<itemizedlist>

<listitem><para><literal>fullWidth</literal>: Talar om för det grafiska XML-gränssnittet att verktygsraden har samma bredd som toppnivåfönstret. Om detta är "false", upptar verktygsraden bara så mycket plats som nödvändigt, och ytterligare verktygsrader placeras på samma rad. </para></listitem>

<listitem><para><literal>newline</literal>: Det här hör ihop med ovanstående alternativ. Om newline är "true", så placeras verktygsraden på en ny rad. Annars kan den placeras i en rad tillsammans med den föregående verktygsraden. </para></listitem>

<listitem><para><literal>noEdit</literal>: Normalt kan verktygsrader anpassas av användaren, t.ex. med <menuchoice><guimenu>Inställningar</guimenu> <guimenuitem>Anpassa verktygsrader</guimenuitem></menuchoice> i <application>Konqueror</application>. Sätts alternativet till "true", markeras verktygsraden så att den inte går att redigera. Det är viktigt för verktygsrader som fylls med objekt när programmet kör, t.ex. <application>Konqueror</application>s bokmärkesverktygsrad. </para></listitem>

<listitem><para><literal>iconText</literal>: Talar om för det grafiska XML-gränssnittet att visa åtgärdens text intill ikonen. Normalt visas texten bara som ett verktygstips när musmarkören hålls över ikonen en stund. Möjliga värden för egenskapen är "icononly" (visar bara ikonen), "textonly" (visar bara texten), "icontextright" (visar texten till höger om ikonen) och "icontextbottom" (visar texten under ikonen). </para></listitem>


<listitem><para><literal>hidden</literal>: Om det här är "true", så visas inte verktygsraden från början, och måste aktiveras av något menyalternativ. </para></listitem>


<listitem><para><literal>position</literal>: Standardvärdet för den här egenskapen är "top", vilket betyder att verktygsraden placeras under menyraden. För program med många verktyg, som grafikprogram, kan det vara intressant att ersätta det här med "left" (vänster), "right" (höger) eller "bottom" (under). </para></listitem>

</itemizedlist>

</simplesect>


<simplesect id="xmlgui-dynamical">
<title>Dynamiska menyer</title>

<para>XML kan naturligtvis bara innehålla en statisk beskrivning av ett användargränssnitt. Ofta finns det menyer som ändras under körning. <application>Konqueror</application>s meny <guimenu>Plats</guimenu> innehåller till exempel en uppsättning alternativ <guimenuitem>Öppna med ...</guimenuitem>, med program som kan ladda en fil med en given Mime-typ. Varje gång dokumentet som visas ändras, uppdateras listan med menyalternativ. Det grafiska XML-gränssnittet är förberett för att hantera sådana fall med begreppet <emphasis>åtgärdslistor</emphasis>. En åtgärdslista deklareras som ett objekt i XML-filen, men består av flera åtgärder som ansluts till menyn när programmet kör. Ovanstående exempel implementeras med följande deklaration i <application>Konqueror</application>s XML-fil: </para>

<programlisting>&lt;Menu name="file"&gt;
  &lt;text&gt;&amp;amp;Location&lt;/text&gt;
  ...
  &lt;ActionList name="openwith"&gt;
  ...
&lt;/Menu&gt;
</programlisting>

<para>Funktionen <function>KXMLGUIClient::plugActionList()</function> används sedan för att lägga till åtgärder som ska visas, medan funktionen <function>KXMLGuiClient::unplugActionList()</function> tar bort alla anslutna åtgärder. Rutinen som är ansvarig för att göra uppdateringarna ser ut på följande sätt: </para>

<programlisting>void MainWindow::updateOpenWithActions()
{
    unplugActionList("openwith");
    openWithActions.clear();
    for ( /* Snurra för relevanta tjänster */ ) {
        TDEAction *action = new TDEAction( ...);
        openWithActions.append(action);
    }
    plugActionList("openwith", openWithActions);
}
</programlisting>

<para>Observera att i motsats till statiska åtgärder, så skapas <emphasis>inte</emphasis> de här med åtgärdssamlingen som förälder, och du ansvarar själv att de tas bort. Det enklaste sättet att åstadkomma det är genom att använda <literal>openWithActions.setAutoDelete(true)</literal> i exemplet ovan. </para>

</simplesect>


<simplesect id="xmlgui-contextmenus">
<title>Sammanhangsberoende menyer</title>

<para>Exemplen ovan innehåller bara klasser där ett huvudfönsters menyrad och verktygsrader skapas. I de fallen är processen som skapar behållarna helt dold för dig inne i anropet av funktionen <function>createGUI()</function> (utom om du har egna behållare). Det finns dock fall då du vill skapa andra behållare och befolka dem med grafiska gränssnittsdefinitioner från XML-filen. Ett sådant exempel är sammanhangsberoende menyer. För att få en pekare till en sammanhangsberoende meny, måste du fråga klientens tillverkare efter den: </para>

<programlisting>void MainWindow::popupRequested()
{
    TQWidget *w = factory()->container("context_popup", this);
    QPopupMenu *popup = static_cast&lt;QPopupMenu *&gt;(w);
    popup->exec(QCursor::pos());
}
</programlisting>

<para>Metoden <function>KXMLGUIFactory::container()</function> som används ovan, ser efter om den hittar en behållare i XML-filen med det angivna namnet. Alltså kan en möjlig definition se ut på följande sätt: </para>

<programlisting>...
&lt;Menu name="context_popup"&gt;
  &lt;Action name="file_add"/&gt;
  &lt;Action name="file_remove"/&gt;
&lt;/Menu&gt;
...
</programlisting>

</simplesect>

</sect1>


<sect1 id="help">
<title>Tillhandahålla inbyggd hjälp</title>

<para>Att göra ett program lätt och intuitivt att använda omfattar en stor mängd funktioner, som ofta kallas inbyggd hjälp. Inbyggd hjälp har flera, delvis motstridiga, mål: å ena sidan ska den ge användaren svar på frågan "Hur kan jag utföra en viss uppgift?", å andra sidan ska den hjälpa användaren utforska programmet och hitta funktioner som han inte ännu känner till. Det är viktigt att inse att det här bara kan åstadkommas genom att erbjuda flera hjälpnivåer: </para>

<itemizedlist>

<listitem><para>Verktygstips är små etiketter som dyker upp över gränssnittselement när musen blir kvar där en längre stund. De är särskilt viktiga för verktygsrader, där ikonerna inte alltid räcker till för att förklara syftet med en knapp. </para></listitem>

<listitem><para>"Vad är det här?" hjälp är ofta en längre och mer utförlig förklaring av en komponent eller menyalternativ. Den är också knepigare att använda. I dialogrutor kan den visas på två olika sätt: antingen genom att trycka på <keycombo><keycap>Skift</keycap> <keycap>F1</keycap></keycombo>, eller genom att klicka på frågetecknet i namnlisten (stöd för det här beror på fönsterhanteraren). Muspekaren ändras då till en pil med ett frågetecken, och ett hjälpfönster visas när ett element i användargränssnittet klickas. "Vad är det här?" hjälp för menyer aktiveras oftast med en knapp i verktygsraden som innehåller en pil och ett frågetecken. </para></listitem>

<listitem><para>Problemet med den här ansatsen är att användaren inte kan se om en grafisk komponent tillhandahåller hjälp eller inte. När användaren aktiverar knappen med frågetecken och inte får något hjälpfönster vid klick på ett element i användargränssnittet, blir han mycket snart frustrerad. </para>

<para>Fördelen med "Vad är det här?" hjälpfönster som de erbjuds av Qt och KDE, är att de kan innehålla <ulink url="kdeapi:qt/QStyleSheet"> formaterad text</ulink>, dvs. de kan innehålla olika teckensnitt, text med fetstil och kursiv stil, och till och med bilder och tabeller. </para>

<para>Ett exempel på "Vad är det här?" hjälp: </para>

<mediaobject>
<imageobject><imagedata fileref="whatsthis.png"/></imageobject>
</mediaobject>

</listitem>

<listitem><para>Till sist, ska alla program ha en handbok. En handbok visas normalt i <application>Hjälpcentralen</application> genom att använda menyn <guimenu>Hjälp</guimenu>. Det betyder att ett helt nytt program dyker upp och avleder användaren från arbetet. Följaktligen ska det bara vara nödvändigt att rådfråga handboken om andra funktioner, som verktygstips och vad är det här hjälp, inte räcker till. Naturligvis har en handbok fördelen att den inte förklarar enskilda isolerade aspekter av användargränssnittet. Den kan istället förklara vissa av programmets aspekter i ett större sammanhang. Handböcker för KDE skrivs med användning av <ulink url="http://i18n.kde.org">DocBook</ulink>-taggspråket. </para></listitem>

</itemizedlist>

<para>Från programmerarens synvinkel, erbjuder Qt ett enkelt gränssnitt för inbyggd hjälp. För att tilldela ett verktygstips till en grafisk komponent, använd klassen <ulink url="kdeapi:qt/QToolTip">QToolTip</ulink>. </para>

<programlisting>QToolTip::add(w, i18n("This widget does something."))
</programlisting>

<para>Om menyraderna och verktygsraderna skapas som <ulink url="actionpattern.html">åtgärdsmönster</ulink>, hämtas strängen som används som verktygstips från det första argumentet i konstruktorn <ulink url="kdeapi:tdeui/TDEAction.html">TDEAction</ulink>. </para>

<programlisting>action = new TDEAction(i18n("&amp;Delete"), "editdelete", 
                     SHIFT+Key_Delete, actionCollection(), "del")
</programlisting>

<para>Här är det också möjligt att tilldela en text som visas i statusraden när motsvarande menyalternativ markeras: </para>

<programlisting>action->setStatusText(i18n("Deletes the marked file"))
</programlisting>

<para>Programmeringsgränssnittet för "Vad är det här?" är mycket likt. Använd följande kod i dialogrutor: </para>

<programlisting>QWhatsThis::add(w, i18n("&lt;qt&gt;This demonstrates &lt;b&gt;Qt&lt;/b&gt;'s"
                        " rich text engine.&lt;ul&gt;"
                        "&lt;li&gt;Foo&lt;/li&gt;"
                        "&lt;li&gt;Bar&lt;/li&gt;"
                        "&lt;/ul&gt;&lt;/qt&gt;"))
</programlisting>

<para>För menyalternativ, använd </para>

<programlisting>action->setWhatsThis(i18n("Deletes the marked file"))
</programlisting>

<para>Start av <application>Hjälpcentralen</application> är inkapslat i klassen <ulink url="kdeapi:tdecore/TDEApplication">TDEApplication</ulink>. För att visa handboken för programmet, använd bara </para>

<programlisting>kapp->invokeHelp()
</programlisting>

<para>Det här visar första sidan med innehållsförteckningen. När du bara vill visa ett visst avsnitt av handboken, kan du ge ytterligare ett argument till <function>invokeHelp()</function>, som avgör ankaret som bläddraren hoppar till. </para>

</sect1>

</chapter>



<chapter id="components">
<title>Komponenter och tjänster</title>

<sect1 id="components-services">
<title>KDE-tjänster</title>

<simplesect id="services-whatarekdeservices">
<title>Vad är KDE-tjänster?</title>

<para>Begreppet <emphasis>tjänst</emphasis> är ett central idé i KDE:s modulära arkitektur. Det finns ingen strikt teknisk implementering kopplat till benämningen: tjänster kan vara insticksprogram i form av delade bibliotek, eller program som styrs via <ulink url="dcop.html">DCOP</ulink>. Genom att göra anspråk på att vara av en viss <emphasis>tjänsttyp</emphasis>, lovar en tjänst att implementera vissa programmeringsgränssnitt eller funktioner. Med C++ språkbruk, kan man föreställa sig en tjänsttyp som en abstrakt klass, och en tjänst som en implementering av gränssnittet. </para>

<para>Fördelen med den här uppdelningen är uppenbar: Ett program som utnyttjar en tjänsttyp behöver inte känna till möjliga implementeringar av den. Det använder bara programmeringsgränssnittet som hör ihop med tjänsttypen. På detta sätt kan tjänsten som används ändras utan att påverka programmet. Dessutom kan användaren anpassa vilka tjänster som han föredrar för vissa funktioner. </para>

<para>Några exempel: </para>

<itemizedlist>

<listitem><para>HTML-uppritningskomponenten som används i <application>Konqueror</application> är en inbäddad komponent som implementerar tjänsttypen <literal>KParts/ReadOnlyPart</literal> och <literal>Browser/View</literal>. </para></listitem>
<listitem><para>I senaste versionen av <application>KDevelop</application>, är största delen av funktionerna paketerade i insticksprogram med tjänsttypen <literal>KDevelop/Part</literal>. Vid start, laddas alla tjänster av den här typen, så att du kan utöka den integrerade utvecklingsmiljön på ett mycket smidigt sätt. </para></listitem>
<listitem><para><application>Konqueror</application> kan visa miniatyrbilder av bilder, HTML-sidor, PDF- och textfiler, om det aktiveras. Den här förmågan kan utökas. Om du vill visa förhandsgranskningsbilder av egna datafiler med en viss Mime-typ, kan du implementera en tjänst med tjänsttypen <classname>ThumbCreator</classname>. </para></listitem>

</itemizedlist>

<para>Naturligtvis karaktäriseras en tjänst inte bara av tjänsttypen som den implementerar, utan också av några <emphasis>egenskaper</emphasis>. Till exempel så gör inte en ThumbCreator bara anspråk på att implementera C++ klassen med typen <classname>ThumbCreator</classname>, den har också en lista med Mime-typer som den är ansvarig för. På samma sätt har KDevelop-delar programspråket de stöder som en egenskap. När ett program begär en tjänsttyp, kan den också ange begränsningar för tjänstens egenskaper. I exemplet ovan, när KDevelop laddar insticksprogram för ett Java-projekt, frågar det bara efter insticksprogram som har egenskapen Java som programspråk. KDE innehåller en fullständig CORBA-liknande <emphasis>handlare</emphasis>, med ett komplext frågespråk, för detta syfte. </para>

</simplesect>


<simplesect id="services-definingservicetypes">
<title>Definiera tjänsttyper</title>

<para>Nya tjänsttyper läggs till genom att installera en beskrivning av dem i katalogen <filename>TDEDIR/share/servicetypes</filename>. I det automatiska byggramverket, kan det göras med detta fragment från <filename>Makefile.am</filename>: </para>

<programlisting>kde_servicetypesdir_DATA = tdeveloppart.desktop
EXTRA_DIST = $(kde_servicetypesdir_DATA)
</programlisting>

<para>Definitionen <filename>tdeveloppart.desktop</filename> för en del till <application>KDevelop</application> ser ut som följer: </para>

<programlisting>[Desktop Entry]
Type=ServiceType
X-TDE-ServiceType=KDevelop/Part
Name=KDevelop Part

[PropertyDef::X-KDevelop-Scope]
Type=TQString

[PropertyDef::X-KDevelop-ProgrammingLanguages]
Type=QStringList

[PropertyDef::X-KDevelop-Args]
Type=TQString
</programlisting>

<para>Förutom de vanliga posterna, förevisar det här exemplet hur man anger att en tjänst har vissa egenskaper. Varje definition av en egenskap motsvarar en grupp <literal>[PropertyDef::name]</literal> i konfigurationsfilen. I gruppen, anger posten <literal>Type</literal> egenskapens typ. Möjliga typer är allt som kan lagras i en <ulink url="kdeapi:qt/QVariant">QVariant</ulink>. </para>

</simplesect>


<simplesect id="services-defininglibraryservices">
<title>Definiera delade bibliotekstjänster</title>

<para>Tjänstdefinitioner lagras i katalogen <filename>TDEDIR/share/services</filename>: </para>

<programlisting>kde_servicesdir_DATA = kdevdoxygen.desktop
EXTRA_DIST = $(kde_servicesdir_DATA)
</programlisting>

<para>Innehållet i följande exempelfil, <filename>kdevdoxygen.desktop</filename>, anger insticksprogrammet <literal>KDevDoxygen</literal> med tjänsttypen <literal>KDevelop/Part</literal>: </para>

<programlisting>[Desktop Entry]
Type=Service
Comment=Doxygen
Name=KDevDoxygen
ServiceTypes=KDevelop/Part
X-TDE-Library=libkdevdoxygen
X-KDevelop-ProgrammingLanguages=C,C++,Java
X-KDevelop-Scope=Project
</programlisting>

<para>Förutom de vanliga deklarationerna, är en viktig post <literal>X-TDE-Library</literal>. Den innehåller namnet på libtool-biblioteket (utan filändelsen <literal>.la</literal>). Det fastlägger också namnet på den exporterade symbolen i biblioteket som returnerar objekttillverkaren (med det inledande prefixet <literal>init_</literal>). I ovanstående exempel, måste biblioteket innehålla följande funktion: </para>

<programlisting>extern "C" {
    void *init_libkdevdoxygen()
    {
        return new DoxygenFactory;
    }
};
</programlisting>

<para>Typen för tillverkningsklassen <classname>DoxygenFactory</classname> beror på den specifika tjänsttyp som tjänsten implementerar. I vårt exempel med ett KDevelop-insticksprogram, måste tillverkaren vara en <classname>KDevFactory</classname> (som ärver <classname>KLibFactory</classname>). Vanligare exempel är <ulink url="kdeapi:tdeparts/KParts::Factory">KParts::Factory</ulink> som antas skapa objekten <ulink url="kdeapi:tdeparts/KParts::ReadOnlyPart">KParts::ReadOnlyPart</ulink> eller i de flesta fall det generella <ulink url="kdeapi:tdecore/KLibFactory">KLibFactory</ulink>. </para>

</simplesect>


<simplesect id="services-usinglibraryservices">
<title>Använda delade bibliotekstjänster</title>

<para>För att kunna använda en delad bibliotekstjänst i ett program, måste du skaffa ett <ulink url="kdeapi:tdeio/KService.html">KService</ulink>-objekt som representerar den. Det här beskrivs i <ulink url="mime.html">avsnittet om Mime-typer</ulink> (och i ett avsnitt om handlaren som återstår att skriva :-) </para>

<para>Med objektet <classname>KService</classname> tillgängligt, kan du mycket lätt ladda biblioteket och få en pekare till dess tillverkningsobjekt. </para>

<programlisting>KService *service = ...
TQString libName = QFile::encodeName(service->library());
KLibFactory *factory = KLibLoader::self()->factory(libName);
if (!factory) {
    TQString name = service->name();
    TQString errorMessage = KLibLoader::self()->lastErrorMessage();
    KMessageBox::error(0, i18n("There was an error loading service %1.\n"
                               "The diagnostics from libtool is:\n%2")
                          .arg(name).arg(errorMessage);
}
</programlisting>

<para>Från det ögonblicket, beror fortsättningen återigen på tjänsttypen. För generella insticksprogram, skapar man objekt med metoden <ulink url="kdeapi:tdecore/KLibFactory.html#ref3">KLibFactory::create()</ulink>. Med KParts, måste tillverkningspekaren konverteras till det mer specifika KParts::Factory, och dess metod create() måste användas: </para>

<programlisting>if (factory->inherits("KParts::Factory")) {
    KParts::Factory *partFactory = static_cast&lt;KParts::Factory*&gt;(factory);
    TQObject *obj = partFactory->createPart(parentWidget, widgetName, 
                                           parent, name, "KParts::ReadOnlyPart");
    ...
} else {
    cout &lt;&lt; "Tjänsten implementerar inte rätt tillverkare" &lt;&lt; endl;
}
</programlisting>

</simplesect>


<simplesect id="services-definingdcopservices">
<title>Definiera DCOP-tjänster</title>

<para>En DCOP-tjänst implementeras oftast som ett program som startas när det behövs. Det går därefter in i en snurra och lyssnar efter DCOP-anslutningar. Programmet kan vara interaktivt, men det kan också köra som en demon i bakgrunden under hela eller delar av sin livstid, utan att användaren märker det. Ett exempel på en sådan demon är <literal>tdeio_uiserver</literal>, som implementerar växelverkan med användaren som förloppsdialogrutor för TDEIO-biblioteket. Fördelen med en sådan central demon är att t.ex. nerladdningsförloppet för flera olika filer kan visas i ett fönster, även om nerladdningarna startades från olika program. </para>

<para>En DCOP-tjänst definieras på annat sätt än en tjänst i ett delat bibliotek. Naturligtvis anger den inte ett bibliotek, utan istället ett körbart program. Dessutom anger inte en DCOP-tjänst raden med tjänsttyp, eftersom den startas med namn. Den innehåller ytterligare två rader som ytterligare egenskaper: </para>

<para><literal>X-DCOP-ServiceType</literal> anger hur tjänsten startas. Värdet <literal>Unique</literal> (unik) anger att tjänsten inte får startas mer än en gång. Det betyder att om du försöker starta tjänsten (t.ex. via <ulink url="kdeapi:tdecore/TDEApplication.html#startServiceByName"> TDEApplication::startServiceByName()</ulink>, kontrollerar KDE om den redan har registrerats i DCOP, och använder tjänsten som kör. Om den inte redan är registrerad, startar KDE den och väntar till den har registrerats. Därför kan du omedelbart skicka DCOP-anrop till tjänsten. I detta fall, ska tjänsten implementeras som <ulink url="kdeapi:tdecore/KUniqueApplication.html">KUniqueApplication</ulink>. </para>

<para>Värdet <literal>Multi</literal> för <literal>X-DCOP-ServiceType</literal> anger att flera instanser av tjänsten kan existera samtidigt, så varje försök att starta tjänsten skapar en ny process. Som en sista möjlighet kan värdet <literal>None</literal> (ingen) användas. I detta fall, väntar inte start av tjänsten på att den har registrerats i DCOP. </para>

<para><literal>X-TDE-StartupNotify</literal> ska normalt anges som "false". Annars visar aktivitetsfältet en startbekräftelse, eller, beroende på användarinställningarna, så ändras markören. </para>

<para>Här är definitionen av <literal>tdeio_uiserver</literal>: </para>

<programlisting>[Desktop Entry]
Type=Service
Name=tdeio_uiserver
Exec=tdeio_uiserver
X-DCOP-ServiceType=Unique
X-TDE-StartupNotify=false
</programlisting>

</simplesect>


<simplesect id="services-usingdcopservices">
<title>Använda DCOP-tjänster</title>

<para>En DCOP-tjänst startas med en av flera metoder i klassen TDEApplication: </para>

<programlisting>DCOPClient *client = kapp->dcopClient();
client->attach();
if (!client->isApplicationRegistered("tdeio_uiserver")) {
    TQString error;
    if (TDEApplication::startServiceByName("tdeio_uiserver", QStringList(), &amp;error))
        cout &lt;&lt; "Start av TDEIO-server misslyckades med meddelandet " &lt;&lt; error &lt;&lt; endl;
}
...
QByteArray data, replyData;
QCString replyType;
QDataStream arg(data, IO_WriteOnly);
arg &lt;&lt; true;
if (!client->call("tdeio_uiserver", "UIServer", "setListMode(bool)", 
                  data, replyType, replyData))
    cout &lt;&lt; "Anrop till tdeio_uiserver misslyckades" &lt;&lt; endl;
...
</programlisting>

<para>Observera att exemplet med ett DCOP-anrop som ges här använder uttrycklig sammansättning av argument. Ofta vill man istället använda en prototyp som skapas av dcopidl2cpp, eftersom det är mycket enklare, och mindre felbenäget. </para>

<para>I exemplet som ges här, startas tjänsten "med namn", dvs. första argumentet till <function>TDEApplication::startServiceByName() </function> är namnet, som det anges på raden <literal>Name</literal> i desktop-filen. Ett alternativ är att använda <function>TDEApplication::startServiceByDesktopName()</function>, som använder namnet på desktop-filen som argument, dvs. i det här fallet <literal>"tdeio_uiserver.desktop"</literal>. </para>

<para>Alla dessa anrop har en lista med webbadresser som andra argument, vilket ges till tjänsten på kommandoraden. Det tredje argumentet är en pekare till en <classname>TQString</classname>. Om starten av tjänsten misslyckas, tilldelas det här argumentet det översatta felmeddelandet. </para>

</simplesect>

</sect1>


<sect1 id="components-mime">
<title>Mime-typer</title>

<simplesect id="mime-whataremimetypes">
<title>Vad är Mime-typer?</title>

<para>Mime-typer används för att beskriva typ av innehåll för filer eller datafragment. Ursprungligen infördes de för att tillåta att bilder eller ljudfiler, etc. kunde skickas med e-post (Mime betyder "Multipurpose Internet Mail Extensions"). Senare användes systemet också av webbläsare för att avgöra hur data som skickades av en webbserver skulle visas för användaren. En HTML-sida har till exempel Mime-typen "text/html", och en Postskript-fil "application/postscript". I KDE används den här idén på många skilda platser: </para>

<itemizedlist>

<listitem><para>I <application>Konqueror</application>s ikonvy, representeras filer av ikoner. Varje Mime-typ har en viss ikon som den hör ihop med, som visas här. </para></listitem>

<listitem><para>När man klickar på en filikon eller ett filnamn i <application>Konqueror</application>, så visas antingen filen i en inbäddad vy, eller så startas ett program som hör ihop med filtypen. </para></listitem>

<listitem><para>När du drar och släpper någon data från ett program till ett annat (eller inom samma program), kan målet välja att bara acceptera vissa datatyper. Dessutom hanteras bilddata på annat sätt än textdata. </para></listitem>

<listitem><para>Data på klippbordet har en Mime-typ. Traditionellt hanterade X-program bara pixmappar eller text, men med Qt finns det ingen begränsning av datatypen. </para></listitem>

</itemizedlist>

<para>Det är klart från ovanstående exempel, att Mime-hantering är en komplex sak. Först måste en tilldelning av filnamn till Mime-typer göras. KDE går ytterligare ett steg, och låter till och med filinnehåll tilldelas till Mime-typer, i de fall då filnamnet inte är tillgängligt. Därefter måste Mime-typer tilldelas till program eller bibliotek som kan visa eller redigera en fil av en viss typ, eller skapa en miniatyrbild av den. </para>

<para>Det finns en mängd olika programmeringsgränssnitt för att räkna ut Mime-typen för data eller filer. I allmänhet måste man göra en avvägning mellan hastighet och tillförlitlighet. Man kan hitta en filtyp genom att bara titta på filnamnet (i de flesta fallen filändelsen). Filen <filename>foo.jpg</filename> är till exempel normalt "image/jpeg". I de fall där filändelsen har tagits bort är det här inte säkert, och man måste verkligen titta i filens innehåll. Det är förstås långsammare, särskilt för filer som först måste laddas ner via HTTP. Den innehållsbaserade metoden använder filen <filename>TDEDIR/share/mimelnk/magic</filename>, och är därför svår att utöka. Men i allmänhet kan information om Mime-typer lätt göras tillgängligt för systemet, genom att installera en <literal>.desktop</literal>-fil, och den blir effektivt och bekvämt tillgänglig via KDE-biblioteken. </para>

</simplesect>


<simplesect id="mime-definingmimetypes">
<title>Definiera Mime-typer</title>

<para>Låt oss definiera typen <literal>"application/x-foo"</literal>, för vårt nya program <application>foobar</application>. För att göra det, måste filen <filename>foo.desktop</filename> skrivas, och installeras i <filename>TDEDIR/share/mimelnk/application</filename>. (Det är den vanliga platsen, som kan variera mellan distributioner). Det här kan göras genom att lägga till följande till <filename>Makefile.am</filename>: </para>

<programlisting>mimedir = $(kde_mimedir)/application
mime_DATA = foo.desktop
EXTRA_DIST = $(mime_DATA)
</programlisting>

<para>Filen <filename>foo.desktop</filename> ska se ut som följer: </para>

<programlisting>[Desktop Entry]
Type=MimeType
MimeType=application/x-foo
Icon=fooicon
Patterns=*.foo;
DefaultApp=foobar
Comment=Foo Data File
Comment[sv]=Foo-datafil
</programlisting>

<para>Posten <literal>"Comment"</literal> är avsedd att översättas. Eftersom <filename>.desktop</filename>-filen anger en ikon, bör du också installera en ikon <filename>fooicon.png</filename>, som representerar filen, t.ex. i <application>Konqueror</application>. </para>

<para>I KDE-biblioteken motsvarar en sådan typdefinition en instans av klassen <ulink url="kdeapi:tdeio/KMimeType.html">KMimeType</ulink>. Använd det som i följande exempel: </para>

<programlisting>KMimeType::Ptr type = KMimeType::mimeType("application/x-foo");
cout &lt;&lt; "Typ:    " &lt;&lt; type->name() &lt; endl;
cout &lt;&lt; "Ikon:    " &lt;&lt; type->icon() &lt; endl;
cout &lt;&lt; "Kommentar: " &lt;&lt; type->icon() &lt; endl;
QStringList patterns = type->patterns();
QStringList::ConstIterator it;
for (it = patterns.begin(); it != patterns.end(); ++it)
  cout &lt;&lt; "Mönster: " &lt;&lt; (*it) &lt;&lt; endl;
</programlisting>

</simplesect>


<simplesect id="mime-determiningmimetypes">
<title>Avgöra Mime-typ för data</title>

<para>Det snabba sättet att avgöra filtypen är <function>KMimeType::findByURL()</function>. Det tittar efter webbadressen och avgör i de flesta fall typen från filändelsen. Med vissa protokoll (t.ex. http, man, info), används inte den mekanismen. CGI-skript på webbservrar som skrivs i Perl, har till exempel ofta ändelsen <literal>.pl</literal>, som skulle ange typen <literal>"text/x-perl"</literal>. Dock är filen som levereras av servern utmatning från skriptet, som normalt är HTML. I sådana fall, returnerar <function>KMimeType::findByURL()</function> Mime-typen <literal>"application/octet-stream"</literal> (tillgänglig via <function>KMimeType::defaultMimeType()</function>), som anger att den misslyckades med att ta reda på typen. </para>

<programlisting>KMimeType::Ptr type = KMimeType::findByURL("/home/bernd/foobar.jpg");
if (type->name() == KMimeType::defaultMimeType())
    cout &lt;&lt; "Kunde inte avgöra typen" &lt;&lt; endl;
else
    cout &lt;&lt; "Typ: " &lt;&lt; type->name() &lt;&lt; endl;
</programlisting>

<para>(den här metoden har några fler argument, men dessa är inte dokumenterade, så glöm helt enkelt bort dem.) </para>

<para>Man kan vilja ta reda på en Mime-typ från filens innehåll i stället för filnamnet. Det är tillförlitligare, men också långsammare, eftersom det kräver att en del av filen läses. Det görs med klassen <ulink url="kdeapi:tdeio/KMimeMagic.html">KMimeMagic</ulink>, som har annorlunda felhantering: </para>

<programlisting>KMimeMagicResult *result = KMimeMagic::self()->findFileType("/home/bernd/foobar.jpg");
if (!result || !result->isValid())
    cout &lt;&lt; "Kunde inte avgöra typen" &lt;&lt; endl;
else
    cout &lt;&lt; "Typ: " &lt;&lt; result->mimeType() &lt;&lt; endl;
</programlisting>

<para>Med en variant av den här funktionen, kan du också avgöra typen för ett minnesblock. Det används till exempel av <application>Kate</application> för att räkna ut färgläggningsläget: </para>

<programlisting>QByteArray array;
...
KMimeMagicResult *result = KMimeMagic::self()->findBufferType(array);
if (!result || !result->isValid())
    cout &lt;&lt; "Kunde inte avgöra typen" &lt;&lt; endl;
else
    cout &lt;&lt; "Typ: " &lt;&lt; result->mimeType() &lt;&lt; endl;
</programlisting>

<para>Till och med KMimeMagic kan förstås bara avgöra filtypen från innehållet i en lokal fil. För fjärrfiler, finns ytterligare en möjlighet: </para>

<programlisting>KURL url("http://developer.kde.org/favicon.ico");
TQString type = TDEIO::NetAccess::mimetype(url);
if (type == KMimeType::defaultMimeType())
    cout &lt;&lt; "Kunde inte avgöra typen" &lt;&lt; endl;
else
    cout &lt;&lt; "Typ: " &lt;&lt; type &lt;&lt; endl;
</programlisting>

<para>Det här startar ett TDEIO-jobb för att ladda ner en del av filen, och kontrollera detta. Observera att den här funktionen kanske är riktigt långsam och blockerar programmet. Normalt vill man bara använda det om <function>KMimeType::findByURL()</function> returnerade <literal>"application/octet-stream"</literal>. </para>

<para>Å andra sidan, om du inte vill blockera programmet, kan du också uttryckligen starta TDEIO-jobbet och ansluta till några av dess signaler: </para>

<programlisting>void FooClass::findType()
{
    KURL url("http://developer.kde.org/favicon.ico");
    TDEIO::MimetypeJob *job = TDEIO::mimetype(url);
    connect( job, TQ_SIGNAL(result(TDEIO::Job*)),
             this, TQ_SLOT(mimeResult(TDEIO::Job*)) );
}

void FooClass::mimeResult(TDEIO::Job *job)
{
    if (job->error())
        job->showErrorDialog();
    else
        cout &lt;&lt; "Mime type: " &lt;&lt; ((TDEIO::MimetypeJob *)job)->mimetype() &lt;&lt; endl;
}
</programlisting>

</simplesect>


<simplesect id="mime-mappingmimetypes">
<title>Tilldela en Mime-typ till ett program eller tjänst</title>

<para>När ett program installeras, installerar det en <literal>.desktop</literal>-fil, som innehåller en lista med MIME-typer som programmet kan ladda. På samma sätt gör komponenter, som en KPart, den här informationen tillgänglig med sina <literal>.desktop</literal>-tjänstfiler. Alltså finns i allmänhet flera program och komponenter som kan behandla en given MIME-typ. Du kan skaffa en sådan lista från klassen <classname>KServiceTypeProfile</classname>: </para>

<programlisting>KService::OfferList offers = KServiceTypeProfile::offers("text/html", "Application");
KService::OfferList::ConstIterator it;
for (it = offers.begin(); it != offers.end(); ++it) {
    KService::Ptr service = (*it);
    cout &lt;&lt; "Namn: " &lt;&lt; service->name() &lt;&lt; endl;
}
</programlisting>

<para>Returvärdet från funktionen är en lista med tjänsterbjudanden. Ett <classname>KServiceOffer</classname>-objekt paketerar en KService::Ptr, tillsammans med ett rangordningsnummer. Listan som returneras av <function>KServiceTypeProfile::offers()</function> är ordnad enligt vad användaren föredrar. Användaren kan ändra detta genom att anropa <command>"keditfiletype text/html"</command> eller välja <guimenuitem>Redigera filtyp</guimenuitem> i <application>Konqueror</application>s sammanhangsberoende meny för en HTML-fil. </para>

<para>I exemplet ovan, begärdes en lista med erbjudanden för programmen som stöder <literal>text/html</literal>. Det omfattar, bland annat, HTML-editorer som <application>Quanta Plus</application>. Du kan också ersätta det andra argumentet <literal>"Application"</literal> med <literal>"KParts::ReadOnlyPart"</literal>. I det fallet, får du en lista med inbäddbara komponenter för att presentera HTML-innehåll, till exempel TDEHTML. </para>

<para>I de flesta fall är du inte intresserad av listan med alla erbjudanden om tjänster för en kombination av Mime-typ och tjänsttyp. Det finns en bekvämlighetsfunktion som bara ger dig tjänsterbjudandet som föredras högst: </para>

<programlisting>KService::Ptr offer = KServiceTypeProfile::preferredService("text/html", "Application");
if (offer)
    cout &lt;&lt; "Namn: " &lt;&lt; service->name() &lt;&lt; endl;
else
    cout &lt;&lt; "Ingen lämplig tjänst hittades" &lt;&lt; endl;
</programlisting>

<para>För ännu mer komplicerade förfrågningar, finns det en fullständig CORBA-liknande <ulink url="kdeapi:tdeio/TDETrader.html">handlare</ulink>. </para>

<para>För att köra en programtjänst med några webbadresser, använd <ulink url="kdeapi:tdeio/KRun.html">KRun</ulink>: </para>

<programlisting>KURL::List urlList;
urlList &lt;&lt; "http://www.ietf.org/rfc/rfc1341.txt?number=1341";
urlList &lt;&lt; "http://www.ietf.org/rfc/rfc2046.txt?number=2046";
KRun::run(offer.service(), urlList);
</programlisting>

</simplesect>


<simplesect id="mime-misc">
<title>Diverse</title>

<para>I det här avsnittet listar vi några av de programmeringsgränssnitt som på något sätt hör ihop med den föregående beskrivningen. </para>

<para>Hämta en ikon för en webbadress. Det här tittar efter webbadressens typ, och returnerar motsvarande ikon. </para>

<programlisting>KURL url("ftp://ftp.kde.org/pub/incoming/wibble.c");
TQString icon = KMimeType::iconForURL(url);
</programlisting>

<para>Kör en webbadress. Det här tittar efter webbadressens typ, och startar tillhörande program till typen som användaren föredrar. </para>

<programlisting>KURL url("http://dot.kde.org");
new KRun(url);
</programlisting>

</simplesect>

</sect1>


<sect1 id="nettransparency">
<title>Nätverkstransparens</title>

<simplesect id="nettransparency-intro">
<title>Inledning</title>

<para>Under Internetåldern är det ytterst viktigt att skrivbordsprogram kan komma åt resurser via Internet: De ska kunna ladda ner filer från en webbserver, skriva filer till en FTP-server eller läsa e-post från en e-postserver. Ofta kallas möjligheten att komma åt filer oberoende av plats för <emphasis>nätverkstransparens</emphasis>. </para>

<para>I det förflutna implementerades olika ansatser för att nå målet. Det gamla NFS-filsystemet är ett försök att implementera nätverkstransparens på POSIX-gränssnittsnivå. Medan denna ansats fungerar riktigt bra i lokala, tätt kopplade nätverk, skalas det inte för resurser med otillförlitlig och möjligen långsam åtkomst. Här är <emphasis>asynkronism</emphasis> viktig. Medan du väntar på att webbläsaren ska ladda ner en sida, ska inte användargränssnittet blockeras. Dessutom ska inte siduppritningen börja när hela sidan är tillgänglig, utan den ska uppdateras regelbundet medan data anländer. </para>

<para>I KDE-biblioteken implementeras nätverkstransparens med TDEIO-programmeringsgränssnittet. Det centrala begreppet i arkitekturen är ett I/O-<emphasis>jobb</emphasis>. Ett jobb kan kopiera filer, ta bort filer och liknande saker. Så fort ett jobb har startats, fungerar det i bakgrunden och blockerar inte programmet. All kommunikation från jobbet tillbaka till programmet, som att leverera data eller förloppsinformation, görs integrerat i Qt:s händelsesnurra. </para>

<para>Bakgrundsoperationer åstadkoms genom att starta <emphasis>I/O-slavar</emphasis> för att utföra vissa uppgifter. I/O-slavar startas som separata processer, och kommunikation sker via Unix domänuttag. På detta sätt behövs inget flertrådssystem, och instabila slavar kan inte krascha programmet som använder dem. </para>

<para>Filplatser uttrycks med webbadresser som har en omfattande användning. Men i KDE, utökar webbadresser inte bara området med tillgängliga filer utanför det lokala filsystemet. De går också i motsatt riktning, t.ex. kan man bläddra i tar-arkiv. Det åstadkoms genom att nästla webbadresser. En fil i ett tar-arkiv på en HTTP-server skulle kunna ha webbadressen: </para>

<programlisting>http://www-com.physik.hu-berlin.de/~bernd/article.tgz#tar:/paper.tex
</programlisting>

</simplesect>


<simplesect id="nettransparency-usingkio">
<title>Använda TDEIO</title>

<para>I de flesta fall skapas jobb genom att anropa funktioner i TDEIO-namnrymden. Dessa funktioner har en eller två webbadresser som argument, och möjligen också andra nödvändiga parametrar. När jobbet är avslutat, skickar det signalen <literal>result(TDEIO::Job*)</literal>. Efter signalen har skickats, tar jobbet bort sig självt. Därför ser ett typiskt användarfall ut så här: </para>

<programlisting>void FooClass::makeDirectory()
{
    SimpleJob *job = TDEIO::mkdir(KURL("file:/home/bernd/kiodir"));
    connect( job, TQ_SIGNAL(result(TDEIO::Job*)), 
             this, TQ_SLOT(mkdirResult(TDEIO::Job*)) );
}

void FooClass::mkdirResult(TDEIO::Job *job)
{
    if (job->error())
        job->showErrorDialog();
    else
        cout &lt;&lt; "mkdir gick bra" &lt;&lt; endl;
}
</programlisting>

<para>Beroende på jobbtypen, kan du också ansluta till andra signaler. </para>

<para>Här är en översikt av de möjliga funktionerna: </para>

<variablelist>

<varlistentry><term>TDEIO::mkdir(const KURL &amp;url, int permission)</term>
<listitem><para>Skapar en katalog, valfritt med vissa rättigheter. </para></listitem>
</varlistentry>

<varlistentry><term>TDEIO::rmdir(const KURL &amp;url)</term>
<listitem><para>Tar bort en katalog. </para></listitem>
</varlistentry>

<varlistentry><term>TDEIO::chmod(const KURL &amp;url, int permissions)</term>
<listitem><para>Ändrar rättigheter för en fil. </para></listitem>
</varlistentry>

<varlistentry><term>TDEIO::rename(const KURL &amp;src, const KURL &amp;dest, bool overwrite)</term>
<listitem><para>Byter namn på en fil. </para></listitem>
</varlistentry>

<varlistentry><term>TDEIO::symlink(const TQString &amp;target, const KURL &amp;dest, bool overwrite, bool showProgressInfo)</term>
<listitem><para>Skapar en symbolisk länk. </para></listitem>
</varlistentry>

<varlistentry><term>TDEIO::stat(const KURL &amp;url, bool showProgressInfo)</term>
<listitem><para>Hittar viss information om filen, som storlek, ändringstid och rättigheter. Informationen kan hämtas från TDEIO::StatJob::statResult() efter jobbet har avslutats. </para></listitem>
</varlistentry>

<varlistentry><term>TDEIO::get(const KURL &amp;url, bool reload, bool showProgressInfo)</term>
<listitem><para>Överför data från en webbadress. </para></listitem>
</varlistentry>

<varlistentry><term>TDEIO::put(const KURL &amp;url, int permissions, bool overwrite, bool resume, bool showProgressInfo)</term>
<listitem><para>Överför data till en webbadress. </para></listitem>
</varlistentry>

<varlistentry><term>TDEIO::http_post(const KURL &amp;url, const QByteArray &amp;data, bool showProgressInfo)</term>
<listitem><para>Sänder data. Särskild för HTTP. </para></listitem>
</varlistentry>

<varlistentry><term>TDEIO::mimetype(const KURL &amp;url, bool showProgressInfo)</term>
<listitem><para>Försöker hitta webbadressens Mime-typ. Typen kan hämtas från TDEIO::MimetypeJob::mimetype() efter jobbet har avslutats. </para></listitem>
</varlistentry>

<varlistentry><term>TDEIO::file_copy(const KURL &amp;src, const KURL &amp;dest, int permissions, bool overwrite, bool resume, bool showProgressInfo)</term>
<listitem><para>Kopierar en ensam fil. </para></listitem>
</varlistentry>

<varlistentry><term>TDEIO::file_move(const KURL &amp;src, const KURL &amp;dest, int permissions, bool overwrite, bool resume, bool showProgressInfo)</term>
<listitem><para>Byter namn på eller flyttar en ensam fil. </para></listitem>
</varlistentry>

<varlistentry><term>TDEIO::file_delete(const KURL &amp;url, bool showProgressInfo)</term>
<listitem><para>Tar bort en ensam fil </para></listitem>
</varlistentry>

<varlistentry><term>TDEIO::listDir(const KURL &amp;url, bool showProgressInfo)</term>
<listitem><para>Listar innehållet i en katalog. Varje gång några nya poster blir kända, skickas signalen TDEIO::ListJob::entries(). </para></listitem>
</varlistentry>

<varlistentry><term>TDEIO::listRecursive(const KURL &amp;url, bool showProgressInfo)</term>
<listitem><para>Liknar funktionen listDir(), men den här är rekursiv. </para></listitem>
</varlistentry>

<varlistentry><term>TDEIO::copy(const KURL &amp;src, const KURL &amp;dest, bool showProgressInfo)</term>
<listitem><para>Kopierar en fil eller katalog. Kataloger kopieras rekursivt. </para></listitem>
</varlistentry>

<varlistentry><term>TDEIO::move(const KURL &amp;src, const KURL &amp;dest, bool showProgressInfo)</term>
<listitem><para>Flyttar eller byter namn på en fil eller katalog. </para></listitem>
</varlistentry>

<varlistentry><term>TDEIO::del(const KURL &amp;src, bool shred, bool showProgressInfo)</term>
<listitem><para>Tar bort en fil eller katalog. </para></listitem>
</varlistentry>

</variablelist>

</simplesect>


<simplesect id="nettransparency-direntries">
<title>Katalogposter</title>

<para>Båda jobben TDEIO::stat() och TDEIO::listDir() returnerar sina resultat med typerna UDSEntry och UDSEntryList. Den senare är definierad som QValueList&lt;UDSEntry&gt;. Akronymen UDS betyder "Universal directory service" (Allmän katalogtjänst). Principen bakom detta är att katalogposten bara innehåller information som en I/O-slav kan tillhandahålla, inte mer. Till exempel tillhandahåller inte HTTP-slaven någon information om åtkomsträttigheter eller ägare av filer. Istället är en UDSEntry en lista med UDSAtoms. Varje objekt tillhandahåller viss information. Den består av en typ som lagras i m_uds, och antingen ett heltalsvärde i m_long, eller ett strängvärde i m_str, beroende på typen. </para>

<para>Följande typer är för närvarande definierade: </para>

<itemizedlist>

<listitem><para>UDS_SIZE (heltal) - Filens storlek. </para></listitem>

<listitem><para>UDS_USER (sträng) - Användaren som äger filen. </para></listitem>

<listitem><para>UDS_GROUP (sträng): Grupp som äger filen. </para></listitem>

<listitem><para>UDS_NAME (sträng): Filnamnet. </para></listitem>

<listitem><para>UDS_ACCESS (heltal) - Filens rättigheter, som t.ex. lagras av C-biblioteksfunktionen stat() i fältet st_mode. </para></listitem>

<listitem><para>UDS_FILE_TYPE (heltal): Filtypen, som t.ex. lagras av stat() i fältet st_mode. Därför kan du använda vanliga makron från C-biblioteket, som S_ISDIR, för att kontrollera värdet. Observera att data som tillhandahålls av I/O-slavar motsvarar stat(), inte lstat(), dvs. i fallet med symboliska länkar, så är filtypen här typen på filen som länken pekar ut, inte själva länken. </para></listitem>

<listitem><para>UDS_LINK_DEST (sträng): I fallet med en symbolisk länk, namnet på filen som pekas ut. </para></listitem>

<listitem><para>UDS_MODIFICATION_TIME (heltal) - Tiden (med typen time_t) då filen sist ändrades, som t.ex. lagras av stat() i fältet st_mtime. </para></listitem>

<listitem><para>UDS_ACCESS_TIME (heltal) - Tiden då filen sist användes, som t.ex. lagras av stat() i fältet st_atime. </para></listitem>

<listitem><para>UDS_CREATION_TIME (heltal) - Tiden då filen skapades, som t.ex. lagras av stat() i fältet st_ctime. </para></listitem>

<listitem><para>UDS_URL (sträng) - Tillhandahåller en fils webbadress, om den inte helt enkelt är sammanslagningen av katalogwebbadressen och filnamnet. </para></listitem>

<listitem><para>UDS_MIME_TYPE (sträng): Filens Mime-typ </para></listitem>

<listitem><para>UDS_GUESSED_MIME_TYPE (sträng): Mime-typ för filen som gissats av slaven. Skillnaden mot föregående typ är att den som tillhandahålls här inte ska betraktas som tillförlitlig (eftersom att avgöra den på ett tillförlitligt sätt skulle vara för dyrt). Klassen KRun kontrollerar till exempel uttryckligen Mime-typen, om den inte har tillförlitlig information. </para></listitem>

</itemizedlist>

<para>Även om sättet att lagra information om filer i en <classname>UDSEntry</classname> är flexibelt och praktiskt ur en I/O-slavs synvinkel, är det rörigt att använda för den somskriver programmet. För att till exempel ta reda på Mime-typen för filen, måste du snurra igenom hela innehållet och kontrollera om <literal>m_uds</literal> är <literal>UDS_MIME_TYPE</literal>. Som tur är, finns ett programmeringsgränssnitt som är mycket enklare att använda: klassen <classname>KFileItem</classname>. </para>

</simplesect>


<simplesect id="nettransparency-syncuse">
<title>Synkron användning</title>

<para>Ofta är det TDEIO:s asynkrona programmeringsgränssnitt för komplext att använda, och därför är inte implementering av fullständig asynkronism prioriterat. I ett program som till exempel bara kan hantera en dokumentfil åt gången, finns det ändå inte mycket som kan göras medan programmet laddar ner en fil. I dessa enkla fall, finns ett mycket enklare programmeringsgränssnitt, i form av ett antal statiska funktioner i TDEIO::NetAccess. För att till exempel kopiera en fil, använd: </para>

<programlisting>KURL source, target;
source = ...;
target = ...
TDEIO::NetAccess::copy(source, target);
</programlisting>

<para>Funktionen returnerar efter hela kopieringsprocessen har avslutats. Ändå så tillhandahåller den här metoden en förloppsdialogruta, och den försäkrar att programmet behandlar omritningshändelser. </para>

<para>En särskilt intressant kombination av funktioner är <function>download()</function> tillsammans med <function>removeTempFile()</function>. Den första laddar ner en fil från en given webbadress, och lagrar den i en tillfällig fil med ett unikt namn. Namnet lagras som det andra argumentet. <emphasis>Om</emphasis> webbadressen är lokal, laddas inte filen ner, utan istället sätts det andra argumentet till det lokala filnamnet. Funktionen <function>removeTempFile()</function> tar bort filen som anges av argumentet, om filen skapades av den föregående nerladdningen. Om det inte är fallet, gör den ingenting. På så sätt får man ett mycket enkelt kodfragment för att ladda filer, oberoende av deras plats: </para>

<programlisting>KURL url;
url = ...;
TQString tempFile;
if (TDEIO::NetAccess::download(url, tempFile) {
    // ladda filen med namnet tempFile
    TDEIO::NetAccess::removeTempFile(tempFile);
}
</programlisting>

</simplesect>


<simplesect id="nettransparency-metadata">
<title>Metadata</title>

<para>Som märks ovan, är gränssnittet för I/O-jobb ganska abstrakt och hanterar inte något utbyte av information mellan program och I/O-slav som är protokollspecifikt. Det är inte alltid lämpligt. Man kan till exempel ge vissa parametrar till HTTP-slaven för att styra dess cachebeteende eller skicka en mängd kakor tillsammans med begäran. För detta behov har ett koncept med metadata införts. När ett jobb skapas, kan man anpassa det genom att lägga till metadata till det. Varje metadataobjekt består av ett par med nyckel och värde. För att till exempel förhindra HTTP-slaven från att ladda en webbsida från cachen, kan du använda: </para>
 
<programlisting>void FooClass::reloadPage()
{
    KURL url("http://www.kdevelop.org/index.html");
    TDEIO::TransferJob *job = TDEIO::get(url, true, false);
    job->addMetaData("cache", "reload");
    ...
}
</programlisting>

<para>Samma teknik används åt andra hållet, dvs. för kommunikation från slaven till programmet. Metoden <function>Job::queryMetaData()</function> frågar efter värdet på en viss nyckel som levereras av slaven. För HTTP-slaven, är ett sådant exempel nyckeln <literal>"modified"</literal> (ändrad), som innehåller datumet då webbsidan sist ändrades (i form av en sträng). Ett exempel på hur det kan användas är följande: </para>
 
<programlisting>void FooClass::printModifiedDate()
{
    KURL url("http://developer.kde.org/documentation/kde2arch/index.html");
    TDEIO::TransferJob *job = TDEIO::get(url, true, false);
    connect( job, TQ_SIGNAL(result(TDEIO::Job*)),
             this, TQ_SLOT(transferResult(TDEIO::Job*)) );
}

void FooClass::transferResult(TDEIO::Job *job)
{
    TQString mimetype;
    if (job->error())
        job->showErrorDialog();
    else {
        TDEIO::TransferJob *transferJob = (TDEIO::TransferJob*) job;
        TQString modified = transferJob->queryMetaData("modified");
        cout &lt;&lt; "Senaste ändring: " &lt;&lt; modified &lt;&lt; endl;
}
</programlisting>

</simplesect>


<simplesect id="nettransparency-scheduling">
<title>Schemaläggning</title>

<para>När TDEIO-programmeringsgränssnittet används, behöver du oftast inte hantera detaljerna med att starta I/O-slavar och kommunicera med dem. Det normala användningsfallet är att starta ett jobb med några parametrar, och hantera signalerna som jobbet skickar. </para>

<para>Bakom ridån är scenariot mycket mer komplicerat. När du skapar ett jobb, läggs det i en kö. När programmet går tillbaka till händelsesnurran, tilldelar TDEIO slavprocesser för jobben i kön. För det första jobbet som startas, är detta trivialt: en I/O-slav för lämpligt protokoll startas. Efter jobbet (som en nerladdning från en HTTP-server) har avslutats, tas det dock inte omedelbart bort. Istället läggs det i en grupp med lediga slavar och tas bort efter en viss tid utan aktivitet (för närvarande tre minuter). Om en ny begäran för samma värddator och protokoll anländer, återanvänds slaven. Den uppenbara fördelen är att vid en serie jobb med samma värddator, sparar man in kostnaden för att skapa nya processer, och möjligen också att genomgå en behörighetskontroll. </para>

<para>Naturligtvis är återanvändning bara möjlig när den befintliga slaven redan har avslutat sitt tidigare jobb. Om en ny begäran anländer medan en befintlig slavprocess fortfarande kör, måste en ny process startas och användas. Med användningen i exemplen ovan av programmeringsgränssnittet, finns det ingen begränsning för att skapa nya slavprocesser: om man startar en serie nerladdningar av 20 olika filer i rad, skapar TDEIO 20 slavprocesser. Den här metoden att tilldela slavar till jobb kallas <emphasis>direkt</emphasis>. Det är inte alltid den mest lämpliga metoden, eftersom den kan behöva mycket minne och ge hög last både på klient- och serverdatorn. </para>

<para>Så det finns ett annat sätt. Man kan <emphasis>schemalägga</emphasis> jobb. Om man gör det, skapas bara ett begränsat antal (för närvarande tre) slavprocesser för ett protokoll. Om du skapar fler jobb än så, läggs de i en kö och processas när en slavprocess blir ledig. Det görs på följande sätt: </para>

<programlisting>KURL url("http://developer.kde.org/documentation/kde2arch/index.html");
TDEIO::TransferJob *job = TDEIO::get(url, true, false);
TDEIO::Scheduler::scheduleJob(job);
</programlisting>

<para>En tredje möjlighet är <emphasis>anslutningsorienterat</emphasis>. Till exempel för IMAP-slaven, är det inte vettigt att starta flera processer för samma server. Bara en IMAP-anslutning åt gången får upprätthållas. I detta fall måste programmet uttryckligen hantera slavbegreppet. Det måste tilldela en slav för en viss anslutning och sedan tilldela alla jobb som ska gå genom samma anslutning till samma slav. Det kan återigen enkelt åstadkommas genom att använda TDEIO::Scheduler: </para>

<programlisting>KURL baseUrl("imap://bernd@albert.physik.hu-berlin.de");
TDEIO::Slave *slave = TDEIO::Scheduler::getConnectedSlave(baseUrl);

TDEIO::TransferJob *job1 = TDEIO::get(KURL(baseUrl, "/INBOX;UID=79374"));
TDEIO::Scheduler::assignJobToSlave(slave, job1);

TDEIO::TransferJob *job2 = TDEIO::get(KURL(baseUrl, "/INBOX;UID=86793"));
TDEIO::Scheduler::assignJobToSlave(slave, job2);

...

TDEIO::Scheduler::disconnectSlave(slave);
</programlisting>

<para>Du kan bara koppla ner slaven efter alla jobb som tilldelats den garanterat har avslutats. </para>

</simplesect>


<simplesect id="nettransparency-definingslaves">
<title>Definiera en I/O-slav</title>

<para>I det följande beskriver vi hur du kan lägga till en ny I/O-slav i systemet. På liknande sätt som tjänster, annonseras I/O-slavar för systemet genom att installera en liten konfigurationsfil. Följande fragment av Makefile.am installerar FTP-protokollet: </para>

<programlisting>protocoldir = $(kde_servicesdir)
protocol_DATA = ftp.protocol
EXTRA_DIST = $(mime_DATA)
</programlisting>

<para>Innehållet i filen ftp.protocol är följande: </para>

<programlisting>[Protocol]
exec=tdeio_ftp
protocol=ftp
input=none
output=filesystem
listing=Name,Type,Size,Date,Access,Owner,Group,Link,
reading=true
writing=true
makedir=true
deleting=true
Icon=ftp
</programlisting>

<para>Posten <literal>"protocol"</literal> anger vilket protokoll som slaven ansvarar för. <literal>"exec"</literal> är (i motsats mot vad man naivt kan förvänta sig) namnet på biblioteket som implementerar slaven. När det är meningen att slaven ska starta, startas programmet <command>"tdeinit"</command>, som i sin tur laddar biblioteket i sitt adressrum. I praktiken kan du betrakta slaven som kör som en separat process, även om den är implementerad som ett bibliotek. Fördelen med den här mekanismen är att den sparar mycket minne, och reducerar tiden som behövs för länkning under körning. </para>

<para>Raderna "input" och "output" används inte för närvarande. </para>

<para>Återstående rader i filen <literal>.protocol</literal> anger vilka förmågor slaven har. I allmänhet är de funktioner som slaven måste implementera mycket enklare än de funktioner som TDEIO-programmeringsgränssnittet tillhandahåller programmet. Orsaken till detta är att komplexa jobb schemaläggs som en följd av deljobb. För att till exempel lista en katalog rekursivt, startas ett jobb för toppnivåkatalogen. För varje underkatalog som rapporteras tillbaka, startas nya underjobb. Schemaläggning i TDEIO försäkrar att inte för många jobb är aktiva samtidigt. På liknande sätt, för att kopiera en fil med ett protokoll som inte stöder kopiering direkt (som <literal>FTP</literal>-protokollet), kan TDEIO läsa källfilen och sedan skriva data till destinationsfilen. För att detta ska fungera, måste <literal>.protocol</literal> annonsera åtgärderna som slaven stöder. </para>

<para>Eftersom slavar laddas som delade bibliotek, men utgör fullständiga program, ser deras kodramverk något annorlunda ut jämfört med normala delade biblioteksinsticksprogram. Funktionen som anropas för att starta slaven kallas <function>kdemain()</function>. Den här funktionen gör en del initieringar, och hoppar sedan till en händelsesnurra och väntar på begäran från programmet som använder den. Det här ser ut som följer: </para>

<programlisting>extern "C" { int kdemain(int argc, char **argv); }

int kdemain(int argc, char **argv)
{
    TDELocale::setMainCatalogue("tdelibs");
    TDEInstance instance("tdeio_ftp");
    (void) TDEGlobal::locale();

    if (argc != 4) {
        fprintf(stderr, "Usage: tdeio_ftp protocol "
                        "domain-socket1 domain-socket2\n");
        exit(-1);
    }

    FtpSlave slave(argv[2], argv[3]);
    slave.dispatchLoop();
    return 0;
}
</programlisting>

</simplesect>


<simplesect id="nettransparency-implementingslaves">
<title>Implementera en I/O-slav</title>

<para>Slavar implementeras som delklasser till <classname>TDEIO::SlaveBase</classname> (FtpSlave i exemplet ovan). På så sätt motsvarar åtgärderna i <literal>.protocol</literal> vissa virtuella funktioner i <classname>TDEIO::SlaveBase</classname> som implementeringen av slaven måste implementera om. Här är en lista med möjliga åtgärder och motsvarande virtuella funktioner: </para>

<variablelist>

<varlistentry><term>läsa: Läser data från en webbadress</term>
<listitem><para>void get(const KURL &amp;url)</para></listitem></varlistentry>

<varlistentry><term>skriva: Skriver data till en webbadress och skapar filen om den inte ännu finns.</term>
<listitem><para>void put(const KURL &amp;url, int permissions, bool overwrite, bool resume)</para></listitem></varlistentry>

<varlistentry><term>flytta: Byter namn på en fil.</term>
<listitem><para>void rename(const KURL &amp;src, const KURL &amp;dest, bool overwrite)</para></listitem></varlistentry>

<varlistentry><term>ta bort: Tar bort en fil eller katalog.</term>
<listitem><para>void del(const KURL &amp;url, bool isFile)</para></listitem></varlistentry>

<varlistentry><term>lista: Listar innehållet i en katalog.</term>
<listitem><para>void listDir(const KURL &amp;url)</para></listitem></varlistentry>

<varlistentry><term>skapa katalog: Skapar en katalog.</term>
<listitem><para>void mkdir(const KURL &amp;url, int permissions)</para></listitem></varlistentry>

</variablelist>

<para>Dessutom finns det funktioner som kan implementeras om, och inte listas i filen <literal>.protocol</literal>. För dessa åtgärder, avgör TDEIO automatiskt om de stöds eller inte (dvs. standardimplementationen returnerar ett fel). </para>

<variablelist>

<varlistentry><term>Levererar information om en fil, liknar C-funktionen stat().</term>
<listitem><para>void stat(const KURL &amp;url)</para></listitem></varlistentry>

<varlistentry><term>Ändrar åtkomsträttigheter för en fil.</term>
<listitem><para>void chmod(const KURL &amp;url, int permissions)</para></listitem></varlistentry>

<varlistentry><term>Avgör Mime-typ för en fil.</term>
<listitem><para>void mimetype(const KURL &amp;url)</para></listitem></varlistentry>

<varlistentry><term>Kopierar en fil.</term>
<listitem><para>copy(const KURL &amp;url, const KURL &amp;dest, int permissions, bool overwrite)</para></listitem></varlistentry>

<varlistentry><term>Skapar en symbolisk länk.</term>
<listitem><para>void symlink(const TQString &amp;target, const KURL &amp;dest, bool overwrite)</para></listitem></varlistentry>

</variablelist>

<para>Alla dessa implementationer ska sluta med ett av två anrop: Om åtgärden lyckades, ska de anropa <literal>finished()</literal>. Om ett fel uppstod, ska de anropa <literal>error()</literal> med en felkod som första argument och en sträng som andra. Möjliga felkoder listats som uppräkningstypen <type>TDEIO::Error</type>. Det andra argumentet är oftast webbadressen i fråga. Den används t.ex. i <function>TDEIO::Job::showErrorDialog()</function> för att parametrisera felmeddelandet som är läsbart av användaren. </para>

<para>För slavar som motsvarar nätverksprotokoll, kan det vara intressant att implementera om metoden <function>SlaveBase::setHost()</function>. Den anropas för att tala om för slavprocessen om värddator och port, och användarnamn och lösenord att använda för inloggning. I allmänhet kan metadata som anges av programmet hämtas med <function>SlaveBase::metaData()</function>. Du kan kontrollera om metadata med en viss nyckel finns med <function>SlaveBase::hasMetaData()</function>. </para>

</simplesect>


<simplesect id="nettransparency-communication">
<title>Kommunicera tillbaka till programmet</title>

<para>Diverse åtgärder som implementeras i en slav, behöver något sätt att skicka tillbaka data till programmet som använder slavprocessen. </para>

<itemizedlist>

<listitem><para><function>get()</function> skickar datablock. Det görs med <function>data()</function>, som använder argumentet <classname>QByteArray</classname>. Du behöver förstås inte skicka all data på en gång. Om du skickar en stor fil, anropa <function>data()</function> med mindre datablock, så att programmet kan behandla dem. Anropa <function>finished()</function> när överföringen är klar. </para></listitem>
    
<listitem><para><function>listDir()</function> rapporterar information om posterna i en katalog. Anropa <function>listEntries()</function> med en <classname>TDEIO::UDSEntryList</classname> som argument, för detta syfte. På motsvarande sätt som <function>data()</function>, kan du anropa den flera gånger. När du är klar, anropa <function>listEntry()</function> med andra argumentet satt till true. Du kan också anropa <function>totalSize()</function> för att rapportera totalt antal katalogposter, om det är känt. </para></listitem>

<listitem><para><function>stat()</function> rapporterar information om en fil, som storlek, Mime-typ, etc. Sådan information paketeras i en <classname>TDEIO::UDSEntry</classname>, som beskrivs nedan. Använd <function>statEntry()</function> för att skicka ett sådant objekt till programmet. </para></listitem>

<listitem><para><function>mimetype()</function> anropar <function>mimeType()</function> med ett strängargument. </para></listitem>

<listitem><para><function>get()</function> och <function>copy()</function> kan vilja tillhandahålla förloppsinformation. Det görs med metoderna <function>totalSize()</function>, <function>processedSize()</function> och <function>speed()</function>. Den totala storleken och behandlade storleken rapporteras som byte, och hastigheten som byte per sekund. </para></listitem>

<listitem><para>Du kan skicka godtyckliga nyckel/värdepar av metadata med <function>setMetaData()</function>. </para></listitem>

</itemizedlist>

</simplesect>


<simplesect id="nettransparency-interacting">
<title>Kommunikation med användaren</title>

<para>Ibland måste en slav kommunicera med användaren. Exempel kan vara informativa meddelanden, dialogrutor för behörighetskontroll och bekräftelsedialogrutor när en fil håller på att skrivas över. </para>

<itemizedlist>

<listitem><para><function>infoMessage()</function>: Det här är för informativ återmatning, som meddelandet "Hämtar data från &lt;värddator&gt;" från HTTP-slaven, som ofta visas i programmets statusrad. På programsidan, motsvarar metoden signalen <function>TDEIO::Job::infoMessage()</function>. </para></listitem>

<listitem><para><function>warning()</function>: Visar en varning i en meddelanderuta med <function>KMessageBox::information()</function>. Om en meddelanderuta fortfarande visas från ett tidigare anrop av warning() från samma underprocess, händer ingenting. </para></listitem>

<listitem><para><function>messageBox()</function>: Den här är utförligare än den tidigare metoden. Den tillåter att en meddelanderuta med text och rubrik och några knappar visas. Se uppräkningstypen <type>SlaveBase::MessageBoxType</type> som referens. </para></listitem>

<listitem><para><function>openPassDlg()</function>: Visar en dialogruta för att mata in användarnamn och lösenord. </para></listitem>

</itemizedlist>

</simplesect>

</sect1>

</chapter>



<appendix id="misc">
<title>Licenser</title>

&underFDL;
&underGPL;

</appendix>

</book>