IDE Window: Code Templates/de: what changed

Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.

Old	New		Line
1	1		## Was sind Code-Schablonen?
2	2
3	3		Code-Schablonen sind Texte mit einem Kurzzeichen. Zum Beispiel: Sie können im Quelltext-Editor 'cl' tippen und dann Strg+J tippen, um die Code-Schablonen aufzurufen, die mit 'cl' beginnen. Dieses Feature ist ein großer Zeitsparer.
4	4
5	5		Dieser Dialog erlaubt Ihnen, existierende Schablonen zu bearbeiten oder eigene hinzuzufügen und ist zu finden unter Werkzeuge -\> Vorlagen
6	6
7	7		Die Texte können Makros enthalten. Und Sie können ihre eigenen Makros hinzufügen durch Erstellen eines Entwicklungszeit-Packages und Verwendung der macrointf.pas aus dem IDEIntf Package.
8	8
9	9		## Beispiel 1 - ifb
10	10
11	11		Tippen Sie
12	12
13	13		ifb\|
14	14
15	15		wobei der senkrechte Strich den Cursor darstellt und drücken anschließend Strg+J, so wird der geschriebene Text verändert zu
16	16
17	17		if \| then begin
18	18
19	19		end;
20	20
21	21		wobei auch hier wieder der \\| nicht da steht, sondern nur andeutet, wo der Cursor steht, so dass Sie sofort die Bedingung eingeben können.
22	22
23	23		Diese Schablone wird 'ifb' genannt und ist wie folgt definiert:
24	24
25	25		if \| then begin
26	26
27	27		end;
28	28
29	29		Hierbei gibt der geschriebene Strich '\\|' an, wo der Cursor nach Ersetzung steht. (Tatsächlich ist in den Werkzeugen ifb anders definiert, nämlich mit einem Macro, aber das wird erst im nächsten Beispiel erklärt)
30	30
31	31		## Beispiel 2 - Verwendung von Makros
32	32
33	33		Dieses Beispiel zeigt, wie die aktuelle Code-Schablone 'ifb' erzeugt wurde.
34	34
35	35		Wählen Sie die Code-Schablone, so steht dort
36	36
37		-	~~` ifb - if statement`~~
	37	+	```text
	38	+	ifb - if statement
	39	+	```
38	40
39	41		und im unteren Fenster steht
40	42
41		-	~~` if $Param(Conditional) then`\~~
42		-	~~` begin`\~~
43		-	~~` \|`\~~
44		-	~~` end$$AddSemicolon() `~~
	43	+	``` pascal
	44	+	if $Param(Conditional) then
	45	+	begin
	46	+	\|
	47	+	end$$AddSemicolon()
	48	+	```
45	49
46	50		Zusätzlich ist "Makros einschalten" angekreuzt.
47	51
48	52		\$Param(Conditional) ist das Macro Param, dem Sie Komma separierte Argumente mitgeben können. In unserem Beispiel ist nur ein Parameter, nämlich Conditional angegeben worden.
49	53
50	54		Rufen Sie nun ifb mit Strg+J auf, so erscheint der Text
51	55
52		-	~~` if <Conditional> then`\~~
53		-	~~` begin`\~~
54		-	~~` \|`\~~
55		-	~~` end; `~~
	56	+	``` pascal
	57	+	if <Conditional> then
	58	+	begin
	59	+	\|
	60	+	end;
	61	+	```
56	62
57	63		und der Cursor steht auf dem markierten Wort Conditional. Hier können Sie nun die Bedingung eingeben. Mit Tab springt der Cursor anschließend auf das '\\|' nach begin, um die entsprechenden Anweisungen einzugeben.
58	64
59	65		## Beispiel 3 - Weiteres Beispiel zur Verwendung von Makros
60	66
61	67		Dieses Beispiel zeigt, wie man eine Code-Schablone 'w' erzeugt, die eine Zeile mit dem aktuellen Prozedur-Namen einfügt, was Zeitersparnis bedeutet und Tippfehler vermeidet.
62	68
63	69		- Klicken Sie auf die 'Hinzufügen' Schaltfläche. Ein Dialog erscheint. Setzen Sie Token auf 'w' und Kommentar auf 'writeln(ProcName)', dann klicken Sie auf Hinzufügen.
64	70		- Ihr neuer Eintrag wurde zur Listbox hinzugefügt.
65	71		- In dem Feld darunter tragen Sie ein
66	72
67		-	~~` writeln(' ',\|);`~~
	73	+	```text
	74	+	writeln(' ',\|);
	75	+	```
68	76
69	77		- Der Strich ist wirklich ein Strich und definiert die neue Cursorposition. Jetzt platzieren Sie den Cursor nach dem ersten ' und klicken auf die 'Insert macro' Schaltfläche. Ein Dialog erscheint, der alle verfügbaren Code Makros zeigt. Wählen Sie 'ProcedureName' und klicken auf 'Insert Macro'. Sie sollten jetzt haben:
70	78
71		-	~~` writeln('$ProcedureName() ',\|);`~~
	79	+	```text
	80	+	writeln('$ProcedureName() ',\|);
	81	+	```
72	82
73	83		- Klicken Sie auf 'OK' zum Speichern und Beenden des Code-Schablone Dialogs.
74	84		- Bewegen Sie den Cursor in einen Methodenrumpf und tippen 'w':
75	85
76	86		Zum Beispiel:
77	87
78		-	~~` procedure TForm1.FormDestroy(Sender: TObject);`\~~
79		-	~~` begin`\~~
80		-	~~` w\|`\~~
81		-	~~` end;`~~
	88	+	``` pascal
	89	+	procedure TForm1.FormDestroy(Sender: TObject);
	90	+	begin
	91	+	w\|
	92	+	end;
	93	+	```
82	94
83	95		Der Strich stellt hier den blinkenden Cursor dar, nicht ein Zeichen.
84	96
85	97		- Drücken Sie Strg+J. Sie erhalten:
86	98
87		-	~~` procedure TForm1.FormDestroy(Sender: TObject);`\~~
88		-	~~` begin`\~~
89		-	~~` writeln('TForm1.FormDestroy ',\|);`\~~
90		-	~~` end;`~~
	99	+	``` pascal
	100	+	procedure TForm1.FormDestroy(Sender: TObject);
	101	+	begin
	102	+	writeln('TForm1.FormDestroy ',\|);
	103	+	end;
	104	+	```
91	105
92	106		## Template Autocompletion
93	107
94	108		Code-Schablonen werden aufgerufen, entweder durch Strg+J oder automatisch (wenn man das so einstellt) nach bestimmten Ereignissen. Für jede Schablone kann man (wenn überhaupt) dieses Ereignis festlegen, das automatisch ausgeführt wird. Folgende Ereignisse (oder gar keines davon) kann man auswählen:
95	109
96	110		- Zeilenende - immer dann, wenn der Benutzer \[Return\] oder \[Enter\] drückt
97	111		- Leerzeichen - wenn der Benutzer die Leertaste drückt.
98	112		- Wortende - wenn der Benutzer ein Wortende-Zeichen (auch ';', z. B. 'b;') benutzt
99	113		- Zeichen nicht hinzufügen - kann mit allen vorgenannten kombiniert werden und bedeutet, dass das letzte eingegebene Zeichen wieder gelöscht wird.
100	114
101	115		## Makros
102	116
103	117		Makros haben die Form \$(MacroName) oder \$MacroName(Param1,...). Makros können verschachtelt sein.
104	118
105	119		### Eigene Makros definieren
106	120
107	121		Eigene Makros können über Entwicklungszeit-Packages registriert werden. Siehe ide/codetemplatesdlg.pas Prozedur CreateStandardCodeMacros für Beispiele.
108	122
109	123		## DCI-Dateiformat
110	124
111	125		Die Vorgabe-dci-Datei der IDE ist pcp/lazarus.dci, wobei pcp für Ihren primären Konfigurationspfad (primary config path) steht. Unter Linux wäre das z.B. \$HOME/.lazarus. Kann die Datei nicht gefunden werden erstellt die IDE sie neu durch Kopieren der Datei ide/lazarus_dci_file.dci.
112	126
113	127		Eine dci-Datei ist eine Textdatei mit einer Liste von Schablonen.
114	128
115	129		Jede Schablone startet mit der Zeile \[Name \\| Beschreibung\]. Die darauf folgenden Zeilen bilden die Schablonen-Werte.
116	130
117	131		---
118	132		From the Free Pascal wiki, page "IDE Window: Code Templates/de", as it stood on 2022-02-23 after a change by Kornelius, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).

Back to history