借助工具提示帮助,当将鼠标悬停在类名/字段名/过程名等上时,我可以显示一些额外的注释,例如:

/// <comments>Some comments on e.g. a class.</comments>


如何在显示的文本中强制换行?

最佳答案

在XE7和XE8中,以下内容

  public
    { Public declarations }
    /// <comments>Some comments<para/>comments on a second line</comments>
    procedure SetUp;


将文本“第二行的注释”放在“帮助见解”弹出窗口的新行中。一个小怪癖是第二行缩进了两个空格,但如果我这样做

/// <comments>Some comments<para>comments on a second line</para>third line</comments>


“第三行”没有缩进。可以通过执行以下操作来掩盖缩进不一致(以将所有内容缩进两个空格为代价):

///<comments><para>Some comments</para><para>comments on a second line</para><para>third</para></comments>
procedure SetUp;


通过实验判断,

<p/>


XML标记曾经在XE4中可以使用,但在我的初始测试中却停止了XE7的使用:

  TForm1 = class(TForm)
    CDS: TClientDataSet;
    DataSource1: TDataSource;
    DBGrid1: TDBGrid;
    Button1: TButton;
    procedure CDSCalcFields(DataSet: TDataSet);
    procedure FormCreate(Sender: TObject);
    procedure Button1Click(Sender: TObject);
  private
    ///<comments>Some comments<p/>more</comments>
    procedure AddHLIndex;


在XE4中,以上内容在XE4中的新行中显示了“更多”,但与XE8中的“某些注释”显示在同一行。

我想知道XE8的差异是否与Castalia的存在有关,但是我发现XE4和XE8之间的差异是相同的,而XE8从/ NOCASTALIA开关开始。

我尚未进行详尽的测试,但XE8忽略了我尝试过的所有“ HTML”格式标签(

<c>


提问者提到的标签),当然这可能是故意更改或事故的结果。另一方面,它似乎确实可以处理HTML转义,例如

&gt;




&lt;


但不幸的是,

&#10;


,它只是忽略了。

10-08 08:04