IDE Window: Code Templates: what changed

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

Old	New		Line
1	1		## What are Code Templates?
2	2
3	3		A Code Template is a section of 'boiler plate' code with an associated abbreviation which invokes its insertion. For example, you can type 'cl' in the Source Editor, and then press the Ctrl+J keyboard shortcut to invoke the code template(s) starting with 'cl'. This feature is a great time saver.
4	4
5	5		The Code Templates dialog (accessed via the Tools\\|Code Templates... menu option) allows you to edit existing templates, or add your own templates.
6	6
7	7		Code template text can contain macros, and you can even add your own macros to the list of those already available by creating a design time package and using the macrointf.pas of the IDEIntf package.
8	8
9	9		## Example 1 - ifb
10	10
11	11		type
12	12
13	13		ifb\|
14	14
15	15		Here the pipe symbol (\\|) represents the blinking screen cursor. Press Ctrl+j. The three characters you typed ('ifb') will be expanded to
16	16
17	17		if \| then begin
18	18
19	19		end;
20	20
21	21		Again the pipe represents the cursor blinking onscreen. You will see that the cursor has been moved. This template is called 'ifb' and it is defined as follows:
22	22
23	23		if \| then begin
24	24
25	25		end;
26	26
27	27		This time the pipe '\\|' is an actual character you type as part of this code template's definition. It stipulates where the cursor will be positioned after the template has been inserted.
28	28
29	29		## Example 2 - Using macros
30	30
31	31		This second example shows you how to create a code template 'w' which repeats the name of the current procedure somewhere in your code. For long names this can be quite a time saver, and it also types it for you without any spelling mistakes!
32	32
33	33		- In the Code Templates dialog, click on the \[Add\] button. In the dialog which pops up set Token to 'w', and Comment to 'writeln(ProcName)', then click \[OK\].
34	34		- Your new code template item has been added to the list box.
35	35		- In the source below fill in
36	36
37		-	~~` writeln(' ',\|);`~~
	37	+	```text
	38	+	writeln(' ',\|);
	39	+	```
38	40
39	41		- Here pipe is an actual pipe character defining the new cursor position. Now place the cursor after the first apostrophe (') and click on the 'Insert macro' button. A dialog pops up listing all available code macros. Choose 'ProcedureName' and click 'Insert Macro'. You should now have:
40	42
41		-	~~` writeln('$ProcedureName() ',\|);`~~
	43	+	```text
	44	+	writeln('$ProcedureName() ',\|);
	45	+	```
42	46
43	47		- Click \[OK\] to save and close the Code Templates dialog.
44	48		- Move the cursor into the body of a method, and type 'w'. For instance:
45	49
46		-	~~` procedure TForm1.FormDestroy(Sender: TObject);`\~~
47		-	~~` begin`\~~
48		-	~~` w\|`\~~
49		-	~~` end;`~~
	50	+	``` pascal
	51	+	procedure TForm1.FormDestroy(Sender: TObject);
	52	+	begin
	53	+	w\|
	54	+	end;
	55	+	```
50	56
51	57		(Here the pipe represents the blinking cursor, not a character).
52	58
53	59		- Press Ctrl+j. You will get:
54	60
55		-	~~` procedure TForm1.FormDestroy(Sender: TObject);`\~~
56		-	~~` begin`\~~
57		-	~~` writeln('TForm1.FormDestroy ',\|);`\~~
58		-	~~` end;`~~
	61	+	``` pascal
	62	+	procedure TForm1.FormDestroy(Sender: TObject);
	63	+	begin
	64	+	writeln('TForm1.FormDestroy ',\|);
	65	+	end;
	66	+	```
59	67
60	68		## Example 3 - Editing macros parameters
61	69
62	70		- Go: Tools - Code Templates, in group box Templates press button Add
63	71		- Input Token: w
64	72		- Input Comment: While i\<count do
65	73		- Press Ok
66	74		- In field below Copy/Paste next text:
67	75
68		-	~~` $Param(i):=0;`\~~
69		-	~~` while($Param(i,Sync=1)<$Param(Count))do`\~~
70		-	~~` begin`\~~
71		-	~~` \|`\~~
72		-	~~` inc($Param(i,Sync=1));`\~~
73		-	~~` end; `~~
	76	+	``` pascal
	77	+	$Param(i):=0;
	78	+	while($Param(i,Sync=1)<$Param(Count))do
	79	+	begin
	80	+	\|
	81	+	inc($Param(i,Sync=1));
	82	+	end;
	83	+	```
74	84
75	85		- Set next check-boxes: Enable Macros, line break, do not add character.
76	86		- Somewhere in editor where you want cycle type letter 'w' (without brackets) and press Enter
77	87		- Now you can type name of counter used instead of 'i' (simultaneously in several places) and press Tab - for edit next parameter. You can press Esc any time to exit from Macros
78	88
79	89		## Template Autocompletion
80	90
81	91		Code templates are invoked either by using the Ctrl+j shortcut, or (if you set this option) automatically following particular events. For each template you can specify the event (if any) that automatically invokes it. You can enable none, some or all of the following events:
82	92
83	93		- line break - insert the template whenever the user presses the \[Return\] or \[Enter\] key
84	94		- space - insert the template whenever the user presses the \[Space bar\].
85	95		- word end - whenever the user presses a word-ending key. For example, when typing 'b;' the code template 'b' can be executed.
86	96		- do not add character - this option can be combined with any of the above. When enabled the triggering key itself will not be inserted. For example when the option 'space' is enabled and the user triggers a template insertion by pressing the space bar, the space character itself will not be inserted in the source editor.
87	97
88	98		## Macros
89	99
90	100		Macros have the form \$(MacroName) or \$MacroName(Param1,...). Macros can be nested.
91	101
92	102		### Define your own macros
93	103
94	104		You can register your own macros by writing a design time package and installing it. See ide/codetemplatesdlg.pas procedure CreateStandardCodeMacros for examples.
95	105
96	106		## DCI file format
97	107
98	108		The default dci file of the IDE is pcp/lazarus.dci, where pcp is your primary config path (e.g. under Linux \$HOME/.lazarus). If this file is not present the IDE will copy the file ide/lazarus_dci_file.dci.
99	109
100	110		A dci file is a text file with a list of templates.
101	111
102	112		Each template starts with line \[name \\| description\]. The template's value are the following lines.
103	113
104	114		---
105	115		From the Free Pascal wiki, page "IDE Window: Code Templates", as it stood on 2016-07-14 after a change by Arent, 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