xref: /aoo4110/main/rsc/doku/feinkonz.43/rsc.doc (revision b1cdbd2c)
1.\\\ WRITER 6 \\\
2C:\ALMUT\SV\SVREF5.LAY
3R:\SW55N\TREIBER\PS.GPM
412
500000
600010
701463
800001
900001
1000001
1100002
1200002
1300000
1400000
1500000
1600000
17MM
18User Doku
19RSC
20RSC-Beschreibung
21
22
23
24
25
26
270
2811905
298390
300
310
32JA
333
3475
350
3620
370
380
390
400
410
420
430
44JA
45
46
47
486
4916
5029
51courier 9.5
52C1
5333
5419
550
56
57Helvetica 14 Pt Fett
58F1
5965
6028
612
62
63Helvetica 12 Pt Fett
64F2
6565
6624
672
68
69Helvetia 10 Pt Fett
70F3
7165
7220
732
74
75Times 10
76T1
7797
7820
790
80
81Courier 7
82C2
8333
8414
850
86
87Grund - Absatzlayout
88GA
890
900
910
920
935
9497
9520
960
970
980
991
100NEIN
101NEIN
102NEIN
103238
1040
1050
10616
1070
1080
1090
1100
1110
1120
1130
114NEIN
115
11613
117576
1180
1190
1201152
1210
1220
1231728
1240
1250
1262304
1270
1280
1292880
1300
1310
1323456
1330
1340
1354032
1360
1370
1384608
1390
1400
1415184
1420
1430
1445760
1450
1460
1476336
1480
1490
1506912
1510
1520
1537488
1540
1550
156Listing
157LI
1580
1590
1600
1610
1621
16333
16419
1650
1661
1670
1681
169NEIN
170NEIN
171NEIN
172238
1730
1740
17516
1760
1770
1780
1790
1800
1810
1820
183NEIN
184
18513
186432
1870
1880
1891008
1900
1910
1921728
1930
1940
1952304
1960
1970
1982880
1990
2000
2013456
2020
2030
2044032
2050
2060
2074608
2080
2090
2105184
2110
2120
2135760
2140
2150
2166336
2170
2180
2197632
2200
2210
2228352
2230
2240
225Funktionsparameter
226FP
2270
2282449
2290
2300
2315
23297
23320
2340
2350
2360
2371
238NEIN
239NEIN
240NEIN
241238
2420
2430
24416
2450
2460
2470
2480
2490
2500
2510
252NEIN
253
2548
2552448
2560
2570
2583024
2590
2600
2613600
2620
2630
2644176
2650
2660
2674752
2680
2690
2705328
2710
2720
2735904
2740
2750
2766480
2770
2780
279Unter�berschrift
280F1
2810
2820
2830
2840
2854
28665
28720
2880
2891
2900
2911
292NEIN
293NEIN
294NEIN
295238
2960
2970
29816
2990
3000
3010
3020
3030
3040
3050
306NEIN
307
30813
309576
3100
3110
3121152
3130
3140
3151728
3160
3170
3182304
3190
3200
3212880
3220
3230
3243456
3250
3260
3274032
3280
3290
3304608
3310
3320
3335184
3340
3350
3365760
3370
3380
3396336
3400
3410
3426912
3430
3440
3457488
3460
3470
348Punktliste
349PL
3500
351289
3520
3530
3545
35597
35620
3570
3580
3590
3601
361NEIN
362NEIN
363NEIN
364238
3650
3660
36716
3680
3690
3700
3710
3720
3730
3740
375NEIN
376
3771
378288
3790
3800
381�berschrift Klasse
382U1
3830
3840
3850
3860
3872
38865
38928
3900
3911
3920
3931
394NEIN
395NEIN
396NEIN
397238
3981
3990
40016
4010
4020
4030
4040
4050
4060
4070
408NEIN
409
41013
411576
4120
4130
4141152
4150
4160
4171728
4180
4190
4202304
4210
4220
4232880
4240
4250
4263456
4270
4280
4294032
4300
4310
4324608
4330
4340
4355184
4360
4370
4385760
4390
4400
4416336
4420
4430
4446912
4450
4460
4477488
4480
4490
450�berschrift Methode
451U0
4520
4530
4540
4550
4562
45765
45824
4590
4601
4610
4621
463NEIN
464NEIN
465NEIN
466238
4670
4680
46916
4700
4710
4720
4730
4740
4750
4760
477NEIN
478
47913
480576
4810
4820
4831152
4840
4850
4861728
4870
4880
4892304
4900
4910
4922880
4930
4940
4953456
4960
4970
4984032
4990
5000
5014608
5020
5030
5045184
5050
5060
5075760
5080
5090
5106336
5110
5120
5136912
5140
5150
5167488
5170
5180
519Kopfzeile rechts
520KR
5210
5220
5230
5240
5254
52665
52720
5280
5292
5300
5311
532NEIN
533NEIN
534NEIN
535238
5360
5370
53816
5390
5400
5410
5420
5430
5440
5450
546NEIN
547
5481
5497920
5501
5510
552Kopfzeile links
553KL
5540
5550
5560
5570
5584
55965
56020
5610
5621
5630
5641
565NEIN
566NEIN
567NEIN
568238
5690
5700
57116
5720
5730
5740
5750
5760
5770
5780
579NEIN
580
5811
5826916
5831
5840
585Fu�zeile linksb�ndig
586FL
5870
5880
5890
5900
5914
59265
59320
5940
5951
5960
5971
598NEIN
599NEIN
600NEIN
601238
6020
6030
60416
6050
6060
6070
6080
6090
6100
6110
612NEIN
613
6141
6155952
6161
6170
618Fu�zeile rechtsb�ndig
619FR
6200
6210
6220
6230
6244
62565
62620
6270
6282
6290
6301
631NEIN
632NEIN
633NEIN
6340
6350
6360
63716
6380
6390
6400
6410
6420
6430
6440
645NEIN
646
6471
6486768
6491
6500
651Linie linksb�ndig
652LL
6530
6540
6550
6560
6574
65865
65920
6600
6611
6620
6631
664NEIN
665NEIN
666NEIN
6670
6680
6690
67016
6710
6720
6730
6740
6750
6760
6770
678NEIN
679
6801
6817920
6821
6830
684Linie rechtsb�ndig
685LR
6860
6870
6880
6890
6904
69165
69220
6930
6942
6950
6961
697NEIN
698NEIN
699NEIN
7000
7010
7020
70316
7040
7050
7060
7070
7080
7090
7100
711NEIN
712
7131
7147920
7151
7160
717Tabelle
718TB
7190
7200
7210
7220
7236
72433
72514
7260
7271
7280
7291
730NEIN
731NEIN
732NEIN
733120
7340
7350
73616
7370
7380
7390
7400
7410
7420
7430
744NEIN
745
74613
747576
7480
7490
7501152
7510
7520
7531728
7540
7550
7562304
7570
7580
7592880
7600
7610
7623456
7630
7640
7654032
7660
7670
7684608
7690
7700
7715184
7720
7730
7745760
7750
7760
7776336
7780
7790
7806912
7810
7820
7837488
7840
7850
786rechtsb�ndiger Fu�strich
787RS
7880
7890
7900
7910
7924
79365
79420
7950
7962
7970
7981
799NEIN
800NEIN
801NEIN
802238
8030
8040
80516
8060
8070
8080
8090
8100
8110
8120
813NEIN
814
8151
8165952
8171
8180
819linksb�ndiger Fu�strich
820LS
8210
8220
8230
8240
8254
82665
82720
8280
8291
8300
8311
832NEIN
833NEIN
834NEIN
835238
8360
8370
83816
8390
8400
8410
8420
8430
8440
8450
846NEIN
847
8481
8495952
8501
8510
852Starlab-Layout
853GS
854566
855440
856850
857566
8581133
859680
8600
8610
8621
863NEIN
8640
8650
866
867Akl#_PFAD##_TEXTNAME#	,-#_S#-
868All______________________________________________________________
869
870Als______________________________________________________________
871Afl$Date:   23 Jan 1992 14:42:12  $
872Afr4$Revision:   1.25  $
873
874Resource linke Seite
875L2
876566
877440
878850
879566
8801133
881680
8820
8832
8841
885NEIN
8860
8870
888
889AklResource
890All______________________________________________________________
891
892Ars______________________________________________________________
893Afl-#_S#-
894Afr3StarView - Referenz
895
896Resource rechte Seite
897L3
898566
899440
900850
901566
9021133
903680
9040
9051
9061
907NEIN
9080
9090
910
911Akr=Resource
912Alr______________________________________________________________
913
914Als______________________________________________________________
915Afl(c) 1990/1991 StarDivision
916Afr@-#_S#-
917
918Resourcecompiler linke Seite
919L4
920566
921440
922850
923566
9241133
925680
9260
9272
9281
929NEIN
9300
9310
932
933AklResourcecompiler
934All______________________________________________________________
935
936Ars______________________________________________________________
937Afl-#_S#-
938Afr3StarView - Referenz
939
940Resourcecompiler rechte Seite
941L5
942566
943440
944850
945566
9461133
947680
9480
9491
9501
951NEIN
9520
9530
954
955Akr4Resourcecompiler
956Alr______________________________________________________________
957
958Als______________________________________________________________
959Afl(c) 1990/1991 StarDivision
960Afr@-#_S#-
961
962ResOwner linke Seite
963L6
964566
965440
966850
967566
9681133
969680
9700
9712
9721
973NEIN
9740
9750
976
977AklResOwner
978All______________________________________________________________
979
980Ars______________________________________________________________
981Afl-#_S#-
982Afr3StarView - Referenz
983
984ResOwner rechte Seite
985L7
986566
987440
988850
989566
9901133
991680
9920
9931
9941
995NEIN
9960
9970
998
999Akr<ResOwner
1000Alr______________________________________________________________
1001
1002Als______________________________________________________________
1003Afl(c) 1990/1991 StarDivision
1004Afr@-#_S#-
1005
1006ScrollBar linke Seite
1007L8
1008566
1009440
1010850
1011566
10121133
1013680
10140
10152
10161
1017NEIN
10180
10190
1020
1021AklScrollBar
1022All______________________________________________________________
1023
1024Ars______________________________________________________________
1025Afl-#_S#-
1026Afr3StarView - Referenz
1027
1028ScrollBar rechte Seite
1029L9
1030566
1031440
1032850
1033566
10341133
1035680
10360
10371
10381
1039NEIN
10400
10410
1042
1043Akr=ScrollBar
1044Alr______________________________________________________________
1045
1046Als______________________________________________________________
1047Afl(c) 1990/1991 StarDivision
1048Afr@-#_S#-
1049
1050SingleLineEdit linke Seite
1051M0
1052566
1053440
1054850
1055566
10561133
1057680
10580
10592
10601
1061NEIN
10620
10630
1064
1065AklSingleLineEdit
1066All______________________________________________________________
1067
1068Ars______________________________________________________________
1069Afl-#_S#-
1070Afr3StarView - Referenz
1071
1072SingleLineEdit rechte Seite
1073M1
1074566
1075440
1076850
1077566
10781133
1079680
10800
10811
10821
1083NEIN
10840
10850
1086
1087Akr8SingleLineEdit
1088Alr______________________________________________________________
1089
1090Als______________________________________________________________
1091Afl(c) 1990/1991 StarDivision
1092Afr@-#_S#-
1093
1094SysMessBox linke Seite
1095M2
1096566
1097440
1098850
1099566
11001133
1101680
11020
11032
11041
1105NEIN
11060
11070
1108
1109AklSysMessBox
1110All______________________________________________________________
1111
1112Ars______________________________________________________________
1113Afl-#_S#-
1114Afr3StarView - Referenz
1115
1116SYsMessBox rechte Seite
1117M3
1118566
1119440
1120850
1121566
11221133
1123680
11240
11251
11261
1127NEIN
11280
11290
1130
1131Akr:SysMessBox
1132Alr______________________________________________________________
1133
1134Als______________________________________________________________
1135Afl(c) 1990/1991 StarDivision
1136Afr@-#_S#-
1137
1138System linke Seite
1139M4
1140566
1141440
1142850
1143566
11441133
1145680
11460
11472
11481
1149NEIN
11500
11510
1152
1153AklSystem
1154All______________________________________________________________
1155
1156Ars______________________________________________________________
1157Afl-#_S#-
1158Afr3StarView - Referenz
1159
1160System rechte Seite
1161M5
1162566
1163440
1164850
1165566
11661133
1167680
11680
11691
11701
1171NEIN
11720
11730
1174
1175Akr?System
1176Alr______________________________________________________________
1177
1178Als______________________________________________________________
1179Afl(c) 1990/1991 StarDivision
1180Afr@-#_S#-
1181
1182SystemWindow linke Seite
1183M6
1184566
1185440
1186850
1187566
11881133
1189680
11900
11912
11921
1193NEIN
11940
11950
1196
1197AklSystemWindow
1198All______________________________________________________________
1199
1200Ars______________________________________________________________
1201Afl-#_S#-
1202Afr3StarView - Referenz
1203
1204SystemWindow rechte Seite
1205M7
1206566
1207440
1208850
1209566
12101133
1211680
12120
12131
12141
1215NEIN
12160
12170
1218
1219Akr7SystemWindow
1220Alr______________________________________________________________
1221
1222Als______________________________________________________________
1223Afl(c) 1990/1991 StarDivision
1224Afr@-#_S#-
1225
1226Timer linke Seite
1227M8
1228566
1229440
1230850
1231566
12321133
1233680
12340
12352
12361
1237NEIN
12380
12390
1240
1241AklTimer
1242All______________________________________________________________
1243
1244Ars______________________________________________________________
1245Afl-#_S#-
1246Afr3StarView - Referenz
1247
1248Timer rechte Seite
1249M9
1250566
1251440
1252850
1253566
12541133
1255680
12560
12571
12581
1259NEIN
12600
12610
1262
1263Akr@Timer
1264Alr______________________________________________________________
1265
1266Als______________________________________________________________
1267Afl(c) 1990/1991 StarDivision
1268Afr@-#_S#-
1269
1270VirtualDevice linke Seite
1271N0
1272566
1273440
1274850
1275566
12761133
1277680
12780
12792
12801
1281NEIN
12820
12830
1284
1285AklVirtualDevice
1286All______________________________________________________________
1287
1288Ars______________________________________________________________
1289Afl-#_S#-
1290Afr3StarView - Referenz
1291
1292VirtualDevice rechte Seite
1293N1
1294566
1295440
1296850
1297566
12981133
1299680
13000
13011
13021
1303NEIN
13040
13050
1306
1307Akr9VirtualDevice
1308Alr______________________________________________________________
1309
1310Als______________________________________________________________
1311Afl(c) 1990/1991 StarDivision
1312Afr@-#_S#-
1313
1314VirtualPrinter linke Seite
1315N2
1316566
1317440
1318850
1319566
13201133
1321680
13220
13232
13241
1325NEIN
13260
13270
1328
1329AklVirtualPrinter
1330All______________________________________________________________
1331
1332Ars______________________________________________________________
1333Afl-#_S#-
1334Afr3StarView - Referenz
1335
1336VirtualPrinter rechte Seite
1337N3
1338566
1339440
1340850
1341566
13421133
1343680
13440
13451
13461
1347NEIN
13480
13490
1350
1351Akr9VirtualPrinter
1352Alr______________________________________________________________
1353
1354Als______________________________________________________________
1355Afl(c) 1990/1991 StarDivision
1356Afr@-#_S#-
1357
1358VScrollBar linke Seite
1359N4
1360566
1361440
1362850
1363566
13641133
1365680
13660
13672
13681
1369NEIN
13700
13710
1372
1373AklVScrollBar
1374All______________________________________________________________
1375
1376Ars______________________________________________________________
1377Afl-#_S#-
1378Afr3StarView - Referenz
1379
1380VScrollBar rechte Seite
1381N5
1382566
1383440
1384850
1385566
13861133
1387680
13880
13891
13901
1391NEIN
13920
13930
1394
1395Akr<VScrollBar
1396Alr______________________________________________________________
1397
1398Als______________________________________________________________
1399Afl(c) 1990/1991 StarDivision
1400Afr@-#_S#-
1401
1402WarningBox linke Seite
1403N6
1404566
1405440
1406850
1407566
14081133
1409680
14100
14112
14121
1413NEIN
14140
14150
1416
1417AklWarningBox
1418All______________________________________________________________
1419
1420Ars______________________________________________________________
1421Afl-#_S#-
1422Afr3StarView - Referenz
1423
1424WarningBox rechte Seite
1425N7
1426566
1427440
1428850
1429566
14301133
1431680
14320
14331
14341
1435NEIN
14360
14370
1438
1439Akr:WarningBox
1440Alr______________________________________________________________
1441
1442Als______________________________________________________________
1443Afl(c) 1990/1991 StarDivision
1444Afr@-#_S#-
1445
1446WinBits linke Seite
1447N8
1448566
1449440
1450850
1451566
14521133
1453680
14540
14552
14561
1457NEIN
14580
14590
1460
1461AklWinBits
1462All______________________________________________________________
1463
1464Ars______________________________________________________________
1465Afl-#_S#-
1466Afr3StarView - Referenz
1467
1468WinBits rechte Seite
1469N9
1470566
1471440
1472850
1473566
14741133
1475680
14760
14771
14781
1479NEIN
14800
14810
1482
1483Akr>WinBits
1484Alr______________________________________________________________
1485
1486Als______________________________________________________________
1487Afl(c) 1990/1991 StarDivision
1488Afr@-#_S#-
1489
1490
1491
1492
14930
1494
14950
1496
1497SkfAga
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507Au0	#_KATEGORIE#
1508Aga
1509
1510Au0	#_THEMA2#
1511Aga
1512
1513Au0
1514Aga
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527Au0	#_AUTOR#
1528Aga
1529
1530Au0	STAR DIVISION / STAR LAB Hamburg
1531Aga
1532
1533Au0	Stand: $Date:   23 Jan 1992 14:42:12  $
1534Aga
1535
1536Sgs
1537SkfAgaPA
1538
1539
1540Au0#_KATEGORIE#
1541Aga
1542
1543
1544AfpDokumentenname	#_THEMA2#
1545Aga
1546AfpProjektname	#_THEMA1#
1547Aga
1548AfpVersionsnummer	$Revision:   1.25  $
1549Aga
1550
1551Afperstellt	31. Juli 1990
1552Aga
1553Afpge�ndert	$Date:   23 Jan 1992 14:42:12  $
1554Aga
1555
1556AfpDateiname	#_PFAD##_TEXTNAME#
1557Aga
1558
1559AfpAutor	#_AUTOR#
1560Aga
1561AfpBearbeiter	$Author:   MM  $
1562Aga
1563AfpQualit�tskontrolle
1564Aga
1565
1566AfpStatus	XX	in Arbeit
1567Afp	__	fertiggestellt
1568Afp	__	abgenommen
1569Afp	__	freigegeben
1570Aga
1571
1572AfpVertraulich	__ Ja   XX Nein
1573Aga
1574
1575AfpCopyright (C)	Star Division 1990
1576Aga
1577Sgs
1578SivAu0PA
1579
1580Au0Inhaltsverzeichnis
1581Aga
1582StarView Resourcecompiler	4
1583Einleitung	4
1584Bekannte Fehler	4
1585Systemabh�ngigkeiten	4
1586Installationshinweise	5
1587rsc-Kommandozeile	5
1588rsc-Preprocessor	7
1589Default Preprozessor	8
1590Einfaches Beispiel	9
1591Syntax	16
1592Klassen-Erkl�rung: Resource -> StarView	18
1593Spezielle Syntax-Konstrukte	59
1594Stichwortverzeichnis	63
1595
1596SgsAiv
1597Aga
1598Au1paStarView Resourcecompiler
1599Aga
1600
1601Au1Einleitung
1602Aga
1603Diese Beschreibung gilt f�r den Resourcecompiler in der Version 1.21.
1604
1605Der StarView Resourcecompiler ( rsc ) dient dazu, die systemunabh�ngigen Resourcen
1606in den Beschreibungsdateien in systemabh�ngige Beschreibungsdateien zu �berf�hren,
1607die dann mit den systemabh�ngigen Resourcecompilern effizient (Laufzeit) in bin�re
1608Resourcen �bersetzt werden.
1609
1610
1611Au1Bekannte Fehler
1612Aga
1613Apl-	Unter Unix (Motif) werden noch keine Icons, Bitmaps und Pointer unterst�tzt.
1614-	Die TMP-Environmentvariable darf keinen "\" am Ende haben (MS-DOS).
1615-	Unter MS-DOS wird die ".rc"-Datei nicht gel�scht.
1616-	Der rscpp gibt die Zeilennummern nicht richtig aus.
1617-	Unter Unix und MAC darf die src-Datei am Ende kein ^Z haben.
1618Aga
1619
1620Au1Systemabh�ngigkeiten
1621Aga
1622Die Resource-Scriptdatei (".src") ist bis auf die Typen Icon, Bitmap und Pointer unab
1623h�ngig. Jede Resource dieser drei Typen steht in einer eigenen Datei. Ob das Format
1624oder die Version korrekt sind, wird durch den systemabh�ngigen Resourcecompiler
1625(rc, uid, rez) entschieden.
1626
1627Die Pfadnamen in den Include-Anweisungen sind systemabh�ngig. Unter MS-DOS ist
1628der Pfadname z.B. "..\..\..", unter Unix ist er z.B. "../../.." und unter dem Betriebssystem
1629des Macintosh z.B. ":: ".
1630
1631Die erstellten Resourcedateien sind nicht nur betriebssystemabh�ngig, sondern auch
1632processor- bzw. compilerabh�ngig. Dies betrifft die L�nge des int und die Darstellung
1633(Drehungen) von ganzzahligen Datentypen.
1634
1635Die Default-Resourcedatei ist unter MS-Windows die ausf�hrbare Datei, unter Unix
1636(Motif) die ausf�hrbare Datei mit der Extension ".res" und unter Macintosh noch nicht
1637festgelegt.
1638
1639Au1paLieferumfang
1640Aga
1641Dateien fuer den Macintosh:
1642	rsc, rsc2, rscpp.
1643Dateien fuer Motif:
1644	rsc, rsc2, rscpp.
1645Dateien fuer MS-DOS:
1646	rsc.exe, rsc2.exe, rsc2r.exe, rsc2z.exe, rscpp, zpm.exe.
1647
1648Au1Installationshinweise
1649Aga
1650Beim Aufruf des rsc m�ssen der Preprocessor rscpp, der Parser rsc2 sowie der
1651systemabh�ngige Resourcecompiler rc.exe f�r MSC-Windows unter MS-DOS, uid f�r
1652Motif unter Unix und rez auf dem Macintosh im Zugriffspfad liegen. Der Preprozessor
1653kann durch einen eigenen ersetzt werden, wenn er den Schnittstellenanforderungen
1654gen�gt (siehe rsc-Preprocessor).
1655Aga
1656
1657Au1rsc-Kommandozeile
1658Aga
1659Af1Syntax der Kommandozeile
1660Aga
1661Alirsc [<Schalter>...] <Quelldateiliste>
1662rsc @<Kommandodatei>
1663Aga
1664Af1Schalter
1665Aga
1666Der rsc akzeptiert folgende Schalter:
1667Aga
1668-h			Zeigt eine Hilfe f�r die Kommandozeile an.
1669Aga-p			Es wird kein Preprozessor aufgerufen. Weiteres siehe "Default
1670			Preprozessor".
1671-s			Es wird eine Syntaxanalyse durchgef�hrt und eine ".srs"-Datei
1672			geschrieben.
1673-l			Es wird eine Syntaxanalyse durchgef�hrt, der Preprocessor wird
1674			nicht aufgerufen. Es wird eine ".rc"-Datei geschrieben. Dann
1675			wird der systemabh�ngige Resourcecompiler aufgerufen und
1676			eine ".res"-Datei erzeugt.
1677-r			Der systemabh�ngige Resourcecompiler wird nicht aufgerufen.
1678-d<Symbol>		Es wird ein Symbol definiert.
1679-i<Pfad>		Der Include-Pfad f�r den Preprocessor wird erweitert.
1680-fl<Dateiname>	Mit diesem Schalter wird eine Listing-Datei angegeben. In diese
1681			Datei werden Fehlermeldungen ausgegeben.
1682-fo<Dateiname>	�ndert den Namen der ".res"-Datei. Der Defaultname ist der
1683			erste Name in der Quelldateiliste. Dieser Name bekommt die
1684			Extension ".res". Die ".res"-Datei ist die vom Resourcecompiler
1685			erzeugte bin�re Datei.
1686-fs<Dateiname>	�ndert den Namen der ".rc"-Datei. Der Defaultname ist der erste
1687			Name in der Quelldateiliste. Dieser Name bekommt die
1688			Extension ".rc". Die ".rc"-Datei ist die vom Resourcecompiler
1689			erzeugte systemabh�ngige Beschreibungsdatei.
1690-fp<Dateiname>	�ndert den Namen der ".srs"-Datei. Der Defaultname ist der erste
1691			Name in der Quelldateiliste. Dieser Name bekommt die
1692			Extension ".srs". Die ".srs"-Datei ist eine symbolfreie
1693			Beschreibungsdatei.
1694-fc<Dateiname>	In diese Datei werden die Resource-Konstruktoren der in der
1695			Beschreibungsdatei spezifizierten Klassen geschrieben. Die
1696			Sprache ist C++.
1697-fh<Dateiname>	In diese Datei werden die Deklarationen der in der
1698			Beschreibungsdatei spezifizierten Klassen geschrieben. Die
1699			Sprache ist C++.
1700-WIN			Es wird eine MS-Windows-Resourcedatei erstellt.
1701-MTF			Es wird eine Motif-Resourcedatei erstellt.
1702-MAC			Es wird eine Mac-Resourcedatei erstellt.
1703-REFDEEP<Zahl>	Die Zahl gibt an wie Tief der rsc-Compiler beim aufl�sen von
1704			Referenzen gehen soll. Der Default ist 10, das hei�t der Compiler
1705			l�st verschachtelungen von Referenzen bis 10 auf.
1706Aga
1707Af1Kommandodatei
1708Aga
1709Die Kommandodatei hat folgende Syntax:
1710Aga
1711Ali[<Schalter>...] <Quelldateiliste>
1712Aga
1713Af1Beispiele
1714Aga
1715AliKommando: rsc test
1716Aga
1717Wirkung: Quelldatei hei�t "test.src".
1718Ae2Die vom Preprocessor erzeugte Datei hei�t "test.srs".
1719Die vom rsc-Compiler erzeugte Datei hei�t "test.rc".
1720Die vom systemabh�ngigen Compiler erzeugte Datei hei�t "test.res".
1721
1722AliKommando: rsc -s -fpTest.srs Test1 Test2 Test3
1723Aga
1724Wirkung: Es wird nur eine Syntaxanalyse durchgef�hrt.
1725Ae2Die Quelldateien hei�en "Test1.src", "Test2.src" und "Test3.src".
1726AgaDie vom Preprocessor erzeugte Datei hei�t "Test.srs".
1727AgaWeitere Dateien werden nicht erzeugt.
1728
1729AliKommando: rsc -l test
1730Aga
1731Wirkung: Quelldatei hei�t "test.srs".
1732Ae2Der Preprocessor wird nicht benutzt.
1733Die vom rsc-Compiler erzeugte Datei hei�t "test.rc".
1734Die vom systemabh�ngigen Compiler erzeugte Datei hei�t "test.res".
1735Aga
1736Au1parsc-Preprocessor
1737Aga
1738Af1Kommandozeile
1739Aga
1740AgaDie Kommandozeile hat folgende Syntax:
1741
1742Alirscpp [<Schalter>...] Quelldatei Zieldatei
1743Aga
1744Af1Schalter
1745Aga
1746-C			Entfernt die Kommentare nicht( //, /* ... */ ).
1747-D<Symbolname>	Hat die gleiche Wirkung wie #define Symbolname in der Datei
1748			selbst.
1749-I<Pfadname>	Gibt an, in welchen Verzeichnissen nach Include-Dateien gesucht
1750			werden soll.
1751
1752Af1Preprocessor-Anweisungen
1753Aga
1754Der Preprocessor mu� folgende Anweisungen verarbeiten k�nnen:
1755
1756#define		Definiert ein Symbol.
1757#undef			Nimmt die Definition eines Symbols zur�ck.
1758#if, #ifdef,
1759#ifndef, #elif,
1760#else und #endif	Bedingte �bersetzung.
1761#include		Eine Datei einschieben.
1762
1763Au1paDefault Preprozessor
1764Aga
1765Der "Default Preprozessor" erkennt nur die Schl�sselw�rter #define und #include.
1766Gro�- und Kleinschreibung wird ignoriert.
1767Hinter dem Schl�sselwort #define mu� eine Zahl definiert werden. Hierzu d�rfen
1768vorher mit dem Schl�sselwort #define definierte Namen verwendet werden. Defines
1769d�rfen nicht an beliebiger Stelle in der Datei stehen.
1770Hinter dem Schl�sselwort #include mu� ein Dateiname angegeben werden. Der Name
1771steht in spitzen Klammern oder in Anf�hrungszeichen. Beide Formate werden gleich
1772interpretiert. Includedateien innerhalb von Includedatei werden ignoriert. Die
1773Includedateien werden in der Reihenfolge in der sie auftreten abgearbeitet. Sie werden
1774immer vor der Datei abgearbeitet, in der sie definiert sind.
1775Eine Datei die nur mit dem "Default Preprozessor" �bersetzt wird, kann mit dem
1776Designeditor bearbeitet werden.
1777Au1paEinfaches Beispiel
1778Aga
1779Szenario: Es soll ein kurzes Programm geschrieben werden, um zu sehen, wie das
1780StarView-Resourcesystem arbeitet. Das Programm hei�t "ownrc".
1781
1782Af1Sourcedatei "ownrc.cxx".
1783Aga
1784Ali/**********************************************************
1785/# Programm zum Anzeigen einer Dialogbox aus der Resource
1786/# Dateiname:	ownrc.cxx
1787/# Autor:	MM
1788/# Datum:	31.07.90
1789**********************************************************/
1790/******************* I N C L U D E S *********************/
1791#include <solar.h>
1792#include <tools.hxx>
1793#include <sv.hxx>
1794#include <ownrc.hrc>  // Identifier der Dialogbox
1795
1796/******************* C L A S S E S **********************/
1797class MyApplication : public Application
1798{ // Meine Applikationsklasse
1799public:
1800	void	Main( int argc, char* argv[] );
1801};
1802
1803class MyDialog : public ModelessDialog
1804{ // Dialogbox mit einem Flash- und Cancel-Button.
1805	PushButton	aPB_Flash;
1806	PushButton	aPB_Cancel;
1807public:
1808	// Der Konstruktor mit ResId zeigt an, da� MyDialog aus
1809	// der Resource geladen wird.
1810	MyDialog( Window* pParent, ResId & rResId );
1811	void	FlashBtnHdl ( Button* );
1812	void	CancelBtnHdl( Button* );
1813};
1814
1815paclass MyWindow : public WorkWin
1816{
1817public:
1818	MyWindow( Window* pParent, WinBits aWinStyle ) :
1819		(pParent, aWinStyle)
1820	{
1821		// Es wird eine Dialogbox aus der Resource geladen.
1822		new MyDialog( this, ResId( DLG_CANCEL ));
1823	};
1824};
1825/*************** G L O B A L   V A R I A B L E S ******/
1826MyApplication MyApp; // Applikationsinstanz
1827
1828/******************* C O D E *****************************/
1829/******************* M y   Ap p l i c a t i o n **********/
1830/*********************************************************/
1831|*
1832|*  MyApplication::Main()
1833|*
1834|*  Beschreibung:	Virtuelle Methode, die vom System
1835|*				gerufen wird, um das Programm zu
1836|*				starten.
1837|*  Ersterstellung:		MM 01.08.90
1838|*  Letzte Aenderung:	MM 03.06.91
1839|*
1840**********************************************************/
1841void MyApplication::Main( int, char* argv[] )
1842{
1843	// Applikationsfenster erzeugen.
1844	MyWindow	aCancel( NULL, WinBits( WB_APP | WB_MOVEABLE |
1845							    WB_SIZEABLE |
1846							    WB_MINMAX |
1847							    WB_CLOSEABLE ));
1848	// Applikationsfenster anzeigen.
1849	aCancel.Show();
1850	// Event-Schleife des Fenstersystems starten.
1851	Execute();
1852}
1853
1854pa/**********************************************************
1855|*
1856|*  MyDialog::MyDialog()
1857|*
1858|*  Beschreibung:	Konstruktor der Klasse MyDialog.
1859|*				Dies ist ein typischer Konstruktor,
1860|*				um Objekte aus der Resource zu
1861|*				laden.
1862|*			  1. rResId.Lock(), die Resource wird
1863|*				gelockt.
1864|*			  2. aPB_Flash( this, ResId( PB_FLASH ));
1865|*				Es wird der Flash-Button geladen.
1866|*			  3. aPB_Cancel( this, ResId( PB_Cancel ));
1867|*				Es wird der Cancel-Button geladen.
1868|*			  4. rResId.Unlock(), ein Unlock auf
1869|*				die Resource.
1870|*				Wurde von keiner abgeleiteten Klasse
1871|*				ein Lock ausgef�hrt, dann wird die
1872|*				Resource an dieser Stelle freigegeben.
1873|*  Ersterstellung:		MM 01.08.90
1874|*  Letzte Aenderung:	MM 03.06.91
1875|*
1876**********************************************************/
1877MyDialog::MyDialog( Window* pParent, ResId & rResId ) :
1878				( pParent, rResId.Lock()),
1879				  aPB_Flash( this, ResId( PB_FLASH )),
1880				  aPB_Cancel( this, ResId( PB_CANCEL ))
1881{
1882	// Handler setzen.
1883	aPB_Flash.ChangeClickHdl
1884		( LINK( this, MyDialog::FlashBtnHdl ));
1885	aPB_Cancel.ChangeClickHdl
1886		( LINK( this, MyDialog::CancelBtnHdl ));
1887
1888	rResId.Unlock(); // Resource freigeben.
1889}
1890pa/*********************************************************
1891|*  MyDialog::CancelBtnHdl()
1892|*
1893|*  Beschreibung:		Die Dialogbox wird zerst�rt.
1894|*  Ersterstellung:		MM 01.08.90
1895|*  Letzte Aenderung:	MM 14.08.90
1896*********************************************************/
1897void MyDialog::CancelBtnHdl( Button* )
1898{
1899	// Das L�schen der Dialogbox ist schneller, wenn sie
1900	// vorher nicht mehr sichtbar ist.
1901	Hide();
1902	// Zerst�ren der DialogBox-Instanz.
1903	delete this;
1904}
1905
1906/**********************************************************
1907|*  MyDialog::FlashBtnHdl()
1908|*
1909|*  Beschreibung:	Die Titlebar der Dialogbox flackert
1910|*				einmal.
1911|*  Ersterstellung:		MM 01.08.90
1912|*  Letzte Aenderung:	MM 14.08.90
1913**********************************************************/
1914void MyDialog::FlashBtnHdl( Button* )
1915{
1916	FlashWindow();
1917}
1918Aga
1919Af1Resource-Headerdatei
1920Aga
1921Ali/**********************************************************
1922|* Headerdatei fuer ownrc.src
1923|* Dateiname:	ownrc.hxx
1924|* Autor:	MM
1925|* Datum:	31.07.90
1926*********************************************************/
1927#define DLG_CANCEL	300
1928#define PB_FLASH	  1
1929#define PB_CANCEL	  2
1930#define DLG_PROTOTYPE 301
1931Aga
1932Af1paResource-Beschreibungsdatei
1933Aga
1934Ali/**********************************************************
1935|* Resourcedatei fuer ownrc.cxx
1936|* Dateiname:	ownrc.src
1937|* Autor:	MM
1938|* Datum:	31.07.90
1939**********************************************************/
1940#include <ownrc.hrc>
1941
1942MODELESSDIALOG DLG_PROTOTYPE
1943{
1944	Pos		= Map_Pixel( 50, 60 );
1945	Size		= Map_SysFont( 100, 100 );
1946	TEXT		= "Markus zweite Dialogbox";
1947	MOVEABLE	= TRUE;
1948	SIZEABLE	= TRUE;
1949	CLOSEABLE	= TRUE;
1950
1951	// Diese Objekte werden automatisch angezeigt.
1952	WinChilds =
1953	{
1954		PUSHBUTTON
1955		{
1956			PosSize	= ( 10, 50, 100, 30 );
1957			TEXT		= "Ok";
1958			TABSTOP	= TRUE;
1959		};
1960		PUSHBUTTON
1961		{
1962			Pos		= ( 130, 50 );
1963			Size		= ( 100, 30 );
1964			TEXT		= "Cancel";
1965			TABSTOP	= TRUE;
1966		};
1967	};
1968};
1969paMODELESSDIALOG DLG_CANCEL
1970{
1971	PosSize	= ( 50, 60, 100, 100 );
1972	TEXT		= "Markus erste Dialogbox";
1973	MOVEABLE	= TRUE;
1974	SIZEABLE	= TRUE;
1975
1976	PUSHBUTTON PB_FLASH
1977	{
1978		PosSize	= ( 10, 50, 100, 30 );
1979		TEXT		= "Flash";
1980		TABSTOP	= TRUE;
1981	};
1982
1983	PUSHBUTTON PB_CANCEL
1984	{
1985		PosSize	= ( 130, 50, 100, 30 );
1986		TEXT		= "Abbrechen";
1987		TABSTOP	= TRUE;
1988	};
1989
1990	// Ueber solche Konstruktionen koennen Objekte in der
1991	// Resource automatisch angezeigt werden.
1992	WinChilds =
1993	{
1994		MODELESSDIALOG , DLG_PROTOTYPE;
1995	};
1996};
1997Aga
1998Af1paMakefile
1999Aga
2000Wie die Dateien gebildet werden, ist dem StarView-Handbuch und den dazugeh�rigen
2001Beispielen zu entnehmen. Der Aufruf des Resourcecompilers lautet in diesem Fall:
2002Aga
2003Aliownrc.res: ownrc.src ownrc.hrc
2004	rsc -fsownrc.rc -fpownrc.srs
2005		-foownrc.res -flownrc.lst ownrc.src
2006Aga
2007Agaownrc.src ist die Eingabedatei des rsc-Compilers.
2008ownrc.srs ist ein Zwischenformat des rsc-Compilers.
2009ownrc.lst ist die Listingdatei des rsc-Compilers.
2010ownrc.rc ist die Textdatei, die als Eingabe des systemspezifischen Compilers dient.
2011ownrc.res ist die bin�re Resourcedatei.
2012
2013Speziell f�r MS-Windows gilt, da� die Resourcedatei an die ".exe"-Datei angebunden
2014werden kann.
2015Aga
2016Ali	rc -k ownrc.res ownrc.exe
2017Aga
2018AgaMit dieser Zeile wird die Resource an die ".exe"-Datei angebunden.
2019Aga
2020Au1paSyntax
2021Aga
2022Af1Compiler Anweisungen
2023Aga#pragma CHARSET IBMPC
2024#pragma CHARSET ANSI
2025#pragma CHARSET MAC
2026Mit diesen Optionen kann angegeben werden, in welchem Zeichensatz die Strings
2027vorliegen. Der Compiler nimmt dann eine Konvertierung in das Zielsystem vor. Als
2028Default wird vorausgesetzt, da� die Datei im Zeichensatz des Zielsystems vorliegt.
2029
2030Af1Default Preprozessor-Syntax
2031AliPrepDefinition:
2032		{ IncludeDefinition }
2033		[{ DefineDefinition  }]
2034
2035IncludeDefinition:
2036		'#' include '<' Dateiname '>' |
2037		'#' include String
2038Ali
2039DefineDefinition:
2040		'#' define SYMBOL NumberExpression
2041
2042Af1Klass-Syntax
2043AliResourceDefinition:
2044Ali		[ PrepDefinition ]
2045		{ ClassDefinition }
2046
2047ClassDefinition:
2048		ClassHeader ClassBody ';'
2049		ClassHeader ';' |
2050		NumberExpression ';' |
2051		TupelExpression ';' |
2052		CONSTNAME ';' |
2053		Boolean ';' |
2054		String ';'
2055
2056ClassHeader:
2057		CLASSNAME [ Identifier ] [ ',' | '<' Identifier ]
2058pa
2059ClassBody:
2060	'{'
2061		{
2062			ClassDefinition |
2063			VariableDefiniton
2064		}
2065	'}'
2066
2067VariableDefinition:
2068		VARIABLENAME '=' ClassDefinition |
2069		VARIABLENAME '=' '{' { ClassDefinition } '}' ';'
2070
2071TupelExpression:
2072	[ ClassDefinition ] '(' { ClassDefinition } ')'
2073
2074NumberExpression:
2075		[ '-' | '+' ] Number |
2076		NumberExpression '+' | '-' | '*' | '/'
2077		NumberExpression |
2078		[ '-' | '+' ] '(' NumberExpression ')'
2079
2080Identifier:
2081		NumberExpression |
2082		Symbol
2083
2084Number:
2085		{ DEZIMALZIFFER } |
2086		'0' 'x' { HEXADEZIMALZIFFER }
2087
2088Boolean:
2089		TRUE | FALSE
2090
2091AgaString:
2092Aga		Mit "\57" k�nnen bestimmte Zeichenwerte angegeben werden.
2093		Der Backslash wird durch "\\" und das Anf�hrungszeichen durch "\""
2094		angegeben. Die Zahl hinter dem Backslash wird Oktal interpretiert.
2095Aga
2096Au1paKlassen-Erkl�rung: Resource -> StarView
2097Aga
2098In diesem Abschnitt wird anhand von vollst�ndigen Beispielen erkl�rt, was f�r Daten
2099in welchen StarView-Klassen in der Resource definiert werden k�nnen.
2100
2101Die Resource ist wie StarView hierarchisch aufgebaut. Das hei�t, alles in einer h�heren
2102Hierarchiestufe Enthaltene wird in eine tiefere �bertragen. Die Namen im nach
2103folgenden Diagramm sind die Namen der Schl�sselw�rter in der Resource, mit Aus
2104nahme von SystemWindow und Edit.
2105
2106Af1Hierarchie:
2107Aga
2108AgaResource
2109	String
2110	Icon
2111	Bitmap
2112	Pointer
2113	Brush
2114	Color
2115	Font
2116	Pen
2117	MapMode
2118	Accelerator
2119	AcceleratorKey
2120	Menu
2121	MenuItem
2122	MessBox
2123		SysMessBox
2124		InfoBox
2125		WarningBox
2126		ErrorBox
2127		QueryBox
2128	OutputDevice
2129		Window
2130			[SystemWindow]
2131				WorkWindow
2132					MDIWindow
2133				[Dialog]
2134					ModelessDialog
2135					ModalDialog
2136			Control
2137				Button
2138					CheckBox
2139						AutoCheckBox
2140					PushButton
2141						DefPushButton
2142					RadioButton
2143						AutoRadioButton
2144					TriStateBox
2145						AutoTriStateBox
2146				[Edit]
2147					SingleLineEdit
2148					MultiLineEdit
2149				ScrollBar
2150					AutoScrollBar
2151				ListBox
2152					DropDownListBox
2153					ComboBox
2154						DropDownComboBox
2155				FixedText
2156				FixedIcon
2157				FixedBitmap
2158				GroupBox
2159
2160Alle Daten, die in Button angegeben werden, k�nnen auch in PushButton oder
2161CheckBox angegeben werden. Entsprechendes gilt z.B. f�r Daten in ListBox, die auch
2162in ComboBox angegeben werden k�nnen. Eine genauere Erkl�rung folgt nach den
2163Erl�uterungen der einzelnen Resourcetypen.
2164Aga
2165Af1paResource Resource
2166Aga
2167Diese Resource definiert Daten f�r die StarView-Klasse Resource.
2168
2169AgaBeispiel:
2170Aga
2171Ali	Resource
2172	{
2173		Comment = "Dies ist ein Kommentar.";
2174		SingleLineEdit 1
2175		{
2176			Text = "Editfeld";
2177		};
2178		PushButton 1
2179		{
2180			Check = TRUE;
2181		};
2182		String 1 "Vorname";
2183		String 2 "Nachname";
2184		String 3 "Adresse";
2185		String 4 "Telefon";
2186		// Zwei Strings angehaengt
2187		EXTRADATA = { 2; // Anzahl der Strings
2188		              "Hallo"; "Markus";
2189		            };
2190		// Vier short angehaengt
2191		EXTRADATA = { 4; // Anzahl der Zahlen
2192		              1; 100; 5; 12;
2193		            };
2194	};
2195Aga
2196In dieser Klasse k�nnen nur lokale Resourcen definiert werden.
2197
2198Wie das Schl�sselwort EXTRADATA verwendet wird lesen sie bitte im Kapitel
2199"Spezielle Resource-Konstrukte" nach.
2200
2201Nach dem Schl�sselwort COMMENT kann ein Kommentar angegeben werden. Unter
2202StarView hat diese Angabe keine Funktion. Sie dient zum Beschreiben von Resourcen,
2203da der Designeditor alle anderen Kommentare l�scht.
2204
2205AgaDefault:
2206Aga
2207Ali	Resource {};
2208Aga
2209Af1Resource String
2210Aga
2211Diese Resource definiert Daten f�r die StarView-Klasse String.
2212
2213AgaBeispiel:
2214Aga
2215Ali	String 1000
2216	{
2217		Text = "Hello World";
2218	};
2219Aga
2220Als abk�rzende Schreibweise ist auch
2221Ali	String 1000 "Hello World";
2222Agaerlaubt.
2223Aga
2224Af1paResource Icon
2225Aga
2226Diese Resource definiert Daten f�r die StarView-Klasse Icon.
2227
2228AgaBeispiel:
2229Aga
2230Ali	Icon
2231	{
2232		Predefine = ICON_DEFAULT;
2233	};
2234Aga
2235Nach dem Schl�sselwort PREDEFINE wird ein Icon benannt, das schon in StarView
2236vorhanden ist. Anstelle von ICON_DEFAULT kann auch ICON_INFORMATION,
2237ICON_EXCLAMATION, ICON_STOP oder ICON_QUERY geschrieben werden.
2238Wie diese Icons aussehen, kann im StarView-Handbuch unter der Klasse Icon nach
2239gelesen werden.
2240
2241AgaBeispiel:
2242Aga
2243Ali	Icon
2244	{
2245		File       = "Icon.ico";
2246		//Nur fuer MAC
2247		Type       = ICON_CICN;
2248		Identifier = 1000;
2249	};
2250Aga
2251Nach dem Schl�sselwort FILE wird ein Dateiname angegeben, der auf eine Datei ver
2252weist, die ein Icon enth�lt. Diese Datei ist systemabh�ngig.
2253
2254Nach dem Schl�sselwort TYPE wird der Typ des Icons angegeben. Es k�nnen
2255ICON_ICON und ICON_CICN als Typen angegeben werden. ICON_ICON verweist
2256auf den Mac-Resourcetyp 'ICON' und ICON_CICN auf den Typ 'cicn'. Diese Angabe
2257wird nur f�r den Mac ben�tigt.
2258
2259Nach dem Schl�sselwort IDENTIFIER wird der Identifier des Icons in der durch FILE
2260spezifizierten Datei angegegeben. Diese Angabe wird nur f�r den Mac ben�tigt.
2261
2262Werden PREDEFINE und FILE angegeben, wird eins der beiden Schl�sselw�rter
2263gew�hlt.
2264
2265AgaDefault:
2266Aga
2267Ali	Icon
2268	{
2269		Predefine = ICON_DEFAULT;
2270	};
2271Aga
2272F�r IDENTIFIER und TYPE gibt es keinen Default.
2273Af1paResource Bitmap
2274Aga
2275Diese Resource definiert Daten f�r die StarView-Klasse Bitmap.
2276Aga
2277AgaBeispiel:
2278Aga
2279Ali	Bitmap
2280	{
2281		File = "Bitmap.bmp";
2282		// Nur fuer Mac
2283		//TYPE = ; Es gibt nur einen Typ
2284		Identifier = 1000;
2285	};
2286Aga
2287Nach dem Schl�sselwort FILE wird ein Dateiname angegeben, der auf eine Datei ver
2288weist, die eine Bitmap enth�lt. Diese Datei ist systemabh�ngig.
2289
2290Nach dem Schl�sselwort TYPE wird der Typ der Bitmap angegeben. Dieses
2291Schl�sselwort ist f�r zuk�nftige Erweiterungen. Der Mac-Resourcetyp ist 'PICT'.
2292Diese Angabe wird nur f�r den Mac ben�tigt.
2293
2294Nach dem Schl�sselwort IDENTIFIER wird der Identifier der Bitmap in der durch
2295FILE spezifizierten Datei angegegeben. Diese Angabe wird nur f�r den Mac ben�tigt.
2296
2297AgaDefault:
2298Aga
2299Ali	Bitmap
2300	{
2301		File = "";
2302	};
2303Aga
2304Der Default ergibt immer einen Fehler. F�r IDENTIFIER und TYPE gibt es keinen
2305Default.
2306
2307Af1paResource Pointer
2308Aga
2309Diese Resource definiert Daten f�r die StarView-Klasse Pointer.
2310
2311AgaBeispiel:
2312Aga
2313Ali	Pointer
2314	{
2315		Predefine = POINTER_ARROW;
2316	};
2317Aga
2318Nach dem Schl�sselwort PREDEFINE wird ein Pointer benannt, der schon in
2319StarView vorhanden ist. Anstelle von POINTER_ARROW kann auch
2320POINTER_WAIT, POINTER_CROSS oder POINTER_BEAM geschrieben werden.
2321Wie diese Pointer aussehen, ist im StarView-Handbuch unter der Klasse Pointer
2322nachzulesen.
2323
2324AgaBeispiel:
2325Aga
2326Ali	Pointer
2327	{
2328		File = "Pointer.pnt";
2329		// Nur fuer Mac
2330		Identifier = 1000;
2331	};
2332Aga
2333Nach dem Schl�sselwort FILE wird ein Dateiname angegeben, der auf eine Datei ver
2334weist, die einen Pointer enth�lt. Diese Datei ist systemabh�ngig.
2335
2336Nach dem Schl�sselwort IDENTIFIER wird der Identifier des Pointers in der durch
2337FILE spezifizierten Datei angegegeben. Diese Angabe wird nur f�r den Mac ben�tigt.
2338
2339Nach dem Schl�sselwort TYPE wird der Typ des Pointers angegeben. Dieses
2340Schl�sselwort ist f�r zuk�nftige Erweiterungen. Der Mac-Resourcetyp ist 'CURS'.
2341Diese Angabe wird nur f�r den Mac ben�tigt.
2342
2343Werden PREDEFINE und FILE angegeben, wird eine der beiden M�glichkeiten
2344ausgew�hlt.
2345
2346AgaDefault:
2347Aga
2348Ali	Pointer
2349	{
2350		Predefine = POINTER_ARROW;
2351	};
2352Aga
2353F�r IDENTIFIER und TYPE gibt es keinen Default.
2354
2355
2356Af1Resource Brush
2357Aga
2358Diese Resource definiert Daten f�r die StarView-Klasse Brush.
2359
2360AgaBeispiel:
2361Aga
2362Ali	Brush
2363	{
2364		Style		= BRUSH_SOLID;
2365		Transparent	= TRUE;
2366		BrushColor	= Color
2367		{
2368			RGB	= (0, 0, 0);
2369		};
2370		FillColor	= Color
2371		{
2372			RGB	= (65535, 65535, 65535);
2373		};
2374	};
2375Aga
2376Nach dem Schl�sselwort STYLE wird der Stil einer Brush benannt. Die Stile sind in
2377StarView vordefiniert. Anstelle von BRUSH_SOLID kann auch
2378BRUSH_HORZ,		BRUSH_VERT,		 BRUSH_CROSS,
2379BRUSH_DIAGCROSS,	
2380BRUSH_UPDIAG,	BRUSH_DOWNDIAG,
2381BRUSH_BITMAP,		BRUSH_25,		BRUSH_50,
2382BRUSH_75,			BRUSH_NULL geschrieben werden. Wie diese Stile
2383aussehen, ist im StarView-Handbuch unter der Klasse Brush nachzulesen.
2384
2385Nach dem Schl�sselwort TRANSPARENT kann TRUE oder FALSE angegeben
2386werden. FALSE bedeutet, da� die Brush transparent ist, bei TRUE wird die Brush mit
2387der F�llfarbe hinterlegt.
2388Aga
2389Die Farbe BRUSHCOLOR ist die Farbe des Musters.
2390Die Farbe FILLCOLOR ist die Farbe in den L�cken innerhalb des Musters.
2391
2392AgaBeispiel:
2393Aga
2394Ali	Brush
2395	{
2396		Bitmap
2397		{
2398			File = "Bitmap.bmp";
2399		};
2400	};
2401Aga
2402Die angegebene Bitmap wird als Brush verwendet. Die Color- und Style-Eintr�ge sind
2403wirkungslos. Das Format der Bitmap ist dem StarView-Handbuch zu entnehmen.
2404
2405Wird BITMAP in Kombination mit FILLCOLOR, BRUSHCOLOR oder STYLE
2406verwendet, wird eine der M�glichkeiten gew�hlt.
2407
2408AgaDefault:
2409Aga
2410Ali	Brush
2411	{
2412		Style		= BRUSH_SOLID;
2413		Transparent	= FALSE;
2414	};
2415Aga
2416Welche Defaults f�r FILLCOLOR und BRUSHCOLOR verwendet werden, ist im
2417StarView-Handbuch unter der Klasse Brush nachzulesen.
2418Au2
2419Af1paResource Color
2420Aga
2421Diese Resource definiert Daten f�r die StarView-Klasse Color.
2422
2423AgaBeispiel:
2424Aga
2425Ali	Color
2426	{
2427		RGB = ( 32768, 0, 32768);
2428	};
2429Aga
2430Nach dem Schl�sselwort RGB wird der Rot-, Gr�n- und Blauanteil einer Farbe defi
2431niert. Das erste Element im Tupel steht f�r Rot, das zweite f�r Gr�n und das dritte f�r
2432Blau. Die Intensit�t kann mit Werten im Bereich von 0 bis 65535 angegeben werden.
2433
2434AgaBeispiel:
2435Aga
2436Ali	Color
2437	{
2438		Red   = 1;
2439		Green = 2;
2440		Blue  = 3;
2441	};
2442Aga
2443Durch das Schl�sselwort RED wird die Rotanteil bestimmt.
2444Durch das Schl�sselwort GREEN wird die Gr�nanteil bestimmt.
2445Durch das Schl�sselwort BLUE wird die Blauanteil bestimmt.
2446Aga
2447Beispiel:
2448Aga
2449Ali	Color
2450	{
2451		Predefine = COL_BLACK;
2452	};
2453Aga
2454AgapaNach dem Schl�sselwort PREDEFINE wird eine Farbe benannt. Die Farben sind in
2455StarView vordefiniert. Anstelle von COL_BLACK kann auch
2456COL_BLUE,			COL_GREEN,	
2457	COL_CYAN,
2458COL_RED,			COL_MAGENTA,		COL_BROWN,
2459COL_GRAY,			COL_LIGTHGRAY,		COL_LIGHTBLUE,
2460COL_LIGHTGREEN,	COL_LIGHTCYAN,		COL_LIGHTRED,
2461COL_LIGHTMAGENTA,		COL_YELLOW,			COL_WHITE,
2462COL_MENUBAR,		COL_MENUBARTEXT,	
2463COL_POUPMENU,
2464COL_POPUPMENUTEXT,	COL_3DTEXT,			COL_3DFACE,
2465COL_3DLIGHT,		COL_3DSHADOW,		COL_USER
2466geschrieben werden. Wie diese Farben aussehen, ist im StarView-Handbuch unter der
2467Klasse Color nachzulesen.
2468Aga
2469Default:
2470Aga
2471Ali	Color
2472	{
2473		Predefine = COL_USER; // RGB g�ltig
2474		RGB = (0, 0, 0);       // schwarz
2475	};
2476Aga
2477Af1paResource Font
2478Aga
2479Diese Resource definiert die Daten f�r die StarView-Klasse Font.
2480
2481AgaBeispiel:
2482Aga
2483Ali	Font
2484	{
2485		Family			= FAMILY_DECORATIVE;
2486		Weight			= WEIGHT_DONTKNOW;
2487		CharSet		= CHARSET_ANSI;
2488		Pitch			= PITCH_FIXED;
2489		Align			= ALIGN_BOTTOM;
2490		Height			= 12;
2491		Width			= 6;
2492		CharOrientation	= 0;
2493		LineOrientation	= 0;
2494		Italic			= TRUE;
2495		Underline		= TRUE;
2496		StrikeOut		= TRUE;
2497		Transparent		= TRUE;
2498		Shadow			= TRUE;
2499		Outline		= TRUE;
2500		Text			= "FontName";
2501		FontColor		= Color { RGB = ( 0, 0, 0 ); };
2502		FillColor		= Color { Predefine = COL_RED; };
2503	};
2504Aga
2505AgaNach dem Schl�sselwort FAMILY wird eine Font-Familie benannt. Die Font-Familien
2506sind in StarView vordefiniert. Anstelle von FAMILY_DECORATIVE kann auch
2507FAMILY_SCRIPT, FAMILY_MODERN, FAMILY_ROMAN, FAMILY_SWISS,
2508FAMILY_SYSTEM oder FAMILY_DONTCARE geschrieben werden. Was diese
2509Font-Familien bewirken, ist im StarView-Handbuch unter der Klasse Font
2510nachzulesen.
2511Aga
2512AgaNach dem Schl�sselwort WEIGHT wird ein weiteres Attribut des Fonts benannt. Diese
2513Attribute sind in StarView vordefiniert. Anstelle von WEIGHT_DONTKNOW kann
2514auch WEIGHT_LIGHT, WEIGHT_NORMAL oder WEIGHT_BOLD geschrieben
2515werden. Was dieses Attribut bewirkt, ist im StarView-Handbuch unter der Klasse Font
2516nachzulesen.
2517Aga
2518AgaNach dem Schl�sselwort CHARSET wird der Zeichensatz des Fonts benannt. Anstelle
2519von CHARSET_ANSI kann auch CHARSET_DONTKNOW, CHARSET_IBMPC,
2520CHARSET_MAC oder CHARSET_SYMBOL geschrieben werden.
2521Aga
2522paNach dem Schl�sselwort PITCH wird ein weiteres Attribut des Fonts benannt. Anstelle
2523von PITCH_FIXED kann auch PITCH_DONTKNOW oder PITCH_VARIABLE
2524geschrieben werden.
2525Aga
2526Nach dem Schl�sselwort ALIGN wird die Ausrichtung des Fonts benannt. Anstelle
2527von ALIGN_BOTTOM kann auch ALIGN_TOP oder ALIGN_BASELINE geschrie
2528ben werden.
2529Aga
2530Nach dem Schl�sselwort HEIGHT wird die H�he eines Fonts angegeben. Der Zahlen
2531bereich umfa�t Werte von 0 bis 65535.
2532
2533Nach dem Schl�sselwort WIDTH wird die Breite eines Fonts angegeben. Der Zahlen
2534bereich umfa�t Werte von 0 bis 65535.
2535
2536Nach dem Schl�sselwort CHARORIENTATION wird die Drehung der Zeichen ange
2537geben. Die Angabe der Drehung erfolgt in Zehntelgrad. Der Zahlenbereich umfa�t
2538Werte von 0 bis 3600.
2539
2540Nach dem Schl�sselwort LINEORIENTATION  wird die Drehung der Ausgabezeile
2541angegeben. Die Angabe der Drehung erfolgt in Zehntelgrad. Der Zahlenbereich umfa�t
2542Werte von 0 bis 3600.
2543
2544Nach dem Schl�sselwort ITALIC kann TRUE oder FALSE angegeben werden. Bei
2545TRUE handelt es sich um einen kursiven Font, bei FALSE um einen nicht kursiven
2546Font.???
2547
2548Nach dem Schl�sselwort UNDERLINE kann TRUE oder FALSE angegeben werden.
2549Bei TRUE handelt es sich um einen unterstrichenen Font, bei FALSE ist der Font nicht
2550unterstrichen.
2551
2552Nach dem Schl�sselwort STRIKEOUT kann TRUE oder FALSE angegeben werden.
2553Bei TRUE handelt es sich um einen durchgestrichenen Font, bei FALSE ist der Font
2554nicht durchgestrichen.
2555
2556Nach dem Schl�sselwort TRANSPARENT kann TRUE oder FALSE angegeben
2557werden. Bei TRUE werden die Zeichen mit der F�llfarbe ausgef�llt, bei FALSE
2558werden die Zeichen nicht ausgef�llt.
2559
2560Nach dem Schl�sselwort SHADOW kann TRUE oder FALSE angegeben werden. Bei
2561TRUE werden die Zeichen mit Schatten ausgegeben, bei FALSE gibt es keinen
2562Schatten.
2563
2564Nach dem Schl�sselwort OUTLINE kann TRUE oder FALSE angegeben werden. Bei
2565TRUE wird nur der Umriss der Zeichen ausgegeben, bei FALSE werden die Zeichen
2566normal dargestellt.
2567
2568Nach dem Schl�sselwort TEXT wird der Name des Fonts angegeben.
2569
2570Die Farbe FONTCOLOR ist die Farbe des Fonts.
2571Die Farbe FILLCOLOR ist die Farbe der L�cken zwischen den Zeichen.
2572
2573AgapaDefault:
2574Aga
2575Ali	Font
2576	{
2577		Family			= FAMILY_DONTKNOW;
2578		Weight			= WEIGHT_NORMAL;
2579		CharSet		= CHARSET_DONTKNOW;
2580		Pitch			= PITCH_DONTKNOW;
2581		Align			= ALIGN_TOP;
2582		Height			= 0;
2583		Width			= 0;
2584		CharOrientation	= 0;
2585		LineOrientation	= 0;
2586		Italic			= FALSE;
2587		Underline		= FALSE;
2588		StrikeOut		= FALSE;
2589		Transparent		= FALSE;
2590		Shadow			= FALSE;
2591		OutLine		= FALSE;
2592		Text			= "";
2593	};
2594Aga
2595Welche Defaults f�r FONTCOLOR und FILLCOLOR verwendet werden, ist im
2596StarView-Handbuch unter der Klasse Font nachzulesen.
2597Au2
2598Af1paResource Pen
2599Aga
2600Diese Resource definiert die Daten f�r die StarView-Klasse Pen.
2601
2602AgaBeispiel:
2603Aga
2604Ali	Pen
2605	{
2606		Width		= 1;
2607		Style		= PEN_DASH;
2608		PenColor	= Color
2609		{
2610			Predefine = COL_BLACK;
2611		};
2612	};
2613Aga
2614Hinter dem Schl�sselwort WIDTH wird die Breite des Stiftes angegeben. Der Zahlen
2615bereich umfa�t Werte von 0 bis 65536.
2616Hinter dem Schl�sselwort Style wird der Linientyp des Stiftes angegeben. Die Typen
2617sind in StarView vordefiniert. Anstelle von PEN_DASH kann auch PEN_NULL,
2618PEN_SOLID, PEN_DOT oder PEN_DASHDOT geschrieben werden. Wie diese
2619Typen aussehen, ist im StarView-Handbuch unter der Klasse Pen nachzulesen.
2620Aga
2621Default:
2622Aga
2623Ali	Pen
2624	{
2625		Width = 0;
2626		Style = PEN_NULL;
2627		PenColor = Color;
2628		{
2629			RGB = (0, 0, 0);
2630		};
2631	};
2632Aga
2633Af1paResource MapMode
2634Aga
2635Diese Resource definiert Daten f�r die StarView-Klasse MapMode.
2636
2637AgaBeispiel:
2638Aga
2639Ali	MapMode
2640	{
2641		MapUnit	= MAP_SYSFONT;
2642		X		= 20;
2643		Y		= 30;
2644		xScale		= ( 2, 1 );
2645		yScale		= ( 1, 1 );
2646	};
2647Aga
2648Nach dem Schl�sselwort MAPUNIT wird eine Einheit des Koordinatensystems defi
2649niert. Die Einheiten sind in StarView vordefiniert. Anstelle von MAP_SYSFONT kann
2650auch MAP_100TH_MM, MAP_10TH_MM, MAP_MM, MAP_CM,
2651MAP_1000TH_INCH, MAP_100TH_INCH, MAP_10TH_INCH, MAP_INCH,
2652MAP_POINT, MAP_TWIP, MAP_PIXEL oder MAP_APPFONT geschrieben
2653werden. Was dies f�r Einheiten sind, ist im StarView-Handbuch unter der Klasse
2654MapMode nachzulesen.
2655
2656Nach den Schl�sselw�rtern X und Y wird der Ursprung des Koordinatensystems ange
2657geben. Die Einheiten sind die nach MapUnit definierten. Der Zahlenbereich umfa�t
2658Werte von 0 bis 65535.
2659
2660Nach den Schl�sselw�rtern XSCALE und YSCALE wird der Streckungsfaktor des
2661Koordinatensystems in x- bzw. in y-Richtung angegeben. Der Zahlenbereich umfa�t
2662Werte von -32768 bis 32767.
2663
2664AgaDefault:
2665Aga
2666Ali	MapMode
2667	{
2668		MapUnit = MAP_APPFONT;
2669		X = 0;
2670		Y = 0;
2671		xScale = ( 1, 1 );
2672		yScale = ( 1, 1 );
2673	};
2674Aga
2675Af1paResource Accelerator
2676Aga
2677Diese Resource definiert die Daten der StarView-Klasse Accelerator.
2678
2679AgaBeispiel:
2680Aga
2681Ali	Accelerator
2682	{
2683		HelpText	= "Hilfetext";
2684		KeyList	=
2685		{
2686			AcceleratorKey
2687			{
2688				Identifier	= 1;
2689				Disable	= FALSE;
2690				Modifier1	= TRUE;
2691				Code		= KEY_D;
2692			};
2693			AcceleratorKey
2694			{
2695				Identifier	= 2;
2696				Disable	= FALSE;
2697				Modifier1	= TRUE;
2698				Code		= KEY_F1;
2699			};
2700		};
2701	};
2702Aga
2703Nach dem Schl�sselwort HELPTEXT wird der Hilfetext des Accelerators angegeben.
2704
2705Im Accelerator k�nnen beliebig viele Acceleratortasten angegeben werden.
2706
2707AgaDefault:
2708Aga
2709Ali	Accelerator
2710	{
2711		HelpText = "";
2712	};
2713Aga
2714Af1paResource AcceleratorKey
2715Aga
2716Diese Resource definiert keine Daten einer StarView-Klasse. Diese Resource kann bei
2717der Methode InsertAccelerator() der Klasse Accelerator angegeben werden.
2718
2719Um diese Beschreibung verstehen zu k�nnen, ist es unbedingt notwendig, im
2720StarView-Handbuch die Beschreibung der Klassen Accelerator und KeyCode zu lesen.
2721
2722AgaBeispiel:
2723Aga
2724Ali	AcceleratorKey
2725	{
2726		Identifier		= 1;
2727		Disable		= FALSE;
2728		Shift			= TRUE;
2729		Modifier1		= TRUE;
2730		Modifier2		= TRUE;
2731		Code			= KEY_A;
2732		SubAccelerator	= Accelerator
2733		{
2734			KeyList = {
2735				AcceleratorKey{ ... };
2736				AcceleratorKey{ ... };
2737			};
2738		};
2739	};
2740Aga
2741Nach dem Schl�sselwort IDENTIFIER wird eine Zahl angegeben, die zur Identifi
2742kation dient. Der Definitionsbereich umfa�t Werte von 1 bis 65535.
2743
2744Nach dem Schl�sselwort DISABLE kann TRUE oder FALSE angegeben werden. Bei
2745TRUE ist die Acceleratortaste inaktiv, bei FALSE aktiv.
2746
2747Nach dem Schl�sselwort SHIFT kann TRUE oder FALSE angegeben werden. Bei
2748TRUE wird der Modifier KEY_SHIFT zum Keycode gesetzt, FALSE hat keine Bedeu
2749tung.
2750paNach dem Schl�sselwort MODIFIER1 kann TRUE oder FALSE angegeben werden.
2751Bei TRUE wird der Modifier KEY_MOD1 zum Keycode gesetzt, FALSE hat keine
2752Bedeutung.
2753
2754Nach dem Schl�sselwort MODIFIER2 kann TRUE oder FALSE angegeben werden.
2755Bei TRUE wird der Modifier KEY_MOD2 zum Keycode gesetzt, FALSE hat keine
2756Bedeutung.
2757
2758AgaNach dem Schl�sselwort CODE wird ein Tastencode angegeben. Die Tastencodes sind
2759in StarView vordefiniert. Anstelle von KEY_A kann auch ein Wert aus
2760KEY_0 ... KEY_9, KEY_A ... KEY_Z, KEY_F1 ... KEY_F24, KEY_DOWN,
2761KEY_UP, KEY_LEFT, KEY_RIGHT, KEY_HOME, KEY_END, KEY_PAGEUP,
2762KEY_PAGEDOWN, KEY_RETURN, KEY_ESCAPE, KEY_TAB, KEY_SPACE,
2763KEY_BACKSPACE, KEY_INSERT, KEY_DELETE, KEY_NUMLOCK,
2764KEY_SHIFTLOCK oder KEY_SCROLLLOCK geschrieben werden.
2765Aga
2766In einer Acceleratortaste kann genau ein Accelerator definiert werden. Dieser
2767Accelerator wird an die Acceleratortaste angeh�ngt.
2768Aga
2769AgaDefault:
2770Aga
2771Ali	AcceleratorKey
2772	{
2773		Identifier = nId; //nicht definiert
2774		DISABLE	= FALSE;
2775		Shift		= FALSE;
2776		Modifier1	= FALSE;
2777		Modifier2	= FALSE;
2778		Code		= nKey; // nicht definiert
2779	};
2780Aga
2781F�r nId und nKey gibt es keinen definierten Default.
2782Au2
2783Af1paResource Menu
2784Aga
2785Diese Resource definiert die Daten der StarView-Klassen PopupMenu und MenuBar.
2786
2787AgaBeispiel:
2788Aga
2789Ali	Menu
2790	{
2791		ItemList =
2792		{
2793			MenuItem
2794			{
2795				Text		= "Laden";
2796				Identifier	= 1;
2797			};
2798			MenuItem
2799			{
2800				Text		= "Speichern";
2801				Identifier	= 2;
2802			};
2803			MenuItem
2804			{
2805				Separator	= TRUE;
2806			};
2807			MenuItem
2808			{
2809				Text		= "Beenden";
2810				Identifier	= 3;
2811			};
2812		};
2813	};
2814Aga
2815In Menu k�nnen beliebig viele Men�-Items angegeben werden. Sie werden in der
2816Reihenfolge, in der sie aufgeschrieben werden, im Men� aufgef�hrt.
2817
2818Nach dem Schl�sselwort SEPARATOR kann TRUE oder FALSE angegeben werden.
2819Bei TRUE werden Men�-Items visuell voneinander getrennt.
2820
2821AgaDefault:
2822Aga
2823Ali	Menu {};
2824Aga
2825Af1paResource MenuItem
2826Aga
2827Diese Resource definiert keine Daten einer StarView-Klasse. Diese Resource kann bei
2828der Methode InsertItem() der Klasse Menu angegeben werden.
2829
2830AgaBeispiel:
2831Aga
2832Ali	MenuItem
2833	{
2834		Text		= "MenuItem";
2835		HelpText	= "Hilfetext";
2836		Identifier	= 1;
2837		HelpId		= 1001:
2838		Check		= TRUE;
2839		Disable	= TRUE;
2840		SubMenu	= Menu
2841		{
2842			ItemList =
2843			{
2844				MenuItem{ ... };
2845				MenuItem{ ... };
2846			};
2847		};
2848	};
2849Aga
2850Nach dem Schl�sselwort TEXT wird der Text des Men�-Items angegeben.
2851
2852Nach dem Schl�sselwort HELPTEXT wird der Hilfetext des Men�-Items angegeben.
2853
2854Nach dem Schl�sselwort IDENTIFIER wird eine Zahl angegeben, die zur Identifi
2855kation dient. Der Definitionsbereich umfa�t Werte von 1 bis 65535.
2856
2857Nach dem Schl�sselwort HELPID wird eine Zahl angegeben. Diese Zahl ist ein
2858Hilfeidentifier (eine Referenz ins Hilfesystem). Der Definitionsbereich umfa�t Werte
2859von 0 bis 4294967295. Es k�nnen auch die vordefinierten Werte HELP_INDEX und
2860HELP_HELPONHELP benutzt werden.
2861
2862Nach dem Schl�sselwort CHECK kann TRUE oder FALSE angegeben werden. Bei
2863TRUE hat das Men�-Item eine Auswahlmarkierung, bei FALSE hat es keine Auswahl
2864markierung.
2865
2866Nach dem Schl�sselwort DISABLE kann TRUE oder FALSE angegeben werden. Bei
2867TRUE ist der Zugriff auf das Men�-Item nicht m�glich, bei FALSE ist der Zugriff
2868m�glich.
2869
2870In einem Men�-Item kann genau ein Men� definiert werden. Dieses Men� wird an das
2871Men�-Item angeh�ngt (SubMenu).
2872
2873AgaBeispiel:
2874Aga
2875Ali	MenuItem
2876	{
2877		Identifier = 1;
2878		ItemBitmap = Bitmap
2879		{
2880			File = "bitmap.bmp";
2881		};
2882	};
2883Aga
2884Anstelle eines Textes wird in dem Men�-Item diese Bitmap ausgegeben.
2885
2886AgaBeispiel:
2887Aga
2888	MenuItem
2889	{
2890		Separator = TRUE;
2891	};
2892
2893Das Men�-Item verh�lt sich wie ein Separator (siehe Menu).
2894
2895Werden TEXT, SEPARATOR oder BITMAP gleichzeitig verwendet, wird eine der
2896drei M�glichkeiten gew�hlt.
2897
2898AgaDefault:
2899Aga
2900Ali	MenuItem
2901	{
2902		Text		= "";
2903		HelpText	= "";
2904		Identifier	= nId; //nicht definiert
2905		HelpId		= 0;
2906		Check		= FALSE;
2907		Disable	= TRUE;
2908	};
2909Aga
2910F�r nId gibt es keinen definierten Default.
2911Au2
2912Af1paResource MessBox
2913Aga
2914Diese Resource definiert die Daten der StarView-Klasse MessBox.
2915
2916AgaBeispiel:
2917Aga
2918Ali	MessBox
2919	{
2920		Title			= "Ich bin eine Messagebox.";
2921		Message		= "Guten Morgen";
2922		HelpText		= "Hilfe";
2923		Buttons		= WB_OK;
2924		DefaultButton	= WB_DEF_OK;
2925		HelpId			= 1;
2926	};
2927Aga
2928Der Text nach dem Schl�sselwort TITLE wird der Titel der Box. Einige Boxen haben
2929einen festen Titel. Welche dies sind, ist dem StarView-Handbuch zu entnehmen.
2930
2931Der Text nach dem Schl�sselwort MESSAGE wird in der Messagebox angezeigt.
2932
2933Nach dem Schl�sselwort HELPTEXT wird der Hilfetext angegeben. Was diese Text
2934angabe bewirkt, ist dem StarView-Handbuch unter der Klasse Window zu entnehmen.
2935
2936Nach dem Schl�sselwort BUTTONS wird angegeben, welche Buttons in der
2937Messagebox angezeigt werden sollen. Die Werte sind in StarView vordefiniert. Im
2938StarView-Handbuch unter der Klasse MessBox ist nachzulesen, wann welche Buttons
2939angezeigt werden. Anstelle von WB_OK kann auch WB_OK_CANCEL,
2940WB_YES_NO, WB_YES_NO_CANCEL, oder WB_RETRY_CANCEL angegeben
2941werden.
2942
2943Nach dem Schl�sselwort DEFAULTBUTTON wird angegeben, welcher Button in der
2944Messagebox der Default-Button ist. Anstelle von WB_DEF_OK kann auch
2945WB_DEF_CANCEL, WB_DEF_RETRY, WB_DEF_YES, oder WB_DEF_CANCEL
2946geschrieben werden.
2947
2948Nach dem Schl�sselwort HELPID wird eine Zahl angegeben. Diese Zahl ist ein
2949Hilfeidentifier (eine Referenz ins Hilfesystem). Der Definitionsbereich umfa�t Werte
2950von 0 bis 4294967295. Es k�nnen auch die vordefinierten Werte HELP_INDEX und
2951HELP_HELPONHELP benutzt werden.
2952
2953AgaDefault:
2954Aga
2955Ali	MessBox
2956	{
2957		Title		= "";
2958		Message	= "";
2959		HelpText	= "";
2960		Buttons	= WB_OK;
2961		HelpId		= 0;
2962	};
2963Aga
2964AgaWird kein Default-Button angegeben, dann wird vom System einer ausgew�hlt.
2965Aga
2966
2967
2968Af1Resource SysMessBox
2969Aga
2970Diese Resource definiert die Daten der StarView-Klasse SysMessBox.
2971
2972AgaBeispiel:
2973Aga
2974Ali	SysMessBox {};
2975Aga
2976Nur der Typ des Fensters ist entscheidend, es sind keine zus�tzlichen Angaben
2977m�glich.
2978
2979Af1Resource InfoBox
2980Aga
2981Diese Resource definiert die Daten der StarView-Klasse InfoBox.
2982
2983AgaBeispiel:
2984Aga
2985Ali	InfoBox {};
2986Aga
2987Nur der Typ des Fensters ist entscheidend, es sind keine zus�tzlichen Angaben
2988m�glich.
2989
2990Af1Resource WarningBox
2991Aga
2992Diese Resource definiert die Daten der StarView-Klasse WarningBox.
2993
2994AgaBeispiel:
2995Aga
2996Ali	WarningBox {};
2997Aga
2998Nur der Typ des Fensters ist entscheidend, es sind keine zus�tzlichen Angaben
2999m�glich.
3000
3001Af1Resource ErrorBox
3002Aga
3003Diese Resource definiert die Daten der StarView-Klasse ErrorBox.
3004
3005AgaBeispiel:
3006Aga
3007Ali	ErrorBox {};
3008Aga
3009Nur der Typ des Fensters ist entscheidend, es sind keine zus�tzlichen Angaben
3010m�glich.
3011
3012Af1Resource QueryBox
3013Aga
3014Diese Resource definiert die Daten der StarView-Klasse QueryBox.
3015
3016AgaBeispiel:
3017Aga
3018Ali	QueryBox {};
3019Aga
3020Nur der Typ des Fensters ist entscheidend, es sind keine zus�tzlichen Angaben
3021m�glich.
3022
3023Af1paResource OutputDevice
3024Aga
3025Diese Resource definiert Daten der StarView-Klasse OutputDevice.
3026
3027AgaBeispiel:
3028Aga
3029Ali	OutputDevice
3030	{
3031		OutputPen		= Pen
3032		{
3033			Width		= 2;
3034		};
3035		BackGroundBrush	= Brush
3036		{
3037			Style		= BRUSH_CROSS;
3038		};
3039		FillInBrush	= Brush
3040		{
3041			Style		= BRUSH_SOLID;
3042		};
3043		OutputFont	= Font
3044		{
3045			Height	= 12;
3046			Width		= 8;
3047			Text		= "Helvetica";
3048		};
3049		OutputMapMode	= MapMode
3050		{
3051			MapUnit	= MAP_MM;
3052		};
3053	};
3054Aga
3055paMit OUTPUTPEN kann der Default-Pen des Output-Devices angegeben werden.
3056
3057Mit der Brush BACKGROUNDBRUSH wird die Default-Background-Brush??? des
3058Output-Devices angegeben.
3059
3060Mit der Brush FILLINBRUSH wird die Default-Fill-In-Brush??? des Output-Devices
3061angegeben.
3062
3063Mit FONT wird der Default-Font des Output-Devices angegeben.
3064Mit OUTPUTMAPMODE wird der Default-Mapping-Mode des Output-Devices ange
3065geben.
3066Aga
3067Default:
3068Aga
3069Ali	OutputDevice {};
3070Aga
3071Welche Defaults in diesem Fall f�r Pen, Brush, Font und MapMode verwendet
3072werden, ist dem StarView-Handbuch unter der Klasse OutputDevice zu entnehmen.
3073
3074Af1paResource Window
3075Aga
3076Diese Resource definiert die Daten der StarView-Klasse Window.
3077
3078AgaBeispiel:
3079Aga
3080Ali	Window
3081	{
3082		Pos			= MAP_MM( 0, 0 );
3083		Size			= MAP_MM( 100, 50 );
3084		Text			= "Fenstertext";
3085		HelpText		= "";
3086		HelpId			= 1001;
3087		Border			= TRUE;
3088		Hide			= TRUE;
3089		ClipChildren	= TRUE;
3090		Disable		= TRUE;
3091		WindowPointer	= Pointer
3092		{
3093			Predefine = POINTER_CROSS;
3094		};
3095Ali	};
3096Aga
3097Nach dem Schl�sselwort POS wird die Position des Fensters angegeben. Ob die
3098Positionierung relativ zu einem anderen Fenster erfolgt, ist dem StarView-Handbuch
3099unter der Klasse Window zu entnehmen. Die MapUnit MAP_MM ist die Einheit f�r
3100die im Tupel folgende x- und y-Position. Anstelle von MAP_MM kann eine beliebige
3101MapUnit angegeben werden, diese Angabe kann auch weggelassen werden. Der
3102Zahlenbereich umfa�t Werte von -32768 bis 32767.
3103
3104Nach dem Schl�sselwort SIZE wird die Gr��e des Fensters angegeben. Die MapUnit
3105MAP_MM ist die Einheit f�r die im Tupel folgende Breiten- und H�henangabe.
3106Anstelle von MAP_MM kann eine beliebige MapUnit angegeben werden, diese
3107Angabe kann auch weggelassen werden. Der Zahlenbereich umfa�t Werte von -32768
3108bis 32767.
3109
3110Nach dem Schl�sselwort TEXT wird der Fenstertext angegeben. Was diese Text
3111angabe bewirkt, ist dem StarView-Handbuch unter der Klasse Window zu entnehmen.
3112
3113Nach dem Schl�sselwort HELPTEXT wird der Hilfetext angegeben. Was diese Text
3114angabe bewirkt, ist dem StarView-Handbuch unter der Klasse Window zu entnehmen.
3115
3116Nach dem Schl�sselwort HELPID wird eine Zahl angegeben. Diese Zahl ist ein
3117Hilfeidentifier (eine Referenz ins Hilfesystem). Der Definitionsbereich umfa�t Werte
3118von 0 bis 4294967295. Es k�nnen auch die vordefinierten Werte HELP_INDEX und
3119HELP_HELPONHELP benutzt werden.
3120
3121Nach dem Schl�sselwort BORDER kann TRUE oder FALSE angegeben werden. Bei
3122TRUE erh�lt das Fenster einen Rahmen, FALSE hat keine Bedeutung.
3123
3124Nach dem Schl�sselwort HIDE kann TRUE oder FALSE angegeben werden. Bei
3125TRUE ist das Fenster nach dem Erzeugen nicht sichtbar, bei FALSE ist es sichtbar
3126(Parent-Beziehung beachten!).
3127
3128Nach dem Schl�sselwort CLIPCHILDREN kann TRUE oder FALSE angegeben
3129werden. Bei TRUE werden die ChildWindows beim Zeichnen des Parents nicht
3130�berschrieben, bei FALSE werden sie �berschrieben.
3131
3132Nach dem Schl�sselwort DISABLE kann TRUE oder FALSE angegeben werden. Bei
3133TRUE ist der Zugriff auf das Fenster nicht m�glich, bei FALSE ist der Zugriff m�glich
3134(Parent-Beziehung beachten!).
3135
3136
3137Mit WINDOWPOINTER wird der Default-Pointer des Fensters angegeben.
3138
3139AgaBeispiel:
3140Aga
3141Ali	Window
3142	{
3143		PosSize	= MAP_MM( 0, 0, 100, 50 );
3144		TEXT		= "Fenstertext";
3145	};
3146Aga
3147Nach dem Schl�sselwort POSSIZE werden die Position und die Gr��e des Fensters
3148angegeben. F�r die MapUnit gilt das gleiche wie bei POS und SIZE. Der
3149Zahlenbereich umfa�t Werte von -32768 bis 32767.
3150
3151Wird POSSIZE zusammen mit POS und SIZE verwendet, wird eine der M�glichkeiten
3152ausgew�hlt.
3153
3154AgaDefault:
3155Aga
3156Ali	Window
3157	{
3158		HelpId			= 0;
3159		Border			= FALSE;
3160		Hide			= FALSE;
3161		ClipChildren	= FALSE;
3162		Disable		= FALSE;
3163	};
3164Aga
3165F�r WindowPointer, Text, HelpText, Pos und Size werden die Systemdefaults
3166verwendet. Welche Defaults verwendet werden, ist dem StarView-Handbuch unter der
3167Klasse Window zu entnehmen.
3168Af1
3169
3170Resource SystemWindow
3171Aga
3172Dieses Schl�sselwort kann nicht angegeben werden.
3173
3174Um diese Beschreibung verstehen zu k�nnen, ist es unbedingt notwendig, im
3175StarView-Handbuch die Beschreibung der Klasse SystemWindow und aller von ihr
3176abgeleiteten Klassen zu lesen.
3177
3178AgaBeispiel:
3179Aga
3180Ali	[SystemWindow]
3181	{
3182		Sizeable		= TRUE;
3183		Moveable		= TRUE;
3184		Minimize		= TRUE;
3185		Maximize		= TRUE;
3186		Closeable		= TRUE;
3187		App			= TRUE;
3188		OutputSize		= TRUE;
3189		WinChilds	=
3190		{
3191			FText
3192			{
3193				PosSize	= MAP_SYSFONT( 0, 0, 80, 10 );
3194				Text		= "Name:";
3195			};
3196		};
3197		DefPushButton 1
3198		{
3199			Text		= "Ok";
3200		};
3201		PushButton 2
3202		{
3203			Text		= "Cancel";
3204		};
3205		SingleLineEdit 3
3206		{
3207			PosSize	= MAP_SYSFONT( 80, 0, 120, 10 );
3208		};
3209	};
3210Aga
3211Nach dem Schl�sselwort SIZEABLE kann TRUE oder FALSE angegeben werden. Bei
3212TRUE kann das Fenster vergr��ert und verkleinert werden, bei FALSE kann die Gr��e
3213nicht ver�ndert werden.
3214
3215Nach dem Schl�sselwort MOVEABLE kann TRUE oder FALSE angegeben werden.
3216Bei TRUE kann das Fenster bewegt werden, bei FALSE kann es nicht bewegt werden.
3217
3218Nach dem Schl�sselwort MINIMIZE kann TRUE oder FALSE angegeben werden. Bei
3219TRUE kann das Fenster minimiert werden, bei FALSE kann es nicht minimiert
3220werden.
3221
3222Nach dem Schl�sselwort MAXIMIZE kann TRUE oder FALSE angegeben werden.
3223Bei TRUE kann das Fenster maximiert werden, bei FALSE kann es nicht maximiert
3224werden.
3225
3226Nach dem Schl�sselwort CLOSEABLE kann TRUE oder FALSE angegeben werden.
3227Bei TRUE kann das Fenster geschlossen werden, bei FALSE kann es nicht geschlos
3228sen werden.
3229
3230Nach dem Schl�sselwort APPLICATION kann TRUE oder FALSE angegeben
3231werden. TRUE bedeutet, da� das Fenster das Applikationsfenster ist, FALSE hat keine
3232Bedeutung.
3233
3234Nach dem Schl�sselwort OUTPUTSIZE kann TRUE oder FALSE angegeben werden.
3235Bei TRUE ist bezieht sich die Gr��enangabe auf die "OutputSize" des Fensters.
3236
3237Nach dem Schl�sselwort WINCHILDS wird ein Textfenster angelegt. Dieses Fenster
3238wird automatisch erzeugt. Anstelle von FTEXT kann jede in der Hierarchie unter
3239Window stehende Resource angegeben werden.
3240
3241Nach dem Schl�sselwort PUSHBUTTON 1 wird ein Button definiert. Auf diese
3242Resource kann �ber den Identifier 1 zugegriffen werden. Der Identifier kann im
3243Bereich von 1 bis 255 liegen. Anstelle von PushButton kann jede in der Hierarchie
3244unter Resource stehende Resource angegeben werden.
3245
3246AgapaDefault:
3247Aga
3248Ali	[SystemWindow] 7
3249	{
3250		Sizeable	= FALSE;
3251		Moveable	= FALSE;
3252		Minimize	= FALSE;
3253		Maximize	= FALSE;
3254		Closeable	= FALSE;
3255		App		= FALSE;
3256		OutputSize	= FALSE;
3257	};
3258Aga
3259Af1paResource WorkWindow
3260Aga
3261Diese Resource definiert die Daten der StarView-Klasse WorkWindow.
3262
3263AgaBeispiel:
3264Aga
3265Ali	WorkWindow
3266	{
3267		Show			= MAXIMIZE;
3268		WorkWindowIcon	= Icon
3269		{
3270			Predefine = ICON_STOP;
3271		};
3272	};
3273Aga
3274Nach dem Schl�sselwort SHOW wird angegeben, wie das Fenster angezeigt wird.
3275Anstelle von MAXIMIZE kann auch NORMAL und MINIMIZE angegeben werden.
3276MAXIMIZE bedeutet, da� das Fenster so gro� wie m�glich dargestellt wird, bei
3277MINIMIZE wird das Fenster so klein wie m�glich dargestellt (iconic). NORMAL
3278bedeutet, da� das Fenster in den angegebenen Koordinaten dargestellt wird.
3279
3280WorkWindowIcon ist das Sinnbild, das dargestellt wird, wenn das Fenster minimiert
3281wird.
3282
3283AgaDefault:
3284Aga
3285Ali	WorkWindow
3286	{
3287		Show = NORMAL;
3288	};
3289Aga
3290Was angezeigt wird, wenn kein Icon angegeben wird, ist im StarView-Handbuch unter
3291der Klasse WorkWindow nachzulesen.
3292
3293Af1paResource MDIWindow
3294Aga
3295Diese Resource definiert die Daten der StarView-Klasse MDIWindow.
3296
3297AgaBeispiel:
3298Aga
3299Ali	MDIWindow {};
3300Aga
3301Es ist nur der Typ des Fensters entscheidend, es sind keine zus�tzlichen Angaben m�g
3302lich.
3303Au2
3304
3305Af1Resource Dialog
3306Aga
3307Diese Schl�sselwort kann nicht angegeben werden.
3308Diese Resource definiert die Daten der StarView-Klasse Dialog.
3309
3310AgaBeispiel:
3311Aga
3312Ali	[Dialog] {};
3313Aga
3314Es ist nur der Typ des Fensters entscheidend, es sind keine zus�tzlichen Angaben m�g
3315lich.
3316Au2
3317
3318Af1Resource ModelessDialog
3319Aga
3320Diese Resource definiert die Daten der StarView-Klasse ModelessDialog.
3321
3322AgaBeispiel:
3323Aga
3324Ali	ModelessDialog {};
3325Aga
3326Es ist nur der Typ des Fensters entscheidend, es sind keine zus�tzlichen Angaben m�g
3327lich.
3328Au2
3329pa
3330Af1Resource ModalDialog
3331Aga
3332Diese Resource definiert die Daten der StarView-Klasse ModalDialog.
3333
3334AgaBeispiel:
3335Aga
3336Ali	ModalDialog
3337	{
3338		SysModal	= TRUE;
3339	};
3340Aga
3341Nach den Schl�sselwort SYSMODAL kann TRUE oder FALSE angegeben werden.
3342Wird FALSE angegeben, dann ist die Dialogbox applikationsmodal, sonst
3343systemmodal.
3344
3345Systemmodal bedeutet, da� das ganze System angehalten wird und nur in dieser
3346Dialogbox gearbeitet werden kann. Applikationsmodal bedeutet, da� die Applikation
3347angehalten wird und applikationsweit nur in dieser Dialogbox gearbeitet werden kann.
3348Weiteres siehe StarView-Handbuch bei den Klassen Dialog, ModalDialog und
3349ModelessDialog.
3350
3351AgaDefault:
3352Aga
3353Ali	ModalDialog
3354	{
3355		SysModal	= FALSE;
3356	};
3357Af1paResource Control
3358Aga
3359Diese Resource definiert die Daten der StarView-Klasse Control.
3360
3361AgaBeispiel:
3362Aga
3363Ali	Control
3364	{
3365		TabStop	= TRUE;
3366		Group		= TRUE;
3367	};
3368Aga
3369Nach dem Schl�sselwort TABSTOP kann TRUE oder FALSE angegeben werden. Bei
3370TRUE ist das Tabstop-Attribut gesetzt, bei FALSE ist es nicht gesetzt.
3371
3372Nach dem Schl�sselwort GROUP kann TRUE oder FALSE angegeben werden. Bei
3373TRUE ist das Group-Attribut gesetzt, bei FALSE ist es nicht gesetzt.
3374
3375Was diese Attribute bewirken, ist im StarView-Handbuch unter den Klassen Control
3376und Dialog nachzulesen.
3377
3378AgaDefault:
3379Aga
3380Ali	Control
3381	{
3382		TabStop	= FALSE;
3383		Group		= FALSE;
3384	};
3385Aga
3386Af1Resource Button
3387Aga
3388Diese Resource definiert die Daten der StarView-Klasse Button.
3389
3390AgaBeispiel:
3391Aga
3392Ali	Button {};
3393
3394AgaNur der Typ des Fensters ist entscheidend, es sind keine zus�tzlichen Angaben
3395m�glich.
3396
3397
3398Af1paResource CheckBox
3399Aga
3400Diese Resource definiert die Daten der StarView-Klasse CheckBox.
3401
3402Beispiel:
3403Aga
3404Ali	CheckBox
3405	{
3406		Check = TRUE;
3407	};
3408Aga
3409Nach dem Schl�sselwort CHECK kann TRUE oder FALSE angegeben werden. Bei
3410TRUE wird ein Button als angeklickt gekennzeichnet. Dies gilt nur f�r Buttons, bei
3411denen solch eine Kennzeichnung vorgesehen ist.
3412
3413AgaDefault:
3414Aga
3415Ali	CheckBox
3416	{
3417		Check = FALSE;
3418	};
3419Aga
3420Af1Resource AutoCheckBox
3421Aga
3422Diese Resource definiert die Daten der StarView-Klasse AutoCheckBox.
3423
3424AgaBeispiel:
3425Aga
3426Ali	AutoCheckBox {};
3427Aga
3428Nur der Typ des Fensters ist entscheidend, es sind keine zus�tzlichen Angaben
3429m�glich.
3430
3431Af1Resource PushButton
3432Aga
3433Diese Resource definiert die Daten der StarView-Klasse PushButton.
3434
3435AgaBeispiel:
3436Aga
3437Ali	PushButton {};
3438Aga
3439Nur der Typ des Fensters ist entscheidend, es sind keine zus�tzlichen Angaben
3440m�glich.
3441Af1Resource DefPushButton
3442Aga
3443Diese Resource definiert die Daten der StarView-Klasse DefPushButton.
3444
3445AgaBeispiel:
3446Aga
3447Ali	DefPushButton {};
3448Aga
3449Nur der Typ des Fensters ist entscheidend, es sind keine zus�tzlichen Angaben
3450m�glich.
3451
3452Af1Resource RadioButton
3453Aga
3454Diese Resource definiert die Daten der StarView-Klasse RadioButton.
3455
3456Beispiel:
3457Aga
3458Ali	RadioButton
3459	{
3460		Check = TRUE;
3461	};
3462Aga
3463Nach dem Schl�sselwort CHECK kann TRUE oder FALSE angegeben werden. Bei
3464TRUE wird ein Button als angeklickt gekennzeichnet. Dies gilt nur f�r Buttons, bei
3465denen solch eine Kennzeichnung vorgesehen ist.
3466
3467AgaDefault:
3468Aga
3469Ali	RadioButton
3470	{
3471		Check = FALSE;
3472	};
3473Aga
3474Af1Resource AutoRadioButton
3475Aga
3476Diese Resource definiert die Daten der StarView-Klasse AutoRadioButton.
3477
3478AgaBeispiel:
3479Aga
3480Ali	AutoRadioButton {};
3481Aga
3482Nur der Typ des Fensters ist entscheidend, es sind keine zus�tzlichen Angaben
3483m�glich.
3484Au2
3485Af1Resource TriStateBox
3486Aga
3487Diese Resource definiert die Daten der StarView-Klasse TriStateBox.
3488
3489Beispiel:
3490Aga
3491Ali	TriStateBox
3492	{
3493		TriStateDisable = TRUE;
3494		TriState		= STATE_CHECK;
3495	};
3496Aga
3497Nach dem Schl�sselwort TRISTATEDISABLE kann TRUE oder FALSE angegeben
3498werden. Bei TRUE k�nnen nur die Zustande STATE_CHECK und
3499STATE_NOCHECK eingenommen werden, sonst ist noch der Zustand
3500STATE_DONTKNOW m�glich.
3501
3502Nach dem Schl�sselwort TRISTATE kann STATE_NOCHECK, STATE_CHECK
3503und STATE_DONTKNOW angegeben werden.
3504
3505AgaDefault:
3506Aga
3507Ali	TriStateBox
3508	{
3509		TriStateDisable = FALSE;
3510		TriState		= STATE_NOCHECK;
3511	};
3512Aga
3513Af1Resource AutoTriStateBox
3514Aga
3515Diese Resource definiert die Daten der StarView-Klasse AutoTriStateBox.
3516
3517AgaBeispiel:
3518Aga
3519Ali	AutoTriStateBox {};
3520Aga
3521Nur der Typ des Fensters ist entscheidend, es sind keine zus�tzlichen Angaben
3522m�glich.
3523Af1paResource Edit
3524Aga
3525Dieses Schl�sselwort kann nicht angegeben werden.
3526Diese Resource definiert die Daten der StarView-Klasse Edit.
3527
3528AgaBeispiel:
3529Aga
3530Ali	[Edit]
3531	{
3532		Center			= TRUE;
3533		Left			= FALSE;
3534		Right			= FALSE;
3535		MaxTextLength	= 10;
3536	};
3537Aga
3538Nach dem Schl�sselwort LEFT kann TRUE oder FALSE angegeben werden. Bei
3539TRUE wird der Text linksb�ndig ausgegeben.
3540
3541Nach dem Schl�sselwort CENTER kann TRUE oder FALSE angegeben werden. Bei
3542TRUE wird der Text zentriert ausgegeben.
3543
3544Nach dem Schl�sselwort RIGHT kann TRUE oder FALSE angegeben werden. Bei
3545TRUE wird der Text rechtsb�ndig ausgegeben.
3546
3547Werden LEFT, CENTER und RIGHT auf TRUE gesetzt, wird eine der M�glichkeiten
3548ausgew�hlt. Sind sie alle FALSE, wird der Text linksb�ndig ausgegeben.
3549
3550Nach dem Schl�sselwort MAXTEXTLENGTH wird die maximale Anzahl der Ein
3551gabezeichen festgelegt. Ist der Wert = 0, k�nnen beliebig viele Zeichen eingegeben
3552werden. Der Definitionsbereich umfa�t Werte von 0 bis 65535.
3553
3554AgaDefault:
3555Aga
3556Ali	[Edit]
3557	{
3558		Left			= FALSE;
3559		Center			= FALSE;
3560		Right			= FALSE;
3561		MaxTextLength	= 0;
3562	};
3563Af1paResource SingleLineEdit
3564Aga
3565Diese Resource definiert die Daten der StarView-Klasse SingleLineEdit.
3566
3567AgaBeispiel:
3568Aga
3569Ali	SingleLineEdit {};
3570Aga
3571Nur der Typ des Fensters ist entscheidend, es sind keine zus�tzlichen Angaben
3572m�glich.
3573Au2
3574Af1paResource MultiLineEdit
3575Aga
3576Diese Resource definiert die Daten der StarView-Klasse MultiLineEdit.
3577
3578AgaBeispiel:
3579Aga
3580Ali	MultiLineEdit
3581	{
3582		HScroll	= TRUE;
3583		VScroll	= TRUE;
3584	};
3585Aga
3586Nach dem Schl�sselwort HSCROLL kann TRUE oder FALSE angegeben werden. Bei
3587TRUE wird nach links gescrollt, wenn bei der Eingabe der rechte Rand erreicht ist.
3588
3589Nach dem Schl�sselwort VSCROLL kann TRUE oder FALSE angegeben werden. Bei
3590TRUE wird nach unten gescrollt, wenn bei der Eingabe der untere Rand erreicht ist.
3591
3592AgaDefault:
3593Aga
3594Ali	MultiLineEdit
3595	{
3596		HSCROLL	= FALSE;
3597		VSCROLL	= FALSE;
3598	};
3599Aga
3600Af1paResource ScrollBar
3601Aga
3602Diese Resource definiert die Daten der StarView-Klasse ScrollBar.
3603
3604AgaBeispiel:
3605Aga
3606Ali	ScrollBar
3607	{
3608		MinPos		= 1;
3609		MaxPos		= 112;
3610		ThumbPos	= 30;
3611		PageSize	= 8;
3612		LineSize	= 2;
3613		HSCROLL	= TRUE;
3614		VSCROLL	= FALSE;
3615	};
3616Aga
3617Nach dem Schl�sselwort MINPOS wird die minimale Position des Thumbs angegeben.
3618Der Definitionsbereich umfa�t Werte von -32768 - 32767.
3619
3620Nach dem Schl�sselwort MAXPOS wird die maximale Position des Thumbs
3621angegeben. Der Definitionsbereich umfa�t Werte von -32768 - 32767.
3622
3623Nach dem Schl�sselwort THUMBPOS wird die Position des Thumbs angegeben. Der
3624Definitionsbereich umfa�t Werte von -32768 - 32767.
3625
3626Nach dem Schl�sselwort PAGESIZE wird die Ver�nderung bei seitenweisem Scrollen
3627angegeben. Der Definitionsbereich umfa�t Werte von -32768 - 32767.
3628
3629Nach dem Schl�sselwort LINESIZE wird die Ver�nderung bei schrittweisem Scrollen
3630angegeben. Der Definitionsbereich umfa�t Werte von -32768 - 32767.
3631
3632Nach dem Schl�sselwort HSCROLL kann TRUE oder FALSE angegeben werden. Bei
3633TRUE bekommt man eine horizontale Scrollbar.
3634
3635Nach dem Schl�sselwort VSCROLL kann TRUE oder FALSE angegeben werden. Bei
3636TRUE bekommt man eine vertikale Scrollbar.
3637pa
3638AgaDefault:
3639Aga
3640Ali	ScrollBar
3641	{
3642		MinPos		= 0;
3643		MaxPos		= 100;
3644		ThumbPos	= 0;
3645		PageSize	= 10;
3646		LineSize	= 1;
3647		VSCROLL	= FALSE;
3648		HSCROLL	= FALSE;
3649	};
3650Aga
3651Aga
3652Af1Resource AutoScrollBar
3653Aga
3654Diese Resource definiert die Daten der StarView-Klasse AutoScrollBar.
3655Aga
3656AgaBeispiel:
3657Aga
3658Ali	AutoScrollBar {};
3659Aga
3660Nur der Typ des Fensters ist entscheidend, es sind keine zus�tzlichen Angaben
3661m�glich.
3662
3663Af1paResource ListBox
3664Aga
3665Diese Resource definiert die Daten der StarView-Klasse ListBox.
3666
3667AgaBeispiel:
3668Aga
3669Ali	ListBox
3670	{
3671		Sort		= TRUE;
3672		CurPos		= 3;
3673		StringList	=
3674		{
3675			 "Ich"; "bin"; "eine"; "ListBox.";
3676		};
3677		StringList		=
3678		{
3679			"Beliebig"; "viele"; "StringLists.";
3680		};
3681	};
3682Aga
3683Nach dem Schl�sselwort SORT kann TRUE oder FALSE angegeben werden. Bei
3684TRUE werden die Strings in der Listbox sortiert, bei FALSE werden sie in der Reihen
3685folge ausgegeben, in der sie aufgeschrieben werden.
3686
3687Nach dem Schl�sselwort CURPOS wird die Position eines Strings angegeben. Der
3688Definitionsbereich umfa�t Werte von 0 - 32535. Der String, der an der angegebenen
3689Position in der Listbox steht, wird selektiert. Hat die Listbox weniger Eintr�ge, wird
3690der ???String selektiert.
3691
3692Nach dem Schl�sselwort STRINGLIST k�nnen Strings angegeben werden. Die Strings
3693werden in der Reihenfolge in die Listbox gestellt, in der sie angegeben werden.
3694
3695AgaDefault:
3696Aga
3697Ali	ListBox
3698	{
3699		Sort	= FALSE;
3700		CurPos	= 0;
3701	};
3702Aga
3703Wird STRINGLIST ausgelassen, stehen keine Strings in der Listbox.
3704
3705Af1paResource DropDownListBox
3706Aga
3707Diese Resource definiert die Daten der StarView-Klasse DropDownListBox.
3708
3709AgaBeispiel:
3710Aga
3711Ali	DropDownListBox {};
3712Aga
3713Nur der Typ des Fensters ist entscheidend, es sind keine zus�tzlichen Angaben
3714m�glich.
3715
3716Af1Resource ComboBox
3717Aga
3718Diese Resource definiert die Daten der StarView-Klasse ComboBox.
3719
3720AgaBeispiel:
3721Aga
3722Ali	ComboBox
3723	{
3724		MaxTextLength = 10;
3725	};
3726Aga
3727Nach dem Schl�sselwort MAXTEXTLENGTH wird die maximale Anzahl der Ein
3728gabezeichen festgelegt. Ist der Wert = 0, k�nnen beliebig viele Zeichen eingegeben
3729werden. Der Definitionsbereich umfa�t Werte von 0 bis 65535.
3730
3731Default:
3732
3733Ali	ComboBox
3734	{
3735		MaxTextLength = 0;
3736	};
3737Aga
3738Af1Resource DropDownComboBox
3739Aga
3740Diese Resource definiert die Daten der StarView-Klasse DropDownComboBox.
3741
3742AgaBeispiel:
3743Aga
3744Ali	DropDownComboBox {};
3745Aga
3746Nur der Typ des Fensters ist entscheidend, es sind keine zus�tzlichen Angaben
3747m�glich.
3748
3749
3750Af1Resource FixedText
3751Aga
3752Diese Resource definiert die Daten der StarView-Klasse FixedText.
3753
3754AgaBeispiel:
3755Aga
3756Ali	FixedText
3757	{
3758		Right = TRUE;
3759	};
3760Aga
3761AgaNach dem Schl�sselwort LEFT kann TRUE oder FALSE angegeben werden. Bei
3762TRUE wird der Text linksb�ndig ausgegeben.
3763
3764Nach dem Schl�sselwort CENTER kann TRUE oder FALSE angegeben werden. Bei
3765TRUE wird der Text zentriert ausgegeben.
3766
3767Nach dem Schl�sselwort RIGHT kann TRUE oder FALSE angegeben werden. Bei
3768TRUE wird der Text rechtsb�ndig ausgegeben.
3769
3770Werden LEFT, CENTER und RIGHT auf TRUE gesetzt, wird eine der M�glichkeiten
3771ausgew�hlt. Sind sie alle FALSE, wird der Text linksb�ndig ausgegeben.
3772
3773AgaDefault:
3774Aga
3775Ali	FixedText
3776	{
3777		Left	= FALSE;
3778		Center	= FALSE;
3779		Right	= FALSE;
3780	};
3781Aga
3782
3783Af1Resource FixedIcon
3784Aga
3785Diese Resource definiert die Daten der StarView-Klasse FixedIcon.
3786
3787AgaBeispiel:
3788Aga
3789Ali	FixedIcon
3790	{
3791		Fixed = Icon { Predefine = ICON_QUERY; };
3792	};
3793Aga
3794AgaNach dem Schl�sselwort FIXED kann ein Icon angeben werden. Dieses Icon wird in
3795dem Control zentriert ausgegeben.
3796
3797AgaDefault:
3798Aga
3799Ali	FixedIcon
3800	{
3801		Fixed	= Icon{};
3802	};
3803Aga
3804
3805Af1Resource FixedBitmap
3806Aga
3807Diese Resource definiert die Daten der StarView-Klasse FixedBitmap.
3808
3809AgaBeispiel:
3810Aga
3811Ali	FixedBitmap
3812	{
3813		Fixed = Bitmap { File = "schmett.bmp"; };
3814	};
3815Aga
3816AgaNach dem Schl�sselwort FIXED kann eine Bitmap angeben werden. Diese Bitmap
3817wird in dem Control zentriert ausgegeben.
3818
3819AgaDefault:
3820Aga
3821Ali	FixedBitmap
3822	{
3823		Fixed	= Bitmap{};
3824	};
3825Aga
3826
3827Af1Resource GroupBox
3828Aga
3829Diese Resource definiert die Daten der StarView-Klasse GroupBox.
3830
3831AgaBeispiel:
3832Aga
3833Ali	GroupBox {};
3834Aga
3835Nur der Typ des Fensters ist entscheidend, es sind keine zus�tzlichen Angaben
3836m�glich.
3837paSpezielle Resource-Konstrukte
3838Aga
3839Af1Globale, lokale Resourcen
3840Aga
3841Globale Resourcen sind Resourcen, die au�erhalb jeder anderen Resource definiert
3842sind. Lokale Resourcen sind innerhalb einer anderen Resource definiert. Lokale
3843Resourcen m�ssen einen Identifier im Bereich von 1 bis 255 haben, globale Resourcen
3844einen Identifier im Bereich von 256 bis 32767.
3845
3846AgaBeispiel:
3847Aga
3848AliWindow 1000
3849{
3850	Text = "Info";
3851	DefPushButton 1
3852	{
3853		Text = "Ok";
3854	};
3855};
3856Aga
3857In diesem Fall ist WINDOW 1000 eine globale Resource und DEFPUSHBUTTON 1
3858eine lokale Resource.
3859
3860Af1paReferenzen
3861Aga
3862Wird eine Resource mehr als nur einmal ben�tigt, so kann diese Resource als globale
3863Resource definiert und an anderer Stelle darauf verwiesen werden.
3864
3865AgaBeispiel:
3866Aga
3867AliDefPushButton 1000
3868{
3869	Text = "Ok";
3870};
3871Window 1000
3872{
3873	Text = "Info";
3874	DefPushButton 1, 1000;
3875};
3876Aga
3877Die Konstruktion DEFPUSHBUTTON 1, 1000 ist eine Referenz auf den
3878DefPushButton 1000, wobei 1 die ID innerhalb der Window-Resource ist. Das hei�t,
3879im Programm greift man �ber die ID 1 auf diese Resource zu.
3880
3881Eine Referenz kann immer angegeben werden, wenn eine Resource-Definition erwartet
3882wird. Beim Erstellen einer ".rc"-Datei m�ssen alle Referenzen aufgel�st werden
3883k�nnen.
3884
3885Af1Lokale Resourcen
3886Aga
3887Lokale Resourcen k�nnen in jeder Resource-Definition angegeben werden.
3888
3889Af1Beispiel:
3890Aga
3891AliWindow 1000
3892{
3893	Text = "Info";
3894	PushButton		1, 1000;
3895	DefPushButton	2, 1001;
3896	SingleLineEdit	3, 1002;
3897	Color			4 { RGB = (0,     0, 0); };
3898	Color			5 { RGB = (65535, 0, 0); };
3899};
3900Aga
3901In diesem Beispiel sind drei Controls und zwei Farben als lokale Resource angegeben.
3902Auf die Resourcen kann �ber die Identifier 1 bis 5 zugegriffen werden.
3903Af1paBenutzerdaten
3904Aga
3905Mit Hilfe der EXTRADATA-Konstruktion k�nnen in einer Resource beliebige Daten
3906definiert werden.
3907
3908Beispiel:
3909
3910AliWindow 1000
3911{
3912	Text		= "Info";
3913	ExtraData	=
3914	{
3915		"Hallo"; 1; -10;
3916	};
3917	ExtraData	=
3918	{
3919		1; 2; 3; 4;
3920	};
3921Ali};
3922Aga
3923Nach dem Schl�sselwort EXTRADATA k�nnen Strings und ganze Zahlen angegeben
3924werden. Der Definitionsbereich der Zahlen reicht von -32536 bis 32535.
3925
3926In der Resource stehen die Daten in folgendem Format:
3927Aga
3928Apl-	Die Benutzerdaten werden hinter die vordefinierten Daten geschrieben.
3929-	Sie werden in der Reihenfolge abgelegt, in der sie aufgeschrieben worden sind.
3930-	Strings sind Null-terminiert. Sie belegen immer eine gerade Anzahl von Bytes im
3931Speicher. Der ben�tigte Platz errechnet sich also wie folgt:
3932	Platzbedarf = Stringl�nge + 1 + ( Stringl�nge + 1 ) MOD 2;
3933	benutzen Sie die Methode GetStringSizeRes() der Klasse Resource.
3934-	Zahlen sind zwei Byte lang und processorspezifisch gedreht.
3935Aga
3936Af1paDefault-Initialisierung
3937Aga
3938Beim Angeben einer Resource ist diese mit bestimmten Werten vorbesetzt. Die
3939Resource kann aber auch durch eine andere globale Resource initialisiert werden, so
3940da� die Resource die Daten der globalen Resource enth�lt.
3941
3942Beispiel:
3943
3944AliWindow 1000
3945{
3946	Text		= "Info";
3947	PosSize	= MAP_SYSFONT( 0, 0, 160, 40 );
3948	Border	= TRUE;
3949	Moveable	= TRUE;
3950	Closeable	= TRUE;
3951	DefPushButton 1, 1000;
3952	ExtraData	= { 10; };
3953};
3954Window 1001 < Window 1000
3955{
3956	Moveable	= FALSE;
3957	FixedText 2
3958	{ // Fu�zeile
3959		Disable	= TRUE;
3960		Size		= MAP_SYSFONT( 160, 4 );
3961	};
3962};
3963Aga
3964Das WINDOW 1001 �bernimmt alle Daten von WINDOW 1000, definiert noch eine
3965lokale Resource hinzu und �ndert das MOVEABLE-Attribut. Es werden auch alle
3966lokalen Resourcen und alle Benutzerdaten �bernommen. Bei den lokalen Resourcen
3967kann es leicht zu Identifier-Konflikten kommen. Es ist zu beachten, da� die Resource,
3968von der die Daten �bernommen werden sollen, von beliebigem Typ sein kann. Es
3969werden alle Daten ab der gemeinsamen Superklasse �bernommen. Das hei�t von der
3970Klasse Resource werden immer alle Daten �bernommen.
3971
3972
3973Au1paFehlermeldungen
3974Aga
3975Af1Aufbau der Fehlermeldung:
3976AgaDie Ausgabe der Fehler hat folgendes Format:
39771.	Zeile in der der Fehler aufgetreten ist.
39782.	Position an der der Fehler aufgetreten ist.
39793.	Fehlernummer: Error ( Typ, Identifier ): Fehlermeldung.
3980
3981Afp256	Allgemeiner Fehler, dieser Fehler kann nicht nicht
3982genauer spezifiziert werden.
3983257	Eine virtuelle Methode die in der abgeleiteten Klasse
3984nicht implementiert ist. Siehe Methoden der Klasse
3985RscInst: SetString(), SetNumber .... Man kann die
3986Fehlermeldung als Typfehler betrachten, das hei�t
3987dieser Typ darf nicht verwendet werden.
3988258	Die Datei mit dem angegebenen Namen konnte nicht
3989ge�ffnet werden.
3990259	Es konnte kein Zeichen generiert werden. Zum Beispiel
3991kann '\333' nicht in ein Zeichen umgewandelt werden.
3992260	Interner Fehler, eine Methode soll auf eine ung�ltige
3993Instanz angewendet werden.
3994261	Es wird eine Kommandozeilenhilfe ausgegeben (rsc -h).
3995262	Es wurde keine Eingabedatei angegeben.
3996263	In der Kommandozeile wurde ein unbekannter Schalter
3997verwendet.
3998264	Referenzen werden nur bis zu einer bestimmten Tiefe
3999aufgel�st. Der Fehler bedeutet, das Referenzen rekursiv
4000definiert wurden oder da� sie zu tief verschachtelt sind.
4001512	Allgemeiner Fehler.
4002513	Es wurde versucht eine Zahl einzusetzen, die au�erhalb
4003des Wertebereichs liegt.
4004528	Allgemeiner Fehler.
4005544	Allgemeiner Fehler.
4006578	Allgemeiner Fehler.
4007579	Allgemeiner Fehler.
4008580	Es wurde versucht eine Resourcrinstanz mit falschem
4009Typ verwendet.
4010608	Allgemeiner Fehler.
4011609	Allgemeiner Fehler.
4012610	F�r ein Makro soll eine Name verwendet werden, der
4013schon belegt ist. Namen k�nnen zum Beispiel schon f�r
4014Variablen vergeben sein.
4015640	Allgemeiner Fehler.
4016641	Zwei globale Resourcen haben den gleichen Identifier.
4017642	Der verwendete Typ ist nicht erlaubt.
4018643	Die Variable darf hier nicht verwendet werden.
4019644	Der Zahlenwert ist au�erhalb von [0, 0xFFFF].
4020645	Der Zahlenwert ist au�erhalb von [0, 0x7FFF].
4021646	Defaultresource wurde nicht gefunden. Eine
4022Resourceinstanz kann mit einer anderen initialisiert
4023werden. Diese ander Instanz wurde nicht gefunden.
4024647	An dieser Stelle ist die Angabe einer Referenz verboten.
4025648	Ein Makroname soll doppelt vergeben werden.
4026649	Die Angabe einer Defaultresource ist verboten.
4027650	Ein Identifier mu� Angegeben werden.
4028651	Es sollte durch Null geteilt werden.
4029652	Fehler in der Pragmaanweisung.
4030653	Das Makro wurde durch weitere Makro's erkl�rt, die
4031nicht in den entsprechenden Include-Dateien stehen.
4032
4033Es folgen Warnungen.
40344098	Resourcen die sich innerhalb einer anderen Resource
4035befinden (Unterresourcen) haben ein Identifier �ber 255.
40364099	Globale Resourcen haben einen Identifier unter 256.
40374100	Die Unterresource werden nicht beachtet. Das bedeutet,
4038da� auf diese Resourcen zur Laufzeit nicht zugegriffen
4039werden kann.
40404101	Die Resourcen haben einen keinen Identifier. Auf diese
4041Resourcen kann zur Laufzeit nicht zugegriffen werden.
40424102	Beim schreiben ein rc-Datei konnte eine Stringreferenz
4043nicht aufgel�st werden.
40444103	Beim schreiben ein rc-Datei konnte eine Referenz nicht
4045aufgel�st werden. Wenn auf Unterresourcen zugegriffen
4046wird, die sich in der referenzierten Resource befinden,
4047dann kann ein Laufzeitfehler auftreten.
40484104	Zwei Unterresource mit gleichem Typ haben den
4049gleichen Identifier.
4050
4051SsvAgaPA
4052Au0Stichwortverzeichnis
4053Aga
4054AsvCompiler Anweisungen	16
4055Resource Accelerator	33
4056Resource AcceleratorKey	34
4057Resource AutoCheckBox	50
4058Resource AutoRadioButton	51
4059Resource AutoScrollBar	55
4060Resource Bitmap	22
4061Resource Brush	24
4062Resource CheckBox	50
4063Resource Color	26
4064Resource ComboBox	57
4065Resource DefPushButton	51
4066Resource DialogBox	48
4067Resource DropDownComboBox	57
4068Resource DropDownListBox		57
4069Resource FixedText	58
4070Resource Font	28
4071Resource GroupBox	58
4072Resource Icon	21
4073Resource ListBox	56
4074Resource MapMode	32
4075Resource MDIWindow	48
4076Resource Menu	36
4077Resource MenuItem	37
4078Resource MessageBox	39
4079Resource MultiLineEdit	53
4080Resource OutputDevice	40
4081Resource Pen	31
4082Resource Pointer	22
4083Resource PushButton	50
4084Resource RadioButton	51
4085Resource Resource	20
4086Resource ScrollBar	54
4087Resource SingleLineEdit	52
4088Resource String	20
4089Resource SystemWindow	44
4090Resource Window	42
4091Resource WorkWindow	47
4092Resource Button	49
4093Resource Control	49
4094
4095Aga
4096