Data-Browse型Data-Aware控件的制作

  • 来源: 互联网 作者: rocket   2008-03-20/14:10
  • Data-Browse型Data-Aware控件的制作


    在MIS系统中,使用得最常见的当属数据感知控件了。学习如何编写自已的组件,一条很重要的原则就是从自己熟悉的
    组件入手,派生出新的合乎自己要求的控件。在数据感知控件中,Data-Browse型是非常简单而又实用的。所以下面
    我们就讲解一个一个自定义的TSunDBText(功能等同于TDBText)的编写:

    TSunDBText = class(TCustomLabel)
     {...}
    end;

    因为DBText仅起着显示数据的作用,即是个具有数据感知功能的标签,又根据Delphi的习惯,从Custom系列控件派生,
    所以我们选择了TCustomLabel。

    如何具有数据感知功能,其实大部分的书上都没有讲得很明白,包括Delphi Help。大致上有这么几点,我们慢慢叙述:
    一:选择一个能数据感知的DataLink对象,通常我们选用TFieldDataLink,表示仅与一个数据库字段关联
    二:组件必须提供DataSource和DataField两个设计时可读写属性
    三:组件必须处理FDataLink的OnDataChange事件,以反映数据字段的变化
    四:必须提供Notification重载方法,以便当关联的TDataSource组件在设计期或者运行期删除时,能得到通知,并且
          反映出这种改变
    五:习惯上,我们还要处理CM_GETDATALINK消息,以符合VCL内部通信的要求
    六:为了组件的灵活性,建议提供一个Field属性,以便可以利用TField的方法来增强编程的适用性

    下面我们就来一一讲解:
    private
       FDataLink:TFieldDataLink;
      
    constructor Create(AOwner:TComponent);override;
    begin
       inherited;
       FDataLink := TFieldDataLink.Create; {创建一个TFieldDataLink的对象}
       FDataLink.OnDataChange := DataChange;
       {
      
        将TFieldDataLink对象的OnDataChange事件处理交给TSunDBText的DataChange来处理
        这样就要以感知数据库字段的变化,并且进行自己想要的处理
       
       }
    end;

    destructor Destroy;override;
    begin
      {
        这里很简单,仅仅是回收资源而已
      }
       FDataLink.Free;
       FDataLink := nil;
       inherited;
    end;

    从上面我们已经看到,数据感知的关键就在于DataChange事件,大致上我们可以知道,是需要将该字段的显示值赋予
    本标签组件的Caption属性即可,所以下面的代码便是做这部分工作的。
    (注意,之所以要用GetFieldText来完成赋值工作,是出于多方面的考虑,包括设计期和运行期,及异常情况)
    procedure TSunDBText.DataChange(Sender: TObject);
    begin
      Caption := GetFieldText; {read only displaytext when make an data browing component}
    end;

    function TSunDBText.GetFieldText: String;
    begin
      {
     
      正常情况下,只需要取得FDataLink所代表的Field的DisplayText即可,如果你开发的不是Data-Browse控件,请用其他
      Field属性
     
      }
      if(FDataLink <> nil) then
        Result := FDataLink.Field.DisplayText
      else if(csDesigning in ComponentState) then Result := Name else Result := ´´;
      {
       如果是处在设计期,则标签中显示的是组件的名称,如果是运行期,则标签为空;当然,这只是习惯而已,但对于使用Delphi IDE的人来说,
       几乎就是规则。
      }
    end;

    如果没有DataSource和DataField这两个属性,那么控件几乎就没法使用了。这也是重要步骤。

        property DataSource:TDataSource read GetDataSource write SetDataSource;
        property DataField:String read GetDataField write SetDataField;
       
        这些方法十分简单,只要存取TFieldDataLink之DataSource和FieldName属性则可。
       
     function TSunDBText.GetDataSource: TDataSource;
    begin
      Result := FDataLink.DataSource;
      {仅需简单地返回TFieldDataLink之DataSource属性
       从这就可以看出,DataSource属性的写方法也是对FDataLink赋值}
    end;

    procedure TSunDBText.SetDataSource(Value: TDataSource);
    begin
      FDataLink.DataSource := Value; {如上所云,对DataSource属性赋值}

      if(Value <> nil) then Value.FreeNotification(self);
      {
        这里很重要,TComponent提供了一个FreeNotification(AComponent:TComponent)方法,这样,当Value释放时,就会自动调用AComponent的Notification
        方法,我们就可以调整对应的Data-Browse控件,以反映这种变化。如TSunDBText对应的DataSource组件删除掉,则应该反映在标签上
      }
    end;

    function TSunDBText.GetDataField: String;
    begin
      Result := FDataLink.FieldName;  {获得TFieldDataLink之FieldName属性,也就知道了连接的是哪一个数据库字段名称}
    end;

    procedure TSunDBText.SetDataField(const Value: String);
    begin
      FDataLink.FieldName := Value; {这应该不用解释了}
    end;

    接上面的,我们说过Notification的由来,下面就进行相关的处理:
    procedure TSunDBText.Notification(AComponent: TComponent;
      Operation: TOperation);
    begin
      inherited;
      if(Operation = opRemove) and (FDataLink <> nil) and (AComponent = DataSource) then
        DataSource := nil;
    end;

    当关联组件被删除时,而且被删除的正好是本身关联的DataSource组件,就应该设置其DataSource属性为空

    function TSunDBText.GetField: TField;
    begin
      Result := FDataLink.Field;
    end;

    最后,数据感知控件还要响应CM_GETDATALINK消息。通常处理是将TDataLink作为Message的Result域返回
    procedure CMGetDataLink(var Message:TMessage);message CM_GETDATALINK;

    procedure CMGetDataLink(var Message:TMessage);
    begin
        Message.Result := Integer(FDataLink);
    end;
    到此,基本上组件的功能就已齐备了,然而,有一点许多组件编写者都没有注意到,即Action的应用。如果自定义组件能融入VCL的Action机制,
    必然可以使自定义控件的功能更强大,更为一些高级使用者喜欢。


    评论 {{userinfo.comments}}

    {{money}}

    {{question.question}}

    A {{question.A}}
    B {{question.B}}
    C {{question.C}}
    D {{question.D}}
    提交

    驱动号 更多