Delphi IDE之向代码中增加方法和字段

向代码中增加方法和数据字段(Adding Methods and Data Fields to Code)

现在可以看出,在快速创建Windows应用程序的UI(用户接口)部分,Delphi是一个强有力的工具。它创建了事件处理程序,因而编程人员可以输入代码驱动其应用程序。但不久将会发现,需要在实际应用中添加更加复杂的代码。

往应用程序中增加复杂代码,其中一部分是在Delphi生成的代码中添加自己编写的数据字段及方法,例如,一个简单的应用程序可能包含有两打各种类型的事件处理程序,Delphi创建所有的事件处理程序,我们只需要在空白处填入实际代码。要使创建的应用程序能真正运转起来,我们必须编写很多方法添加到其中。

往Delphi生成的代码中添加方法和数据字段并不困难,但必须清楚规则,否则就会遇到麻烦。

Delphi如何管理类声明(How Delphi Manages Class Declarations)

正如我们知道的,在用Form Designer创建新窗体时,Delphi自动为新建的窗体建立单元文件。Delphi在创建类声明时,它把类声明创建为两段,第一段是Delphi管理的类声明部分,第二段是我们自己来管理。

在前面讲解Form Designer和Menu Designer中创建了一个名为“ScratchPad”的程序,下面的列表是ScratchPad程序的主窗体类声明。

ScratchPad主窗体类声明(THE class DECLARATION FOR ScratchPad'S MAIN FORM)

type
  TMainForm = class(TForm)
    ToolBar1: TToolBar;
    ToolButton1: TToolButton;
    ToolButton2: TToolButton;
    StatusBar: TStatusBar;
    Memo: TMemo;
    MainMenu: TMainMenu;
    FileMenu: TMenuItem;
    FileNew: TMenuItem;
    FileOpen: TMenuItem;
    FileSave: TMenuItem;
    FileSaveAs: TMenuItem;
    N1: TMenuItem;
    FilePrint: TMenuItem;
    FilePrintSetup: TMenuItem;
    N2: TMenuItem;
    FileExit: TMenuItem;
    Edit1: TMenuItem;
    EditReplace: TMenuItem;
    EditFind: TMenuItem;
    N4: TMenuItem;
    EditPaste: TMenuItem;
    EditCopy: TMenuItem;
    EditCut: TMenuItem;
    N5: TMenuItem;
    EditUndo: TMenuItem;
    Help1: TMenuItem;
    EditAbout: TMenuItem;
    EditContents: TMenuItem;
    EditSelectAll: TMenuItem;
    EditWordWrap: TMenuItem;
    OpenDialog: TOpenDialog;
    SaveDialog: TSaveDialog;
    MemoPopup: TPopupMenu;
    PopupCut: TMenuItem;
    PopupCopy: TMenuItem;
    PopupPaste: TMenuItem;
    procedure FileExitClick(Sender: TObject);
    procedure EditCutClick(Sender: TObject);
    procedure FileNewClick(Sender: TObject);
    procedure FileOpenClick(Sender: TObject);
    procedure FileSaveClick(Sender: TObject);
    procedure FileSaveAsClick(Sender: TObject);
    procedure EditUndoClick(Sender: TObject);
    procedure EditSelectAllClick(Sender: TObject);
    procedure EditCopyClick(Sender: TObject);
    procedure EditPasteClick(Sender: TObject);
    procedure EditWordWrapClick(Sender: TObject);
  private
    { Private declarations }
  public
    { Public declarations }
  end;

注意,组件声明的顺序与组件在窗体中的排列顺序一致。读者在“ScratchPad”中创建的主窗体类声明所包含的组件应该与上面列表中列出的相同,但排列顺序可能不一样。

有一点要特别指出:从类声明的第一行到关键字private这一段由Delphi管理,编程人员不要去动它。

Caution

在由Delphi管理的窗体类声明段中加进任何代码都会引起程序出错;一些情况下可能只是编译出错;但在某些时候也可能使程序出现无法修复的错误(这种情况很罕见,但是有可能发生)。因此,要像躲避瘟疫一样避开这段类声明。

在类声明的private段和public段添加数据字段或方法声明是安全的。还可以增加一个protected段,并在其中加进数据字段或方法。

简单介绍状态栏和提示信息(A WORD ABOUT STATUS BARS AND HINTS)

马上就要在ScratchPad程序的状态栏中加进显示提示文本的功能。在开始之前,需要简单介绍一下如何处理提示文本。

当Application对象的ShowHint属性设置为True(缺省设置),同时鼠标光标所指的ShowHint属性也设置成True时,就会触发提示事件。Application对象中有一个OnHint事件,只要提示事件被触发,该事件就会发生。Application对象的Hint属性包含了控件的提示文本。应用程序可使用OnHint事件来把提示显示在状态栏上。

问题是不能直接存取Application对象的OnHint事件。但是,可以将一个自己编写的方法分配给OnHint。这样,当提示事件发生时,该事件就改由自己的OnHint处理程序来处理。要做到这一点,就必须自己编写OnHint事件的事件处理程序。事件处理程序的编写下面再讲。

向代码中添加方法(Adding a Method to Your Code)

下面以在ScratchPad程序中实现提示文本的例子来讲解如何向应用程序中添加方法。首先,打开ScratchPad程序,如下图:

以下各步就是为每一个工具栏按钮指定提示文本,以便状态栏接收提示信息。ScratchPad中的工具栏的按钮仅仅是用于演示,但这不妨碍为这些按钮指定提示文本。

(1)显示ScratchPad的主窗体,点击主窗体工具栏的第一个按钮;

(2)在Object Inspector中找到Hint属性,并输入下面的内容作为提示文本:

Open|Open an Existing File

 (3)把ShowHint属性设置为True;

(4)对工具栏中的其他按钮重复第(2)步和第(3)步。为每个按钮加上提示文本;

(5)点击主窗体底部的状态栏组件。把SimplePanel属性设置为True,使整个状态栏可以通过SimpleText属性来显示文本字符串。

现在,各项准备工作均已完成。把创建的OnHint处理程序取名为MyOnHint。首先,按下列步骤把方法声明加到类声明中:

(1)切换到Code Editor中,并保证当前编辑文件为SPMain.pas

(2)在TScratchPad类的声明中找到private段,把下面一行代码加到private关键字后:

procedure MyOnHint(Sender : TObject);

为了方便观察,下面给出了类声明的最后几行,看起来如下:

  private
    { Private declarations }
    procedure MyOnHint(Sender : TObject);
  public
    { Public declarations }
  end;

很好,现在已经把新方法的说明加到了类声明中。下面还有两项工作要做,先是要把实际的方法加到执行段(implementation);然后把新方法分配给Application对象的OnHint事件。步骤如下:

(1)滚动屏幕到执行段的底部;

(2)输入以下代码(正好在单元结尾end关键字之上):

procedure TMainForm.MyOnHint(Sender: TObject);
begin
  StatusBar.SimpleText := Application.Hint;
end;

(3)切换到Object Inspector,从Object Inspector选取ScratchPad的主窗体MainForm;

(4)切换到Object Inspector的Events页面,双击OnCreate事件,此时会显示Code Editor,在Code Editor中输入代码:

procedure TMainForm.FormCreate(Sender: TObject);
begin
  Application.OnHint := MyOnHint;
end;

(5)编译并运行程序,当鼠标指着一个工具栏按钮时,长提示文本显示在状态栏上,当鼠标光标停留在一个按钮上时,该按钮的短提示文本会以工具提示的方式显示在按钮旁边。

 

上面的第(2)步是把Application对象的Hint属性也就是提示文本赋值给StatusBar组件的SimpleText属性。第(5)步把第(2)步创建的方法分配给Application对象的OnHint事件。每当OnHint事件发生时,就调用MyOnHint方法,把提示文本显示在状态栏上。

Note

上面的例子是一个在应用中实现状态栏提示的例子,其过程比较繁琐,目的是讲解如何为窗体加方法及如何为事件分配方法。其实有一个简便的办法来实现状态栏提示,就是把状态栏的AutoHint属性设置为True,并指定每个组件的提示文本,其他工作由Delphi自动完成。

添加类数据字段(Adding a Class Data Field)

往类中添加数据字段,类似于向类中添加方法。只能把数据字段加到类声明的private段和public段,如果在类中创建了protected段,也可以往protected段中添加数据字段。

删除Delphi生成的代码(Deleting Delphi-Generated Code)

有时候需要把应用程序中Delphi生成的一段代码删除。例如,一个窗体上有一个按钮,由于改变了设计,不再需要这个按钮。从Form Designer中选取该按钮,并按键盘上的Delete键,就可以将这个按钮删除,Delphi删除按钮后,与按钮相对应的OnClick处理程序仍留在代码中。

Delphi明知道按钮已经删除,为什么不把与之对应的OnClick处理程序删除呢?因为有可能其他组件也使用这个事件处理程序。我们可以手动将其从代码中删除。

删除事件处理程序是件简单的事情。把事件处理程序中的代码全部删除,然后保存或编译工程,Delphi就会自动删除空的事件处理程序。

Note

有人可能会说,如果不能肯定某个事件处理程序是否被其他组件使用,最好还是将它留在代码中。依作者的卡法,这不是一个好的解决办法。编程人员有责任地对他自己的代码知道的一清二楚,及时删除不用的方法。不用的代码不会有什么大危害,但它会使.exe文件变得更庞大,某些情况下还会降低程序性能。请及时削减程序中不用代码或低效代码。

好的代码像粥一样,都是用时间熬出来的
原文地址:https://www.cnblogs.com/jijm123/p/13656512.html