Новая линия в помощь понимание
С подсказкой подсказки подсказки я могу отобразить некоторые дополнительные комментарии при наведении курсора на имя класса / имя поля / имя процедуры и т. Д., Например:
/// <comments>Some comments on e.g. a class.</comments>
Как я могу заставить новую строку в отображаемом тексте?
1 ответ
В XE7 и XE8 следующее
public
{ Public declarations }
/// <comments>Some comments<para/>comments on a second line</comments>
procedure SetUp;
помещает текст "комментарии на второй строке" в новую строку во всплывающем окне "Help Insight". Незначительная изюминка - это вторая строка с отступом в пару пробелов, но если я сделаю
/// <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, такое как
>
а также
<
но не, к сожалению,
, который он просто игнорирует.