Sign in Join
Wiki copytemporary

Lazarus IDE Tools/ja: what changed

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

Title: Lazarus IDE Tools/ja

OldNewLine
1+## 概要
2+
3+IDEは"コードツール"と呼ばれる、pascalソースの構文解析と編集のためのツールのライブラリを使用しています。これらのツールは宣言の探索、コード補完、抽出、pascalのソースの移動・挿入、美化といった機能を提供します。これらの機能は、多くの時間の節約につながり、効率を倍加させてくれます。これらはカスタマイズでき、どの機能もショートカットで利用できます(エディタオプションを見てください)。それらの機能はソースにのみ作用し、fpcやdelphiやkylixコードを解釈するだけなので、コンパイルされたユニットやBorlandコンパイラを必要としません。 あなたはDelphiとFPCコードを同時に編集できます。あなたはいくつかのバージョンのDelphiとFPCコードに同時に取り組むことさえできます。このことがDelphiコードの移植をより容易にします。
4+
5+## IDE ショートカットの要約テーブル
6+
7+| | |
8+|-------------------------|-----------------------------------------------|
9+| 宣言への移動 | Ctrl+Click or Alt+Up (型や変数の宣言への移動) |
10+| メソッドへの移動 | Ctrl+Shift+Up (宣言と本体との切り替え) |
11+| コードテンプレート | Ctrl+J |
12+| コード補完 (クラス補完) | Ctrl+Shift+C |
13+| 識別子補完 | Ctrl+Space |
14+| 語句補完 | Ctrl+W |
15+
16+## メソッドへの移動
17+
18+手続きの本体(begin..end)と手続き宣言(procedure Name;)の間の移動にはCtrl+Shift+Upを用いてください。 例えば: interface
19+
20+``` pascal
21+ procedure DoSomething; // procedure definition
22+
23+ implementation
24+
25+ procedure DoSomething; // 手続き本体
26+ begin
27+ end;
28+```
29+
30+カーソルが手続きの本体にあるときにCtrl+Shift+Upすると、カーソルが手続き宣言に移動します。もう一度 Ctrl+Shift+Upを押すと本体のbeginのあとに移動します。 この機能はメソッド（クラスの手続き）でも使えます。 ヒント: 'メソッドへの移動'は同じ名前と引数リストをもつ同じ手続きに移動します。もし合致する手続きがなければ最良の候補の中の最初に異なる部分に移動します。(Delphiユーザーへ: Delphiにはない機能です).
31+
32+異なる引数型をもつ手続きの例:
33+
34+``` pascal
35+ interface
36+
37+ procedure DoSomething(p: char); // procedure definition
38+
39+ implementation
40+
41+ procedure DoSomething(p: string); // 手続き本体
42+ begin
43+ end;
44+```
45+
46+宣言から本体に移動するとカーソルはキーワード'string'に移動します。これはメソッドの名称変更や引数の変更のさいに便利です。
47+
48+例： 'DoSomething'を 'MakeIt'に変更した場合:
49+
50+``` pascal
51+ interface
52+
53+ procedure MakeIt; // 手続きの定義
54+
55+ implementation
56+
57+ procedure DoSomething; // 手続きの本体
58+ begin
59+ end;
60+```
61+
62+このときMakeItから本体に移動します。IDEは一致する本体を探し、それが見付からないので候補を探します。あなたが名称変更した手続きは一つしかないので、宣言(DoSomething)のない本体はひとつしかなく、したがってDoSomethingに移動し、'DoSomething'のすぐ右側にカーソルが置かれます。ですからその名前も同様に変更すればいいわけです。この機能は引数についても同様です。
63+
64+## インクルードファイル
65+
66+インクルードファイルはコンパイラ指令{\$I filename} もしくは {\$INCLUDE filename} でソースに挿入されるファイルです。異なるプラットフォームをサポートするため、LazarusとFPCは、冗長になることを防ぎ、読みにくい{\$IFDEF}構造体を避けるためにインクルードファイルはコンパイラ指令を用いています。
67+
68+例えば、.pasファイルの中のメソッドからインクルードファイル内のメソッド本体へ移動できます。 コード補完のようなすべてのコードツールはインクルードファイルを特殊な拘束条件とみなします。
69+
70+例：コード補完がもうひとつのメソッド本体のうしろに新しいメソッドを追加すると、コード補完は双方を同じファイル内に保持します。このようにして、LCLがほぼ全てのコントロールにそうやって管理しているのと同様に、すべてのクラス実装をインクルードファイル内に置くことができます。 しかし、初心者が陥りやすい罠があります： インクルードファイルを最初に開き、メソッド移動もしくは定義検索をしようとすると、エラーが発生します。IDEはどのユニットにインクルードファイルが属するかを知りません。まず初めに対象とするユニットを開かなければなりません。
71+
72+IDEがユニットを構文解析するとすぐに、そこのインクルード指令を解釈し、IDEはこの関係を記憶します。IDEはこの情報を終了時やプロジェクト保存時に‾/.lazarus/includelinks.xmlに保存します。次にこのインクルードファイルを開き、移動や定義検索をしようとすると、IDEは内部的にそのユニットを開き、移動機能が作動します。
73+
74+このメカニズムにはもちろん限界があります。いくつかのインクルードファイルは2回かそれ以上インクルードされます。例： lcl/include/winapih.inc.
75+
76+このインクルードファイルの手続きもしくはメソッド定義からその本体への移動は直前の動作次第です。もしlcl/lclintf.ppに取り組んでいるのであれば、IDEはwinapi.incに移動します。もしlcl/interfacebase.ppを扱っているのであれば、IDEはlcl/include/interfacebase.inc (もしくはその他のインクルードファイル)に移動します。それらの両方に取り組んでいるのであれば...混乱してしまいますね ;)
77+
78+## コードテンプレート
79+
80+コードテンプレートは、ある識別子からあるテキストもしくはコードの断片に変換します。 コードテンプレートのデフォルトのショートカットはCtrl+Jです。識別子をタイプして、Ctrl+Jを押すと識別子は識別子に応じて設定されたテキストに置き換えられます。コードテンプレートは環境 -\> コードテンプレートで設定できます。
81+
82+例: 識別子'classf'を書き、カーソルをfのすぐ後ろに置いて、Ctrl+Jを押すと、'classf'は以下に置き換えられます。
83+
84+``` pascal
85+ T = class(T)
86+ private
87+
88+ public
89+ constructor Create;
90+ destructor Destroy; override;
91+ end;
92+```
93+
94+そしてカーソルは'T'の後ろに来ます。 カーソルを空白に置いて(識別子の上でなく)Ctrl+Jを押すとテンプレートのリストがポップアップで示されます。カーソルキーもしくはいくつかの文字をタイプしてその中のどれかを選択してください。リターンキーを押せば選択されたテンプレートが挿入され、Escでそのポップアップが閉じます。
95+
96+## コード補完
97+
98+コード補完はIDEメニューの編集 -\> コード補完で呼び出すことができ、標準ショートカットはCtrl+Shift+Cです。
99+
100+Delphiユーザーへ: Delphiでは"コード補完"と呼ばれている機能は、現在のソースの位置で(Ctrl+Space)すると識別子のリストが示されるもので、Lazarusでは"識別子補完"と呼ばれているものです。
101+
102+コード補完はいくつかの強力な機能を組み合わせたものです。例:
103+
104+- クラス補完: プロパティを補完し、メソッド本体を加え、プライベートな変数とアクセスメソッドを加えるものです。
105+- 前方手続き補完: 手続きの本体を加えます。
106+- イベント代入補完: イベント代入を補完し、メソッド定義と本体を加えます。
107+- 変数宣言補完: ローカル変数定義を加えます。
108+
109+どの機能が作動するかはエディタ内のカーソルの位置によります。
110+
111+### クラス補完
112+
113+最も強力なコード補完機能は「クラス補完」です。クラスとメソッドとプロパティを書くと、コード補完はメソッド本体とプロパティアクセスメソッド/変数とプライベートな変数を追加します。
114+
115+例えば: クラスを作成し、(タイピングを少なくするにはコードテンプレートを参照):
116+
117+``` pascal
118+TExample = class(TObject)
119+ public
120+ constructor Create;
121+ destructor Destroy; override;
122+ end;
123+```
124+
125+カーソルをクラスのどこかに置いてCtrl+Shift+Cしてみてください。メソッドのまだ書かれていない本体が作成され、カーソルを一番上の最初に作成されたメソッド本体に移動させますので、そのままクラスコードを書きはじめることができます:
126+
127+``` pascal
128+ { TExample }
129+
130+ constructor TExample.Create;
131+ begin
132+ |
133+ end;
134+
135+ destructor TExample.Destroy;
136+ begin
137+ inherited Destroy;
138+ end;
139+```
140+
141+注意: '\|'はカーソルを表し、文字は挿入されません。
142+
143+ヒント： Ctrl+Shift+Upでメソッドとその本体とを移動移動できます。
144+
145+IDEが'inherited Destroy'呼び出しを追加したことがわかりますね。これはもし'override'キーワードがクラス定義にあれば追加されます。
146+
147+ではDoSomethingメソッドを追加してみましょう:
148+
149+``` pascal
150+ TExample = class(TObject)
151+ public
152+ constructor Create;
153+ procedure DoSomething(i: integer);
154+ destructor Destroy; override;
155+ end;
156+```
157+
158+ここでCtrl+Shift+Cを押すとIDEは以下を追加します
159+
160+``` pascal
161+ procedure TExample.DoSomething(i: integer);
162+ begin
163+ |
164+ end;
165+```
166+
167+クラス定義と同じくCreateとDestroyの間に新しいメソッド本体が挿入されたのがわかりますね。このようにして本体はあなたが定義したのと同じ論理的順序で作成されます。挿入ポリシーは、環境 -\> コードツールオプション -\> コード作成で設定できます。
168+
169+**プロパティの補完** プロパティAnIntegerを加えましょう:
170+
171+``` pascal
172+ TExample = class(TObject)
173+ public
174+ constructor Create;
175+ procedure DoSomething(i: integer);
176+ destructor Destroy; override;
177+ property AnInteger: Integer;
178+ end;
179+Ctrl+Shift+Cを押すと、次のようになります:
180+ procedure TExample.SetAnInteger(const AValue: integer);
181+ begin
182+ |if FAnInteger=AValue then exit;
183+ FAnInteger:=AValue;
184+ end;
185+```
186+
187+コード補完はWriteアクセス指定子と数行の共通コードを追加しました。 新しいクラスを見るにはCtrl+Shift+Upでそのクラスに移動します。
188+
189+``` pascal
190+ TExample = class(TObject)
191+ private
192+ FAnInteger: integer;
193+ procedure SetAnInteger(const AValue: integer);
194+ public
195+ constructor Create;
196+ procedure DoSomething(i: integer);
197+ destructor Destroy; override;
198+ property AnInteger: integer read FAnInteger write SetAnInteger;
199+ end;
200+```
201+
202+そのプロパティにReadとWriteアクセス指定子が追加されています。そのクラスはFAnInteger変数と'SetAnInteger'メソッドを有する'private'という新しいセクションを得ました。 変数に接頭文字F、メソッドにSetを付けるのはDelphiの共通スタイル規則です。もしこれがお気に召さなければ、環境 \> コードツールオプション -\> コード補完でこれを変更できます。
203+
204+読み込み専用プロパティを作成する場合:
205+
206+``` pascal
207+property PropName: PropType read;
208+```
209+
210+が以下のように拡張されます。
211+
212+``` pascal
213+property PropName: PropType read FPropName;
214+```
215+
216+書き込み専用プロパティを作成する場合:
217+
218+``` pascal
219+property PropName: PropType write;
220+```
221+
222+が以下のように拡張されます。
223+
224+``` pascal
225+property PropName: PropType write SetPropName;
226+```
227+
228+Read メソッドを持つ読み込み専用プロパティを作成する場合:
229+
230+``` pascal
231+property PropName: PropType read GetPropName;
232+```
233+
234+これはそのままで、GetPropName関数が追加されます:
235+
236+``` pascal
237+function GetpropName: PropType;
238+```
239+
240+stored指定子を持つプロパティを作成する場合:
241+
242+``` pascal
243+property PropName: PropType stored;
244+```
245+
246+が次のように拡張されます。
247+
248+``` pascal
249+property PropName: PropType read FPropName write SetPropName stored PropNameIsStored;
250+```
251+
252+storedはストリーミングに用いられるため、readとwrite指定子が同様に自動的に追加されます。
253+
254+ヒント： 識別子補完は不完全なプロパティも認識し、デフォルトの名前を提案します。例:
255+
256+``` pascal
257+property PropName: PropType read |;
258+```
259+
260+カーソルを'read'キーワードより１スペース後ろに置き、Ctrl+Spaceを押すと識別子補完が作動します。識別子補完は変数'FPropName'と手続き'SetPropName'を提案します。
261+
262+### 前方手続き補完
263+
264+"前方手続き補完"はコード補完機能の一部で、不足している手続き本体を追加します。カーソルが前方に定義された手続き宣言の上にあるときに有効となります。
265+
266+例: 宣言部に新しい手続き宣言を追加します: procedure DoSomething; カーソルをその上に置き、Ctrl+Shift+Cを押してコード補完を呼び出すと、実行部が作成されます:
267+
268+procedure DoSomething; begin
269+
270+`  |`
271+
272+end; ヒント： Ctrl+Shift+Upでメソッドとその本体とを移動移動できます。
273+
274+新しい手続き本体がクラスメソッドの前に追加されます。もし宣言部に既にいくつかの手続きがあれば、IDEはその順序を維持しようとします。 例:
275+
276+``` pascal
277+procedure Proc1;
278+procedure Proc2; // 新しい proc
279+procedure Proc3;
280+```
281+
282+もしProc1とProc3の本体が既に存在すれば、Proc2の本体はProc1とProc3の間に挿入されます。この動作は環境 -\> コードツールオプション -\>コード作成　で設定できます。
283+
284+``` pascal
285+Multiple procedures:
286+ procedure Proc1_Old; // 本体が存在
287+ procedure Proc2_New; // 本体がまだない
288+ procedure Proc3_New; // "
289+ procedure Proc4_New; // "
290+ procedure Proc5_Old; // 本体が存在
291+```
292+
293+コード補完は３つの手続き本体 (Proc2_New, Proc3_New, Proc4_New)を追加します。
294+
295+なぜそれを前方手続き補完と呼ぶのでしょうか？
296+
297+なぜならそれは宣言部に定義された手続きにのみ作用するのではなく、"forward" 指定子をもつ手続きにも同様に作用するからです。そしてそのコードツールが宣言部内の暗黙の'forward' 指定子をもつ手続きを扱うからです。
298+
299+### イベント 代入補完
300+
301+"イベント代入補完"はコード補完機能の一部で、単一のイベント:=\| 文を補います。これはカーソルがイベントへの代入のすぐ後ろにあるときに呼び出されます。
302+
303+例: あるメソッド, 例えばFormCreateイベントで、'OnPaint:='という行を追加してみます:
304+
305+``` pascal
306+ procedure TForm1.Form1Create(Sender: TObject);
307+ begin
308+ OnPaint:=|
309+ end;
310+```
311+
312+'\|'はカーソルを表しており、タイプすべきものではありません。 ここでCtrl+Shift+Cと押してコード補完を呼び出します。その文は次のように補完されます。
313+
314+``` pascal
315+OnPaint:=@Form1Paint;
316+```
317+
318+新しいメソッドForm1PaintがTForm1クラスに追加されます。それからクラス補完が作動し、次のようになります:
319+
320+``` pascal
321+procedure TForm1.Form1Paint(Sender: TObject);
322+begin
323+ |
324+end;
325+```
326+
327+これはちょうどオブジェクトインスペクタでメソッドを追加するような動作です。
328+
329+注意: カーソルは':='代入の後ろに置いてください。カーソルをその識別子 (e.g. OnPaint)の上に置いた場合、 コード補完は"ローカル変数補完"を呼び出してしまいます（そしてそれは失敗します。なぜならOnPaintは既に宣言されているから）。
330+
331+ヒント： 新しいメソッド名をあなた自身で定義することもできます。例えば:
332+
333+` OnPaint:=@ThePaintMethod;`
334+
335+### 変数宣言補完
336+
337+"変数宣言補完"もコード補完の一部で、ローカル変数定義を識別子:=Term; 文に追加します。これはカーソルが代入識別子もしくは変数の上にある時に呼び出せます。
338+
339+例:
340+
341+``` pascal
342+procedure TForm1.Form1Create(Sender: TObject);
343+begin
344+ i:=3;
345+end;
346+```
347+
348+カーソルを i もしくはその後ろに置いてみて下さい。それからCtrl+Shift+Cを押してコード補完を呼び出すと次のようになります:
349+
350+``` pascal
351+procedure TForm1.Form1Create(Sender: TObject);
352+var
353+ i: Integer;
354+begin
355+ i:=3;
356+end;
357+```
358+
359+このコードツールはまず識別子 i が既に定義されているかどうかをチェックし、もしなかったら宣言 'var i: integer;'を追加します。識別子の型は代入 ':=' 演算子の右辺から推測されます。3のような数値はデフォルトでIntegerと判断されます。
360+
361+もうひとつの例:
362+
363+``` pascal
364+type
365+ TWhere = (Behind, Middle, InFront);
366+
367+ procedure TForm1.Form1Create(Sender: TObject);
368+ var
369+ a: array[TWhere] of char;
370+ begin
371+ for Where:=Low(a) to High(a) do writeln(a[Where]);
372+ end;
373+```
374+
375+カーソルをWhereの上に置き、 Ctrl+Shift+Cで コード補完を呼び出すと、次のようになります:
376+
377+``` pascal
378+ procedure TForm1.Form1Create(Sender: TObject);
379+ var
380+ a: array[TWhere] of char;
381+ Where: TWhere;
382+ begin
383+ for Where:=Low(a) to High(a) do writeln(a[Where]);
384+ end;
385+```
386+
387+0.9.11以降Lazarusは引数も補完できるようになりました。 例：
388+
389+``` pascal
390+ procedure TForm1.FormPaint(Sender: TObject);
391+ begin
392+ with Canvas do begin
393+ Line(x1,y1,x2,y2);
394+ end;
395+ end;
396+```
397+
398+カーソルをx1の上に置き、Ctrl+Shift+Cでコード補完を呼び出すと、次のようになります:
399+
400+``` pascal
401+ procedure TForm1.FormPaint(Sender: TObject);
402+ var
403+ x1: integer;
404+ begin
405+ with Canvas do begin
406+ Line(x1,y1,x2,y2);
407+ end;
408+ end;
409+```
410+
411+### コメントとコード補完
412+
413+コード補完はコメントをそれが属する場所に留めようとします。 例:
414+
415+``` pascal
416+ FList: TList; //TComponentのリスト
417+ FInt: integer;
418+```
419+
420+新しい変数をFListとFIntの間に挿入しようとすると、そのコメントはFListの行に保たれます。これは次のような場合にも同様です。
421+
422+``` pascal
423+ FList: TList; {TComponentのリスト
424+ これはFListの行から始まる数行に渡るコメントで、
425+ コードツールはこれがFListの行に属するものとして
426+ 扱い、この関係を壊しません。コードはこのコメントの
427+ 後ろに挿入されます。}
428+ FInt: integer;
429+```
430+
431+コメントが次の行から始まっている場合、それはそれがそれ以下のコードに属するものとして扱われます。 例:
432+
433+``` pascal
434+ FList: TList; // list of TComponent
435+ {このコメントはこれ以下に属します。
436+ 新しいコードはこのコメントの上で、
437+ FListの行の後に挿入されます。}
438+ FInt: integer;
439+```
440+
441+## リファクタリング
442+
443+### 逆代入
444+
445+要約 : "逆代入"はいくつかの選択された文を取り上げ、すべての代入を逆にします。このツールは保存用コードから読み込み用コードに変換する際に演算を逆にしたいときに便利です。
446+
447+例:
448+
449+``` pascal
450+ procedure DoSomething;
451+ begin
452+ AValueStudio:= BValueStudio;
453+ AValueAppartment :=BValueAppartment;
454+ AValueHouse:=BValueHouse;
455+ end;
456+```
457+
458+代入を行っている行(beginとendの間)を選択し、逆代入します。すべての代入は逆になりインデントが自動的に追加されます。 例の結果:
459+
460+``` pascal
461+ procedure DoSomething;
462+ begin
463+ BValueStudio := AValueStudio;
464+ BValueAppartment := AValueAppartment;
465+ BValueHouse := AValueHouse;
466+ end;
467+```
468+
469+### 手続きの抽出
470+
471+[[IDE Window: Extract Procedure|Extract Procedureを]]参照のこと
472+
473+## 定義検索
474+
475+カーソルをある識別子の上に置き、'定義検索'をすると、コードツールは識別子の宣言を検索し、そのファイルを開き、そこに移動します。
476+
477+定義検索は毎回移動位置をセットします。このことは定義検索で宣言に移動した後、検索-\>後方へ飛ぶ で簡単に戻れることを意味しています。 Delphiといくつか異なる点があります: コードツールは、コンパイラ出力を用いる代わりに通常のpascal規則に従ってソースに作用します。コンパイラは最終の型を返します。コードツールはソースを読み、その間でステップします。 例: *Visible* プロパティは初めにTControl (controls.pp)で定義され、TCustomFormで再定義され、さらにTFormで最終的に再定義されます。定義検索をVisibleについて呼び出すとまずTFormのVisibleが表示されます。それから再び定義検索を呼び出すとTCustomFormのVisibleが表示されます。さらに呼び出すとTControlのVisibleに移動します。
478+
479+TColorのような型についても同様です。 コンパイラにとってはそれは単なるlongintです。しかしソースには次のように定義されています。
480+
481+``` pascal
482+ TGraphicsColor = -$7FFFFFFF-1..$7FFFFFFF;
483+ TColor = TGraphicsColor;
484+```
485+
486+そして**前方定義クラス**についても同様です。 例えばTControlにprivate 変数
487+
488+``` pascal
489+ FHostDockSite: TWinControl;
490+```
491+
492+があります。TWinControlに対する定義検索は前方定義
493+
494+``` pascal
495+ TWinControl = class;
496+```
497+
498+そしてそれを再び呼び出すと実装の
499+
500+``` pascal
501+ TWinControl = class(TControl)
502+```
503+
504+に移動します。このようにすべての識別子について追跡でき、すべてのオーバーロードを見つけることができます。
505+
506+**ヒント:** Ctrl+Hで元の位置に戻れます。
507+
508+## インクルード指令に行く
509+
510+IDEの検索メニューの"インクルード指令に行く"は現在のインクルードファイルが用いられている{\$I filename}文に移動します。
511+
512+## プロジェクトの発行
513+
514+プロジェクト全体のコピーを作成します。誰かにコードのソースとコンパイラ設定だけを送りたいときにはこの機能はとても便利です。
515+
516+通常のプロジェクトディレクトリは多くの情報を含んでいます。そのほとんどは発行する際には不要です。 .lpiファイルは (キャレット位置や閉じられているユニットのブックマークのような)セッション情報を含んでおり、プロジェクトディレクトリは多くの.ppu、.oファイルと実行ファイルを含んでいます。 すべてのサブディレクトリとともに基本的な情報のみを含むlpiファイルとそのソースのみを作成するには、"プロジェクトを発行する(パブリッシュプロジェクト)"を使ってください。
517+
518+**注意**: バージョン0.9.13以降、セッション情報を通常の.lpiファイルとは別個のファイルに記録できる新しい*プロジェクトオプション*ができました。この新しいファイルは.lps拡張子で終わりセッション情報のみを含んでおり、.lpiファイルをより簡潔にすることができます。
519+
520+そのダイアログで除外および包含フィルタを設定でき、そのコマンドにより出力を一つのアーカイブに圧縮することができます。
521+
522+## Original contributors
523+
524+This page has been converted from the epikwiki [version](http://lazarus-ccr.sourceforge.net/index.php?wiki=LazarusIdeTools).
525+
526+- Created page and initial template - 4/6/2004 VlxAdmin
527+- Initial content posted - 4/10/2004 MattiasG
528+- Small wiki and formatting fixes - 4/11/2004 VlxAdmin
529+- Added a summary table for IdeTools shortcuts - 12 July 2004 User:Kirkpatc
530+
531+---
532+*From the Free Pascal wiki, page "Lazarus IDE Tools/ja", as it stood on 2024-03-18 after a change by Ariben, 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