【 tulaoshi.com - 编程语言 】
4.9.4 编写动作组件
一般使用的动作是通过在对象观察器中设置其属性为具体的应用程序创建的。要使用这样的动作,必须编写事件处理程序在本节的“执行动作”部分描述的分发流程中的某一点上响应动作。
当使用C++Builder自带的预定义动作时,不需要写任何事件处理程序,因为目标组件知道如何响应该动作。也可以创建自己的预定义动作类。当编写自己的动作类时,可内嵌能够在某些特定目标对象类上执行的能力。然后,就可像使用预定义动作类一样使用你的定制动作类。也就是说,当动作能自行识别并应用于目标类时,就可简单地将动作分配给客户控件,并且不需要编写事件处理程序,它会自行作用于目标。
1.动作如何搜索其目标
本节的“执行动作”部分描述了用户激活动作时发生的执行流程。若在动作、动作列表或应用程序层都没有事件处理程序响应动作时,则应用程序试图找到一个动作可自行作用的目标对象。图4-12举例说明了应用程序搜索这种目标对象的过程。预定义动作类和自行创建的动作类都遵循这一过程。
1)应用程序收到一个CM_ACTIONEXECUTE消息,它指示动作未被任何事件处理程序处理。这种应用程序将它分发到屏幕的ActiveForm处。若没有当前活跃的窗体,应用程序将消息分发到MainForm。
2)Form1(在本例中为当前活跃的窗体)首先搜索当前活跃的控件(Memo1),将其作为潜在的目标。当前活跃的控件(Memo1)调用动作的HandlesTarget方法,确定自己是否是适当的动作目标。若Memo1不是适当的目标,HandlesTarget返回false,并且该控件通知应用程序它不是有效目标。
3)在本例中,Memo1是Cut1的适当的目标,因此HandlesTarget返回true。然后Memo1调用Cut1:ExecuteTarget,并将自身作为一个参数传入。
4)因为Cut1是TEditCut动作的一个实例,该动作调用Memo1的CutToClipboard方法:
若该活跃控件不是适当的目标,进程会继续如下:
· Form1检查自身是否是适当的目标。若 Form1是适当的目标(例如,窗体可以作为这个TWindowCascade动作的目标),它调用Cut1的ExecuteTarget方法并将自身作为一个参数传入。
· 若Form1不是适当的目标,应用程序会在Form1的所有可见控件中循环,直到发现目标。注重 若该动作是TCustomAction的后裔,那么当它不能被处理时将自动被禁用,同时其DisableIfNoHandler属性为true。
2.注册动作
当编写自己的动作时,可通过使用ActnList单元中的全局例程在IDE中注册动作或注销其注册:
点击查看大图 当调用RegisterActions时,注册的动作在动作列表编辑器中出现以供给用程序使用。可通过赋予分类名来组织动作,或通过Resource参数提供缺省的属性。
例如,下列代码在IDE中将动作注册入MyAction单元:
当调用UnRegisterActions时,动作不再在动作列表编辑器上出现。
3.编写动作列表编辑器
可为动作列表编写自己的组件编辑器。假如要这样做,需将自己的过程赋予ActnList单元中的四个全局过程变量:
点击查看大图 若要用非缺省的方式治理注册、注销注册、创建及枚举过程的动作,只需重新给这些变量赋值即可。为此,编写自己的处理程序,并在设计时单元初始化部分给这些变量赋值。