Lazarus IDE Tools/zh CN: what changed

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

Old	New		Line
1	1		Lazarus IDE 工具
2	2
3	3		## 概述
4	4
5	5		IDE使用了Pascal源码解析和编辑工具库，被称为“codetools（代码工具）”。工具提供的功能像查找声明、代码完成、提取、移动插入和美化Pascal。这些函数可以节省你很多时间，你可以在编辑器选项中对它们进行自定义配置。
6	6
7	7		因为它们的工作时解析FPC、Delphi和Kylix代码。它们不需要编译单元，也不是一个安装了Borland的编译器。你可以在同一时间编辑Delphi和FPC代码。你可以使用不同版本的Delphi和FPC。这使得移植Delphi代码变得容易很多。
8	8
9	9		## IDE 快捷键列表
10	10
11	11		\| \| \|
12	12		\|----\|----\|
13	13		\| [[Lazarus IDE Tools/zh CN\|查找声明]] \| `Ctrl`+点击 or `Alt`+`Up` (跳转到声明的类型或变量) \|
14	14		\| [[Lazarus IDE Tools/zh CN\|方法跳转]] \| `Ctrl`+`Shift`+`Up` (在定义部分和实现部分进行切换。看见一个定义，就可以用快键方式，直接找到它的实现部分。) \|
15	15		\| [[Lazarus IDE Tools/zh CN\|代码模板]] \| `Ctrl`+`J` \|
16	16		\| [[Lazarus IDE Tools/zh CN\|Syncro 编辑(同步编辑)]] \| `Ctrl`+`J` (需要选择文本) \|
17	17		\| [[Lazarus IDE Tools/zh CN\|类自动完成]] \| `Ctrl`+`Shift`+`C` \|
18	18		\| [[Lazarus IDE Tools/zh CN\|标识符自动完成]] \| `Ctrl`+`空格` \|
19	19		\| [[Lazarus IDE Tools/zh CN\|关键字自动完成]] \| `Ctrl`+`W` \|
20	20		\| [[Lazarus IDE Tools/zh CN\|参数提示]] \| `Ctrl`+`Shift`+`空格` \|
21	21		\| [[Lazarus IDE Tools/zh CN\|渐进式搜索]] \| `Ctrl`+`E` \|
22	22
23	23		## 方法跳转
24	24
25	25		要在过程体(begin..end)与过程定义(procedure 过程名)间跳转，使用 `Ctrl`+`Shift`+`Up`.
26	26
27	27		示例:
28	28
29		-	~~`interface`\~~
	29	+	``` pascal
	30	+	interface
30	31
31		-	~~`procedure DoSomething; // 过程定义`\~~
32		-	~~` `\~~
33		-	~~`implementation`\~~
34		-	~~` `\~~
35		-	~~`procedure DoSomething; // 过程体`\~~
36		-	~~`begin`\~~
37		-	~~`end;`~~
	32	+	procedure DoSomething; // 过程定义
	33	+
	34	+	implementation
	35	+
	36	+	procedure DoSomething; // 过程体
	37	+	begin
	38	+	end;
	39	+	```
38	40
39	41		如果光标在过程体，当你按`Ctrl`+`Shift`+`Up`时，会跳转到其定义，再次按`Ctrl`+`Shift`+`Up`会跳转到过程体；如此循环。
40	42
41	43		在方法间（类中的过程）也是如此。
42	44
43	45		注意: 方法跳转，将跳转到具有相同名称和参数列表的地方，如果没有，它将跳到最佳匹配的地方，并将光标定位在第一个上面。（对于Delphians：Delphi不能做到这一点。）
44	46
45	47		例如，不同参数类型的过程：
46	48
47		-	~~`interface`\~~
	49	+	``` pascal
	50	+	interface
48	51
49		-	~~`procedure DoSomething(p: char); // 过程定义`\~~
	52	+	procedure DoSomething(p: char); // 过程定义
50	53
51		-	~~`implementation`\~~
52		-	~~` `\~~
53		-	~~`procedure DoSomething(p: string); // 过程主体`\~~
54		-	~~`begin`\~~
55		-	~~`end;`~~
	54	+	implementation
	55	+
	56	+	procedure DoSomething(p: string); // 过程主体
	57	+	begin
	58	+	end;
	59	+	```
56	60
57	61		自定义跳转会在'string'处定位光标，这可用于重命名方法或改变参数。
58	62
59	63		如:\
60	64		你更名'DoSomething' 为 'MakeIt'：
61	65
62		-	~~`interface`\~~
	66	+	``` pascal
	67	+	interface
63	68
64		-	~~`procedure MakeIt; // 过程定义`\~~
	69	+	procedure MakeIt; // 过程定义
65	70
66		-	~~`implementation`\~~
	71	+	implementation
67	72
68		-	~~`procedure DoSomething; // 过程主体`\~~
69		-	~~`begin`\~~
70		-	~~`end;`~~
	73	+	procedure DoSomething; // 过程主体
	74	+	begin
	75	+	end;
	76	+	```
71	77
72	78		Then you jump from MakeIt to the body. The IDE searches for a fitting body, does not find one, and hence searches for a candidate. Since you renamed only one procedure there is exactly one body without definition (DoSomething) and so it will jump to DoSomething and position the cursor right on 'DoSomething'. Then you can simply rename it there too. This works for parameters as well.
73	79
74	80		## 引入文件
75	81
76	82		引入文件是使用{\$I 文件名} 或 {\$INCLUDE 文件名}编译指令。Lazarus和FPC大量采用它，以减少冗余，为考虑平台兼容性，可以使用{\$IFDEF}结构。
77	83
78	84		Contrary to Delphi, the Lazarus IDE has full support for include files. You can for example jump from the method in the .pas file to the method body in the include file. All codetools like code completion consider include files as special bounds.
79	85
80	86		For instance: When code completion adds a new method body behind another method body, it keeps them both in the same file. This way you can put whole class implementations in include files, like the LCL does for nearly all controls.
81	87
82	88		But there is a newbie trap: If you open an include file for the first time and try method jumping or find declaration you will get an error. The IDE does not know to which unit the include file belongs. You must open the unit first.
83	89
84	90		As soon as the IDE parses the unit, it will parse the include directives there and the IDE will remember this relationship. It saves this information on exit and on project save to ~/.lazarus/includelinks.xml. The next time you open this include file and jump or do a find declaration, the IDE will internally open the unit and the jump will work. You can also hint the IDE by putting
85	91
86		-	~~`{%mainunit yourunit.pas} `~~
	92	+	```text
	93	+	{%mainunit yourunit.pas}
	94	+	```
87	95
88	96		on the top of yourinclude.inc.
89	97
90	98		This mechanism has of course limits. Some include files are included twice or more. For example: lcl/include/winapih.inc.
91	99
92	100		Jumping from the procedure/method definitions in this include file to the bodies depends on your last actions. If you worked on lcl/lclintf.pp the IDE will jump to winapi.inc. If you worked on lcl/interfacebase.pp, then it will jump to lcl/include/interfacebase.inc (or one of the other include files). If you are working on both, then you can get confused. ;)
93	101
94	102		## 代码模板
95	103
96	104		代码模板将标识符转换为文本或代码片段。
97	105
98	106		默认快捷键是`Ctrl`+`J`。输入一个标识符，之后按`Ctrl`+`J`键将会替换该标识符为选定的内容。代码模板可以在“工具”菜单-\>“选项“-\>“代码工具”里设置。
99	107
100	108		如，在标识符classf后按`Ctrl`+`J`，classf将被替换为：
101	109
102		-	~~`T = class(T)`\~~
103		-	~~`private`\~~
	110	+	``` pascal
	111	+	T = class(T)
	112	+	private
104	113
105		-	~~`public`\~~
106		-	~~` constructor Create;`\~~
107		-	~~` destructor Destroy; override;`\~~
108		-	~~`end;`~~
	114	+	public
	115	+	constructor Create;
	116	+	destructor Destroy; override;
	117	+	end;
	118	+	```
109	119
110	120		并且光标在T后面。你可以将光标定位在空白位置（而不是标识符那里），按下 `Ctrl`+`J`键，将显示代码模板列表。选择一个，将返回选择的代码模板。
111	121
112	122		输入b之后，按`Ctrl`+`J`键，将显示 begin..end; 块。
113	123
114	124		## 参数提示
115	125
116	126		显示参数提示。
117	127
118	128		例如：
119	129
120		-	~~`Canvas.FillRect();`~~
	130	+	```text
	131	+	Canvas.FillRect();
	132	+	```
121	133
122	134		将光标置于括号中，按`Ctrl`+`Shift`+`space`键，将显示FillRect的参数提示信息。
123	135
124	136		## 渐进式搜索
125	137
126	138		渐进式搜索，按`Ctrl`+`E`，输入搜索的文本，编辑器会高亮所有搜索到的。
127	139
128	140		- 例如，输入`e`，将搜索并高亮显示所有e的匹配项。
129	141		- 然后，输入`t` ，将突出显示所有匹配et的文本。
130	142		- 跳转到下一个匹配项，按 `F3`或(`Ctrl`+`E`)；跳转到上一匹配项，按`Shift`+`F3`。
131	143		- `Backspace` 删除最后一个字符。
132	144		- 停止搜索，可以按`Enter`键，或者在代码编辑器中点击鼠标。
133	145		- You can resume the last search by pressing `Ctrl`+`e` a second time, immediately after you started incr-search with `Ctrl`+`e`. that is while the search term is still empty.
134	146		- `Ctrl`+`V`键，粘贴剪贴板中的内容到当前搜索（因为lazarus 0.9.27 r19824）。
135	147
136	148		### 注意：快速搜索与渐进式搜索的标识符
137	149
138	150		- Place text cursor on identifier (do not select anything) ~~将光标放在标识符处（不要选择任何内容）。~~
139	151		- 按`Ctrl`+`C`键，将复制选择的标识符到剪贴板。
140	152		- 按`Ctrl`+`E`键，开始渐进式搜索。
141	153		- 按`Ctrl`+`V`键，搜索标识符（自0.9.27）。
142	154		- `F3`，向下搜索，`Shift`+`F3`向下搜索。
143	155		- 使用任意键（如，光标左、右键）来终止搜索。
144	156
145	157		## Syncro 编辑(同步编辑)
146	158
147	159		Syncro Edit（同步编辑）可以让你在同一时间同步编辑所有匹配到的内容。你简单的在一个地方编辑，所有匹配的内容也会同步更新。
148	160
149	161		它适用于所有选择区域的文本：
150	162
151	163		- 选择文本块。
152	164		- 按`Ctrl`+`J`或，点击编辑左侧显示的“编辑图标”（![](/wiki-images/7/7e/SyncroEditIcon.png)）。按`tab`键，选择要编辑的内容。
153	165		- 输入新内容。
154	166		- 按`Esc`键完成编辑。
155	167
156	168		这里有[[New IDE features since\|动画演示]]。
157	169
158	170		> Note: `Ctrl`+`J`也是代码模板的快捷键，如果你选择的不是文本块的话。
159	171
160	172		## 查找下一个/上一个出现的单词
161	173
162	174		这两个功能，可以在源代码编辑器的弹出菜单中找到：
163	175
164	176		- 源代码编辑器 / 弹出菜单 / 查找 / 查找下一个发现的词
165	177		- 源代码编辑器 / 弹出菜单 / 查找 / 查找前一个发现的词
166	178
167	179		And you can assign them shortcuts in the editor options.~~你也可以在查找菜单中，找到相应菜单项，它与其功能相同，当然也可以使用快捷键。~~
168	180
169	181		## 代码自动完成
170	182
171	183		代码自动完成，可以在“编辑”菜单-\>“自动完成代码”，或按`Ctrl`+`Shift`+`C`键。（新版的Lazarus，在“Source”菜单-\>“自动完成代码”）
172	184
173	185		对于Delphians：
174	186
175	187		Delphi的“代码完成”，按`Ctrl`+`Space`将显示标识符列表。在Lazarus中称为“标识符提示”。
176	188
177	189		代码自动完成，有多种强大功能：
178	190
179	191		- 类完成：自动完成属性，在方法体中增加/更新私有变量或私有方法。
180	192		- [[Basic Pascal Tutorial/Chapter 4/Forward Referencing/zh CN\|前向引用]]过程完成: 添加过程体。
181	193		- 事件赋值完成：完成事件赋值，并增加了方法定义和主体。
182	194		- 变量声明完成：增加了局部变量定义。
183	195		- 过程调用完成：添加新过程。
184	196		- 反转过程完成：添加过程/函数体声明。
185	197		- 反转类完成：添加了方法体声明。
186	198
187	199		这个功能的使用，取决于编辑器中光标的位置，下面进行说明。
188	200
189	201		### 类自动完成
190	202
191	203		（翻译不完善不完整，需要修订）
192	204
193	205		“类完成”是代码完成中最强大的，编写一个类，添加方法和属性，代码完成，将添加方法休，属性访问方法和变量。
194	206
195	207		如，创建一个类（见代码模板，以节省你的工作时间）：
196	208
197		-	~~`TExample = class(TObject)`\~~
198		-	~~`public`\~~
199		-	~~` constructor Create;`\~~
200		-	~~` destructor Destroy; override;`\~~
201		-	~~`end;`~~
	209	+	``` pascal
	210	+	TExample = class(TObject)
	211	+	public
	212	+	constructor Create;
	213	+	destructor Destroy; override;
	214	+	end;
	215	+	```
202	216
203	217		在类中，按`Ctrl`+`Shift`+`C`键，将会创建缺少的方法，并将光标移到创建的第一个方法体中，所以，你可以开始编写类代码：
204	218
205		-	~~`{ TExample }`\~~
	219	+	``` pascal
	220	+	{ TExample }
206	221
207		-	~~`constructor TExample.Create;`\~~
208		-	~~`begin`\~~
209		-	~~` \|`\~~
210		-	~~`end;`\~~
	222	+	constructor TExample.Create;
	223	+	begin
	224	+	\|
	225	+	end;
211	226
212		-	~~`destructor TExample.Destroy;`\~~
213		-	~~`begin`\~~
214		-	~~` inherited Destroy;`\~~
215		-	~~`end;`~~
	227	+	destructor TExample.Destroy;
	228	+	begin
	229	+	inherited Destroy;
	230	+	end;
	231	+	```
216	232
217	233		留意: '\\|'是光标位置。
218	234
219	235		提示：你可以按按`Ctrl`+`Shift`+`Up`键，在方法与方法体间跳转。
220	236
221	237		你可以看到，在IDE中加入了继承销毁，因为，在类中定义了override关键字。
222	238
223	239		现在，添加一个DoSomething方法：
224	240
225		-	~~`TExample = class(TObject)`\~~
226		-	~~`public`\~~
227		-	~~` constructor Create;`\~~
228		-	~~` procedure DoSomething(i: integer);`\~~
229		-	~~` destructor Destroy; override;`\~~
230		-	~~`end;`~~
	241	+	``` pascal
	242	+	TExample = class(TObject)
	243	+	public
	244	+	constructor Create;
	245	+	procedure DoSomething(i: integer);
	246	+	destructor Destroy; override;
	247	+	end;
	248	+	```
231	249
232	250		按`Ctrl`+`Shift`+`C`，将添加：
233	251
234		-	~~`procedure TExample.DoSomething(i: integer);`\~~
235		-	~~`begin`\~~
236		-	~~` \|`\~~
237		-	~~`end;`~~
	252	+	``` pascal
	253	+	procedure TExample.DoSomething(i: integer);
	254	+	begin
	255	+	\|
	256	+	end;
	257	+	```
238	258
239	259		你可以看到新的方法体中插入了创建和销毁，因为在类中已经定义。You can define the insertion policy in Environment \> Codetools Options -\> Code Creation.
240	260
241	261		完成属性添加一个AnInteger属性：
242	262
243		-	~~`TExample = class(TObject)`\~~
244		-	~~`public`\~~
245		-	~~` constructor Create;`\~~
246		-	~~` procedure DoSomething(i: integer);`\~~
247		-	~~` destructor Destroy; override;`\~~
248		-	~~` property AnInteger: Integer;`\~~
249		-	~~`end;`~~
	263	+	``` pascal
	264	+	TExample = class(TObject)
	265	+	public
	266	+	constructor Create;
	267	+	procedure DoSomething(i: integer);
	268	+	destructor Destroy; override;
	269	+	property AnInteger: Integer;
	270	+	end;
	271	+	```
250	272
251	273		按`Ctrl`+`Shift`+`C`将得到：
252	274
253		-	~~`procedure TExample.SetAnInteger(const AValue: integer);`\~~
254		-	~~`begin`\~~
255		-	~~` \|if FAnInteger=AValue then exit;`\~~
256		-	~~` FAnInteger:=AValue;`\~~
257		-	~~`end;`~~
	275	+	``` pascal
	276	+	procedure TExample.SetAnInteger(const AValue: integer);
	277	+	begin
	278	+	\|if FAnInteger=AValue then exit;
	279	+	FAnInteger:=AValue;
	280	+	end;
	281	+	```
258	282
259	283		代码完成增加了一个写访问修饰符，并增加了一些常代码，跳转到类，按`Ctrl`+`Shift`+`Up`：
260	284
261		-	~~`TExample = class(TObject)`\~~
262		-	~~`private`\~~
263		-	~~` FAnInteger: integer;`\~~
264		-	~~` procedure SetAnInteger(const AValue: integer);`\~~
265		-	~~`public`\~~
266		-	~~` constructor Create;`\~~
267		-	~~` procedure DoSomething(i: integer);`\~~
268		-	~~` destructor Destroy; override;`\~~
269		-	~~` property AnInteger: integer read FAnInteger write SetAnInteger;`\~~
270		-	~~`end;`~~
	285	+	``` pascal
	286	+	TExample = class(TObject)
	287	+	private
	288	+	FAnInteger: integer;
	289	+	procedure SetAnInteger(const AValue: integer);
	290	+	public
	291	+	constructor Create;
	292	+	procedure DoSomething(i: integer);
	293	+	destructor Destroy; override;
	294	+	property AnInteger: integer read FAnInteger write SetAnInteger;
	295	+	end;
	296	+	```
271	297
272	298		该属性继承了一个读取和写入访问修饰符，这个类得到了一个新的private（私有）变量FAnInteger和SetAnInteger方法。
273	299
274	300		It is a common Delphi style rule to prepend private variables with an 'F' and the write method with a 'Set'. If you don't like that, you can change this in Environment \> Codetools Options -\> Code Creation.
275	301
276	302		创建一个只读属性：
277	303
278		-	~~`property PropName: PropType read;`~~
	304	+	```text
	305	+	property PropName: PropType read;
	306	+	```
279	307
280	308		将它继承：
281	309
282		-	~~`property PropName: PropType read FPropName;`~~
	310	+	```text
	311	+	property PropName: PropType read FPropName;
	312	+	```
283	313
284	314		创建一个只写属性：
285	315
286		-	~~` property PropName: PropType write;`~~
	316	+	```text
	317	+	property PropName: PropType write;
	318	+	```
287	319
288	320		将它继承：
289	321
290		-	~~`property PropName: PropType write SetPropName;`~~
	322	+	```text
	323	+	property PropName: PropType write SetPropName;
	324	+	```
291	325
292	326		创建一个只读属性与读取方法：
293	327
294		-	~~`property PropName: PropType read GetPropName;`~~
	328	+	```text
	329	+	property PropName: PropType read GetPropName;
	330	+	```
295	331
296	332		保持和GetPropName功能：
297	333
298		-	~~`function GetpropName: PropType;`~~
	334	+	``` pascal
	335	+	function GetpropName: PropType;
	336	+	```
299	337
300	338		创建一个属性与存储的修饰符：
301	339
302		-	~~`property PropName: PropType stored;`~~
	340	+	```text
	341	+	property PropName: PropType stored;
	342	+	```
303	343
304	344		将它继承：
305	345
306		-	~~`property PropName: PropType read FPropName write SetPropName stored PropNameIsStored;`~~
	346	+	```text
	347	+	property PropName: PropType read FPropName write SetPropName stored PropNameIsStored;
	348	+	```
307	349
308	350		Because stored is used for streaming read and write modifiers are automatically added as well.
309	351
310	352		提示：标识符完成允许不完整的属性，并且会提示的默认名称。例如：
311	353
312		-	~~`property PropName: PropType read \|;`~~
	354	+	```text
	355	+	property PropName: PropType read \|;
	356	+	```
313	357
314	358		将光标置于一个空格的'读'的关键字，然后按`Ctrl`+`Space`，它会给出变量'FPropName'和过程'SetPropName“。
315	359
316	360		### 前向引用自动完成
317	361
318	362		前向引用自动完成是代码完成部分，用于添加缺少的过程体。当光标在一个前向定义的过程上时，
319	363
320	364		例如：添加一个新过程在接口部分：
321	365
322		-	~~`procedure DoSomething;`~~
	366	+	``` pascal
	367	+	procedure DoSomething;
	368	+	```
323	369
324	370		将光标放在声明上，按`Ctrl`+`Shift`+`C`，这将创建实现部分：
325	371
326		-	~~`procedure DoSomething;`\~~
327		-	~~`begin`\~~
328		-	~~` \|`\~~
329		-	~~`end;`~~
	372	+	``` pascal
	373	+	procedure DoSomething;
	374	+	begin
	375	+	\|
	376	+	end;
	377	+	```
330	378
331	379		提示：你可以按`Ctrl`+`Shift`+`Up`，在过程定义与过程体间跳转。
332	380
333	381		如果已经存在过程，新过程体将添加到类方法中，IDE试图保持有序，例如：
334	382
335		-	~~` procedure Proc1;`\~~
336		-	~~` procedure Proc2; // 新过程`\~~
337		-	~~` procedure Proc3;`~~
	383	+	``` pascal
	384	+	procedure Proc1;
	385	+	procedure Proc2; // 新过程
	386	+	procedure Proc3;
	387	+	```
338	388
339	389		如果Proc1和Proc3已经存在，那么Proc2部分会在Proc1和Proc3间添加。This behaviour can be setup in Environment \> Codetools Options -\> Code Creation.
340	390
341	391		多个过程：
342	392
343		-	~~`procedure Proc1_Old; // 过程体存在`\~~
344		-	~~`procedure Proc2_New; // 过程体不存在`\~~
345		-	~~`procedure Proc3_New; // "`\~~
346		-	~~`procedure Proc4_New; // "`\~~
347		-	~~`procedure Proc5_Old; // 过程体存在`~~
	393	+	``` pascal
	394	+	procedure Proc1_Old; // 过程体存在
	395	+	procedure Proc2_New; // 过程体不存在
	396	+	procedure Proc3_New; // "
	397	+	procedure Proc4_New; // "
	398	+	procedure Proc5_Old; // 过程体存在
	399	+	```
348	400
349	401		代码完成，将添加3个过程体：(Proc2_New, Proc3_New, Proc4_New)。
350	402
351	403		为什么称它是“前向引用自动完成”？
352	404
353	405		先了解下，[[Basic Pascal Tutorial/Chapter 4/Forward Referencing/zh CN\|前向引用]]。
354	406
355	407		Because it does not only work for procedures defined in the interface, but for procedures with the "forward" modifier as well. And because the codetools treats procedures in the interface as having an implicit 'forward' modifier.
356	408
357	409		### 事件赋值自动完成
358	410
359	411		事件赋值自动完成，是代码自动完成的一部分，在使用时，将光标放在要赋值事件的后面。
360	412
361	413		例如，在FormCreate中添加一行：
362	414
363		-	~~`OnPaint:=`~~
	415	+	``` pascal
	416	+	OnPaint:=
	417	+	```
364	418
365		-	~~`procedure TForm1.Form1Create(Sender: TObject);`\~~
366		-	~~`begin`\~~
367		-	~~` OnPaint:=\|`\~~
368		-	~~`end;`~~
	419	+	``` pascal
	420	+	procedure TForm1.Form1Create(Sender: TObject);
	421	+	begin
	422	+	OnPaint:=\|
	423	+	end;
	424	+	```
369	425
370	426		注意：\\|是光标所在位置。
371	427
372	428		按`Ctrl`+`Shift`+`C`后，代码将会：
373	429
374		-	~~`OnPaint:=@Form1Paint;`~~
	430	+	``` pascal
	431	+	OnPaint:=@Form1Paint;
	432	+	```
375	433
376	434		Form1Paint方法，将被添加到TForm1类中，
377	435
378		-	~~`procedure TForm1.Form1Paint(Sender: TObject);`\~~
379		-	~~`begin`\~~
380		-	~~` \|`\~~
381		-	~~`end;`~~
	436	+	``` pascal
	437	+	procedure TForm1.Form1Paint(Sender: TObject);
	438	+	begin
	439	+	\|
	440	+	end;
	441	+	```
382	442
383	443		这就像在对象观察器中添加方法。
384	444
385	445		注意:\
386	446		你必须把光标放在:=后，但如果你将光标放在标识符后，那么将调用代码自动完成。
387	447
388	448		提示：\
389	449		你可以自定义方法名，如：
390	450
391		-	~~` OnPaint:=@ThePaintMethod;`~~
	451	+	``` pascal
	452	+	OnPaint:=@ThePaintMethod;
	453	+	```
392	454
393	455		### 变量声明自动完成
394	456
395	457		变量声明自动完成，将未声明的变量对它声明。
396	458
397	459		如一个局部变量定义：
398	460
399		-	~~`标识符:=值;`~~
	461	+	``` pascal
	462	+	标识符:=值;
	463	+	```
400	464
401	465		将光标放置在标识符后面。
402	466
403	467		``` pascal
404	468		procedure TForm1.Form1Create(Sender: TObject);
405	469		begin
406	470		i:=3;
407	471		end;
408	472		```
409	473
410	474		将光标位在i后，按`Ctrl`+`Shift`+`C`将得到：
411	475
412	476		``` pascal
413	477		procedure TForm1.Form1Create(Sender: TObject);
414	478		var
415	479		i: Integer;
416	480		begin
417	481		i:=3;
418	482		end;
419	483		```
420	484
421	485		如果标识符i已经被定义，并且没有添加声明
422	486
423		-	~~`var i: integer;`~~
	487	+	``` pascal
	488	+	var i: integer;
	489	+	```
424	490
425	491		标识符的类型，通过赋值运算来得到类型。像数字3默认为整型。
426	492
427	493		另一个例子：
428	494
429	495		``` pascal
430	496		type
431	497		TWhere = (Behind, Middle, InFront);
432	498
433	499		procedure TForm1.Form1Create(Sender: TObject);
434	500		var
435	501		a: array[TWhere] of char;
436	502		begin
437	503		for Where:=Low(a) to High(a) do writeln(a[Where]);
438	504		end;
439	505		```
440	506
441	507		将光标放置在where后，按`Ctrl`+`Shift`+`C`将得到：
442	508
443	509		``` pascal
444	510		procedure TForm1.Form1Create(Sender: TObject);
445	511		var
446	512		a: array[TWhere] of char;
447	513		Where: TWhere;
448	514		begin
449	515		for Where:=Low(a) to High(a) do writeln(a[Where]);
450	516		end;
451	517		```
452	518
453	519		lazarus 0.9.11后将会完成参数：
454	520
455	521		``` pascal
456	522		procedure TForm1.FormPaint(Sender: TObject);
457	523		begin
458	524		with Canvas do begin
459	525		Line(x1,y1,x2,y2);
460	526		end;
461	527		end;
462	528		```
463	529
464	530		将光标放置在x1后，按`Ctrl`+`Shift`+`C`将得到：
465	531
466	532		``` pascal
467	533		procedure TForm1.FormPaint(Sender: TObject);
468	534		var
469	535		x1: integer;
470	536		begin
471	537		with Canvas do begin
472	538		Line(x1,y1,x2,y2);
473	539		end;
474	540		end;
475	541		```
476	542
477	543		### 过程调用自动完成
478	544
479	545		代码完成可以通过调用语句本身创建一个新程序。假设你刚编写声明
480	546
481		-	~~`DoSomething(Width);`~~
	547	+	```text
	548	+	DoSomething(Width);
	549	+	```
482	550
483	551		``` pascal
484	552		procedure SomeProcedure;
485	553		var
486	554		Width: integer;
487	555		begin
488	556		Width:=3;
489	557		DoSomething(Width);
490	558		end;
491	559		```
492	560
493	561		将光标放在标识符DoSomething上，按`Ctrl`+`Shift`+`C`，将得到：
494	562
495	563		``` pascal
496	564		procedure DoSomething(aWidth: LongInt);
497	565		begin
498	566
499	567		end;
500	568
501	569		procedure SomeProcedure;
502	570		var
503	571		Width: integer;
504	572		begin
505	573		Width:=3;
506	574		DoSomething(Width);
507	575		end;
508	576		```
509	577
510	578		它不会创建函数或方法。
511	579
512	580		### 反转类自动完成
513	581
514	582		声明当前私有方法。自Lazarus 0.9.21后可用。
515	583
516	584		如：
517	585
518		-	~~` procedure TForm1.DoSomething(Sender: TObject);`\~~
519		-	~~` begin`\~~
520		-	~~` end;`~~
	586	+	``` pascal
	587	+	procedure TForm1.DoSomething(Sender: TObject);
	588	+	begin
	589	+	end;
	590	+	```
521	591
522	592		DoSomething未被声明，按`Ctrl`+`Shift`+`C`，将添加TForm1类的私有方法
523	593
524		-	~~`procedure DoSomething(Sender: TObject);`~~
	594	+	``` pascal
	595	+	procedure DoSomething(Sender: TObject);
	596	+	```
525	597
526	598		对于 Delphians:
527	599
528	600		Lazarus下完成工作始终是：从类接口来实现向后/反转类声明。Delphi是两个方向，但它有个缺点：让你不注意的一个错字会很容易的创建一个方法。
529	601
530	602		### 注释和代码自动完成
531	603
532	604		Code completion tries to keep comments where they belong. For example:
533	605
534		-	~~` FList: TList; // list of TComponent`\~~
535		-	~~` FInt: integer;`~~
	606	+	```text
	607	+	FList: TList; // list of TComponent
	608	+	FInt: integer;
	609	+	```
536	610
537	611		When inserting a new variable between FList and FInt, the comment is kept in the FList line. Same is true for
538	612
539		-	~~` FList: TList; { list of TComponent`\~~
540		-	~~` This is a comment over several lines, starting`\~~
541		-	~~` in the FList line, so codetools assumes it belongs `\~~
542		-	~~` to the FLIst line and will not break this `\~~
543		-	~~` relationship. Code is inserted behind the comment. }`\~~
544		-	~~` FInt: integer;`~~
	613	+	```text
	614	+	FList: TList; { list of TComponent
	615	+	This is a comment over several lines, starting
	616	+	in the FList line, so codetools assumes it belongs
	617	+	to the FLIst line and will not break this
	618	+	relationship. Code is inserted behind the comment. }
	619	+	FInt: integer;
	620	+	```
545	621
546	622		If the comment starts in the next line, then it will be treated as if it belongs to the code below. For example:
547	623
548		-	~~` FList: TList; // list of TComponent`\~~
549		-	~~` { This comment belongs to the statement below. `\~~
550		-	~~` New code is inserted above this comment and `\~~
551		-	~~` behind the comment of the FList line. }`\~~
552		-	~~` FInt: integer;`~~
	624	+	```text
	625	+	FList: TList; // list of TComponent
	626	+	{ This comment belongs to the statement below.
	627	+	New code is inserted above this comment and
	628	+	behind the comment of the FList line. }
	629	+	FInt: integer;
	630	+	```
553	631
554	632		### 方法更新
555	633
556	634		通常类完成将添加缺少的方法体，自0.9.27，如果类中的方法不同，那么方法体将被更新，如你有一个DoSomething方法：
557	635
558	636		``` pascal
559	637		public
560	638		procedure DoSomething;
561	639		end;
562	640
563	641		procedure TForm.DoSomething;
564	642		begin
565	643		end;
566	644		```
567	645
568	646		添加一个参数：
569	647
570	648		``` pascal
571	649		public
572	650		procedure DoSomething(i: integer);
573	651		end;
574	652		```
575	653
576	654		按`Ctrl`+`Shift`+`C`，该方法声明将被更新，新的参数将被更新：
577	655
578	656		``` pascal
579	657		procedure TForm.DoSomething(i: integer);
580	658		begin
581	659		end;
582	660		```
583	661
584	662		## 重构
585	663
586	664		### 互换指派
587	665
588	666		"Invert Assignments" takes some selected pascal statements and inverts all assignments from this code. This tool is usefull for transforming a "save" code to a "load" one and inverse operation. ~~摘要：互换指派，将某些选定的Pascal语句互换。~~
589	667
590	668		如:\
591		-	~~procedure DoSomething;~~
592	669
593		-	~~`begin`\~~
594		-	~~` AValueStudio:= BValueStudio;`\~~
595		-	~~` AValueAppartment :=BValueAppartment;`\~~
596		-	~~` AValueHouse:=BValueHouse;`\~~
597		-	~~`end;`~~
	670	+	``` pascal
	671	+	procedure DoSomething;
	672	+	begin
	673	+	AValueStudio:= BValueStudio;
	674	+	AValueAppartment :=BValueAppartment;
	675	+	AValueHouse:=BValueHouse;
	676	+	end;
	677	+	```
598	678
599	679		选择要反转的代码，右击选择重构-\>互换指派”。（或者，Source菜单-\>重构-\>互换指派）。
600	680
601	681		结果：
602	682
603		-	~~`procedure DoSomething;`\~~
604		-	~~`begin`\~~
605		-	~~` BValueStudio := AValueStudio;`\~~
606		-	~~` BValueAppartment := AValueAppartment;`\~~
607		-	~~` BValueHouse := AValueHouse;`\~~
608		-	~~`end;`~~
	683	+	``` pascal
	684	+	procedure DoSomething;
	685	+	begin
	686	+	BValueStudio := AValueStudio;
	687	+	BValueAppartment := AValueAppartment;
	688	+	BValueHouse := AValueHouse;
	689	+	end;
	690	+	```
609	691
610	692		### 封装所选
611	693
612	694		选择一些内容，按`Ctrl`+`Shift`+`N`，会弹出一个对话框，你可以选择一项，之后，会将所选择的内容，括住。
613	695
614	696		如，你选择了try..finally项，那么，你选择的内容将会被try..finally括住。
615	697
616	698		你可以在选择内容上右击，源代码-\>封装所选；或者，Source菜单-\>封装所选，都可以实现此功能。
617	699
618	700		### 重命名标识符
619	701
620	702		将光标放在标识符上，并调用它（按`F2`，或右击重构-\>重命名标识符；也可以在Source菜单-\>重构-\>重命名标识符）。
621	703
622	704		将弹出对话框，输入新的标识符名称，设置搜索范围。
623	705
624	706		- It will rename all occurences and only those that actually use this declaration. That means it does not rename declarations with the same name.
625	707		- ~~它将重命名所有出现,只有那些真正使用这个声明。这意味着它不重命名声明名称相同的。~~
626	708		- And it will first check for name conflicts.
627	709		- ~~它将首先检查名称冲突。~~
628	710		- Limits: It only works on pascal sources, does not yet rename files nor adapt lfm/lrs files nor lazdoc files.
629	711		- ~~限制：它仅适用于Pascal源文件，还没有重命名的文件，不适用LFM/LRS文件，也不适用，lazdoc文件。~~
630	712
631	713		### 查找标识符参考
632	714
633	715		将光标放在标识符上，并调用它（按`Ctrl`+`Shift`+`I`，或右击查找-\>查找标识符参考；也可以在查找菜单-\>查找标识符参考）；
634	716
635	717		在出现的对话框中设置搜索范围，IDE将搜索所有出现的，只有那些真正使用这一标识符的，意味着不会显示相同名称的。
636	718
637	719		### 显示抽象方法
638	720
639	721		This feature lists and auto completes virtual, abstracts methods that need to be implemented. Place the cursor on a class declaration and invoke it. If there are missing abstract methods a dialog will appear listing them. Select the methods to implement and the IDE creates the method stubs.
640	722
641	723		### 抽取过程
642	724
643	725		查看 [[IDE Window: Extract Procedure/zh CN\|抽取过程]]
644	726
645	727		## 查找声明
646	728
647	729		将光标定位在要查找声明的标识符上，右击选择查找声明。之后，将搜索并跳转到所选择标识符的定义部分。
648	730
649	731		Every find declaration sets a Jump Point. That means you jump with find declaration to the declaration and easily jump back with Search -\> Jump back.
650	732
651	733		在Delphi上有些不同：
652	734
653	735		The codetools work on sources following the normal pascal rules, instead of using the compiler output. The compiler returns the final type. The codetools see the sources and all steps in between. For example:
654	736
655	737		The Visible property is first defined in TControl (controls.pp), then redefined in TCustomForm and finally redefined in TForm. Invoking find declaration on Visible will you first bring to Visible in TForm. Then you can invoke Find Declaration again to jump to Visible in TCustomForm and again to jump to Visible in TControl.
656	738
657	739		~~可见属性是在TControl (controls.pp)中定义的，然后重新定义TCustomForm在TForm。查找声明时，首先找到TForm，之后再查找时会跳转找到TControl。~~
658	740
659	741		像TColor类型，对于编译器它是一个简单的'longint'类型，但在源中其定义是：
660	742
661		-	~~`TGraphicsColor = -$7FFFFFFF-1..$7FFFFFFF;`\~~
662		-	~~`TColor = TGraphicsColor;`~~
	743	+	```text
	744	+	TGraphicsColor = -$7FFFFFFF-1..$7FFFFFFF;
	745	+	TColor = TGraphicsColor;
	746	+	```
663	747
664	748		和前向定义类类似，如TControl中，有一个私有变量
665	749
666		-	~~`FHostDockSite: TWinControl;`~~
	750	+	```text
	751	+	FHostDockSite: TWinControl;
	752	+	```
667	753
668	754		查找声明TWinControl，将跳到前向定义。
669	755
670		-	~~`TWinControl = class;`~~
	756	+	```text
	757	+	TWinControl = class;
	758	+	```
671	759
672	760		之后再跳转到真正实现部分
673	761
674		-	~~`TWinControl = class(TControl)`~~
	762	+	```text
	763	+	TWinControl = class(TControl)
	764	+	```
675	765
676	766		这样你就可以跟踪每个标识符或查找负载。
677	767
678	768		提示：
679	769
680	770		- 按 `Ctrl`+`H` 跳回来
681	771		- 查看所有跳转历史：查看菜单-\>查看跳转历史
682	772		- With a 5 button Mouse you can use the 2 extra buttons to go forward/backward between the visited points
683	773		- ~~用5键鼠标，可以使用2个额外的按钮来实现前进/后退光标位置~~
684	774
685	775
686	776		(你可以使用[[IDE Window: EditorMouseOptionsAdvanced\|高级鼠标选项]]来映射)
687	777
688	778		## 标识符自动完成
689	779
690	780		按`Ctrl`+`space`调用标识符自动完成，它将显示范围内的所有标识符提示。如：
691	781
692		-	~~` procedure TForm1.FormCreate(Sender: TObject);`\~~
693		-	~~` begin`\~~
694		-	~~` \|`\~~
695		-	~~` end;`~~
	782	+	``` pascal
	783	+	procedure TForm1.FormCreate(Sender: TObject);
	784	+	begin
	785	+	\|
	786	+	end;
	787	+	```
696	788
697	789		在begin和end间按`Ctrl`+`space`，IDE将分析你的代码，显示所有标识符列表。结果会被缓存，第二次调用时会很快。
698	790
699	791		Delphians注意：：Delphi称为代码完成。
700	792
701	793		像这些标识符'Write', 'ReadLn', 'Low', 'SetLength', 'Self', 'Result', 'Copy'等被内置到编译器里。 The identifier completion has a lot of these things built in as well. If you find one missing, just create a feature request in the bug tracker.
702	794
703	795		标识符自动完成，并没有完成所有关键字。所以，人不能用它来完成repe到repeat。对于这些你可以按`Ctrl`+`W`[[Lazarus IDE Tools/zh CN\|关键字自动完成]] 或 `Ctrl`+`J` [[Lazarus IDE Tools/zh CN\|代码模板]]。
704	796
705	797		自0.9.27后，标识符自动完成了，完成了些关键字。
706	798
707	799		Identifier completion shows even those identifiers, that are not compatible.
708	800
709	801		### 前缀
710	802
711	803		你可以使用一个单词或字母做为前缀，比如说：
712	804
713		-	~~` procedure TForm1.FormCreate(Sender: TObject);`\~~
714		-	~~` begin`\~~
715		-	~~` Ca\|ption`\~~
716		-	~~` end;`~~
	805	+	``` pascal
	806	+	procedure TForm1.FormCreate(Sender: TObject);
	807	+	begin
	808	+	Ca\|ption
	809	+	end;
	810	+	```
717	811
718	812		在Ca后使用标识符自动完成，将显示所有ca开头的标识符列表。
719	813
720	814		### 键
721	815
722	816		- 字母或数字：字符添加到源代码编辑器作为前缀，这将更新列表。
723	817		- 退格键：从前缀中删除一个字符，这将更新列表。
724	818		- Return: replace the whole word at cursor with the selected identifier and close the popup window.
725	819		- Shift+Return: as Return, but replaces only the prefix (left part) of the word at the cursor.
726	820		- 上/下键: 移动选择。
727	821		- ESC键: 不保存信息，关闭弹出对话框。
728	822		- Tab: completes the prefix to next choice. For example: The current prefix is 'But' and the identifier completion only shows 'Button1' and 'Button1Click'. Then pressing Tab will complete the prefix to 'Button1'.
729	823		- Else: as Return and add the character to the source editor
730	824
731	825		### 方法
732	826
733	827		当光标在类中定义方法时，使用标识符自动完成会添加相应参数并添加override关键字。例如：
734	828
735	829		``` pascal
736	830		TMainForm = class(TForm)
737	831		protected
738	832		mous\|
739	833		end;
740	834		```
741	835
742	836		完成的MouseDown：
743	837
744	838		``` pascal
745	839		TMainForm = class(TForm)
746	840		protected
747	841		procedure MouseDown(Button: TMouseButton; Shift: TShiftState; X,
748	842		Y: Integer); override;
749	843		end;
750	844		```
751	845
752	846		### 属性
753	847
754	848		``` pascal
755	849		property MyInt: integer read \|;
756	850		```
757	851
758	852		标识符自动完成，将显示FMyInt和GetMyInt。
759	853
760	854		``` pascal
761	855		property MyInt: integer write \|;
762	856		```
763	857
764	858		标识符自动完成，将显示FMyInt和SetMyInt。
765	859
766	860		### 引用部分/单元名称
767	861
768	862		In uses sections the identifier completion will show the filenames of all units in the search path. These will show all lowercase (e.g. avl_tree), because most units have lowercase filenames. On completion it will insert the nice case of the unit (e.g. AVL_Tree).
769	863
770	864		~~引用某些单元文件时，使用标识符自动完成，将显示它们的文件路径，文件名通常是小写的（像avl_tree），完成后，会插入像AVL_Tree一样的名称。~~
771	865
772	866		### 语句
773	867
774	868		``` pascal
775	869		procedure TMainForm.Button1Click(Sender: TObject);
776	870		begin
777	871		ModalRe\|;
778	872		end;
779	873		```
780	874
781	875		变为:
782	876
783	877		``` pascal
784	878		procedure TMainForm.Button1Click(Sender: TObject);
785	879		begin
786	880		ModalResult:=\|;
787	881		end;
788	882		```
789	883
790	884		## 关键字自动完成
791	885
792	886		按`Ctrl`+`W`键调用关键词自动完成。它显示了当前打开文件中的匹配到的关键词，你也可以在非Pascal源文件中使用，在注释中也可以使用。
793	887
794	888		否则，它的工作方式等同于标识符自动完成。
795	889
796	890		## Goto Include Directive
797	891
798	892		"Goto Include Directive" in the search menu of the IDE jumps to {\$I filename} statement where the current include file is used.
799	893
800	894		## 发布工程
801	895
802	896		创建项目副本。If you want to send someone just the sources and compiler settings of your code, this function is your friend.
803	897
804	898		一个项目目录包含了大量信息，很多是不需要再作公布：lpi文件包含了会话信息（像光标位置、单元书签），项目目录包含了ppu、o及可执行文件。
805	899
806	900		要发布工程，在工程菜单下使用发布工程。
807	901
808	902		注：0.9.13版本后，有了新的解决方法，它将会话信息存储在了以lps为扩展名的文件里，这样，当你发布时，lpi文件会清爽很多。
809	903
810	904		在对话框中你可以设置排除列表和过滤器，也可以完成后使用命令压缩成一个档案。
811	905
812	906		## 注释提示
813	907
814	908		在某些地方IDE将显示帮助提示。如，将鼠标移动在一个标识符上等待几秒钟，将显示与此标识符相关的提示信息。
815	909
816	910		IDE为了支持常见的注释、编程风格，通常会给予试探：
817	911
818	912		### 显示注释提示
819	913
820	914		注释声明中以\<开头（没有空行），将作为其上的提示：
821	915
822	916		``` pascal
823	917		var
824	918		{Comment}
825	919		Identifier: integer;
826	920		```
827	921
828	922		注释在\<之后。
829	923
830	924		与标识符同行的注释：
831	925
832	926		``` pascal
833	927		var
834	928		identifier, // Comment
835	929		other,
836	930		```
837	931
838	932		注释和定义在同一行：
839	933
840	934		``` pascal
841	935		var
842	936		identifier:
843	937		char; // Comment
844	938		```
845	939
846	940		\<示例：
847	941
848	942		``` pascal
849	943		const
850	944		a = 1;
851	945		//< comment for a
852	946		b = 2;
853	947		// comment for c
854	948		c = 3;
855	949		```
856	950
857	951		支持三种注释方式
858	952
859	953		``` pascal
860	954		{Comment}(Comment)//Comment
861	955		c = 1;
862	956		```
863	957
864	958		注释中\$和%将被忽略。
865	959
866	960		### 不显示注释信息
867	961
868	962		用空行分隔的注释，将不会用于提示显示。像下面的类头部注释将不会被显示：
869	963
870	964		``` pascal
871	965		type
872	966		{ TMyClass }
873	967
874	968		TMyClass = class
875	969		```
876	970
877	971		类头部注释创建于类完成时。你可以关闭这个功能：在工具菜单-\>选项中，代码工具-\>Class completion-\>类的头注释。如果你想显示这些提示，删除空行即可。
878	972
879	973		下面的注释，GL_TRUE将会显示提示，GL_FALSE不会：
880	974
881	975		``` pascal
882	976		// Boolean
883	977		GL_TRUE = 1;
884	978		GL_FALSE = 0;
885	979		```
886	980
887	981		---
888	982		From the Free Pascal wiki, page "Lazarus IDE Tools/zh CN", as it stood on 2023-01-25 after a change by Kai Burghardt, 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