xref: /aoo41x/main/rsc/doku/feinkonz.43/rscinst.doc (revision cdf0e10c)
1.\\\ WRITER 6 \\\
2S:\APP\SW5\STARLAB.LAY
3R:\SW55N\TREIBER\PS.GPM
412
500000
600010
701394
800001
900001
1000001
1100002
1200002
1300000
1400000
1500000
1600000
17Markus Meyer
18Spezifikation
19Rsc-Compiler
20Schnittstelle
21
22
23
24
25
26
270
2816836
2911338
300
310
32JA
333
3475
350
3620
370
380
390
400
410
420
430
44JA
45
46
47
489
4920
504
51Helvetica 14 Pt
52H1
5397
5420
550
56
57Helvetica 12 Pt
58H2
5965
6023
610
62
63Helvetia 10 Pt
64H3
6565
6620
670
68
69Courier 10 Pt
70C1
711
7223
730
74
75Helvetica 14 Pt Fett
76F1
7765
7827
792
80
81Helvetica 12 Pt Fett
82F2
8365
8423
852
86
87Helvetia 10 Pt Fett
88F3
8965
9020
910
92
93Tasten
94T1
95129
9627
970
98
99Grundschrift
100GA
10197
10220
1030
104
105Grund - Absatzlayout V1.5-LSLP8
106GA
1070
1080
1090
1100
1119
11297
11320
1140
1151
1160
1171
118NEIN
119NEIN
120NEIN
121240
1220
1230
12416
1250
1260
1270
1280
1290
1300
1310
132NEIN
133
13413
135576
1360
1370
1381152
1390
1400
1411728
1420
1430
1442304
1450
1460
1472880
1480
1490
1503456
1510
1520
1534032
1540
1550
1564608
1570
1580
1595184
1600
1610
1625760
1630
1640
1656336
1660
1670
1686912
1690
1700
1717488
1720
1730
174Grundabsatzlayout-rechtsb�ndig
175GR
1760
1770
1780
1790
1809
18135
18220
1830
1842
1850
1861
187NEIN
188NEIN
189NEIN
190240
1910
1920
19316
1940
1950
1960
1970
1980
1990
2000
201NEIN
202
20313
204576
2050
2060
2071152
2080
2090
2101728
2110
2120
2132304
2140
2150
2162880
2170
2180
2193456
2200
2210
2224032
2230
2240
2254608
2260
2270
2285184
2290
2300
2315760
2320
2330
2346336
2350
2360
2376912
2380
2390
2407488
2410
2420
243Listing
244LI
2450
2460
2470
2480
2490
2501
25123
2520
2531
2540
2551
256NEIN
257NEIN
258NEIN
259240
2600
2610
26216
2630
2640
2650
2660
2670
2680
2690
270NEIN
271
27213
273576
2740
2750
2761152
2770
2780
2791728
2800
2810
2822304
2830
2840
2852880
2860
2870
2883456
2890
2900
2914032
2920
2930
2944608
2950
2960
2975184
2980
2990
3005760
3010
3020
3036336
3040
3050
3066912
3070
3080
3097488
3100
3110
312�berschrift
313U0
3140
3150
3160
3170
3185
31935
32028
3212
3221
3230
3241
325NEIN
326NEIN
327JA
328240
3290
3300
33116
3320
3330
3340
3350
3360
3370
3380
339NEIN
340
34113
342576
3430
3440
3451152
3460
3470
3481728
3490
3500
3512304
3520
3530
3542880
3550
3560
3573456
3580
3590
3604032
3610
3620
3634608
3640
3650
3665184
3670
3680
3695760
3700
3710
3726336
3730
3740
3756912
3760
3770
3787488
3790
3800
381�berschrift X.
382U1
3830
3840
3850
3860
3875
38835
38928
3902
3911
3920
3931
394NEIN
395NEIN
396JA
397240
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 X.X.
451U2
4520
4530
4540
4550
4566
45735
45824
4592
4601
4610
4621
463NEIN
464NEIN
465JA
466240
4672
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
519�berschrift X.X.X.
520U3
5210
5220
5230
5240
5256
52635
52720
5282
5291
5300
5311
532NEIN
533NEIN
534JA
535240
5363
5370
53816
5390
5400
5410
5420
5430
5440
5450
546NEIN
547
54813
549576
5500
5510
5521152
5530
5540
5551728
5560
5570
5582304
5590
5600
5612880
5620
5630
5643456
5650
5660
5674032
5680
5690
5704608
5710
5720
5735184
5740
5750
5765760
5770
5780
5796336
5800
5810
5826912
5830
5840
5857488
5860
5870
588�berschrift X.X.X.X.
589U4
5900
5910
5920
5930
5947
59535
59620
5970
5981
5990
6001
601NEIN
602NEIN
603NEIN
604240
6054
6060
60716
6080
6090
6100
6110
6120
6130
6140
615NEIN
616
61713
618576
6190
6200
6211152
6220
6230
6241728
6250
6260
6272304
6280
6290
6302880
6310
6320
6333456
6340
6350
6364032
6370
6380
6394608
6400
6410
6425184
6430
6440
6455760
6460
6470
6486336
6490
6500
6516912
6520
6530
6547488
6550
6560
657�berschrift X.X.X.X.X.
658U5
6590
6600
6610
6620
6637
66435
66520
6660
6671
6680
6691
670NEIN
671NEIN
672NEIN
673240
6745
6750
67616
6770
6780
6790
6800
6810
6820
6830
684NEIN
685
68613
687576
6880
6890
6901152
6910
6920
6931728
6940
6950
6962304
6970
6980
6992880
7000
7010
7023456
7030
7040
7054032
7060
7070
7084608
7090
7100
7115184
7120
7130
7145760
7150
7160
7176336
7180
7190
7206912
7210
7220
7237488
7240
7250
726Einr�ckung 4 Sp / 4 Sp
727E1
728576
729576
7300
7310
7329
73335
73420
7350
7361
7370
7381
739NEIN
740NEIN
741NEIN
742240
7430
7440
74516
7460
7470
7480
7490
7500
7510
7520
753NEIN
754
75513
756576
7570
7580
7591152
7600
7610
7621728
7630
7640
7652304
7660
7670
7682880
7690
7700
7713456
7720
7730
7744032
7750
7760
7774608
7780
7790
7805184
7810
7820
7835760
7840
7850
7866336
7870
7880
7896912
7900
7910
7927488
7930
7940
795Einr�ckung 8 Sp / 8 Sp
796E2
7971150
7981150
7990
8000
8019
80235
80320
8040
8051
8060
8071
808NEIN
809NEIN
810NEIN
811240
8120
8130
81416
8150
8160
8170
8180
8190
8200
8210
822NEIN
823
82413
825576
8260
8270
8281152
8290
8300
8311728
8320
8330
8342304
8350
8360
8372880
8380
8390
8403456
8410
8420
8434032
8440
8450
8464608
8470
8480
8495184
8500
8510
8525760
8530
8540
8556336
8560
8570
8586912
8590
8600
8617488
8620
8630
864Einr�ckung 0 Sp / 4 Sp
865E3
8660
867564
8680
8690
8709
87135
87220
8730
8741
8750
8761
877NEIN
878NEIN
879NEIN
880240
8810
8820
88316
8840
8850
8860
8870
8880
8890
8900
891NEIN
892
89313
894576
8950
8960
8971152
8980
8990
9001728
9010
9020
9032304
9040
9050
9062880
9070
9080
9093456
9100
9110
9124032
9130
9140
9154608
9160
9170
9185184
9190
9200
9215760
9220
9230
9246336
9250
9260
9276912
9280
9290
9307488
9310
9320
933Einr�ckung 4 Sp / 8 Sp
934E4
935564
9361150
9370
9380
9399
94035
94120
9420
9431
9440
9451
946NEIN
947NEIN
948NEIN
949240
9500
9510
95216
9530
9540
9550
9560
9570
9580
9590
960NEIN
961
96213
963576
9640
9650
9661152
9670
9680
9691728
9700
9710
9722304
9730
9740
9752880
9760
9770
9783456
9790
9800
9814032
9820
9830
9844608
9850
9860
9875184
9880
9890
9905760
9910
9920
9936336
9940
9950
9966912
9970
9980
9997488
10000
10010
1002Funktionsparameter
1003FP
10040
10052891
10060
10070
10089
100935
101020
10110
10121
10130
10141
1015NEIN
1016NEIN
1017NEIN
1018240
10190
10200
102116
10220
10230
10240
10250
10260
10270
10280
1029NEIN
1030
103113
1032576
10330
10340
10351152
10360
10370
10381728
10390
10400
10412304
10420
10430
10442880
10450
10460
10473456
10480
10490
10504032
10510
10520
10534608
10540
10550
10565184
10570
10580
10595760
10600
10610
10626336
10630
10640
10656912
10660
10670
10687488
10690
10700
1071Inhaltsverzeichnis
1072IV
10730
10740
10750
10760
10779
107835
107920
10800
10811
10820
10831
1084NEIN
1085NEIN
1086NEIN
1087240
10880
10890
109016
10910
10920
10930
10940
10950
10960
10970
1098NEIN
1099
11001
11017653
11020
11030
1104Stichwortverzeichnis
1105SV
11060
11070
11080
11090
11109
111135
111220
11130
11141
1115141
11161
1117JA
1118NEIN
1119NEIN
1120240
11210
11220
112316
11240
11250
11260
11270
11280
11290
11300
1131NEIN
1132
11331
11343744
11351
11360
1137Fettschrift einzeilig
1138F1
11390
11400
11410
11420
11437
114465
114520
11462
11471
11480
11491
1150NEIN
1151NEIN
1152NEIN
1153240
11540
11550
115616
11570
11580
11590
11600
11610
11620
11630
1164NEIN
1165
116613
1167576
11680
11690
11701152
11710
11720
11731728
11740
11750
11762304
11770
11780
11792880
11800
11810
11823456
11830
11840
11854032
11860
11870
11884608
11890
11900
11915184
11920
11930
11945760
11950
11960
11976336
11980
11990
12006912
12010
12020
12037488
12040
12050
1206Punktliste
1207PL
12080
1209564
12100
12110
12129
121335
121420
12150
12161
12170
12181
1219NEIN
1220NEIN
1221NEIN
1222240
12230
12240
122516
12260
12270
12280
12290
12300
12310
12320
1233NEIN
1234
123513
1236566
12370
12380
12391133
12400
12410
12421728
12430
12440
12452304
12460
12470
12482880
12490
12500
12513456
12520
12530
12544032
12550
12560
12574608
12580
12590
12605184
12610
12620
12635760
12640
12650
12666336
12670
12680
12696912
12700
12710
12727488
12730
12740
1275Fu�zeile
1276FZ
12770
12780
12790
12800
12813
128297
128320
12842
12851
12860
12871
1288NEIN
1289NEIN
1290NEIN
1291240
12920
12930
129416
12950
12960
12970
12980
12990
13000
13010
1302NEIN
1303
13041
13057200
13061
13070
1308Kopfzeile
1309KZ
13100
13110
13120
13130
13143
131597
131620
13172
13181
13190
13201
1321NEIN
1322NEIN
1323NEIN
1324240
13250
13260
132716
13280
13290
13300
13310
13320
13330
13340
1335NEIN
1336
13371
13387920
13391
13400
1341Grund-Seitenlayout
1342GS
1343566
1344609
13452436
1346679
13471416
13481416
13490
13500
13511
1352NEIN
13530
13540
1355
1356AkzBf3#_PFAD##_TEXTNAME#	6-#_S#-
1357Bf3�������������������������������������������������������������
1358
1359AfzBf3$Date:   05 Feb 1992 08:23:58  $	$Revision:   1.7  $
1360
1361Stichwortverzeichnis
1362SV
1363566
1364609
13652437
1366680
13671416
13681416
1369566
13700
13712
1372NEIN
13730
13740
1375
1376AliBf3Stichwortverzeichnis
1377AliBf3�������������������������������������������������������������
1378�������
1379
1380Ali6Bf3- #_S# -B00
1381
1382GS - ohne Fu�zeile
1383KF
1384566
1385609
13862437
1387680
13881416
13891416
13900
13910
13921
1393NEIN
13940
13950
1396
1397AliBf3#_KATEGORIE# / #_THEMA2#
1398AliBf3���������������������������������������������������������
1399
1400Ali
1401
1402Inhaltsverzeichnis
1403IV
1404566
1405609
14062437
1407680
14081416
14091416
14100
14110
14121
1413NEIN
14140
14150
1416
1417AliBf3Inhaltsverzeichnis
1418AliBf3�������������������������������������������������������������
1419�������
1420
1421Ali
1422
1423
1424
1425
14260
1427
14280
1429
1430SkfAga
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440Au0	#_KATEGORIE#
1441Aga
1442
1443Au0	#_THEMA2#
1444Aga
1445
1446Au0
1447Aga
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460Au0	#_AUTOR#
1461Aga
1462
1463Au0	STAR DIVISION / STAR LAB Hamburg
1464Aga
1465
1466Au0	Stand: $Date:   05 Feb 1992 08:23:58  $
1467Aga
1468
1469Sgs
1470SkfAgaPA
1471
1472
1473Au0#_KATEGORIE#
1474Aga
1475
1476
1477AfpDokumentenname	#_THEMA2#
1478Aga
1479AfpProjektname	#_THEMA1#
1480Aga
1481AfpVersionsnummer	$Revision:   1.7  $
1482Aga
1483
1484Afperstellt	02. April 1990
1485Aga
1486Afpge�ndert	$Date:   05 Feb 1992 08:23:58  $
1487Aga
1488
1489AfpDateiname	#_PFAD##_TEXTNAME#
1490Aga
1491
1492AfpAutor	#_AUTOR#
1493Aga
1494AfpBearbeiter	$Author:   MM  $
1495Aga
1496AfpQualit�tskontrolle
1497Aga
1498
1499AfpStatus	XX	in Arbeit
1500Afp	!__	fertiggestellt
1501Afp	!__	abgenommen
1502Afp	!__	freigegeben
1503Aga
1504
1505AfpVertraulich	__ Ja   XX Nein
1506Aga
1507
1508AfpCopyright (C)	Star Division 1990
1509Aga
1510Sivpa
1511
1512Au0Inhaltsverzeichnis
1513Aga
1514Aiv
15151 Einleitung	N4
15162 Klassenbaum	M5
15173 Klassenbeschreibung	E5
1518RscDataBase	O6
1519RscHrc	T14
1520RscSrc	T24
1521RscInst	S31
1522RscInstCopy	O50
1523Stichwortverzeichnis	F53
1524
1525Sgs
1526Au1pa#1 Einleitung
1527Aga
1528In diesem Dokument werden die Klassen beschrieben, mit denen die vom Rsc-Compiler erstellte
1529Datenbasis ver�ndert werden k�nnen. Als Beispiel sei hier der Design-Editor genannt.
1530Um das Verst�ndnis zu erleichtern, ist es hilfreich die Benutzerbeschreibung des Rsc-Compilers zu
1531lesen.
1532
1533Hinweise zur Implementation
1534
1535Die in diesem Dokument beschriebenen Klassen weisen einen hohen Grad an gegenseitigen
1536Abh�ngigkeiten auf. Daher mu� bei der Anwendung einiger Methoden auf diese Zusammenh�nge
1537besonders geachtet werden. Ein genaues lesen der Dokumentation ist unumg�nglich. Zum Beispiel ist
1538das L�schen einer Instanz nicht immer m�glich, da noch Referenzen auf sie bestehen. Diese
1539Schnittstelle ist darauf ausgelegt, da� auf die Daten im Dialogbetrieb zugegriffen wird. Das hei�t, sie
1540ist auf �bersichtlichkeit und Fehlererkennung nicht aber auf Speicher- und Geschwindigkeitseffizienz
1541ausgelegt.
1542Bevor eine dieser Klassen benutzt wird, mu� die InitRscCompiler() Funktion aufgerufen werden.
1543Agapa
1544Au1#2 Klassenbaum
1545Aga
1546RscDataBase
1547RscHrc	->	RscSrc
1548RscInst	->	RscInstCopy
1549
1550
1551Au1#3 Klassenbeschreibung
1552Aga
1553AgaRscDataBase:
1554
1555Diese Klasse stellt Methoden zur Verf�gung mit denen ein Resourceprojekt verwaltet werden kann,
1556wie zum Beispiel das Anlegen einer neuen Datei oder zu einem Klassennamen den Klassentyp
1557erzeugen.
1558
1559AgaRscHrc:
1560
1561Diese Klasse stellt Methoden zur Verf�gung mit denen dateiabh�ngige Informationen und Daten aus
1562der Datenbasis gewonnen werden k�nnen. Es handelt sich hierbei haupts�chlich um Makros. Diese
1563Klasse ist als Sicht auf eine hrc-Datei zu verstehen. Die Daten stehen in der Datenbasis.
1564
1565AgaRscSrc:
1566
1567Diese Klasse stellt Methoden zur Verf�gung mit denen dateiabh�ngige Informationen und Daten aus
1568der Datenbasis gewonnen werden k�nnen. Diese Klasse ist als Sicht auf eine src-Datei zu verstehen.
1569Die Daten stehen in der Datenbasis.
1570
1571RscInst:
1572
1573Eine RscInst repr�sentiert eine Referenz auf eine Resourceinstanz, wie zum Beispiel Farbe oder Breite.
1574Eine Resourceinstanz kann weitere Resourceinstanzen enthalten.
1575
1576RscInstCopy:
1577
1578Diese Instanz repr�sentiert eine Kopie einer Resourceinstanz.
1579
1580Au0PARscDataBase
1581Aga
1582Aliclass RscDataBase {
1583protected:
1584    RscCmdLine  * pCmdLine;
1585    RscTypCont  * pTC;
1586public:
1587                 RscDataBase( RscError * );
1588                 ~RscDataBase();
1589    RscTop*      GetClassType( HASHID nClassName );
1590    BOOL         MakeConsistent( RscInconsList * pList );
1591    RscFileTab * GetFileTab();
1592    RscFile *    GetFileStruct( ULONG lFileKey );
1593    RscStrList * GetPathList();
1594    ULONG        AddSrcFile( const String & rFileName );
1595    ULONG        AddHrcFile( const String & rFileName );
1596    void         ScanForIncFiles( ULONG lFileKey );
1597    void         RemoveFile( ULONG lKey );
1598    RscDefine *  FindDef( const String & rName );
1599    ULONG        GetFileKey( const String & rFileName );
1600};
1601Aga
1602Af1Beschreibung
1603Aga
1604Diese Klasse enth�lt die Klassen RscCmdLine und RscTypCont.
1605Die Klasse RscCmdLine enth�lt die Steuerinformation f�r den Compiler. Die Klasse RscTypCont
1606enth�lt die vom Compiler erstellte DatenBasis.
1607Diese Klasse l�st folgende Aufgaben:
1608	1. Das �berpr�fen der Konsistenz der Datenbasis.
1609	2. Das Bearbeiten der Projektstruktur.
1610
1611Af1Anmerkungen
1612Aga
1613F�r einige Methoden der Klasse RscDataBase gilt, da� sie eventuell auf alle existierenden
1614Resourceinstanzen zugreifen m�ssen. Wenn zum Beispiel die Konsistenz der Datenbasis �berpr�ft
1615wird, kann dies nur �ber die Objekte in der Datenbasis geschehen.
1616
1617Af1Querverweise
1618Aga
1619Klassen:  RscCmdLine, RscTypCont, RscFile, RscDefList, RscError, RscId, RscHrc, RscSrc.
1620Methoden: HashId, GetHashString.
1621
1622Af1Beispiel
1623Aga
1624Im Beispiel wird der einer Resource erfragt.
1625Ali.....
1626Ali// statische Datenstrukturen initialisieren
1627InitRscCompiler();
1628.....
1629RscError	aErrorHandle;              // Fehlerbehandlung
1630RscDataBase	aCmpInst( &aErrorHandle ); // Datenbasis
1631RscTop*	pClassTyp;                  // ein Klassentyp
1632
1633// Typ einer Resource aus dem Namen der Klasse erzeugen
1634pClassTyp = aCmpInst.GetClassType( HashId( "Color" ) );
1635Ali.....
1636
1637Au0PARscDataBase::RscDataBase()
1638Aga
1639AliRscDataBase::RscDataBase( RscError * pErrorHandler );
1640Aga
1641Af1Beschreibung
1642Aga
1643Diese Methode erzeugt eine Instanz der Klasse RscDataBase. Der Scope von dieser Instanz mu�
1644innerhalb des Scopes von pErrorHandler liegen.
1645
1646Af1Parameter
1647Aga
1648AfppErrorHandler	Ein Zeiger auf einen Fehlerhandler. Durch ableiten von der Klasse
1649"RscError kann ein eigener Fehlermechanismus entwickelt werden.
1650Aga
1651Af1Querverweise
1652Aga
1653Klasse: RscError
1654
1655Af1Beispiel
1656Aga
1657Ali.....
1658RscError	aErrorHandler;
1659RscDataBase	aCmpInst( &aErrorHandle );
1660.....
1661Aga
1662Aga���������������������������������������������������������
1663Aga
1664Au0RscDataBase::RscDataBase()
1665Aga
1666AliRscDataBase::~RscDataBase();
1667Aga
1668Af1Beschreibung
1669Aga
1670L�scht die Membervariablen pCmdLine und pTC.
1671
1672Af1Anmerkungen
1673Aga
1674Es d�rfen keine Resourceinstanzen, die mit Hilfe dieser Instanz erzeugt worden sind, mehr existieren.
1675
1676Af1Querverweise
1677Aga
1678Klassen: RscInst, RscCmdLine, RscTypCont, RscIncList, RscHrc, RscSrc.
1679
1680Aga���������������������������������������������������������
1681Aga
1682Au0RscDataBase::GetClassType()
1683Aga
1684AliRscTop * RscDataBase::GetClassType( HASHID aClassName );
1685Aga
1686Af1Beschreibung
1687Aga
1688Aus dem Namen einer Klasse wird der Typ einer Klasse generiert. Der Typ bezieht sich nur auf die
1689RscDataBase-Instanz von der er erzeugt wurde.
1690
1691Af1Parameter
1692Aga
1693AfpaClassName	ist der Name der Klasse.
1694Aga
1695Af1Return-Werte
1696Aga
1697Der Typ der Klasse wird zur�ckgeliefert. Wird unter dem Namen keine Klasse gefunden, dann wird
1698NULL zur�ckgeliefert.
1699
1700Af1Anmerkungen
1701Aga
1702Wenn aus gleichen Namen zweier unterschiedlicher Instanzen Typen erzeugt werden, dann sind diese
1703unterschiedlich.
1704
1705Af1Beispiel
1706Aga
1707Ali.....
1708HASHID	aClassName = HashId( "Color" );
1709RscTop * aType1 = aCmpInst1.GetClassType( aClassName );
1710RscTop * aType2 = aCmpInst2.GetClassType( aClassName );
1711RscTop * aType3 = aCmpInst2.GetClassType( aClassName );
1712.....
1713Aga
1714aType1 ist ungleich zu aType2.
1715aType2 ist gleich zu aType3.
1716
1717Aga���������������������������������������������������������
1718Aga
1719Au0RscDataBase::MakeConsistent()
1720Aga
1721AliBOOL RscDataBase::MakeConsistent( RscInconsList * pList );
1722Aga
1723Af1Beschreibung
1724Aga
1725Es ist m�glich, da� durch Ver�nderungen von Makros die Datenbasis inkonsistent wird. Mit dieser
1726Methode wird versucht, die Datenbasis wieder in einen konsistenten Zustand zu versetzen. Dies kann
1727aber auch scheitern, wenn zum Beispiel der Wertebereich einer Variablen verlassen wird oder die
1728 Identifier von Resourceinstanzen den gleichen Wert haben. pList enth�lt die Makros bei denen es
1729Inkonsistenzen gibt.
1730
1731Af1Parameter
1732Aga
1733AfppList	ist ein Zeiger auf eine Liste von Makro-Paaren. pList darf auch
1734"NULL sein.
1735Aga
1736Af1Return-Werte
1737Aga
1738AfpTRUE	die Datenbasis ist wieder konsistent.
1739FALSE	es konnte kein konsistenter Zustand hergestellt werden.
1740Aga
1741Af1Anmerkungen
1742Aga
1743Wenn die Datenbasis inkonsistent ist, d�rfen auf ihr keine Operationen ausgef�hrt werden.
1744
1745Af1Querverweise
1746Aga
1747Klassen:  RscInconsList.
1748Methoden: RscInst::IsConsistent.
1749
1750Af1Beispiel
1751Aga
1752Ali...
1753RscDataBase *pDataBase = new ...; // DatenBasis
1754RscSrc      aSrc( ... );  //entspricht einer .src Datei
1755RscDefine * pDef1, *pDef2;        //Makros
1756
1757aSrc.NewDef( "DEF1", 1000, LIST_APPEND ); //Makro erzeugen
1758aSrc.NewDef( "DEF2", 1001, LIST_APPEND ); //Makro erzeugen
1759pDef1 = aSrc.FindDef( "DEF1" );           //Makro holen
1760pDef2 = aSrc.FindDef( "DEF2" );           //Makro holen
1761
1762/* aStrInst enth�lt eine g�ltige String-Instanz */
1763//String-Instanz unter Id mit Wert 1000 einsetzen
1764AliaSrc.SetRscInst( RscId( pDef1 ), aStrInst );
1765//String-Instanz unter Id mit Wert 1001 einsetzen
1766AliaSrc.SetRscInst( RscId( pDef2 ), aStrInst );
1767//aendern des Makro-Wertes
1768aSrc.ChangeDef( "DEF2", 1000 );
1769//Datenbasis ueberpruefen
1770if( pDataBase->MakeConsistent( NULL ) )
1771	printf( "Konsistent" );
1772else
1773	printf( "Inkonsistent" );
1774Aga
1775Die Ausgabe ist 'Inkonsistent', weil in der Datenbasis zwei String-Instanzen mit dem Identifier 1000
1776existieren.
1777Aga���������������������������������������������������������
1778Aga
1779Au0RscDataBase::GetFileTab()
1780Aga
1781AliRscFileTab  * RscDataBase::GetFileTab();
1782Aga
1783Af1Beschreibung
1784Aga
1785Die interne Struktur der Makro- und Dateiverwaltung wird zur�ckgeliefert.
1786
1787Af1Return-Werte
1788Aga
1789Es wird ein Zeiger auf die Struktur der Projektverwaltung zur�ckgeliefert.
1790Aga
1791Af1Querverweise
1792Aga
1793Klassen: RscFileTab.
1794Aga
1795Aga���������������������������������������������������������
1796Aga
1797Au0RscDataBase::GetFileStruct()
1798Aga
1799AliRscFile * RscDataBase::GetFileStruct( ULONG lFileKey );
1800Aga
1801Af1Beschreibung
1802Aga
1803Auf die interne Darstellung der Daten einer Datei wird �ber einen Schl�ssel zugegriffen. Mit Hilfe
1804dieses Schl�ssels kann man einen Zeiger auf die interne Datenstruktur bekommen.
1805
1806Af1Parameter
1807Aga
1808AfplFileKey	Schl�ssel der Datei.
1809Aga
1810Af1Return-Werte
1811Aga
1812Zeiger auf interne Struktur.
1813Aga
1814Af1Querverweise
1815Aga
1816Klassen:  RscFile, RscFileTab.
1817Methoden: GetKey().
1818Aga
1819Aga���������������������������������������������������������
1820Aga
1821Au0RscDataBase::GetPathList()
1822Aga
1823AliRscStrList * RscDataBase::GetPathList();
1824Aga
1825Af1Beschreibung
1826Aga
1827Diese Methode gibt einen Zeiger auf eine Liste mit Pfadnamen zur�ck. Diese Liste kann ver�ndert
1828werden. Die �nderungen wirken sich sofort auf den Suchpfad aus.
1829
1830Af1Return-Werte
1831Aga
1832Es wird die PfadListe zur�ckgeliefert.
1833
1834Af1Beispiel
1835Aga//veraendern der Pfadliste
1836
1837AliRscDataBase aBase( ... ); //Datenbasis
1838
1839// Pfadliste holen
1840RscStrList * pPathLst = aBase.GetPathList();
1841//Pfad hinzufuegen
1842pPathList->Insert( String( "c:\demo\resource" ) );
1843Aga
1844Aga���������������������������������������������������������
1845Au0
1846Au0RscDataBase::AddSrcFile()
1847Aga
1848AliULONG RscDataBase::AddSrcFile( const String & rName );
1849Aga
1850Af1Beschreibung
1851Aga
1852Diese Methode stellt eine Src-Datei in die Projektverwaltung.
1853
1854Af1Parameter
1855Aga
1856AfprName	Dies ist der Name der Datei.
1857Aga
1858Af1Return-Werte
1859Aga
1860Es wird der Schl�ssel der Datei zur�ckgeliefert.
1861Aga
1862Af1Anmerkungen
1863Aga
1864Wenn es eine Datei unter diesem Namen gibt, dann wird der Schl�ssel dieser Datei zur�ckgegeben.
1865
1866Af1Querverweise
1867Aga
1868Klassen:  RscFileTab.
1869
1870Aga��������������������������������������������������������
1871Aga
1872Au0RscDataBase::AddHrcFile()
1873Aga
1874AliULONG RscDataBase::AddHrcFile( const String & rName );
1875Aga
1876Af1Beschreibung
1877Aga
1878Diese Methode stellt eine Hrc-Datei in die Projektverwaltung.
1879
1880Af1Parameter
1881Aga
1882AfprName	Dies ist der Name der Datei.
1883Aga
1884Af1Return-Werte
1885Aga
1886Es wird der Schl�ssel der Datei zur�ckgeliefert.
1887Aga
1888Af1Anmerkungen
1889Aga
1890Wenn es eine Datei unter diesem Namen gibt, dann wird der Schl�ssel dieser Datei zur�ckgegeben.
1891
1892Af1Querverweise
1893Aga
1894Klassen:  RscFileTab.
1895
1896Aga���������������������������������������������������������
1897
1898Au0RscDataBase::ScanForIncFiles()
1899Aga
1900Alivoid RscDataBase::ScanForIncFiles( ULONG lFileKey );
1901Aga
1902Af1Beschreibung
1903Aga
1904Diese Methode durchsucht die Datei nach Include-Anweisungen. Die Dateien werden in die
1905Abh�ngigkeitsliste von der Datei mit dem Schl�ssel lFileKey eingetragen. Die Dateien werden in die
1906Projektverwaltung gestellt.
1907
1908Af1Anmerkungen
1909Aga
1910Kann die Datei nicht ge�ffnet werden dann wird die Abh�ngigkeitsliste nicht ge�ndert.
1911Preprozessoranweisungen wie #ifdef... werden nicht beachtet. C- und C++-Kommentare werden
1912beachtet.
1913
1914Af1Querverweise
1915Aga
1916Klassen:  RscCompiler.
1917Methoden: RscCompiler::IncludeParser().
1918Aga
1919Aga���������������������������������������������������������
1920
1921Au0RscDataBase::RemoveFile()
1922Aga
1923Alivoid RscDataBase::RemoveFile( ULONG lFileKey );
1924Aga
1925Af1Beschreibung
1926Aga
1927Die Datei wird aus der Projektverwaltung gel�scht. Alle dieser Datei zugeordneten Makros und
1928Resource-Instanzen werden gel�scht. Alle Verweise auf diese Datei werden gel�scht.
1929
1930Af1Parameter
1931Aga
1932AfplFileKey	Schl�ssel der Datei.
1933Aga
1934Af1Anmerkungen
1935Aga
1936Diese Datei wird auch aus den Abh�ngigkeitslisten der anderen Dateien gel�scht. Wenn
1937Abh�ngigkeiten auf Makros bestehen, dann werden sie durch Zahlen ersetzt.
1938
1939Af1Querverweise
1940Aga
1941Klassen:  RscFile, RscFileTab.
1942Methoden: RscTypCont::WriteSrc().
1943
1944Aga���������������������������������������������������������
1945Aga
1946Au0RscDataBase::FindDef()
1947Aga
1948AliRscDefine * RscDataBase::FindDef( const String & rName );
1949Aga
1950Af1Beschreibung
1951Aga
1952Mit dieser Methode kann ein Makro �ber seinen Namen gefunden werden.
1953
1954Af1Parameter
1955Aga
1956AfprName	ist der Name des Makros.
1957Aga
1958Af1Return-Werte
1959Aga
1960Es wird ein Zeiger auf das Makro mit Namen rName zur�ckgegeben.
1961AfpNULL	Es wurde kein Makro gefunden.
1962Aga
1963Af1Querverweise
1964Aga
1965Klassen: RscFileTab.
1966
1967Aga���������������������������������������������������������
1968Aga
1969Au0RscDataBase::GetFileKey()
1970Aga
1971AliULONG RscDataBase::GetFileKey( const String & rFileName );
1972Aga
1973Af1Beschreibung
1974Aga
1975Diese Methode sucht in der Projektverwaltung nach einem Datei mit Namen "rFileName".
1976Wenn eine Datei unter diesem Namen in der Projektverwaltung steht wird der Schl�ssel dieser Datei
1977zur�ckgegeben.
1978
1979Af1Parameter
1980Aga
1981AfprFileKey	Der Dateiname nach dem gesucht wird.
1982Aga
1983Af1Return-Werte
1984Aga
1985Es wird die Schl�ssel der Datei zur�ckgeliefert.
1986AfpNOFILE_INDEX	dieser Wert zeigt an, da� der Dateiname nicht gefunden wurde.
1987Aga
1988Af1Anmerkungen
1989Aga
1990Gro�-und Kleinschreibung wird bei der Suche beachtet.
1991
1992Af1Querverweise
1993Aga
1994Klassen: RscFileTab.
1995
1996Aga���������������������������������������������������������
1997Aga
1998Au0PARscHrc
1999Aga
2000Aliclass RscHrc {
2001protected:
2002    ULONG lFileKey;//Schluessel der Datei
2003public:
2004                   RscHrc( RscDataBase *, ULONG lKey );
2005                   ~RscHrc();
2006    ERRTYPE        ReadFile();
2007    ULONG          GetFileKey();
2008    void           SetDirty();
2009    BOOL           IsDirty();
2010    void           SetPathName( const String & );
2011    String         GetPathName();
2012    void           SetFileName( const String & );
2013    String         GetPathName();
2014    void           InsertDepend( ULONG lKey, ULONG lPos );
2015    RscDefineList * GetDefineList();
2016    RscDefine *    FindDef( const String & );
2017    ERRTYPE        NewDef( const String & rName,
2018                           long lValue, ULONG lPos );
2019    ERRTYPE        NewDef( const String & rName,
2020                           const String & rMacro,
2021                           ULONG lPos );
2022    ERRTYPE        ChangeDef( const String & rName,
2023                              long lValue );
2024    ERRTYPE        ChangeDef( const String & rName,
2025                              const String & rMacro );
2026    BOOL           IsDefUsed( const String & rName );
2027    void           DeleteDef( const String & rName );
2028    ERRTYPE        ChangeDefName( const String & rName,
2029                                const String & rNewName );
2030
2031    RscFile *      GetFileStruct();
2032    RscDependList * GetDependList();
2033    ERRTYPE        WriteFile();
2034};
2035Aga
2036Af1Beschreibung
2037AgaDiese Klasse enth�lt nur eine Referenz auf eine andere Klasse. Alle Operation werden also auf der
2038referenzierten Klasse durchgef�hrt. Diese Klasse ist nur eine Schnittstelle. Diese Klasse stellt eine
2039Sicht auf eine hrc-Datei dar.
2040
2041Diese Klasse l�st folgende Aufgaben:
2042	1. Das Verwalten der Abh�ngigkeitsliste einer Datei.
2043	2. Das Verwalten der Makros in dieser Datei.
2044	3. Das Schreiben von ".hrc"-Dateien.
2045
2046Af1Querverweise
2047Aga
2048Klassen:  RscTypCont, RscDependList, RscDefList, RscError, RscId.
2049
2050Au0PARscHrc::RscHrc()
2051Aga
2052AliRscHrc::RscHrc( RscDataBase * pDataBase, ULONG lKey );
2053Aga
2054Af1Beschreibung
2055Aga
2056Diese Methode erzeugt eine Instanz der Klasse RscHrc. Der Scope von dieser Instanz mu� innerhalb
2057des Scopes von pDataBase liegen.
2058
2059Af1Parameter
2060Aga
2061AfppDataBase	Ein Zeiger auf eine Datenbasis.
2062lKey	Ist der Schl�ssel einer Datei.
2063Aga
2064Af1Querverweise
2065Aga
2066Klassen RscError, RscSrc, RscFileTab.
2067
2068Af1Beispiel
2069Aga
2070Ali.....
2071/* aSrc ist ein bestehende Instanz der Klasse RscSrc */
2072//Abhaengigkeitsliste holen
2073RscDependList * pDepLst = aSrc.GetDependList();
2074//Erstes Element holen
2075RscDepend * pDep = pDepList->First();
2076//Hrc-Instanz erzeugen, aHrc ist die Repraesentation der
2077//ersten Datei in der Abhaengigkeitsliste
2078RscHrc	aHrc( pDataBase, pDep->GetFilekey() );
2079.....
2080Aga
2081Aga���������������������������������������������������������
2082Au0RscHrc::~RscHrc()
2083Aga
2084AliRscHrc::~RscHrc();
2085Aga
2086Af1Beschreibung
2087Aga
2088Der Destruktor hat keine Funktion.
2089
2090Aga���������������������������������������������������������
2091Aga
2092Au0RscHrc::ReadFile()
2093Aga
2094AliERRTYPE RscHrc::ReadFile();
2095Aga
2096Af1Beschreibung
2097Aga
2098Es wird eine Datei eingelesen. Es wird in der Abh�ngigkeitsliste �berpr�ft ob alle Dateien geladen
2099sind, sind sie nicht geladen, werden sie zuerst eingelesen. Tritt ein fehler auf, wurde die Fehlerhafte
2100Datei nicht eingelesen. Der Fehler innerhalb der Datei mu� mit einem Editor verbessert werden (siehe
2101Rsc-Compiler Benutzerhandbuch).
2102
2103Af1Return-Werte
2104Aga
2105AfpERRTYPE.IsOk()	Es ist kein Fehler aufgetreten.
2106AfpERR_OPENFILE	Die Datei konnte nicht g�ffnet werden.
2107anderer Wert	Siehe Klasse RscError.
2108Aga
2109Af1Anmerkungen
2110Aga
2111Es sollte sichergestellt sein, da� die Datei mit dem Rsc-Compiler ohne Preprozessor �bersetzt werden
2112kann. Es k�nnen aber trotzdem Fehler auftreten wie zum Beispiel Identifierkonflikte mit vorher
2113eingelesener Datei, oder die Include-Dateien wurden vorher nicht eingelesen (#define kann nicht
2114aufgel�st werden).
2115
2116Af1Querverweise
2117Aga
2118Klassen: RscError, RscCompiler.
2119
2120Aga���������������������������������������������������������
2121
2122Au0RscHrc::GetFileKey()
2123Aga
2124AliULONG RscHrc::GetFileKey();
2125Aga
2126Af1Return-Werte
2127Aga
2128Liefert den Schl�ssel der Datei zur�ck.
2129Aga
2130Aga���������������������������������������������������������
2131Aga
2132Au0RscHrc::SetDirty()
2133Aga
2134Alivoid RscHrc::SetDirty( BOOL bSet );
2135Aga
2136Af1Beschreibung
2137Aga
2138Es wird das Attribut Dirty gesetzt. Das Attribut Dirty bewirkt nichts.
2139
2140Af1Parameter
2141Aga
2142AfpbSet	Ist der Wert auf den das Attribut gesetzt werden soll.
2143Aga
2144Af1Querverweise
2145Aga
2146Methoden: IsDirty().
2147
2148Aga���������������������������������������������������������
2149Aga
2150Au0RscHrc::IsDirty()
2151Aga
2152AliBOOL RscHrc::IsDirty();
2153Aga
2154Af1Beschreibung
2155Aga
2156Gibt an ob das Attribut Dirty gesetzt ist.
2157
2158Af1Return-Werte
2159Aga
2160AfpTRUE	Dirty ist gesetzt.
2161FALSE	Dirty ist nicht gesetzt.
2162Aga
2163Aga���������������������������������������������������������
2164Au0RscHrc::SetPathName()
2165Aga
2166Alivoid RscHrc::SetPathName( const String & rPath );
2167Aga
2168Af1Beschreibung
2169Aga
2170Der Pfadname der Datei, die durch diese Instanz repr�sentiert wird, wird ge�ndert. Der Pfadname ist
2171der Name, unter dem die Datei gespeichert wird.
2172
2173Af1Parameter
2174Aga
2175AfprPath	Der Pfadname der Datei.
2176Aga
2177Af1Querverweise
2178Aga
2179Klassen:  RscFile.
2180Methoden: GetPathname(), SetFileName(), GetFileName()
2181
2182Aga���������������������������������������������������������
2183Aga
2184Au0RscHrc::GetPathName()
2185Aga
2186AliString RscHrc::GetPathName();
2187Aga
2188Af1Return-Werte
2189Aga
2190Der Pfadname der Datei wird zur�ckgeliefert.
2191Aga
2192Af1Querverweise
2193Aga
2194Klassen:  RscFile.
2195Methoden: SetPathName(), SetFileName(), GetFileName().
2196
2197Aga���������������������������������������������������������
2198Aga
2199Au0RscHrc::SetFileName()
2200Aga
2201Alivoid RscHrc::SetFileName( const String & rPath );
2202Aga
2203Af1Beschreibung
2204Aga
2205Der Name der Datei, die durch diese Instanz repr�sentiert wird, wird ge�ndert. Unter diesem Namen
2206wird die Datei zum Beispiel in den "#include <Name>" Anweisungen verwendet.
2207
2208Af1Parameter
2209Aga
2210AfprPath	Der Name der Datei.
2211Aga
2212Af1Querverweise
2213Aga
2214Klassen:  RscFile.
2215Methoden: SetPathName(), GetPathname(), GetFileName()
2216
2217Aga���������������������������������������������������������
2218Aga
2219Au0RscHrc::GetFileName()
2220Aga
2221AliString RscHrc::GetFileName();
2222Aga
2223Af1Return-Werte
2224Aga
2225Der Name der Datei wird zur�ckgeliefert.
2226Aga
2227Af1Querverweise
2228Aga
2229Klassen:  RscFile.
2230Methoden: SetPathName(), GetPathName(), SetFileName().
2231
2232Aga���������������������������������������������������������
2233Aga
2234Aga
2235Au0RscHrc::InsertDepend()
2236Aga
2237Alivoid RscHrc::InsertDepend( ULONG lFileKey, ULONG lPos );
2238Aga
2239Af1Beschreibung
2240Aga
2241Eine neue Include-Datei wird in die Abh�ngigkeitsliste eingef�gt.
2242
2243Af1Parameter
2244Aga
2245AfplFileKey	Dies ist der Schl�ssel der Include-Datei.
2246lPos	An dieser Position wird der Schl�ssel in die Abh�ngigkeitsliste
2247"eingef�gt.
2248Aga
2249Af1Return-Werte
2250Aga
2251Es wird der Schl�ssel der Datei zur�ckgeliefert.
2252
2253Af1Anmerkungen
2254Aga
2255Wenn eine Include-Datei unter diesem Schl�ssel schon in der Abh�ngigkeitsliste steht, wird er nicht
2256noch einmal eingetragen.
2257
2258Af1Querverweise
2259Aga
2260Klassen:  RscFile.
2261Methoden: FillIncList().
2262
2263Aga���������������������������������������������������������
2264Aga
2265Au0RscHrc::GetDefineList()
2266Aga
2267AliRscDefineList * RscHrc::GetDefineList();
2268Aga
2269Af1Beschreibung
2270Aga
2271In jeder Hrc-Datei gibt es Makros. Diese Makros werden in eine RscDefineList gestellt.
2272
2273Af1Return-Werte
2274Aga
2275Es wird ein Zeiger auf die Makro-Liste zur�ckgeliefert.
2276
2277Af1Querverweise
2278Aga
2279Klassen:  RscDefineList.
2280
2281Aga���������������������������������������������������������
2282Aga
2283Au0RscHrc::FindDef()
2284Aga
2285AliRscDefine * RscHrc::FindDef( const String & rName );
2286Aga
2287Beschreibung
2288Aga
2289Mit dieser Methode kann ein Makro �ber seinen Namen gefunden werden. Es wird nur in dieser Datei
2290oder in den Dateien gesucht, von denen diese Datei abh�ngt.
2291
2292Af1Parameter
2293Aga
2294AfprName	ist der Name des Makros.
2295Aga
2296Af1Return-Werte
2297Aga
2298Es wird ein Zeiger auf das Makro mit Namen rName zur�ckgegeben.
2299AfpNULL	Es wurde kein Makro gefunden.
2300Aga
2301Af1Querverweise
2302Aga
2303Klassen: RscFileTab.
2304
2305Af1Beispiel
2306Aga
2307Ali//Dateiname = t.src
2308...
2309#include <t1.hrc>
2310#include <t2.hrc>
2311
2312#define TEST 1
2313Aga
2314Wenn aHrc2 die Datei t2.hrc repr�sentiert, dann werden die Makros in t2.hrc und t1.hrc gesucht. Sie
2315werden nicht in t.src gesucht.
2316
2317Aga���������������������������������������������������������
2318Aga
2319Au0RscHrc::NewDef()
2320Aga
2321AliERRTYPE RscHrc::NewDef( const String & rName,
2322                        long lValue, ULONG lPos );
2323ERRTYPE RscHrc::NewDef( const String & rName,
2324                        const String & rMacro,
2325                        ULONG lPos );
2326Aga
2327Af1Beschreibung
2328Aga
2329Mit dieser Methode k�nnen neue Makros angelegt werden. Die Makros werden der Datei zugeordnet,
2330die durch diese Instanz repr�sentiert wird.
2331
2332Af1Parameter
2333Aga
2334AfprName	Ist der Name des neuen Makros.
2335lValue	Ist der Wert des neuen Makros.
2336rMacro	Ist ein String der ausgewertet wird.
2337lPos	gibt die Position an, an welcher das Makro eingef�gt werden soll.
2338Aga
2339Af1Return-Werte
2340Aga
2341In ERRTYPE steht, ob ein Fehler aufgetreten ist und um welchen es sich handelt.
2342
2343Af1Anmerkungen
2344Aga
2345Durch rMacro k�nnen Makros auch wieder durch Makros erkl�rt werden. Es wird sichergestellt, da�
2346nur Makros verwendet werden, die vorher deklariert wurden. Ob sie vorher deklariert wurden, wird
2347anhand der Abh�ngigkeitslisten entschieden.
2348
2349Af1Querverweise
2350Aga
2351Klassen:  RscFileTab.
2352Methoden: ::MacroParser().
2353
2354Af1Beispiel
2355Aga
2356Ali//Datei demo.hrc in Projektverwaltung
2357lFileKey = pBase->AddHrcFile( "demo.hrc" );
2358//Sicht auf demo.hrc
2359RscHrc	aHrc( pBase, lFileKey );
2360//Makro erzeugen
2361aHrc.NewDef( String( "BASE" ), 1000 );
2362//Makro erzeugen
2363aHrc.NewDef( String( "DEF_TEST" ), String( "1000 + 2" ) );
2364//Makro erzeugen
2365aHrc.NewDef( String( "MENU_FILE" ),String( "BASE + 100" ));
2366Aga
2367Aga���������������������������������������������������������
2368Aga
2369Au0RscHrc::ChangeDef()
2370Aga
2371AliERRTYPE RscHrc::ChangeDef( const String & rName,
2372                           const String & rMacro );
2373ERRTYPE RscHrc::ChangeDef( const String & rName,
2374                           long lValue );
2375Aga
2376Af1Beschreibung
2377Aga
2378Mit dieser Methode k�nnen Makros ge�ndert werden.
2379
2380Af1Parameter
2381Aga
2382AfprName	Ist der Name des neuen Makros.
2383rMacro	Ist ein String der ausgewertet wird.
2384lValue	Ist der Wert des ge�nderten Makros.
2385Aga
2386Af1Return-Werte
2387Aga
2388In ERRTYPE steht, ob ein Fehler aufgetreten ist und um welchen es sich handelt.
2389
2390Af1Anmerkungen
2391Aga
2392Durch rMacro k�nnen Makros auch wieder durch Makros erkl�rt werden. Es wird sichergestellt, da�
2393nur Makros verwendet werden, die vorher deklariert wurden. Ob sie vorher deklariert wurden, wird
2394anhand der Abh�ngigkeitslisten entschieden.
2395
2396Af1Querverweise
2397Aga
2398Klassen:  RscFileTab.
2399Methoden: ::MacroParser(), NewDef().
2400
2401Af1Beispiel
2402Aga
2403Ali//Datei demo.hrc in Projektverwaltung
2404lFileKey = pBase->AddHrcFile( "demo.hrc" );
2405//Sicht auf demo.hrc
2406RscHrc	aHrc( pBase, lFileKey );
2407//Makro erzeugen
2408aHrc.NewDef( String( "BASE" ), 1000 );
2409//Makro erzeugen
2410aHrc.NewDef( String( "DEF_TEST" ), String( "1000 + 2" ) );
2411//Makro aendern
2412aHrc.ChangeDef( String( "DEF_TEST" ),
2413                String( "BASE + 100" ) );
2414Aga
2415Aga���������������������������������������������������������
2416Aga
2417Au0RscHrc::IsDefUsed()
2418Aga
2419AliBOOL RscHrc::IsDefUsed( const String & rName );
2420Aga
2421Af1Beschreibung
2422Aga
2423Mit dieser Methode kann festgestellt werden ob ein Makro noch ben�tigt wird. Es wird ben�tigt, wenn
2424Referenzen bestehen, z.B. das Makro wird zur Definition von anderen Makros verwendet.
2425
2426Af1Parameter
2427Aga
2428AfprName	Ist der Name des Makros.
2429Aga
2430Af1Return-Werte
2431Aga
2432AfpTRUE	Das Makro wird noch ben�tigt.
2433FALSE	Das Makro wird nicht mehr ben�tigt.
2434Aga
2435Af1Querverweise
2436Aga
2437Klassen: RscFileTab.
2438
2439Aga���������������������������������������������������������
2440
2441Au0RscHrc::DeleteDef()
2442Aga
2443Alivoid RscHrc::DeleteDef( const String & rName );
2444Aga
2445Af1Beschreibung
2446Aga
2447Das Makro mit dem Namen rName wird gel�scht.
2448
2449Af1Parameter
2450Aga
2451AfprName	Ist der Name des Makros.
2452Aga
2453Af1Querverweise
2454Aga
2455Klassen: RscFileTab.
2456
2457Aga��������������������������������������������������������
2458Aga
2459Au0RscHrc::ChangeDefName()
2460Aga
2461AliERRTYPE RscHrc::ChangeDefName( const String & rName,
2462                               const String & rNewName );
2463Aga
2464Af1Beschreibung
2465Aga
2466Der Name des Makros wird umbenannt. Existiert der neue Name schon, oder ist der neue Name ein
2467reserviertes Wort, wird ein Fehler zur�ckgeliefert.
2468
2469Af1Parameter
2470Aga
2471AfprName	Der Name des Makros.
2472rNewName	Der neue Name des Makros.
2473Aga
2474Af1Return-Werte
2475Aga
2476In ERRTYPE steht, ob ein Fehler aufgetreten ist und um welchen es sich handelt.
2477
2478Af1Anmerkungen
2479Aga
2480Alle Objekte oder Makros, die das umbenannte Makro benutzen, enthalten den neuen Namen.
2481
2482Af1Querverweise
2483Aga
2484Klassen: RscFileTab.
2485
2486Aga���������������������������������������������������������
2487
2488Au0RscHrc::GetFileStruct()
2489Aga
2490AliRscFile * RscHrc::GetFileStruct();
2491Aga
2492Af1Return-Werte
2493Aga
2494Liefert einen Zeiger auf die interne Datenstruktur..
2495
2496Af1Querverweise
2497Aga
2498Klassen:  RscFile, RscFileTab.
2499Aga
2500Aga���������������������������������������������������������
2501
2502Au0RscHrc::GetDependList()
2503Aga
2504AliRscDependList * RscHrc::GetDependList();
2505Aga
2506Af1Beschreibung
2507Aga
2508Mit dieser Methode bekommt man die Abh�ngigkeitsliste der Datei.
2509
2510Af1Return-Werte
2511Aga
2512Die Methode liefert einen Zeiger auf die Abh�ngigkeitsliste zur�ck.
2513Aga
2514Af1Anmerkungen
2515Aga
2516Die Datei ist selbst als letztes Element in der Liste vermerkt.
2517
2518Af1Querverweise
2519Aga
2520Klassen: RscFile, RscFileTab.
2521
2522Aga���������������������������������������������������������
2523Aga
2524Au0RscHrc::WriteFile()
2525Aga
2526AliERRTYPE RscHrc::WriteFile();
2527Aga
2528Af1Beschreibung
2529Aga
2530Diese Methode schreibt eine Datei im src-Format. Alle Resourceinstanzen die zu dieser Datei geh�ren
2531werden geschrieben. Es werden auch alle zugeh�rigen Makros geschrieben. Ein Datei ohne
2532Resourceinstanzen ist eine hrc-Datei. Der Name unter dem die Datei geschrieben wird ist der
2533Pfadname.
2534
2535Aga
2536Af1Return-Werte
2537Aga
2538AfpERRTYPE.IsOk()	Die Daten wurden in die entsprechende Datei geschrieben.
2539Afpanderer Wert	Es ist ein Fehler aufgetreten. Die angegebene Datei wurde
2540"eventuell unvollst�ndig geschrieben.
2541Aga
2542Af1Querverweise
2543Aga
2544Klassen:  RscTypCont.
2545Methoden: RscTypCont::WriteSrc(), RscDefineList::WriteAll(), SetPathName().
2546
2547Aga���������������������������������������������������������
2548Au0PARscSrc
2549Aga
2550Aliclass RscSrc {
2551public:
2552            RscSrc( RscDataBase * pDataBase, ULONG lKey );
2553            ~RscSrc();
2554    RscInstCopy CreateRscInst( RscTop * pClass );
2555    ERRTYPE DeleteRscInst( RscTop * pTypeClass,
2556                           RscId & rName );
2557    ERRTYPE SetRscInst( RscId & rInstName, RscInstCopy & );
2558    RscInst GetRscInst( RscTop * pClass, RscId & rInst );
2559    void    FillNameIdList( REResourceList * pList );
2560    ERRTYPE WriteCxxFile( const String &,
2561                          const String & rHxxFile );
2562    ERRTYPE WriteHxxFile( const String & );
2563};
2564Aga
2565Af1Beschreibung
2566Aga
2567Diese Klasse l�st folgende Aufgaben:
2568	1. Das Einlesen der Include-Dateien und der ".src"-Datei mit Erstellung der Datenbasis.
2569	2. Das Erzeugen von Resourceinstanzen.
2570	3. Das Finden und Herausgeben von Resourceinstanzen.
2571	4. Das Einsetzen von Resourceinstanzen.
2572	5. Das Schreiben von ".cxx"- und ".hxx"-Dateien.
2573
2574Af1Anmerkungen
2575Aga
2576Die von einer Instanz dieser Klasse herausgegebenen Resourceinstanzen sind von der Verwendeten
2577Datenbasis abh�ngig, das hei�t bevor die Datenbasis gel�scht wird, m�ssen alle Resourceinstanzen
2578gel�scht oder wieder eingesetzt worden sein.
2579
2580Af1Querverweise
2581Aga
2582Klassen:  RscTypCont, RscError, RscId, RscDataBase.
2583Methoden: HashId, GetHashString.
2584
2585Af1Beispiel
2586Aga
2587Auszug aus der test.src Datei.
2588Ali.....
2589Color 1000 {
2590	Red   = 0;     //kein Rotanteil
2591	Green = 65535;
2592	Blue  = 65535;
2593};
2594.....
2595
2596AgaAuszug aus der ".cxx" Datei.
2597Ali.....
2598// Compilers initialisieren
2599InitRscCompiler();
2600.....
2601RscError	aErrorHandle;              // Fehlerbehandlung
2602RscdataBase aBase( aErrorHandle );  // Datenbasis erzeugen
2603//src-Datei
2604RscSrc	aSrc( &aBase,
2605              aBase->AddSrcFile( "test.src" ) );
2606RscInst	aInst;                      // eine ResourceInstanz
2607RscTop*	pClassTyp;                  // ein Klassentyp
2608
2609// Einlesen der Resourcedatei test.src
2610aSrc.ReadFile();
2611// Typ einer Resource aus dem Namen erzeugen
2612pClassTyp = aBase.GetClassType( HashId( "Color" ) );
2613// Instanz holen
2614aInst = aSrc.GetRscInst( pClassTyp, RscId( 1000 ) );
2615// Instanz ver�ndern
2616aInst.SetNumber( HashId( "Red" ), 65535 );
2617// Da es sich bei aInst nur um eine Referenz in die
2618// Datenbasis handelt, werden die Aenderungen sofort
2619// uebernommen.
2620
2621// Ver�nderte test.src Datei schreiben
2622aSrc.WriteFile();
2623.....
2624
2625AgaAuszug aus der ver�nderten test.src Datei.
2626Alle Kommentare werden gel�scht. Bei Preprozessoranweisungen wie #include oder #define kommt
2627es zu Reihenfolge�nderungen.
2628
2629Ali.....
2630Color 1000 {
2631	Red   = 65535;
2632	Green = 65535;
2633	Blue  = 65535;
2634};
2635.....
2636Aga
2637
2638Au0PARscSrc::RscSrc()
2639Aga
2640AliRscSrc::RscSrc( RscDataBase * pDataBase,
2641                ULONG lFileKey );
2642Aga
2643Af1Beschreibung
2644Aga
2645Diese Methode erzeugt eine Instanz der Klasse RscSrc. Der Scope von dieser Instanz mu� innerhalb
2646des Scopes von pDataBase liegen.
2647
2648Af1Parameter
2649Aga
2650AfppDataBase	Ein Zeiger auf eine Datenbasis.
2651lFileKey	Der Schl�ssel einer Datei.
2652Aga
2653Af1Querverweise
2654Aga
2655Klasse: RscError
2656
2657Af1Beispiel
2658Aga
2659Ali.....
2660RscDataBase	aDataBase(...);
2661RscSrc	aCmpInst( &aDataBase,
2662                  aDataBase.AddSrcFile( "t.src" ) );
2663.....
2664Aga
2665Aga���������������������������������������������������������
2666Aga
2667Au0RscSrc::RscSrc()
2668Aga
2669AliRscSrc::~RscSrc();
2670Aga
2671Af1Beschreibung
2672Aga
2673Diese Methode hat keine Funktion.
2674
2675Aga���������������������������������������������������������
2676Aga
2677Au0RscSrc::CreateRscInst()
2678Aga
2679AliRscInstCopy RscSrc::CreateRscInst( RscTop * pClass );
2680Aga
2681Af1Beschreibung
2682Aga
2683Diese Methode erzeugt eine Instanz vom Typ pClass.
2684
2685Af1Parameter
2686Aga
2687AfppClass	ist der Typ der Resource, die erzeugt werden soll.
2688Aga
2689Af1Return-Werte
2690Aga
2691Es wird eine RscInstCopy Instanz zur�ckgeliefert.
2692
2693Af1Anmerkungen
2694Aga
2695Ist der Typ der Klasse nicht bekannt, dann wird eine ung�ltige RscInstCopy zur�ckgeliefert.
2696
2697Af1Querverweise
2698Aga
2699Klasse:   RscInst, RscInstCopy.
2700Methoden: RscInst::IsInst(), RscDataBase::GetClassType().
2701
2702Af1Beispiel
2703Aga
2704Ali.....
2705RscInstCopy  aColInst;
2706RscTop * pColorType =
2707    aBase.GetClassType( HashId( "Color" ) );
2708
2709// Resourceinstanz einer Farbe erzeugen
2710aColInst = aCmpInst.CreateRscInst( pColorType );
2711if( !aColInst.IsInst() )
2712    printf( "Farbinstanz konnte nicht erzeugt werden!" );
2713.....
2714Aga
2715Aga���������������������������������������������������������
2716
2717Au0RscSrc::DeleteRscInst()
2718Aga
2719AliERRTYPE RscSrc::DeleteRscInst( RscTop * pClass,
2720                               RscId & rInstName );
2721Aga
2722Af1Beschreibung
2723Aga
2724Diese Methode l�scht Resourceinstanz mit dem Namen rInstName aus der Datenbasis.
2725
2726Af1Parameter
2727Aga
2728AfppClass	ist der Typ der Resourceinstanz.
2729rInstName	ist der Identifier der Resourceinstanz, die gel�scht werden soll.
2730Aga
2731Af1Return-Werte
2732Aga
2733Zeigt an ob ein Fehler und welcher Fehler aufgetreten ist.
2734Aga
2735Af1Querverweise
2736Aga
2737Klasse: RscId, RscError.
2738
2739Aga
2740Aga���������������������������������������������������������
2741Aga
2742Au0RscSrc::SetRscInst()
2743Aga
2744AliERRTYPE RscSrc::SetRscInst( RscId & rInstName,
2745                            RscInstCopy & rInst );
2746Aga
2747Af1Beschreibung
2748Aga
2749Diese Methode setzt die Daten einer Instanz unter dem Namen rInstName in die Datenbasis ein. Ist
2750eine andere Instanz unter diesem Namen gespeichert, wird sie gel�scht.
2751
2752Af1Parameter
2753Aga
2754AfprInstName	Identifier der Instanz.
2755AfprInst	Die Daten aus dieser Instanz werden in die Datenbasis eingesetzt.
2756Aga
2757Af1Return-Werte
2758Aga
2759AfpERRTYPE.IsOk()	die Instanz wurde eingesetzt.
2760anderer Wert	Es ist ein Fehler aufgetreten.
2761Aga
2762Af1Anmerkungen
2763Aga
2764Die Identifikation einer Instanz erfolgt �ber den Typ und den Namen. Wird ein Fehler zur�ckgegeben,
2765dann wurde die Instanz nicht eingesetzt.
2766
2767Af1Querverweise
2768Aga
2769Klassen: RscInstCopy, RscId.
2770Methode: RscDataBase::DeleteRscInst(), GetRscInst().
2771
2772Af1Beispiel
2773Aga
2774Ali.....
2775RscId   aWindowName;// Identifier eines Fensters
2776RscInst aWindow;    // Instanz eines Fensters
2777.....
2778//Instanz einsetzen und die Alte l�schen, falls vorhanden
2779aCmpInst.SetRscInst( aWindowName, aWindow );
2780Aga
2781Aga���������������������������������������������������������
2782Aga
2783Au0RscSrc::GetRscInst()
2784Aga
2785AliRscInst RscSrc::GetRscInst( RscTop * pClass,
2786                            RscId & rInstName );
2787Aga
2788Af1Beschreibung
2789Aga
2790Diese Methode holt eine RscInst Instanz aus der Datenbasis.
2791
2792Af1Parameter
2793Aga
2794AfppClass	der Typ der Instanz.
2795AfprInstName	der Identifier der Instanz.
2796Aga
2797Af1Return-Werte
2798Aga
2799Es wird eine RscInst Intanz zur�ckgeliefert.
2800
2801Af1Anmerkungen
2802Aga
2803Wenn unter dem Typ und Namen keine Instanz zu finden ist, dann ist die zur�ckgelieferte Instanz
2804ung�ltig.
2805
2806Af1Querverweise
2807Aga
2808Klassen: RscInst, RscId.
2809
2810Af1Beispiel
2811Aga
2812AliRscId    aWindowName;// Identifier eines Fensters
2813RscInst  aWindow;    // Instanz eines Fensters
2814RscTop * pClassType;
2815.....
2816// Klassentyp holen
2817pClassType = aBase.GetClassType( HashId( "Window" ) );
2818// Instanz holen
2819aWindow = aCmpInst.GetRscInst( aWindowName, pClassType ) );
2820// Instanz gefunden
2821if( aWindow.IsInst() )
2822    printf( "Instanz gefunden!" );
2823....
2824Aga
2825Aga���������������������������������������������������������
2826Aga
2827Au0RscSrc::FillNameIdList()
2828Aga
2829Alivoid RscSrc::FillNameIdList( REResourceList * pList );
2830Aga
2831Af1Beschreibung
2832Aga
2833F�llt eine Liste mit den Namen und Typen von Resourceinstanzen, die in der Datenbasis stehen.
2834
2835Af1Parameter
2836Aga
2837AfppList	Dies ist die Liste, die gef�llt wird.
2838Aga
2839Af1Anmerkungen
2840Aga
2841pList ist eine Liste von Listen. Resourceinstanzen k�nnen beliebige weitere Resourceinstanzen
2842beinhalten. Die Liste spiegelt diese Verschachtelung wieder.
2843
2844Af1Querverweise
2845Aga
2846Klasse: REResourceList.
2847
2848Af1Beispiel
2849Aga
2850Ali// Resourcedatei
2851Window 1000 {
2852    .....
2853    PushButton 1 { ..... };
2854    String     1 { ..... };
2855    String     2 { ..... };
2856};
2857AliWindow 1001 { ..... };
2858WorkWindow 1000 {
2859    .....
2860    String    1 { ..... };
2861};
2862AgaEine von diesen Resourcen erzeugte Liste h�tte folgende Struktur:
2863Window 1000
2864	PushButton 1
2865	String 1
2866	String 2
2867Window 1001
2868WorkWindow 1000
2869	String 1
2870Aga���������������������������������������������������������
2871
2872Au0RscSrc::Write...File()
2873Aga
2874AliERRTYPE RscSrc::WriteCxxFile( const String & rFileName
2875                              const String & rHxxName );
2876ERRTYPE RscSrc::WriteHxxFile( const String & rFileName );
2877Aga
2878Af1Beschreibung
2879Aga
2880Diese Methoden schreiben ein entsprechendes Format, der in der Datenbasis stehenden
2881Resourceinstanzen, in die Dateien. WriteHxxFile schreibt die Include-Datei f�r die ".cxx"-Dateien.
2882
2883Af1Parameter
2884Aga
2885AfprFileName	Dies ist der Name der Datei in die das entsprechende Format
2886"geschrieben werden soll.
2887rHxxName	Dies ist der Name "hxx"-Datei, die von der "cxx"-Datei eingef�gt
2888"wird.
2889Aga
2890Af1Return-Werte
2891Aga
2892AfpERRTYPE.IsOk()	Das Format wurde in die entsprechende Datei geschrieben.
2893Afpanderer Wert	Es ist ein Fehler aufgetreten. Die angegebene Datei wurde
2894"eventuell unvollst�ndig geschrieben.
2895Aga
2896Aga���������������������������������������������������������
2897Au0PARscInst
2898Aga
2899Aliclass RscInst {
2900public:
2901    RSCINST   aInst;
2902              RscInst();
2903              RscInst( const RscInst & rInst );
2904              RscInst( RSCINST aTmpI );
2905    RscInst&  operator =  ( const RscInst& rRscInst );
2906              ~RscInst();
2907    void      OverWrite( RscInstCopy & rInst );
2908    BOOL      IsInst();
2909              // Listen Methoden
2910    ERRTYPE   SetElement( const RscId & rName,
2911                          RscInstCopy & rInst );
2912    ERRTYPE   SetPosEle( USHORT nPos,
2913                         RscInstCopy & rInst );
2914    ERRTYPE   SetPosRscId( USHORT nPos, const RscId & rId);
2915    SUBINFO_STRUCT  GetInfoEle( USHORT nPos );
2916    USHORT    GetCount();
2917    RscInst   GetElement( RscTop * pClass,
2918                          const RscId & rName );
2919    RscInst   GetPosEle( USHORT nPos );
2920    ERRTYPE   MovePosEle( USHORT nDestPos,
2921                          USHORT nSourcePos );
2922    ERRTYPE   DeleteElement( RscTop * pClass,
2923                             RscId & rName );
2924    ERRTYPE   DeletePosEle( USHORT nPos );
2925    ERRTYPE   SetVar( HASHID nVarName,
2926                      RscInstCopy & rInst );
2927    ERRTYPE   SetConst( HASHID nConstId );
2928    ERRTYPE   SetBool( BOOL bSet );
2929    ERRTYPE   SetNumber( long lValue );
2930    ERRTYPE   SetString( const char * pStr );
2931    ERRTYPE   SetRef( const RscId & rRscId );
2932    ERRTYPE   SetDefault( HASHID nVarName );
2933
2934    RscInst&  GetVar( HASHID nVarName );
2935    HASHID    GetConst();
2936    USHORT    GetConstPos();
2937    BOOL      GetBool();
2938    long      GetNumber();
2939    const char * GetString();
2940    RscId     GetRef();
2941    BOOL      IsDefault( HASHID nVarName );
2942    BOOL      IsConsistent( RscInconsList * pList );
2943
2944    HASHID    GetClassEnum( USHORT nPos );
2945    RscTop *  GetClassType();
2946    HASHID    GetClassName();
2947    ERRTYPE   WriteRc( RscWriteRc & aMem );
2948};
2949Aga
2950Af1Beschreibung
2951Aga
2952Diese Klasse stellt Methoden zur Verf�gung, mit denen Resourceinstanzen erzeugt, ver�ndern und
2953gel�scht werden k�nnen. Das Erzeugen von Instanzen erfolgt immer impliziet. Das hei�t beim
2954Anfordern einer Instanz wird sie erzeugt, wenn sie nicht vorhanden war.
2955
2956Af1Ausnahmen
2957Aga
2958Eine Ausname bildet die Methode GetPosEle, wenn an der angegebenen Stelle keine Instanz steht, so
2959wird eine ung�ltige Instanz zur�ckgeliefert.
2960
2961Af1Anmerkungen
2962Aga
2963Die Implementation ist nicht auf Geschwindigkeit und Speicherbedarf optimiert.
2964
2965Af1Querverweise
2966Aga
2967Klassen: RscDataBase, RscHrc, RscSrc, RSCINST, RscTop, RscId.
2968
2969Af1Beispiel
2970AgaDas Beispiel zeigt, wie der Wert einer Variablen ge�ndert wird
2971Ali.....
2972RscInst  aWindow;
2973RscInst  aBorder;
2974RscTop*  pWindowType;
2975
2976// Typ des Klasse Window
2977pWindowType = aDataBase.GetClassType( HashId( "Window" ) );
2978// Exemplar der Klasse Window erzeugen
2979aWindow = aCompilerInst.CreateRscInst( pWindowType );
2980// Exemplar mit Namen "Border" holen
2981aBorder = aWindow.GetVar( HashId( "Border" ) );
2982// Wert auf TRUE setzen
2983aBorder.SetBool( TRUE );
2984.....
2985Aga
2986Au0PARscInst::RscInst()
2987Aga
2988AliRscInst::RscInst();
2989RscInst::RscInst( const RscInst & rInst );
2990RscInst::RscInst( RSCINST aTmpI );
2991
2992Af1Beschreibung
2993Aga
2994Diese Instanz beinhaltet nur eine Referenz auf die Resourcedaten.
2995
2996Af1Parameter
2997Aga
2998AfprInst	ist die Instanz, aus der die Referenz �bernommen wird.
2999aTmpI	Aus dieser Instanz wird eine RscInst erzeugt.
3000
3001Af1Anmerkungen
3002Aga
3003RscInst hat zwei verschiedene Zust�nde die mit der Methode IsInst() abgefragt werden k�nnen. Liefert
3004IsInst() TRUE zur�ck, dann ist es eine g�ltige Instanz. Anderenfalls ist die Instanz ung�ltig und alle
3005Methoden liefern Fehler oder weitere ung�ltige Instanzen.
3006
3007Af1Querverweise
3008Aga
3009Klassen:  RSCINST, ERRTYPE.
3010Methoden: IsInst(), GetClassType().
3011
3012Aga���������������������������������������������������������
3013Aga
3014Au0RscInst::operator = ()
3015Aga
3016AliRscInst & RscInst::operator = ( const RscInst & rInst );
3017Aga
3018Af1Beschreibung
3019Aga
3020Es werden die Referenzen von rInst �bernommen.
3021
3022Af1Parameter
3023Aga
3024AfprInst	Intanz von dem die Referenzen �bernommen werden.
3025Aga
3026Af1Return-Werte
3027Aga
3028Es wird die eigene Instanz zur�ckgeliefert.
3029Aga
3030Aga���������������������������������������������������������
3031Aga
3032
3033Au0RscInst::~RscInst()
3034Aga
3035AliRscInst::~RscInst();
3036Aga
3037Af1Beschreibung
3038Aga
3039Im Destruktor passiert nichts.
3040
3041Aga���������������������������������������������������������
3042Aga
3043Au0RscInst::OverWrite()
3044Aga
3045Alivoid RscInst::OverWrite( RscInstCopy & rInst );
3046Aga
3047Af1Beschreibung
3048Aga
3049Die Daten in der Instanz werden mit den Daten in rInst �berschrieben.
3050
3051Af1Parameter
3052Aga
3053AfprInst	ist die Instanz, deren Daten eingesetzt werden.
3054Aga
3055Af1Anmerkungen
3056Aga
3057Stimmen die Typen nicht �berein, werden die Daten der gemeinsamen Oberklassen �bernommen. Die
3058anderen Daten werden auf Default gesetzt.
3059
3060Af1Querverweise
3061Aga
3062Klasse:  RscTop.
3063Methode: RscInstCopy::RscInstCopy(), RscTop::Create().
3064
3065Aga���������������������������������������������������������
3066Aga
3067Au0RscInst::IsInst()
3068Aga
3069AliBOOL RscInst::IsInst();
3070Aga
3071Af1Beschreibung
3072Aga
3073Zeigt an ob eine g�ltige Instanz vorligt.
3074
3075Af1Return-Werte
3076Aga
3077AfpTRUE	hei�t, es liegt eine g�ltige Instanz vor.
3078FALSE	hei�t, es liegt keine g�ltige Instanz vor.
3079Aga
3080Af1Querverweise
3081Aga
3082Klasse:  RSCINST
3083Methode: RSCINST::IsInst();
3084
3085Aga���������������������������������������������������������
3086Aga
3087Au0RscInst::SetElement()
3088Aga
3089AliERRTYPE RscInst::SetElement( const RscId & rName,
3090                             RscInstCopy & rInst);
3091Aga
3092Af1Beschreibung
3093Aga
3094Die Methode f�gt eine Resourceinstanz unter dem Namen rName ein.
3095
3096Af1Parameter
3097Aga
3098AfprInst	ist die Instanz die eingef�gt werden soll.
3099AfprName	ist der Identifier unter dem die Instanz eingef�gt wird.
3100Aga
3101Af1Return-Werte
3102Aga
3103AfpERRTYPE.IsOk()	bedeutet, die Instanz wurde Eingef�gt.
3104anderer Wert	bedeutet, da� ein Fehler aufgetreten ist.
3105Aga
3106Af1Anmerkungen
3107Aga
3108Wenn in der Liste unter diesem Namen und Typ schon eine Instanz steht, wird die Instanz gel�scht
3109und die neue Instanz wird an der gleichen Stelle eingef�gt. Wenn rName keine g�ltige Id enth�lt, wird
3110die Instanz am Ende angef�gt.
3111
3112Af1Querverweise
3113Aga
3114Klassen:  ERRTYPE, RscId, RSCINST.
3115Methoden: SetPosEle(), RscId::IsId().
3116
3117Aga���������������������������������������������������������
3118Aga
3119Au0RscInst::SetPosEle()
3120Aga
3121AliERRTYPE RscInst::SetPosEle( USHORT nPos,
3122                            RscInstCopy & rInst );
3123Aga
3124Af1Beschreibung
3125Aga
3126An der Position nPos wird eine Resourceinstanz durch rInst ersetzt.
3127
3128Af1Parameter
3129Aga
3130AfprInst	ist die Instanz die an die Position nPos gesetzt wird.
3131nPos	ist die Position an die die Instanz gesetzt wird.
3132Aga
3133Af1Return-Werte
3134Aga
3135AfpERRTYPE.IsOk()	bedeutet, die Instanz auf nPos wurde ersetzt.
3136andere Wert	bedeutet, die Instanz wurde nicht ersetzt.
3137Aga
3138Af1Anmerkungen
3139Aga
3140Wenn ein Fehler zur�ckgeliefert wird, so hei�t das meistens, da� an der Position nPos keine
3141Reourceinstanz steht.
3142
3143Af1Querverweise
3144Aga
3145Klassen:  ERRTYPE, RSCINST.
3146
3147Aga���������������������������������������������������������
3148Aga
3149Au0RscInst::SetPosRscId()
3150Aga
3151AliERRTYPE RscInst::SetPosRscId( USHORT nPos,
3152                              const RscId & rId );
3153Aga
3154Af1Beschreibung
3155Aga
3156An der Position nPos wird der Identifier durch rId ersetzt.
3157
3158Af1Parameter
3159Aga
3160AfprId	ist die Id die an die Position nPos gesetzt wird.
3161nPos	ist die Position, an die die Id gesetzt wird.
3162Aga
3163Af1Return-Werte
3164Aga
3165AfpERRTYPE.IsOk()	bedeutet, die Id auf nPos wurde ersetzt.
3166andere Wert	bedeutet, die Id wurde nicht ersetzt.
3167Aga
3168Af1Anmerkungen
3169Aga
3170Wenn ein Fehler zur�ckgeliefert wird, so hei�t das meistens, da� an der Position nPos keine
3171Reourceinstanz steht.
3172
3173Af1Querverweise
3174Aga
3175Klassen:  ERRTYPE, RSCINST.
3176
3177Aga���������������������������������������������������������
3178Aga
3179
3180Aga
3181Au0RscInst::GetInfoEle()
3182Aga
3183AliSUBINFO_STRUCT RscInst::GetInfoEle( USHORT nPos );
3184Aga
3185Af1Beschreibung
3186Aga
3187Es wird Information �ber die Resourceinstanz, die auf nPos steht, zur�ckgeliefert.
3188
3189Af1Parameter
3190Aga
3191AfpnPos	ist die Position der Resourceinstanz.
3192Aga
3193Af1Return-Werte
3194Aga
3195Die Information �ber die Resourceinstanz wird zur�ckgeliefert.
3196
3197Af1Anmerkungen
3198Aga
3199Steht an der Stelle nPos keine Resourceinstanz, dann ist der Inhalt undefiniert.
3200
3201Af1Querverweise
3202Aga
3203Klassen: SUBINFO_STRUCT, RSCINST.
3204
3205Aga���������������������������������������������������������
3206
3207Au0RscInst::GetCount()
3208Aga
3209AliUSHORT RscInst::GetCount();
3210Aga
3211Af1Beschreibung
3212Aga
3213Gibt die Anzahl der Resourceinstanzen zur�ck, die in der Liste gespeichert sind.
3214
3215Af1Return-Werte
3216Aga
3217Es wird die Anzahl der Resourceinstanzen zur�ckgeliefert.
3218
3219Af1Querverweise
3220Aga
3221Klasse: RSCINST.
3222
3223Aga���������������������������������������������������������
3224Aga
3225Au0RscInst::GetElement()
3226Aga
3227AliRscInst RscInst::GetElement( RscTop * pClass,
3228                             const RscId & rName );
3229Aga
3230Af1Beschreibung
3231Aga
3232Diese Methode liefert eine Referenz auf die Daten der Instanz zur�ck, die unter diesem Namen in der
3233Liste steht. Wenn unter diesem Namen keine Instanz steht, dann wir sie erzeugt.
3234
3235Af1Parameter
3236Aga
3237AfppClass	ist der Typ der Instanz.
3238rName	ist der Identifier der Instanz.
3239Aga
3240Af1Return-Werte
3241Aga
3242Es wird eine Instanz zur�ckgeliefert.
3243
3244Af1Anmerkungen
3245Aga
3246Besteht in der Liste eine Einschr�nkung auf bestimmte Resourceinstanzen, zum Beispiel nur Instanzen
3247vom Typ Window oder abgeleitete Typen, dann kann es vorkommen, da� eine ung�ltige Instanz
3248zur�ckgeliefert wird.
3249
3250Af1Querverweise
3251Aga
3252Klassen: RscTop, RscId.
3253Methode: IsInst().
3254
3255Aga���������������������������������������������������������
3256Aga
3257Au0RscInst::GetPosEle()
3258Aga
3259AliRscInst RscInst::GetPosEle( USHORT nPos );
3260Aga
3261Af1Beschreibung
3262Aga
3263Es wird eine Referenz auf die Daten der Instanz an der angegebenen Stelle zur�ckgeliefert.
3264
3265Af1Parameter
3266Aga
3267AfpnPos	ist die Position der Resourceinstanz.
3268Aga
3269Af1Return-Werte
3270Aga
3271Es wird eine Resourceinstanz zur�ckgeliefert.
3272
3273Af1Anmerkungen
3274Aga
3275Wenn an der Position keine Instanz steht, dann wird eine ung�ltige Instanz zur�ckgeliefert.
3276
3277Af1Querverweise
3278Aga
3279Klasse:  RscInst.
3280Methode: IsInst().
3281Aga
3282Aga���������������������������������������������������������
3283Aga
3284Au0RscInst::MovePosEle()
3285Aga
3286AliERRTYPE RscInst::MovePosEle( USHORT nDestPos
3287                             USHORT nSourcePos );
3288Aga
3289Af1Beschreibung
3290Aga
3291In einem Feld wird die Resourceinstanz an der Position nSourcePos an die Stelle nDestPos
3292verschoben.
3293
3294Af1Parameter
3295Aga
3296AfpnDestPos	An dieser Position wird die Instanz eingef�gt.
3297nSourcePos	Von dieser Position wird die Instanz genommen.
3298Aga
3299Af1Return-Werte
3300Aga
3301Es wird ein Fehler zur�ckgegeben, wenn nSourcePos oder nDestPos ung�ltige Positionen sind.
3302Aga
3303Aga���������������������������������������������������������
33040�
3305Aga
3306Au0RscInst::DeleteElement()
3307Aga
3308AliERRTYPE RscInst::DeleteElement( RscTop * pClass,
3309                                RscId& rName );
3310Aga
3311Af1Beschreibung
3312Aga
3313In der Liste wird die erste Resourceinstanz mit dem entsprechenden Namen und dem Typ gel�scht.
3314
3315Af1Parameter
3316Aga
3317AfppClass	ist der Typ der Resourceinstanz.
3318rName	ist der Identifier der Resourceinstanz.
3319Aga
3320Af1Return-Werte
3321Aga
3322Gibt es keinen Fehler, dann wurde die Resourceinstanz gel�scht.
3323Aga
3324Af1Querverweise
3325Aga
3326Klassen: RscTop, RscId.
3327
3328Aga���������������������������������������������������������
3329Aga
3330Au0RscInst::DeletePosEle()
3331Aga
3332AliERRTYPE RscInst::DeletePosEle( USHORT nPos );
3333Aga
3334Af1Beschreibung
3335Aga
3336Die Resourceinstanz an der Stelle nPos wird gel�scht.
3337
3338Af1Parameter
3339Aga
3340AfpnPos	ist die Position der Resourceinstanz.
3341Aga
3342Af1Return-Werte
3343Aga
3344Gibt es keinen Fehler, dann wurde die Resourseinstanz gel�scht.
3345Aga
3346Aga���������������������������������������������������������
3347Aga
3348Au0RscInst::SetVar()
3349Aga
3350AliERRTYPE RscInst::SetVar( HASHID nVarName,
3351                         RscInstCopy & rInst );
3352Aga
3353Af1Beschreibung
3354Aga
3355In die Variable mit Namen nVarName wird die Resourceinstanz rInst eingesetzt.
3356
3357Af1Parameter
3358Aga
3359AfpnVarName	ist der Name der Variablen.
3360rInst	ist die Instanz, die eingesetzt wird.
3361Aga
3362Af1Return-Werte
3363Aga
3364AgaGibt es keinen Fehler, wurde die Instanz eingesetzt.
3365Aga
3366Af1Anmerkungen
3367Aga
3368Ein Fehler tritt auf, wenn der Variablentyp und der Instanztyp nicht �bereinstimmen.
3369
3370Af1Querverweise
3371Aga
3372Klasse:  RscTop.
3373Methode: GetVar().
3374
3375Aga���������������������������������������������������������
3376Aga
3377Au0RscInst::SetConst()
3378Aga
3379AliERRTYPE RscInst::SetConst( HASHID nConst );
3380Aga
3381Af1Beschreibung
3382Aga
3383In die Instanz wird die Konstante nConst eingesetzt.
3384
3385Af1Parameter
3386Aga
3387AfpnConst	ist die Konstante, die eingesetzt wird.
3388Aga
3389Af1Return-Werte
3390Aga
3391Gibt es keinen Fehler, wurde die Konstante eingesetzt.
3392Aga
3393Af1Querverweise
3394Aga
3395Klassen:  RscTop.
3396Methoden: GetConst().
3397
3398Af1Beispiel
3399Aga�nderung einer Konstanten.
3400
3401AliRscInstCopy aColorInst;
3402RscInst     aConst;
3403RscTop*     pColorType;
3404.....
3405// Erzeuge Farbinstanz
3406aColorInst = aCmpInst.CreateRscInst( pColorType );
3407//Const-Instanz holen
3408aConst = aColorInst.GetVar( HashId( "Predefined" ) );
3409// Farbe auf blau setzten
3410aConst.SetConst( HashId( "COL_BLUE" ) );
3411// Die gleiche Wirkung haette
3412// aConst.SetNumber( COL_BLUE );
3413// wobei COL_BLUE in sv.hxx definiert ist
3414
3415Aga���������������������������������������������������������
3416Aga
3417Au0RscInst::SetBool()
3418Aga
3419AliERRTYPE RscInst::SetBool( BOOL bVal );
3420Aga
3421Af1Beschreibung
3422Aga
3423In die Instanz wird der Wert bVal eingesetzt.
3424
3425Af1Parameter
3426Aga
3427AfpbVal	ist der Wert, der eingesetzt wird.
3428Aga
3429Af1Return-Werte
3430Aga
3431AgaGibt es keinen Fehler, wurde der Wert eingesetzt.
3432Aga
3433Af1Querverweise
3434Aga
3435Klassen:  RscTop.
3436Methoden: GetBool().
3437
3438Af1Beispiel
3439Aga�ndern eines Wahrheitswertes.
3440
3441AliRscInstCopy aWindowInst;
3442RscInst     aBool;
3443RscTop*     pWindowType;
3444.....
3445// Erzeuge Windowinstanz
3446aWindowInst = aCmpInst.CreateRscInst( pWindowType );
3447aBool = aWindowInst.GetVar( HashId( "Border" ) );
3448// Fensterattribut Rand setzen
3449aBool.SetBool( TRUE );
3450
3451Aga���������������������������������������������������������
3452Aga
3453Au0RscInst::SetNumber()
3454Aga
3455AliERRTYPE RscInst::SetNumber( long lVal );
3456Aga
3457Af1Beschreibung
3458Aga
3459In die Instanz wird der Wert lVal eingesetzt.
3460
3461Af1Parameter
3462Aga
3463AfplVal	ist der Wert, der eingesetzt wird.
3464Aga
3465Af1Return-Werte
3466Aga
3467AgaGibt es keinen Fehler, wurde die Zahl eingesetzt.
3468Aga
3469Af1Querverweise
3470Aga
3471Klassen:  RscTop.
3472Methoden: GetNumber().
3473
3474Af1Beispiel
3475Aga�ndern eines Zahlenwertes.
3476
3477AliRscInstCopy aColorInst;
3478RscInst     aNumber;
3479RscTop*     pColorType;
3480.....
3481// Erzeuge Farbinstanz
3482aColorInst = aCmpInst.CreateRscInst( pColorType );
3483aNumber = aColorInst.GetVar( HashId( "RED" ) );
3484// volle Rotintensit�t
3485aNumber.SetNumber( 0xFFFF );
3486
3487Aga���������������������������������������������������������
3488
3489Au0RscInst::SetString()
3490Aga
3491AliERRTYPE RscInst::SetString( const char * pStr );
3492Aga
3493Af1Beschreibung
3494Aga
3495In die Instanz wird der String pStr eingesetzt.
3496
3497Af1Parameter
3498Aga
3499AfppStr	ist der String, der eingesetzt wird.
3500Aga
3501Af1Return-Werte
3502Aga
3503AgaGibt es keinen Fehler, wurde der String eingesetzt.
3504Aga
3505Af1Querverweise
3506Aga
3507Klassen:  RscTop.
3508Methoden: GetString();
3509
3510Af1Beispiel
3511Aga�ndern einer Zeichenkette.
3512
3513AliRscInstCopy aFontInst;
3514RscInst     aStr;
3515RscTop*     pFontType;
3516.....
3517// Erzeuge Fontinstanz
3518aFontInst = aCmpInst.CreateRscInst( pFontType );
3519aStr = aFontInst.GetVar( HashId( "Text" ) );
3520// Fontnamen setzen
3521aStr.SetString( "Helvetica" );
3522
3523Aga���������������������������������������������������������
3524
3525Au0RscInst::SetRef()
3526Aga
3527AliERRTYPE RscInst::SetRef( const RscId & rRefName );
3528Aga
3529Af1Beschreibung
3530Aga
3531Beim Schreiben der verschiedenen Dateien wird nicht die Resourceinstanz verwendet, sondern eine
3532Resourceinstanz vom selben Typ mit dem Namen rRefName. Diese Instanz wird in der Datenbasis
3533gesucht.
3534
3535Af1Parameter
3536Aga
3537AfprRefName	ist der Identifier der referenzierten Instanz.
3538Aga
3539Af1Return-Werte
3540Aga
3541AgaGibt es keinen Fehler, wurde die Referenz eingesetzt.
3542
3543Af1Anmerkungen
3544Aga
3545Die referenzierte Instanz wird nur in der ersten Ebene der Datenbasis gesucht.
3546Mit SetRef( RscId() ), werden die Referenzen wieder aufgehoben.
3547
3548Af1Querverweise
3549Aga
3550Klassen:  RscTop, RscId.
3551Methoden: GetRef().
3552
3553Af1Beispiel
3554Aga
3555Aga���������������������������������������������������������
3556Aga
3557Au0RscInst::SetDefault()
3558Aga
3559AliERRTYPE RscInst::SetDefault( HASHID nVarName );
3560Aga
3561Af1Beschreibung
3562Aga
3563Die Instanz hinter der Variable nVarName wird auf ihre Defaultwerte gesetzt.
3564
3565Af1Parameter
3566Aga
3567AfpnVarName	ist der Name der Variablen.
3568Aga
3569Af1Return-Werte
3570Aga
3571AgaGibt es keinen Fehler, wurde die Instanz nicht auf Default gesetzt.
3572
3573Af1Querverweise
3574Aga
3575Klassen:  RscTop.
3576Methoden: IsDefault().
3577
3578Af1Beispiel
3579Aga
3580AliRscInst aColorInst;
3581RscTop* pColorType;
3582.....
3583// Hole Farbinstanz
3584aColorInst = aCmpInst.GetRscInst( pColorType,
3585                                  RscId( 1000 ) );
3586// Rot auf Default setzten
3587aColorInst.SetDefault( HashId( "Red" ) );
3588
3589Aga���������������������������������������������������������
3590
3591
3592Au0RscInst::GetVar()
3593Aga
3594AliRscInst RscInst::GetVar( HASHID nVarName );
3595Aga
3596Af1Beschreibung
3597Aga
3598Die Methode liefert eine Kopie des Inhaltes der Variablen nVarName.
3599
3600Af1Parameter
3601Aga
3602AfpnVarName	ist der Name der Variablen.
3603Aga
3604Af1Return-Werte
3605Aga
3606Es wird eine Resourceinstanz zur�ckgeliefert.
3607
3608Af1Anmerkungen
3609Aga
3610Existiert keine Variable unter diesem Namen, dann wird eine ung�ltige Instanz zur�ckgeliefert.
3611
3612Af1Querverweise
3613Aga
3614Klassen:  RscTop.
3615Methoden: SetVar().
3616
3617Aga���������������������������������������������������������
3618
3619Au0RscInst::GetConst()
3620Aga
3621AliHASHID RscInst::GetConst();
3622Aga
3623Af1Beschreibung
3624Aga
3625Die Methode liefert die Instanz als Konstante.
3626
3627Af1Return-Werte
3628Aga
3629Der Wert der Konstanten.
3630Kann die Instanz nicht in eine Konstante umgewandelt werden, wird HASH_NONAME
3631zur�ckgeliefert.
3632
3633Af1Querverweise
3634Aga
3635Klassen:  RscTop.
3636Methoden: SetConst().
3637
3638Aga���������������������������������������������������������
3639
3640Au0RscInst::GetBool()
3641Aga
3642AliBOOL RscInst::GetBool();
3643Aga
3644Af1Beschreibung
3645Aga
3646Die Methode liefert die Instanz als Wahrheitswert.
3647
3648Af1Return-Werte
3649Aga
3650Es wird ein boolscher Wert zur�ckgeliefert.
3651Kann die Instanz nicht in einen Wahrheitswert umgewandelt werden, wird FALSE zur�ckgeliefert.
3652
3653Af1Querverweise
3654Aga
3655Klassen:  RscTop.
3656Methoden: SetBool().
3657
3658Aga���������������������������������������������������������
3659
3660Au0RscInst::GetNumber()
3661Aga
3662Alilong RscInst::GetNumber();
3663Aga
3664Af1Beschreibung
3665Aga
3666Die Methode liefert die Instanz als Zahl.
3667
3668Af1Return-Werte
3669Aga
3670Es wird ein Wert zur�ckgeliefert.
3671Kann die Instanz nicht in ein Zahl umgewandelt werden, wird 0 zur�ckgeliefert.
3672
3673Af1Querverweise
3674Aga
3675Klassen:  RscTop.
3676Methoden: SetNumber().
3677
3678Aga���������������������������������������������������������
3679
3680Au0RscInst::GetString()
3681Aga
3682Aliconst char * RscInst::GetVar();
3683Aga
3684Af1Beschreibung
3685Aga
3686Die Methode liefert die Instanz als String.
3687
3688Af1Return-Werte
3689Aga
3690Es wird ein Zeiger auf eine Zeichenkette zur�ckgeliefert.
3691Kann die Instanz nicht in einen String umgewandelt werden, wird NULL zur�ckgeliefert.
3692
3693Af1Querverweise
3694Aga
3695Klassen:  RscTop.
3696Methoden: SetString().
3697
3698Aga���������������������������������������������������������
3699
3700Au0RscInst::GetRef()
3701Aga
3702AliRscId RscInst::GetRef();
3703Aga
3704Af1Beschreibung
3705Aga
3706Ist in der Instanz eine Referenz eingetragen, wird diese zur�ckgegeben.
3707
3708Af1Return-Werte
3709Aga
3710Es wird der Identifier der Referenz zur�ckgeliefert.
3711
3712Af1Anmerkungen
3713Aga
3714Der zur�ckgelieferte Identifier kann ung�ltig sein. Das ist der Fall, wenn keine Referenz besteht.
3715
3716Af1Querverweise
3717Aga
3718Klassen: RscTop, RscId.
3719Methode: IsId(), SetDefault().
3720
3721Aga���������������������������������������������������������
3722
3723Au0RscInst::IsDefault()
3724Aga
3725AliBOOL RscInst::IsDefault( HASHID nVarName );
3726Aga
3727Af1Beschreibung
3728Aga
3729Stellt fest ob die genannte Variable noch die Defaulteinstellung besitzt.
3730
3731Af1Parameter
3732Aga
3733AfpnVarName	ist der Name der Variablen.
3734Aga
3735Af1Return-Werte
3736Aga
3737AfpTRUE	bedeutet, die Variable hat die Defaulteinstellung.
3738FALSE	bedeutet, sie wurde ver�ndert.
3739Aga
3740Af1Querverweise
3741Aga
3742Methoden: SetDefault().
3743
3744Aga���������������������������������������������������������
3745
3746Au0RscInst::IsConsistent()
3747Aga
3748AliBOOL RscInst::IsConsistent( RscInconsList * pList );
3749Aga
3750Af1Beschreibung
3751Aga
3752Die Methode �berpr�ft ob diese Instanz noch konsistent ist.
3753
3754Af1Parameter
3755Aga
3756AfppList	Eine Liste die mit den RscId-Objekten gef�llt wird, die
3757"Inkonsistenzen hervorrufen. pList darf Null sein.
3758Aga
3759Af1Return-Werte
3760Aga
3761AfpTRUE	bedeutet die Instanz ist konsistent.
3762FALSE	bedeutet die Instanz ist inkonsistent.
3763Aga
3764Af1Anmerkungen
3765Aga
3766Ein RscId-Objekt kann aus Objekten zusammengesetzt sein, die global ver�ndert werden k�nnen.
3767Nach einer solchen Ver�nderung mu� die Konsistenz �berpr�ft werden.
3768
3769Af1Querverweise
3770Aga
3771Klassen:  RscId, RscHrc, RscFileTab.
3772Mehtoden: RscDataBase::MakeConsistent(), RscTop::IsConsistent().
3773
3774Aga���������������������������������������������������������
3775Au0
3776Au0RscInst::GetClassEnum()
3777Aga
3778AliHASHID RscInst::GetClassEnum( USHORT nPos );
3779Aga
3780Af1Beschreibung
3781Aga
3782Diese Methode liefert den Namen der Konstanten zur�ck, die in einem Aufz�hlungstyp an der Position
3783nPos definiert ist.
3784
3785Af1Parameter
3786Aga
3787AfpnPos	Position der Konstante.
3788Aga
3789Af1Return-Werte
3790Aga
3791AfpHASH_NONAME	Dieser Wert wird zur�ckgeliefert, wenn der Variablentyp kein
3792"Aufz�hlungstyp war oder wenn nPos >= der Anzahl der
3793"Konstanten.
3794AgaSonst wird der Name der Konstanten zur�ckgeliefert.
3795Aga
3796Af1Beispiel
3797Aga
3798Das Beispiel zeigt wie die Namen eine Aufz�hlungstypen ermittelt werden k�nnen.
3799AgaVariable ist ein Aufz�hlungstyp mit den Werten COL_WHITE, COL_RED und COL_BLACK. Die
3800Konstanten haben die Name "White", "Red", "Black".
3801Der Variablenname ist "Predefined".
3802Die Klasse, in der diese Variable definiert ist, hei�t "Color".
3803Ali
3804HASHID nConstName;
3805HASHID nVarName;
3806RscInst aColorInst;
3807RscInst aConst;
3808USHORT i;
3809
3810nVarName = HashId( "Predefined" ); //Variablennamen setzen
3811// pCmpEd ist eine Compiler-Instanz
3812aColorInst = pCmpEd->CreateRscInst(
3813               pCmpEd->GetClassType( HashId( "Color" ) ) );
3814 if( aColorInst.IsInst() ){ //Instanz wurde erzeugt
3815	aConst = aColorInst.GetVar( nVarName );
3816	i = 0;
3817	nConstName = aConst.GetClassEnum( i );
3818	while( HASH_NONAME != nConstName ){
3819		printf( "%s\n", GetHashString( nConstName ) );
3820		i++;
3821		nConstName = aConst.GetClassEnum( i );
3822	}
3823}
3824Aga
3825Die Ausgabe ist:
3826White
3827Red
3828Black
3829Aga���������������������������������������������������������
3830
3831Au0RscInst::GetTypeClass()
3832Aga
3833AliRscTop * RscInst::GetTypeClass();
3834Aga
3835Af1Beschreibung
3836Aga
3837Diese Methode liefert den Typ der Instanz zur�ck.
3838
3839Af1Return-Werte
3840Aga
3841Der Typ der Instanz wird zur�ckgeliefert.
3842
3843Aga���������������������������������������������������������
3844
3845Au0RscInst::GetClassName()
3846Aga
3847AliHASHID RscInst::GetClassName();
3848Aga
3849Af1Beschreibung
3850Aga
3851Diese Methode liefert den Namen einer Klasse.
3852
3853Af1Return-Werte
3854Aga
3855AfpHASH_NONAME	Dieser Wert wird zur�ckgeliefert, wenn die Klasse keinen Namen
3856"hat.
3857AgaAnsonsten wird der Name der Klasse zur�ckgeliefert.
3858
3859Af1Beispiel
3860AgaDiese Funktion gibt zu einer Instanz den Klassennamen aus.
3861
3862Alivoid PrintClassName( RscInst & rInst ){
3863// rInst, Instanz deren Klassenname ausgegeben werden soll
3864HASHID nClassName;
3865
3866nClassName = rInst.GetClassName(); // Klassenname holen
3867if( HASH_NONAME == nClassName )
3868	printf( "Kein Klassenname\n" );
3869else
3870	printf( "%s\n", GetHashString( nClassName ) );
3871}
3872Aga
3873Aga���������������������������������������������������������
3874Au0
3875Au0RscInst::WriteRc()
3876Aga
3877AliERRTYPE RscInst::WriteRc( RscWriteRc & aMem );
3878Aga
3879Af1Beschreibung
3880Aga
3881Diese Methode erzeugt eine Resource im StarView Resourceformat. Mit dieser Resource kann der
3882Resourcekonstruktor der entsprechenden Klasse gerufen werden.
3883
3884Af1Parameter
3885Aga
3886AfpaMem	ist die Instanz, die die Resourcedaten enth�lt.
3887Aga
3888Af1Return-Werte
3889Aga
3890AfpERRTYPE.IsOk()	bedeutet, da� in aMem eine korrekte Resource steht.
3891anderer Wert	bedeutet, das Format ist nicht korrekt.
3892Aga
3893Af1Ausnahmen
3894Aga
3895Die System abh�ngigen Resourcen Icon, Bitmap und Pointer werden nicht vollst�ndig geschrieben.
3896Um einen Programmfehler zu vermeiden, m�ssen die StarView-Klassen entsprechend abgesichert sein.
3897
3898Af1Anmerkungen
3899Aga
3900Die Referenzen m�ssen zum Zeitpunkt von WriteRc aufgel�st werden k�nnen. K�nnen sie nicht
3901aufgel�st werden, werden die Daten der Instanz benutzt, in der die Referenz angegeben ist.
3902
3903Af1Querverweise
3904Aga
3905Klassen: RscWriteRc, ERRTYPE.
3906
3907Af1Beispiel
3908Aga
3909AliRscInst aColor;
3910RscTop* pColorType;
3911Color   aSvColor;
3912
3913// Farbinstanz erzeugen
3914aColor = aCmpInst.CreateColor( pColorType );
3915// Farbe auf Gelb setzten
3916AliaColor.SetConst( HashId( "Predefined" ),
3917                 HashId( "COL_YELLOW" ) );
3918
3919RscWriteRc aMem;
3920if( aColor.WriteRc( aMem ).IsOk() ){
3921    aSvColor = Color( RscId( aMem.GetRes() ) );
3922    .....
3923};
3924Aga
3925
3926Aga���������������������������������������������������������
3927Au0PARscInstCopy
3928Aga
3929Aliclass RscInstCopy {
3930public:
3931                RscInstCopy();
3932                RscInstCopy( const RscInstCopy & rInst );
3933                RscInstCopy( const RscInst & rInst );
3934                RscInstCopy( RSCINST aTmpI );
3935                RscInstCopy( RscTop * pNewType,
3936                             const RscInst & rInst );
3937    RscInstCopy& operator = (const RscInstCopy & rRscInst);
3938    RscInstCopy& operator = ( const RscInst & rRscInst );
3939                ~RscInstCopy();
3940};
3941Aga
3942Af1Beschreibung
3943Aga
3944Mit Hilfe dieser Klasse wird eine Kopie einer Resourceinstanz angefertigt. Die Kopie enth�lt keine
3945Referenz in die Datenbasis. Es kann somit auch nicht zu einem Fehler kommen, wenn eine
3946Resourceinstanz in der Datenbasis gel�scht wird. Solch ein Fehler kann bei einer Instanz der Klasse
3947RscInst auftreten.
3948
3949Af1Anmerkung
3950Aga
3951Alle Makros die in der Datenbasis ge�ndert werden, �ndern sich auch in dieser Instanz. Mit der
3952Methode IsConsistent() kann diese Instanz auf Konsistenz �berpr�ft werden.
3953
3954Af1Querverweise
3955Aga
3956Klassen: RscDataBase, RscHrc, RscSrc, RSCINST, RscTop, RscId.
3957
3958Af1Beispiel
3959AgaDas Beispiel zeigt, wie der Wert einer Variablen ge�ndert wird
3960Ali.....
3961RscInstCopy  aWindow;
3962RscInstCopy  aBorder;
3963RscTop*      pWindowType;
3964
3965// Typ des Klasse Window
3966pWindowType = aDataBase.GetClassType( HashId( "Window" ) );
3967// Exemplar der Klasse Window erzeugen
3968aWindow = aCompilerInst.CreateRscInst( pWindowType );
3969// Exemplar mit Namen "Border" holen
3970aBorder = aWindow.GetVar( HashId( "Border" ) );
3971// Wert auf TRUE setzen
3972aBorder.SetBool( TRUE );
3973// wieder in aWindow einsetzen
3974aWindow.SetVar( HashId( "Border" ), aBorder );
3975.....
3976Aga
3977Au0PARscInstCopy::RscInstCopy()
3978Aga
3979AliRscInstCopy::RscInstCopy();
3980RscInstCopy::RscInstCopy( const RscInst & rInst );
3981RscInstCopy::RscInstCopy( const RscInstCopy & rInst );
3982RscInstCopy::RscInstCopy( RSCINST aTmpI );
3983RscInstCopy::RscInstCopy( RscTop * pNewType,
3984                          const RscInst & rInst );
3985Aga
3986Af1Beschreibung
3987Aga
3988Im Konstruktor wird eine Instanz erzeugt oder kopiert.
3989
3990Af1Parameter
3991Aga
3992AfprInst	ist die Instanz, die kopiert wird.
3993aTmpI	Aus dieser Instanz wird eine RscInstCopy erzeugt.
3994pNewType	Wenn dieser Konstruktor verwendet wird, wird eine Instanz mit
3995"Typ pNewType erzeugt. Alle Daten ab der ersten gemeinsamen
3996"Oberklasse von rInst und pNewType werden �bernommen.
3997Aga
3998Af1Querverweise
3999Aga
4000Klassen:  RSCINST, ERRTYPE.
4001Methoden: IsInst(), GetClassType().
4002
4003Af1Beispiel
4004AgaEs wird gezeigt wie aus einer Button-Instanz eine Edit-Instanz erzeugt wird.
4005
4006AliRscInstCopy aButton;
4007RscInstCopy aEdit;
4008RscTop * pEditType =
4009         aDataBase.GetClassType( HashId( "Edit" ) );
4010//Voraussetzung: In aButton ist g�ltige Button-Instanz
4011//Erzeuge Edit-Instanz
4012aEdit = RscInstCopy( pEditType, aButton );
4013Aga
4014Alle Daten oberhalb von der Klasse Control wurden nach aEdit kopiert.
4015Aga
4016Aga���������������������������������������������������������
4017
4018Au0RscInstCopy::operator = ()
4019Aga
4020AliRscInstCopy & RscInstCopy::operator =
4021                           ( const RscInst & rInst );
4022RscInstCopy & RscInstCopy::operator =
4023                           ( const RscInstCopy & rInst );
4024Aga
4025Af1Beschreibung
4026Aga
4027Es werden die Daten von rInst in die Instanzdaten kopiert.
4028
4029Af1Parameter
4030Aga
4031AfprInst	Intanz von dem die Daten �bernommen werden.
4032Aga
4033Af1Return-Werte
4034Aga
4035Es wird die eigene Instanz zur�ckgeliefert.
4036Aga
4037Aga���������������������������������������������������������
4038Aga
4039
4040Au0RscInstCopy::~RscInstCopy()
4041Aga
4042AliRscInstCopy::~RscInstCopy();
4043Aga
4044Af1Beschreibung
4045Aga
4046Die Daten in der Instanz werden gel�scht.
4047
4048Aga���������������������������������������������������������
4049Aga
4050SsvPA
4051Au0Stichwortverzeichnis
4052Aga
4053Asv
4054RscDataBase	6
4055RscDataBase::AddHrcFile()	11
4056RscDataBase::AddSrcFile()	10
4057RscDataBase::FindDef()	12
4058RscDataBase::GetClassType()	7
4059RscDataBase::GetFileKey()	12
4060RscDataBase::GetFileStruct()	9
4061RscDataBase::GetFileTab()	9
4062RscDataBase::GetPathList()	10
4063RscDataBase::MakeConsistent()	
40638
4064RscDataBase::RemoveFile()	12
4065RscDataBase::RscDataBase()	7
4066RscDataBase::ScanForIncFiles()	11
4067RscHrc	#14
4068RscHrc::ChangeDef()	20
4069RscHrc::ChangeDefName()	22
4070RscHrc::DeleteDef()	21
4071RscHrc::FindDef()	19
4072RscHrc::GetDefineList()	18
4073RscHrc::GetDependList()	23
4074RscHrc::GetFileKey()	16
4075RscHrc::GetFileName()	18
4076RscHrc::GetFileStruct()	22
4077RscHrc::GetPathName()	17
4078RscHrc::InsertDepend()	18
4079RscHrc::IsDefUsed()	21
4080RscHrc::IsDirty()	16
4081RscHrc::NewDef()	19
4082RscHrc::ReadFile()	15
4083RscHrc::RscHrc()	15
4084RscHrc::SetDirty()	16
4085RscHrc::SetFileName()	17
4086RscHrc::SetPathName()	17
4087RscHrc::WriteFile()	23
4088RscHrc::~RscHrc()	15
4089RscInst	"31
4090RscInst::DeleteElement()	38
4091RscInst::DeletePosEle()	39
4092RscInst::GetBool()	44
4093RscInst::GetClassEnum()	46
4094RscInst::GetClassName()	48
4095RscInst::GetConst()	44
4096RscInst::GetCount()	36
4097RscInst::GetElement()	37
4098RscInst::GetInfoEle()	36
4099RscInst::GetNumber()	44
4100RscInst::GetPosEle()	37
4101RscInst::GetRef()	45
4102RscInst::GetString()	45
4103RscInst::GetTypeClass()	47
4104RscInst::GetVar()	43
4105RscInst::IsConsistent()	46
4106RscInst::IsDefault()	46
4107RscInst::IsInst()	34
4108RscInst::MovePosEle()	38
4109RscInst::operator = ()	33
4110RscInst::OverWrite()	34
4111RscInst::RscInst()	33
4112RscInst::SetBool()	40
4113RscInst::SetConst()	39
4114RscInst::SetDefault()	43
4115RscInst::SetElement()	34
4116RscInst::SetNumber()	41
4117RscInst::SetPosEle()	35
4118RscInst::SetPosRscId()	35
4119RscInst::SetRef()	42
4120RscInst::SetString()	41
4121RscInst::SetVar()	39
4122RscInst::WriteRc()	48
4123RscInst::~RscInst()	33
4124RscInstCopy	50
4125RscInstCopy::operator = ()	51
4126RscInstCopy::RscInstCopy()	51
4127RscInstCopy::~RscInstCopy()	52
4128RscSrc	#24
4129RscSrc::CreateRscInst()	26
4130RscSrc::DeleteRscInst()	27
4131RscSrc::FillNameIdList()	29
4132RscSrc::GetRscInst()	28
4133RscSrc::RscSrc()	26
4134RscSrc::SetRscInst()	27
4135RscSrc::Write...File()	30
4136
4137Aga
4138