delphi - 如何为特定类型的所有实例实现我自己的自定义属性编辑器？

Question

我已经遵循了一些关于创建自定义属性编辑器对话框的教程，但是涉及的事情太多，我无法让它正常工作。我想要完成的是一个带有日期选择器(日历)、时间选择器以及“确定”和“取消”按钮的自定义表单。该表单完全没有问题，但是我将如何实现它，以便我可以通过启动属性编辑器的按钮在某种类型的任何组件中发布属性？

我想完全覆盖 TDateTime 类型并将我的自定义编辑器放在其位置，因此无论何时发布 TDateTime 并在对象检查器中可见，我都可以使用此编辑器可以在同一窗口中同时修改日期和时间。

问题在于，有关创建自定义属性编辑器的文档很差，尽管某些资源非常详尽，但它们对功能的详细介绍过多，并且缺乏对最常见场景的切入点。

Answer 1

我不想在这里问这个问题并期望任何人为我回答，所以我自己做了研究来解决我的问题，我想分享这个迷你项目中涉及的独特经验，因为我当然其他人也会因同样的事情而感到沮丧。

自定义属性编辑器、对话框和组件编辑器有许多不同的可能性。这尤其需要 TDateTimeProperty 后代。这将使您能够直接在对象检查器中以纯文本(字符串)形式编辑属性值，同时保留日期时间格式。

我假设您已经具备创建自定义组件和可以从中发布此属性编辑器的包的一般知识，因为这本身就是一个类，我不会介绍。这仅需要在 Register 过程中放置​​一行代码，但我们稍后会讨论这一点。

首先，您需要在 Design-Time 包中创建一个新表单，您的组件将在其中注册。将单元命名为 DateTimeProperty.pas，并将窗体命名为 DateTimeDialog(从而创建窗体的类 TDateTimeDialog)。放置您需要的任何控件，在本例中为 TMonthCalendar、TDateTimePicker(将 Kind 设置为 dtkTime)，以及2 个 TBitBtn 控件，一个标记为 OK，ModalResult 为 mrOK，另一个标记为 Cancel > ModalResult 为 mrCancel。

你的单位应该看起来像这样:

unit DateTimeProperty;

interface

uses
  Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants,
  System.Classes, Vcl.Graphics, Vcl.Controls, Vcl.Forms, Vcl.Dialogs,
  Vcl.ComCtrls, Vcl.StdCtrls, Vcl.Buttons;

type
  TDateTimeDialog = class(TForm)
    dtDate: TMonthCalendar;
    dtTime: TDateTimePicker;
    BitBtn1: TBitBtn;
    BitBtn2: TBitBtn;
  private

  public

  end;         

var
  DateTimeDialog: TDateTimeDialog;

implementation

{$R *.dfm}

end.

这是此表单背后的DFM代码:

object DateTimeDialog: TDateTimeDialog
  Left = 591
  Top = 158
  BorderIcons = [biSystemMenu]
  BorderStyle = bsToolWindow
  Caption = 'Pick Date/Time'
  ClientHeight = 231
  ClientWidth = 241
  Color = clBtnFace
  Font.Charset = DEFAULT_CHARSET
  Font.Color = clWindowText
  Font.Height = -11
  Font.Name = 'Tahoma'
  Font.Style = []
  OldCreateOrder = False
  Position = poScreenCenter
  DesignSize = (
    241
    231)
  PixelsPerInch = 96
  TextHeight = 13
  object dtDate: TMonthCalendar
    Left = 8
    Top = 31
    Width = 225
    Height = 166
    Anchors = [akLeft, akRight, akBottom]
    Date = 41261.901190613430000000
    TabOrder = 1
  end
  object dtTime: TDateTimePicker
    Left = 8
    Top = 8
    Width = 113
    Height = 21
    Date = 41261.000000000000000000
    Time = 41261.000000000000000000
    Kind = dtkTime
    TabOrder = 2
  end
  object BitBtn1: TBitBtn
    Left = 158
    Top = 200
    Width = 75
    Height = 25
    Caption = 'OK'
    Default = True
    ModalResult = 1
    TabOrder = 0
  end
  object BitBtn2: TBitBtn
    Left = 77
    Top = 200
    Width = 75
    Height = 25
    Caption = 'Cancel'
    ModalResult = 2
    TabOrder = 3
  end
end

现在，将 DesignEditors 和 DesignIntf​​ 添加到您的 uses 子句中。确保在此 Design-Time 包的 Requires 中声明了 DesignIDE。这是发布任何属性编辑器所必需的。

在表单中，创建一个名为 DateTime 的新公共(public)属性，其类型为 TDateTime，并带有属性 getter 和 setter。此属性将允许您轻松读取/写入选择实际代表的完整 TDateTime 值。所以你应该在你的表单中包含以下内容:

private
  function GetDateTime: TDateTime;
  procedure SetDateTime(const Value: TDateTime);
public
  property DateTime: TDateTime read GetDateTime write SetDateTime;

....

function TDateTimeDialog.GetDateTime: TDateTime;
begin
  Result:= Int(dtDate.Date) + Frac(dtTime.Time);
end;

procedure TDateTimeDialog.SetDateTime(const Value: TDateTime);
begin
  dtDate.Date:= Value;
  dtTime.DateTime:= Value;
end;

接下来我们需要添加实际的属性编辑器类。在 {$R *.dfm} 下创建此类，该类位于 implementation 下:

type
  TDateTimeEditor = class(TDateTimeProperty)
  public
    procedure Edit; override;
    function GetAttributes: TPropertyAttributes; override;
    function GetValue: String; override;
    procedure SetValue(const Value: String); override;
  end;

procedure TDateTimeEditor.Edit;
var
  F: TDateTimeDialog;
begin
  //Initialize the property editor window
  F:= TDateTimeDialog.Create(Application);
  try
    F.DateTime:= GetFloatValue;
    if F.ShowModal = mrOK then begin
      SetFloatValue(F.DateTime);
    end;
  finally
    F.Free;
  end;
end;

function TDateTimeEditor.GetAttributes: TPropertyAttributes;
begin
  //Makes the small button show to the right of the property
  Result := inherited GetAttributes + [paDialog];
end;

function TDateTimeEditor.GetValue: String;
begin
  //Returns the string which should show in Object Inspector
  Result:= FormatDateTime('m/d/yy h:nn:ss ampm', GetFloatValue);
end;

procedure TDateTimeEditor.SetValue(const Value: String);
begin
  //Assigns the string typed in Object Inspector to the property
  inherited;
end;

最后，我们需要添加一个Register过程来执行这个新属性编辑器的实际注册:

procedure Register;
begin
  RegisterPropertyEditor(TypeInfo(TDateTime), nil, '', TDateTimeEditor);
end;

现在，在对 RegisterPropertyEditor 的调用中，有一个重要的部分需要理解。由于第二个和第三个参数是 nil 和空字符串，这意味着编辑器将应用于 TDateTime 的所有实例。查看此过程，了解有关使其特定于某些组件和属性实例的更多信息。

这是安装后的最终结果...

自定义属性编辑器贡献的一些好资源如下:

1. how to make custom component property?
2. http://delphi.about.com/library/bluc/text/uc092501d.htm
3. http://www.sandownet.com/propedit.html