Difference between revisions of "Lazarus Tutorial/zh CN"

From Lazarus wiki
m (公共属性)
m (事件动作)
Line 680: Line 680:
==== 事件动作 ====
==== 事件动作 ====
Many actions are commonly listed in the 'Events' tab of the Object Inspector. If you select an entry in the list, a ComboBox appears with a DropDown list showing any actions that have aleady been defined, and allowing you to choose one to be associated with this event. Alternatively you can select the ellipsis (three dots ...) and you will be taken to an area of the Source Editor where you can begin typing your own action instructions for the selected event.
While a large number of events is available for any given control, in practice it is only necessary to populate a few of them. For most controls, it is sufficient to provide coding for 'OnClick'; for more complex controls it may be necessary also to provide for 'OnEntry' (when the mouse cursor enters the Control and gives it focus) and 'OnExit' (when the mouse cursor leaves the Control; or you may need to write an event handler for 'OnChange' or 'OnScroll', depending on the nature of the particular control with which you are dealing.
The pop-up menu that appears when you right-click an object in the Form Designer has, as its first item: 'Create default event' and selecting this option will have the same effect as selecting the ellipsis in the Object Inspector for the default event, usually OnClick: you are taken to the Implementation area of the Source Editor where you can type the code for the event handler.
A common strategy in Object-Oriented programming is to provide an '''ActionList''' with the facility for entering, removing or editing a number of pre-defined actions from which the most appropriate can be selected to use in any particular instance.
在窗体设计器上右击控件 ,“创建默认的事件“也有相同的效果,通常是OnClick(点击)事件。之后在源代码编辑器里编写相应操作。
在面向对象程序设计中,使用 TActionList 组件是为了集中处理许多常用的操作,把用户界面和应用逻辑分开,减少程序的代码行数,方便程序的维护和调试。它用于维护一系列动作列表,以供其他组件或控制所使用,如菜单和按钮。
   <caption><b>Some commonly listed Actions</b></caption>
     <td>Action to be taken if any change is detected (eg mouse move, mouse click, key press, edit text, alter picture, etc)</td>
     <td>Action to be taken when the (first, usually left) mouse button is clicked. This is commonly the main or default action of the control; for example clicking on a button or checkbox initiates the action associated with the checkbox. It may alternatively initate a process of selection, for instance in a TextBox or Memo, or signal the beginning of painting with a Pen or Brush.</td>
     <td>A method to emulate in code the effect of clicking on a control. This method is most often found in Button-type controls (TButton, TBitBtn, TSpeedButton etc). A procedure can be written that calls the same code as the OnClick action. This facility can be particularly useful if the activation of one control by clicking causes a cascade of other controls to be activated, and the Click method can be used to initiate the action rather than having the user explicitly click on a lot of controls.</td>
     <td>Action to be taken during Drag-Drop manoeuvres, ie when the mouse is used to 'capture' an item or some text etc and move it around the screen to a new location.</td>
     <td>Action to be taken when the user has finished all edits/modifications to the control. This is often used to validate the control content (e.g. check if an entered text is a valid IP address)</td>
     <td>Action to be taken when the mouse cursor enters the area occupied by the object, usually transfering focus to that object. This might include changes in the appearance of the object such as highlighting or raising the border.</td>
     <td>Action to be taken when the mouse moves out of the area of the object, usually transferring focus out of the object.</td>
     <td>Action to be taken for any key-press. Subtly different from OnKeyDown, which simply responds to a key being down, whether or not it was already down when focus was given to this control. OnKeyPress requires that a key becomes pressed while focus is in this control.</td>
     <td>Action to be taken if a key is down while focus is in this control. Subtly different from OnKeyPress - for example the key might already have been down when focus entered this control, whereas OnKeyPress requires the key to become pressed while focus is in the control.</td>
     <td>Action to be taken if a key is up (ie not pressed) while focus is in this control.</td>
     <td>Action to be taken if the mouse cursor moves while focus is in this control.</td>
     <td>Action to be taken if the mouse button is down while focus is in this control.</td>
     <td>Action to be taken if the mouse button is up while the cursor is over this control. Implies that the mouse button was previously down and has been released. The case where the cursor enters the control but the mouse button has not yet been pressed is covered by OnEntry or OnMouseEnter.</td>
     <td>Action to be taken when the control is resized. Might include re-alignment of text or selection of a different font size etc.</td>

Revision as of 03:47, 23 January 2014

Deutsch (de) English (en) español (es) suomi (fi) français (fr) magyar (hu) italiano (it) 日本語 (ja) македонски (mk) Nederlands (nl) português (pt) русский (ru) slovenčina (sk) shqip (sq) 中文(中国大陆)‎ (zh_CN) 中文(台灣)‎ (zh_TW)



Lazarus是一个自由并且开源的RAD(快速应用开发)开发工具,它基于同样自由开源的FreePascal(object pascal)编译器。Lazarus IDE(screenshot)可以创建独立的(原文是self-standing,我不确认是否准确)的图形或控制台程序,同时稳定并且富于特色.目前可以运行在Linux, FreeBSD和Win32平台下,同时提供可自定义的源代码编辑器,包含包管理器的可视化GUI设计环境,以及完整地集成在GUI环境中的调试器和FreePascal编译器。

起点 - 你的第一个Lazarus程序!




首先,如果你的Lazarus是全英文的,那么你可以通过主菜单上的Environment -> Environment Options打开环境设置窗口,在Desktop标签下有Language选项,改成Chinese (zh_CN),确定后重新启动下Lazarus,大部分界面就是中文的了。

注:对于linux用户,Lazarus的默认编译/安装很大可能是使用GTK1库(非常容易辩认...因为非常丑...),GTK1对于Unicode的支持不完善,无法显示中文,你可以使用GTK2重新编译Lazarus,具体方法请参照Quick start: Recompile the IDE



 procedure TForm1.Button1Click(Sender: TObject);
   {你的光标将位于这里,请输入后面的代码:}    Button1.caption := 'Press again';



 procedure TForm1.Button2Click(Sender: TObject);
 {输入:}   Close;



尝试下点击Press按钮,你会发现按钮的标签变成了"Press again"。之后你再怎么按,它依然显示"Press again"。


现在你应该保存你的工作了(你应该经常这么做!),选择顶部主菜单上的" 工程 > 保存工程 "来保存工程文件。






 procedure TForm1.Button1Click(Sender: TObject);
   if Button1.tag =0 then
     Button1.caption := 'Press again';
     Button1.tag := 1
   end else
     Button1.caption := 'Press';
     Button1.tag := 0



如果你准备编写控制或者基于文本的Pascal程序(例如你正在使用一份基本的Pascal指南,准备编写在控制台环境下运行的程序,以及为系统底层编程等等),你依然可以使用Lazarus编写,编译并且运行你的程序。Lazarus是一个理想的Pascal开发环境。具体请参照Console Mode Pascal.



首先,在桌面顶部有一个窗口,标题是Lazarus 编辑器 vxxxx - project(这会随着你当前打开的工程名字而改变)。这是你工程的主要控制窗口,包括主菜单和组件面板。

Screenshot-Lazarus 编辑器 v0.9.24 测试版 - project1.png






Screenshot-Lazarus 源代码编辑器2.png








Screenshot-工程浏览 - project1.png





主菜单包括如下内容: File(文件) Edit(编辑) Search(查找) View(查看) Project(项目) Run(运行) Components(构件) Tools(工具) Environment(环境) Windows(窗口) Help(帮助)



  • 新建单元: 创建一个新的单元文件(Pascal 源代码).
  • 新建窗体: 创建一个新的窗体: 提供可视化窗口以及Pascal源代码.
  • 新建 ...: 弹出一个对话框,(screenshot) 可以选择各种类型的文档进行创建。
  • 打开: 弹出一个对话框,可以浏览文件,并选择文件打开。
  • 重新打开: 放弃你对打开文件所进行的编辑,恢复到该文件的初始状态。
  • 打开最近的文件: 列出你最近编辑的文件, 让你从中选择一个。
  • 保存: 保存当前文件, 使用其当前文件名,如果该文件未命名, 系统将提示你取一个(类似于另存为)。
  • 另存为: 允许您选择一个目录和文件名保存当前文件。
  • 全选: Lazarus翻译成“全选”,个人认为翻译成“全部保存”更好一点,顾名思义,将所有文件都保存下来。
  • 关闭: 关闭当前文件, 提示你是否保存已编辑过的文件。
  • 关闭所有编辑器中的文件: 关闭当前文件编辑器中所有的文件,提示保存已编辑的文件。
  • 清除目录: 提供可编辑的过滤器,从目录中清除项目临时文件。
  • 打印: 打印当前文件。该菜单某默认不显示,你需要安装 $Lazdir/components/printers/design/printers4lazide.pas,并重新编译IDE。
  • 重启: 退出并重新启动Lazarus。
  • 退出: 退出Lazarus,会提示你保存所有修改过的文件


  • 撤销: 撤销最后一次操作, 返回到上一步操作时状态。
  • 重做: 重新最后的操作,取消撤销。
  • 剪切: 删除选定的文本或其他项目,并将其放置在剪贴板中。
  • 复制: 复制选定的文本
  • 粘贴: 将剪贴板中文本复制到光标位置,如果光标位置有选定文本,剪贴板中的内容将取代所选文本。
  • 缩进所选: 将光标所选内容安装Lazarus设置缩进(环境->Options->Editor->普通->代码折叠)。这个将你的Pascle代码格式化,使之结构整齐。
  • 取消所选缩进: 删除你所选文本一个级别的缩进。
  • 封装所选: 提供一个窗口列表出一些逻辑上可以封装所选文本,如(begin ... end; try ... except; try ... finally; repeat ... until; { ... } 等等).该功能可以将所选代码包含在begin ... end;或者其他所选的块结构中.
  • 转换所选为大写: 转换选择的文本为大写.
  • 转换所选为小写: 转换选择的文本为小写.
  • 制表符转为空格: 将选择文本中的制表符转换为空格。在Environment -> Editor options -> General -> Tab widths中可以设置制表符宽度。
  • 选中节自动换行: 如果选择的内容所在行超出80个字符将不再显示,使用此功能,将会换行显示,Environment -> Editor options -> Display -> Right Margin, 设置显示宽度。
  • 注释选择: 注释选中的文本,即在行前加 // 。
  • 取消注释: 移除注释信息。
  • 排序所选: 排序所选内容,按字母顺序、区分大小写等等,在列表中对分类进行排序,它将非常有用。
  • 选择: 允许选择文本块、所有、到括号、段落、行、单词等。
  • 从字符映射表插入: 允许插入非键盘符号,如重音字符。
  • 插入文本: 弹出菜单,允许插入标准文本,如CVS关键字(作者、日期、标题等)或GPL信息,用户名或当前时间与日期。
  • 自动完成代码: 它可以节省你很多时间,在你获取或设置属性时,或使用方法时,你可以得到相关提示。在事件中加入方法,可参见Lazarus IDE工具
  • 解析过程: 使用选定文本(一条语句或多条),以创建一个新的过程。


SearchMenu zh CN.png
  • 查找: 和大多编辑器一样,弹出一个搜索对话框,输入要搜索的内容,可以按大小写、全字匹配、范围、方向等查找。
  • 查找下一个, 查找上一个: 向上或向下再次搜索指定内容。
  • 在文件中查找: 在文件中搜索指定内容:在弹出的对话框中设置参数,可以按打开的文件,设定的目录,及筛选文件来查找。
  • 替换: 等同于 查找; 在弹出的替换对话框中,输入要搜索及要替换的内容。可以按区分大小写的方式,向上或向下进行替换操作。
  • 增量搜索: 高亮显示你搜索的字符串。如,选择增量搜索后,你按L后,将会高亮L显示,如果你再按A,编辑器会查找下一个LA并高亮显示。
  • 转到行: 移动光标到指定行。
  • 跳转到后一个:跳转到原来的位置。IDE会记录你的光标位置,根据它来决定你跳转或返回位置。
  • 跳转到前一个: 跳转到下一个位置。跳回来。
  • 添加跳转点到历史: 添加跳转位置到历史记录。
  • 查看跳转历史: 查看跳转点:功能未实现
  • 跳转到下一错误, 跳转到上一错误: 跳转到上一个或下一个错误处。
  • 设置一个自由书签:标记当前光标所在位置用作书签。在源文件中点击右键,在弹出来的菜单中跳到书签切换书签进行跳转操作。
  • 跳转到下一书签, 跳转到上一书签: 跳转到下一个或上一个书签。
  • 查找代码区段结束: 如果定位在beign处,则找到相应的end处,反之亦然。
  • 查找代码区段开始: 移动光标到过程或函数的begin处。
  • 在光标处查找声明: 查找选择的标识符被声明的地方,如文件没有被打开(如果是一个过程或函数的声明,如classesh.inc),将会被打开。
  • 在光标处打开文件名: 如果选择的内容是文件,将会打开它。你可以看看单元中引用的文件。
  • 前往包含指示处: 如果光标定位在包含的文件处,那么将打开包含的文件。
  • 查找标识符参考: Produces a list of all the lines in the current file, or the current project or all attached files, in which an identifier is mentioned. (显示包含标识符的过程(函数)列表。)
  • 重命名标识符: 允许开发人员重命名一个标识符。
  • 过程列表: 显示当前文件中定义的过程(函数)。


ViewMenu zh CN.png


  • 对象观察器: 通常显示在编辑器的左侧,它显示了控件的属性选项。用鼠标选择列表中的控件,会显示它们的属性信息。也可以在窗体中选择控件来改变它们的属性值。

主面板中的标签“属性”:用来改变控件显示属性,如名称、颜色,标题、字体、大小等(两列中,左侧为属性,右来输入或选择属性值)。 “事件”:列表控件允许的事件,如点击、双击等。点击...在源代码编辑器中编写相应事件。 “常用”:显示常用的属性和事件列表(你也可以右击属性,也添加到“常用”中)。 “限制“,控件在各平台中的支持情况。

  • 源代码编辑器: 编辑源代码的地方。和大多图形化文本编辑器一样,可以使用鼠标定位输入位置,并支持高亮代码。右击将弹出菜单,通常包含:复制、剪切、粘贴功能。源代码编辑器顶部可多个选项卡,你可以单击来切换不同的源文件来编辑它。源代码编辑器支持缩进和语法高亮,你可以在“Environment”->"Editor"中设置相应参数。
  • 代码浏览器: 以树形方式显示定义的信息。“显示类别“:它通常只显示名称、接口部分与实现部分的定义。点击+展开显示更多。直到具体的常量、类型、变量及过程、函数的声明。如果修改了源代码,你需要点击“刷新”,来刷新文件结构。
  • 单元...:显示单元文件,显示包含的文件,并可以编辑它。允许显示多个文件,同时打开并编辑它。
  • 窗体...: 显示当前窗体列表,允许选择一个或多个。
  • 查看单元信赖关系: 以树状形式显示单元文件的信赖关系。
  • 切换窗体/单元 视图 F12: 切换源代码编辑器和窗体。你也可以按F12键来切换。
  • 消息:显示编译器消息,编译进度或编译错误的信息。
  • 查找结果: 显示找到文件的结果。
  • 调试窗口: 在子菜单中选择用于操作和配置的调试器。具体可以参看调试器


ProjectMenu zh CN.png
  • 新建工程...: 在弹出的对话框中,选择工程类型,以创建一个新工程。
  • 从文件新建工程...: 打开“选择程序源代码”窗口,选择一个文件,以创建新的项目。
  • 打开工程... 打开“打开工程文件(*.lpi)”窗口,选择一个工程文件,以打开工程。
  • 打开最近的工程...: 显示最近打开的工程列表,以供选择。
  • 保存工程: 等同于“文件”->“保存”,将当前工程文件全部保存,如果工程文件未保存,将提示保存它。
  • 工程另存为...: 输入工程名后,另存工程,默认工程名为Project1.lpi;Lazarus不允许你使用相同名称做为项目文件、单元文件名。(参见 下文)。
  • 发布工程...: 创建整个项目的副本。一个正常的项目目录包含了大量信息,大部分不需要再作发布:lpi文件包含会话信息(如光标位置,单元标签等),项目目录也包含了很多ppu、o及可执行文件。此功能在对话框中你可以设置过滤器排除掉那些无用的文件;也可以使用命令压缩为一个文件。参见 Lazarus IDE 工具
  • 工程浏览器: 以树状列出当前工程包含的文件及需要的包,你可以删除,或打开选择的文件,也可以添加文件到工程。
  • 工程选项...: 配置工程,在这里,你可以设置程序标题,目标文件名等详细信息。
  • 编译器选项 ...: (Recently moved here from the Run Menu). Opens a multi-page tabbed window which allows configuration of the compiler. Tabs include Paths which allows definition of search paths for units, include files, libraries etc, as well as allowing choice of widget type for the forms (gtk, gnome, win32); Parsing which allows choice of rules for parsing source programs, Code which allows choice of optimisation for faster or smaller programs, choice of target processor, types of checks, heap size etc; Linking allowing choice of whether or how to use debugging, static or dynamic libraries, and whether to pass options through to the linker; Messages to define what type of messages should be generated during error conditions; Other which allows decision to use default configuration file (fpc.cfg) or some other file; Inherited which shows a tree structure diagram to indicate how options have been inherited from units already incorporated; Compilation which allows definition of commands to be executed before or after the compiler is launched and can allow use of Make files.
  • 添加代码编辑器中的文件到工程: 添加文件到当前项目。
  • 从工程中移除...: 在弹出的窗口中,选择文件,以从当前工程中移除。
  • View Source: 显示代码编辑器。
  • 显示 ToDo 列表:显示与此项目有关的待办事项。它将列出项目中的TODO注释(//TODO)。

新版本(如1.0.14),Ctrl+Shift+T键,在当前位置添加一个TODO。格式如// TODO : 待办说明。


RunMenu zh CN.png
  • 构建: 构建(即编译)项目。
  • 构建所有: 编译项目中所有的文件。
  • 中止构建: 停止构建,一旦它运行——停止时会造成一些异常,如IDE失去响应。(你需要在任务管理器中关闭IDE进程)
  • 运行: 常用的方式编译程序,如果成功将开始运行程序;实际情况时,Lazarus保存编辑的文件,启动编译器和链接器。最后执行链接后的可执行程序。
  • 暂停: 暂停执行当前正在运行的程序,这样你可以检查调试输出。通过“运行”可进行恢复。
  • 单步进入: 与调试器配合使用,程序一步一步的执行。
  • Step over: Causes stepwise execution up to the statement marked, then skips the marked statement, and continues execution at normal speed. Useful in trying to isolate a statement that introduces a logical error.
  • 运行到光标处: 执行到光标所在位置,然后停止。通过“运行“恢复程序继续执行。
  • 停止: 停止当前正在运行的程序。无法通过“运行”恢复,这将再次启动程序。
  • 带参数运行: 打开“带参数运行”窗口,将参选参数传递给程序。你可以选择一个运行终端(如X终端);一些系统环境变量可以被覆盖。



"xterm: Can't execvp /usr/share/lazarus//tools/runwait.sh: Permission denied".(大意为:权限不足。) 

如果出现这种情况,你需要设置程序的拥有可执行权限(如使用 chmod +x 文件名);程序启动后,程序的所有输入/输出都将在控制台中显示。

程序执行完毕,“Press Enter”显示在屏幕上,这时,程序之前的输入/输出都将在屏幕上显示,直至你按 Enter关闭控制台窗口。

注意: 作为当前版本,对Windows用户,没有控制台命令。直到Lazarus团队的adressess说,下面一行应该工作(on WinXP -- someone please update for other Windowses)

C:\Windows\system32\cmd.exe /C ${TargetCmdLine}

参见Pascal 控制台模式的单独教程。

  • 重置调试器: 恢复调试器到最初状态,这时候,变量、断点的值都将重置。
  • 构建文件: 编译(构建)当前文件。
  • 运行文件: 编译、链接并执行当前文件。
  • 配置 编译+运行 文件: 打开“配置构建”窗口,进行构建设置。

--Feibaicamel 14:28, 31 12月 2009 (CET)


PackageMenu zh CN.png

  • 打开包文件: 打开包文件。

  • 打开最近的包: 打开最近使用的包。

  • 将活动单元添加到包: 将单元文件添加到包中。

  • 包关系图: 显示当前正在使用的软件包关系图(如果你没有使用其他包,将显示Lazarus包和FCL及LCL包。)

  • 配置已安装的包:如果你已经创建了一些组件,此项允许你配置它们。



ToolsMenu zh CN.png
  • 配置外部工具: 允许用户添加各种外部工具(通常是宏)。

  • 快速语法检查: 非实际编译任何源文件,只进行语法快速检查。在开发大的或复杂的程序时,使用此项将节省你的时间;因为编译代码时错误是不可避免的。

  • 猜测未关闭的块: 这是个有用的工具,假设你的一个复杂的嵌套块,缺少end块,使用此项功能可能会帮到你。

  • 猜测错位的IFDEF/ENDIF: 如果你有一个复杂的嵌套,缺少或错位endif时,此项功能会帮到你。

  • 生成资源字符串: Makes the selected string a resource string by placing it in the resourcestrings section. An advantage of resource strongs is you can change them without the need to recompile your project!

  • 比较Diff: 允许两个文件进行比较(通常是文件的不同版本)。允许设置一些选项进行比较。

  • 在编辑器中检查LFM文件: 检查lfm文件。

  • 构建Lazarus: 重新构建Lazarus,按下按钮,等待构建。(在消息窗口会有状态显示。)

  • 配置 ”构建Lazarus: 允许用户确定Lazarus哪部分重建,以及如何重建。如,你可以重建LCL,或一些小部分,你可以选择目标系统,并指定不同目录。
  • 重新扫描FPC源代码目录: 如果改变了环境目录,可以使用此功能让Lazarus重新扫描源目录。如果扫描失败,你需要检查“工具”->“选项”中配置FPC源目录。及重新扫描FPC源代码目录。


在Lazarus 1.0.14版中,通过"工具"->"选项",可以打开IDE设置窗口。 在这里你可以对环境、编译器、JCF格式设置、代码工具、代码管理器、调试器、帮助等信息配置。

IDE Options zh CN.png
  • 环境
    • 文件:最大记录工程数、文件数及设置Lazarus目录、编译器路径、FPC源代码目录、Make文件目录等等。
    • 桌面:设置IDE语言、自动保存信息等等。
    • 窗口:可对窗口位置、终端输出进行相应设置。
    • 窗体编辑器:对颜色、风格等设置。
    • 对象查看器:对颜色、速度等设置。
    • 备份:工程文件备份设置,其他文件备份设置。
    • 命名:对Pascal后缀、可疑文件动作、自动重命名Pascal文件为小写、单元被重命名,更新引用等等配置。
    • FPDoc编辑器:配置FPDoc。
    • 文件筛选:对单元、工程、窗体、包、其他文件设置筛选器。
  • 编辑器
    • 普通:允许设置撤销/重做次数、滚动方式、缩进与制表符、光标等设置。
    • 显示:设置边界和边缝及默认编辑器字体。
    • 键盘映射:快捷键设置。
    • 鼠标:对鼠标操作进行相应设置。
    • 自动化功能:对自动补充信息进行设置。
    • 代码折叠:对代码折叠相关进行配置。
    • 隔离区绘制:代码块间线条设置。
    • 页和Windows:暂无。
  • JCF格式设置
    • 文件格式:暂无。
    • obfuscate:暂无。
    • clarify:暂无。
    • preprocessor:暂无。
  • 代码工具
    • 普通:方法跳转、工程附加源文件路径等设置、pascal源文件缩进设置。
    • 类完成:类、方法部分插入方式及属性自动完成配置。
    • 创建代码:插入过程策略、新单元添加到uses部分等配置。
    • 单词:设置关键字策略、标识符规则及例外等。
    • 分割行:可设置最大行宽、不拆分前面、后面行的条件。
    • 空格:空格插入方式,在关键字、标识符等前或后插入空格。
    • 标识符自动完成:设置标识符自动完成条件,如添加分号时。
  • 代码管理器
    • 更新:设置优先表现模式(分类、源代码),自动刷新条件及跟随光标。
    • 种类:设置只在类模式中使用变量、常量、引入、定义等。
    • 代码观察器:对代码观察器进行一些配置。
  • 调试器
    • 普通:可设置调试器类型和路径调试器特殊选项等。
    • 事件日志:对消息窗口进行设置,如错误时显示的颜色等。
    • 语言异常:设置忽略哪些异常,如 中止、代码工具错误、Fopen错误。并允许添加忽略。
    • 操作系统异常:设置操作系统异常处理方式。
  • 帮助
    • 帮助选项:设置FPC HTML文件路径、默认查看器等。
    • 外部:对外部程序进行配置,如Windows、PostgreSQL、Gtk2配置名称、单元文件及位置。并允许添加外部程序。


WindowMenu zh CN.png



HelpMenu zh CN.png


  • 在线帮助 在打开的浏览器窗口中,显示FPC和Lazarus的帮助链接。
  • 配置帮助 (1.0.14没有此菜单项)在弹出的菜单中,设置Lazarus帮助信息。目前,在默认情况下,鼠标选中关键字,按F1键盘,将会显示与此关键字相关的帮助信息。
  • 关于 Lazarus 显示一个弹出式窗口,里面有一些关于Lazarus的信息。


We need contributions from anyone who feels able to provide them: the WiKi is very easy to edit.(我们需要从任何人那里得到帮助:编辑维基很容易


ButtonBar zh CN.png









Component Palette Standart.png
通常使用的组件: TMainMenu, TPopupMenu, TButton, TLabel, TEdit, TMemo, TToggleBox, TCheckBox, TRadioButton, TListBox, TComboBox, TScrollBar, TGroupBox, TStaticText, TRadioGroup, TCheckGroup, TPanel, TActionList
Component Palette Additional.png
更多经常使用的组件: TBitBtn, TSpeedButton, TImage, TShape, TBevel, TPaintBox, TNotebook, TLabeledEdit, TSplitter, TMaskEdit, TCheckListBox, TScrollBox, TApplicationProperties, TStringGrid, TDrawGrid, TPairSplitter
Component Palette Common Controls.png
TTrackBar, TProgressBar, TTreeView, TListView, TStatusBar, TToolBar, TUpDown, TPageControl, TImageList
Component Palette Dialogs.png
TOpenDialog, TSaveDialog, TSelectDirectoryDialog, TColorDialog, TFontDialog, TOpenPictureDialog, TSavePictureDialog, TCalendarDialog, TCalculatorDialog





  • 杂项组件
Component Palette Misc.png
TColorButton, TSpinEdit, TArrow, TCalendar, TEditButton, TFileNameEdit, TDirectoryEdit, TDateEdit, TCalcEdit, TFileListBox
  • 数据组件
Component Palette DataControls.png
数据组件,通常用于数据库: TDBNavigation, TDBText, TDBEdit, TDBMemo, TDBImage, TDBListBox,TDBComboBox, TDBCheckBox, TDBRadioGroup, TDBCalendar, TDBGroupBox, TdbGrid
  • 数据访问组件
Component Palette DataAccess.png
  • 系统组件
Component Palette System.png
TTimer, TIdleTimer, TProcess
  • SynEdit(编辑器组件
Component Palette SynEdit.png
SynEdit是一个高级的文本编辑器控制,对Borland的Delphi,Kylix、C++Builder等支持语法高亮和代码自动完成,并支持输出为HTML、Tex和RTF。这是一个VCL/CLX控件,意味着,适用于Microsoft的Windows,没有信赖的运行库,SynEdit作为跨平台组件,也是Lazarus IDE中的编辑器组件。 查看 sourceforge上的synedit. TSynEdit, TSynAutoComplete, TSynExporterHTML, TSynMacroRecorder, TSynMemo, TSynPasSyn, TSynCppSyn, TSynJavaSyn, TSynPerlSyn, TSynHTMLSyn, TSynXMLSyn, TSynLFMSyn, TSynUNIXShellScriptSyn, TSynCssSyn, TSynPHPSyn, TSynTeXSyn, TSynSQLSyn, TSynMultiSyn











Form1.Button1.Height := 48;



  • 通过鼠标在窗体上调整
  • 通过设置对象观察器中的值
  • 通过代码来设置属性




If the description of a property on that page is insufficient, you can navigate to the corresponding description in the ancestor classes, by selecting the links in the Inheritance listing or by selecting the ancestor Type in the declaration of the object.

Action 行动 与对象关联的主要动作或事件。如,在选择“退出”时,会导致“关闭”。
Align 对齐 定义与父对象对齐方式。alTop:顶对齐;alBottom:底对齐;alLeft、alRight:左对齐和右对齐;alNone:无;alClient:占用父对象所有空间。
Anchor 用于保持控件的父控件;当父控件调试大小将调整与其距离。[akBottom,akRight]将保持固定在父控制右下角距离。
AutoSelect 自动选择 为True时,控件在获取到焦点,或当按下 Enter键时选择所有文本。
AutoSelected 自动选中 True indicate that the edit or combobox control has just performed an AutoSelect operation so that subsequent mouse-clicks and keystrokes proceed normally without selecting the text.
BorderSpacing 边框间距 The space around the edge between an Anchored control and its parent.
Caption 标题 设置显示内容,如按钮标题为“关闭”或“执行”。默认情况下,标题名称与Name属性值相同。
CharCase 字符显示 设置字母在编辑控件中显示方式:Normal:正常(不改变字母大小写);ecLowerCase:转换为小写;ecUppercase:转换为大写。
Constraints 限制 设置控件最大、小、高、宽度。如果调整控件大小,新的大小将在此范围内。You should take care when setting these options that they do not conflict with the Anchors and Align settings.
Color 颜色 设置控件的文本颜色。
Enabled 启用 设置控制是否可用,如果为False,在窗体上显示为灰色
Font 字体 设置对象的字体信息,通常(+)号展开详细,如字体、字号、颜色等。
Hint 提示 鼠标悬停在控件上时,弹出的提示信息。请注意ShowHint属性为True时才显示。
Items 项目 包含的数据信息,如果文本行等。
Lines 列表 字符串数组,包含单个数据,数组为索引从0开始,即[0..numLines-1]。
Name 名称 设置控件的标识符。如TBitButton的实例,为Form1.BitBitton1、Form1.BitButton2等等,程序员应该使用见名真义的名称,如ExitButton(退出按钮)或OKButton(确定按钮)。
PopUpMenu 弹出式菜单 设置在控件上右击时,弹出的菜单。
Position (or Top, Left) 位置 设置控件位置。
ReadOnly 只读 为True时,控件只能被读取,不能被更改。如Edit。
ShowHint 显示提示 设置鼠标'悬停'在控件上时,是否显示提示信息。
Size (or Height and Width) 大小 设置控件尺寸。
Style 样式 The options available for Style depend upon the sort of Control being considered: for instance the Style may be defined by TFormStyle, TBorderStyle, TButtonStyle etc.
TabOrder Tab键顺序 输入整数,设置Tab 的顺序。
TabStop 制表位 为False时,Tab 将无法选中此控件,否则可以。
Text 文本 字符串文本,表示该控件包含的数据。适用于Text、Memo、StringList类型。Most of the editing operations (such as Select, Clear, Cut, Copy) are performed in this part of the object, which holds the actual string being edited. If the control contains more than a single line of text, for example TMemo or TComboBox, then the textual elements are arranged as an array of strings (zero-indexed, ie numbered from [0..numLines-1]) in Lines.
Visible 可见 为True,在窗体中可以看到此控件,否则将隐藏。
WordWrap 自动换行 为True时,文本内容将自动换行。




在窗体设计器上右击控件 ,“创建默认的事件“也有相同的效果,通常是OnClick(点击)事件。之后在源代码编辑器里编写相应操作。

在面向对象程序设计中,使用 TActionList 组件是为了集中处理许多常用的操作,把用户界面和应用逻辑分开,减少程序的代码行数,方便程序的维护和调试。它用于维护一系列动作列表,以供其他组件或控制所使用,如菜单和按钮。

事件 说明 介绍
OnChange 改变事件 当检测到任何更改(如鼠标移动、点击、按键、编辑文字、更改图片等)都将触发此事件。
OnClick 点击事件 鼠标点击时触发此事件(点击,指的是鼠标左键点击),点击事件大多是控件默认的事件,如点击一个按钮、单选框或复选框。
Click 单击方法 单击方法,在代码中模拟点击控件。一个程序可以调用相同代码的OnClick事件,通过点击激活其他事件。这个方法可以在程序启动时使用,而不是用户点击后再进行某些操作。
OnDragDrop 拖放事件 拖放操作之前,即当鼠标选中某些信息(如文本)要移动到新位置时。
OnEditingDone 编辑完成事件 当用户完成编辑/修改时,通常用来验证输入内容,如检测输入的文本是不是有效的IP地址。
OnEntry 获得焦点事件 当控件获取到焦点时,触发此事件。
OnExit 移出事件 当鼠标移出控件区域时触发此事件。
OnKeyPress 按键事件 按键事件,当按下某键时,将触发此事件。不同于OnKeyDown:当按下但不松开某键时触发此事件。
OnKeyDown 按下键不松事件 如果一个键被按下,但不松开,将触发此事件。
OnKeyUp 松开键事件 松开按键时触发此事件。
OnMouseMove 鼠标移动事件 当鼠标在控件上移动时触发此事件。
OnMouseDown 鼠标按下事件 鼠标按下但不松开时触发此事件。
OnMouseUp 鼠标松开事件 鼠标按下并松开时触发此事件。
OnResize 改变大小事件 调整控件大小时触发此事件。


These are two special methods associated with each control:

  • Constructors: such as Create allocate memory and system resources needed by the object. They also call the constructor of any sub-objects present in the class.
  • Destructors: remove the object and de-allocate memory and other resources. If you call Destroy for an object which hasn't being initialized yet it will generate an error. Always use the Free method to deallocate objects, because it checks whether an object's value is nil before invoking Destroy.

Take the following precautions when creating your own Destroy method:

  • Declare Destroy with the override directive, because it is a virtual method.
  • Always call 'inherited Destroy;' as the last thing on the destructor code.
  • Be aware that an exception may be raised on the constructor in case there is not enought memory to create an object, or something else goes wrong. If the exception is not handled inside the constructor, the object will be only partially built. In this case Destroy will be called when you weren't expecting it, so your destructor must check if the resources were really allocated before disposing of them.
  • Remember to call Free for all objects created on the constructor.

How to use Menu Controls

Hints for creating menus for your forms

TMainMenu is the Main Menu that appears at the top of most forms; form designers can customise by choosing various menu items. TPopupMenu is a menu window that pops up with pertinent, usually context-sensitive, details and choices when the right mouse button is clicked near a control

Main Menu is a non-visible component: that is, if the icon is selected from the Component Palette and placed on the form, it will not appear at runtime. Instead, a menu bar with a structure defined by the Menu Editor will appear. Popup menus (placed on the form by selecting the icon from the Component Palette) do not appear at all unless the right mouse button is clicked on a control that owns such a menu.

To see the Menu Editor, right-click on the Main Menu or Popup Menu icon on your Form. A pop-up box appears that invites you to enter items into the Menu bar.

An edit box is displayed, containing a button labelled "New Item1". If you right-click on that box, a pop-up menu is displayed that allows you to add a new item before or after (along the same level) or create a sub-menu with the opportunity to add further items below (or above) the new item in a downward column.

Any of the MenuItems that you add can be configured using the Object Inspector.

At the least you should give each item a Caption which will appear on the Menu Bar. The caption should indicate the activity to be selected, such as "File Open" or "Close", "Run" or "Quit". You may also wish to give it a more meaningful Name.

If you want a particular letter in the Caption to be associated with a shortcut key, that letter should be preceded by an ampersand (&). The Menu item at run-time will appear with the shortcut letter underlined, and hitting that letter key will have the same effect as selecting the menu item. Alternatively you can choose a shortcut key sequence (such as Ctrl+C for Copy or Ctrl+V for Paste - the standard keyboard shortcuts) with the ShortCut property of the MenuItem.

It is often helpful to use the Menu controls in conjunction with an ActionList which contains a series of standard or customised Actions. Menu Items can be linked in the Object Inspector to actions on the list, and the same actions can be linked to buttons, toolbar buttons, speedbuttons etc. It is obviously more efficient to re-use the same code to respond to the various events, rather than writing separate OnClick event handlers for each individual control.

By default, a number of standard actions are pre-loaded from StdActns or, if DataAware controls are used, from DBActns. These actions can be chosen using the ActionList editor which appears when you right-click on the ActionList icon on the Form Designer.



更多 category: IDE Window - Debug

Lazarus 文件

   (感谢 Kevin Whitefoot.)
   (Giuseppe Ridinò, User:Kirkpatc 和 Tom Lisjac 添加)


  xxx.pas 和 yyy.lpr





total 4740  free 76500
-rwxrwxrwx   1 kjwh     root  4618697 Mar 24 11:19 again.exe
-rw-rw-rw-   1 kjwh     root     3002 Mar 24 11:21 again.lpi
-rw-rw-rw-   1 kjwh     root      190 Mar 24 11:18 again.lpr
-rw-rw-rw-   1 kjwh     root      506 Mar 24 11:08 againu.lfm
-rw-rw-rw-   1 kjwh     root      679 Mar 24 11:08 againu.lrs
-rw-rw-rw-   1 kjwh     root      677 Mar 24 11:08 againu.pas
-rw-rw-rw-   1 kjwh     root     2124 Mar 24 11:08 againu.ppu
-rwxrwxrwx   1 kjwh     root      335 Mar 24 11:07 ppas.bat

Note that there are many more files than the two that I thought I was saving.(注意,好像是多了两个文件,我想是我存的吧。)


again.exe: 二进制可执行文件,Win32中添加exe扩展名。linux没有。此文件在Linux上很大的原因是,加入了调试标记。 注意:在1.0.14版,可以勾选,“工程”->“工程选项”中的“编译选项”->“链接”:“从可执行程序中除去符号,可以减少程序体积(Strip Symbol)”;以减少程序体积。

again.lpi: 它以XML格式存储,是Lazarus项目的主要文件(项目信息);Delphi应用程序文件是.dpr。

again.lpr: 这是主程序的源代码文件,尽管使用了特定的扩展名,但它仍是正常的Pascal源文件。它有use部分,可以让编译器找到所需的单元。注意,程序名可以和该名称相同。

againu.lfm: 存储了Lazarus窗体布局信息;也包含了初始化部分的资源文件。Delphi的DFM文件可以转换为LFM格式:“工具“->“转换DFM文件为LFM文件”。

againu.lrs: 生成的资源文件。需要注意的是它不是Windows的资源文件。

againu.pas: The unit that contains the code for the form. 包含窗体代码的单元文件。

againu.ppu: 编译的单元文件。

ppas.bat: 一个简单的脚本,链接程序生成可执行文件。如果编译完成,将由编译器删除。


这个页面来自 这里(失效)。

  • Created initial page and template. T. Lisjac - 11/04/2003 VlxAdmin
  • Inserted a note containing instructions for writing your first Lazarus Program. Suggest an administrator places it in the appropriate place on the Tutorial menu. 3/09/2004 User:Kirkpatc
  • Per above, moved Chris's writeup to the main body of the tutorial VlxAdmin
  • Began to insert text describing the Lazarus Editor - more to follow! 24 Mar 2004 User:Kirkpatc
  • Added some more to Lazarus Editor section of Tutorial. 25 Mar 2004 User:Kirkpatc
  • Added screenshots and revised some of the page formatting VlxAdmin 3/25/2004
  • Moved some of kwhitefoot's comments into Tutorial section. Formatting not quite right, but have to go to bed now! 26 Mar 2004 User:Kirkpatc
  • Formatted, added credits and comments. Removed original notes. VlxAdmin 3/26/2004
  • More material added to Editor section of tutorial. 26 Mar 2004 User:Kirkpatc
  • More material added describing the Main Menu. Renamed 'Hello World' to 'Getting Started' and moved it to nearer the top. 31 March 2004 User:Kirkpatc
  • Inserted section on Run sub-menu. Some general editing (eg ended each entry with a period to ensure consistency). 9 Apr 2004 User:Kirkpatc
  • Inserted a new section on How to get started with MySQL in FPC/Lazarus. 13 Apr 2004 User:Kirkpatc
  • Deleted the section on MySQL from here: it has been copied to Lazarus Database section of tutorial. 14 Apr 2004 User:Kirkpatc
  • Added some more to the description of the Editor Main Menu. 18 Apr 2004 User:Kirkpatc
  • Added section on Environment sub-menu. 19 Apr 2004 User:Kirkpatc
  • Added section on Components sub-menu. 4 May 2004 User:Kirkpatc
  • Adding Tools sub-menu description (incomplete). 7 May 2004 User:Kirkpatc
  • Added some screenshots to Menu descriptions. 9 May 2004 User:Kirkpatc
  • Fixed a bit in Environment Options - thanks VincentSnijders. 14 May 2004 User:Kirkpatc
  • More additions to Tools sub-menu. 19 May 2004 User:Kirkpatc
  • Added a section on the Button Bar and started work on The Component Palette. 20 May 2004 User:Kirkpatc
  • Posted a description file for the StdCtrls unit of the LCL, in the hope that people will add comments. 26 May 2004 User:Kirkpatc
  • Edited the StdCtrls file, removing a lot of repetitive material and doing some formatting. It is still far too long. 28 May 2004 User:Kirkpatc
  • Expanding on the Components Palette. 5 June 2004 User:Kirkpatc
  • Added a lot to the DialogExamples page. 10 June 2004 User:Kirkpatc
  • Considerable revision of the StdCtrls page, hopefully making it clearer and encouraging people to contribute - particularly in the 'Description' sections. 14 June 2004 User:Kirkpatc
  • Added pages for Menus and Dialogs units (linked to Component Palette description) - please feel free to add to these pages. 14 June 2004 User:Kirkpatc
  • Added page for Common Controls (linked to Component Palette). 16 June 2004 User:Kirkpatc
  • Added MaskEdit page (linked to Component Palette). 17 June 2004 User:Kirkpatc
  • Added Buttons, ExtCtrls pages (linked to Component Palette). 17 June 2004 User:Kirkpatc
  • Edited MainMenu component description page. 23 June 2004 User:Kirkpatc
  • Some additions to Common Controls. 28 June 2004 User:Kirkpatc
  • A new tutorial on Text-mode Pascal programming has been added. 5 July 2004 User:Kirkpatc
  • Minor changes to ComCtrls, ExtCtrls, Environment Menu. 10 July User:Kirkpatc
  • Added FormsTxt, component description page for Component Palette. 20 July 2004 User:Kirkpatc
  • Some corrections to ConsoleModePascal. 21 July 2004 User:Kirkpatc
  • Some small changes to ComponentPalette. 22 July 2004 User:Kirkpatc
  • Returned after a long absence! Changed link for component descriptions in StdCntls group of ComponentPalette to point directly at the Lazarus on-line help html pages. 25 Sept 2007 User: Kirkpatc
  • Uploaded some more up-to-date screenshots and fixed links in descriptions of the Menus. 2 October 2007 User: Kirkpatc
  • Fixed links for component descriptions in Extra Controls section of Component Palette. 2 October 2007 User: Kirkpatc