Правила написания кода на Delphi

[Virtson]

Описание класса имеет вид:

type
  <имя> = class (<предок>, <интерфейс>, <интерфейс>...)
  private
    {описание личных членов класса}
  protected
    {описание защищённых членов класса}
  public
    {описание общих членов класса}
  published
    {описание публичных членов класса}
  end;

1. Если класс целиком написан вручную, то каждая из секций private, protected, public, published должна быть единственной в данном классе.
2. Если класс является результатом генерации средой Delphi (то есть это — класс формы, модуля данных или COM-компонента), то рекомендуется для размещения добавленных вручную методов, атрибутов и свойств создать отдельные секции private, protected, public, published (разумеется, только те из них, которые нужны), чтобы вручную добавленные члены класса не смешивались с созданными средой. Например:

type
  TDiaPanel = class(TActiveForm, IDiaPanel)
  // Здесь начинается часть класса, сгенерированная автоматически. 
    
  private
    { Private declarations }
    FEvents: IDiaPanelEvents;
    procedure ActivateEvent(Sender: TObject);
    // ... Здесь часть описаний пропущена 
    procedure PaintEvent(Sender: TObject);
  protected
    { Protected declarations }
    procedure DefinePropertyPages(DefinePropertyPage: TDefinePropertyPage); override;
    procedure EventSinkChanged(const EventSink: IUnknown); override;
    // ... Здесь часть описаний пропущена 
    procedure PrepareFromFileXML(const AFileName: WideString); safecall;
    procedure PrepareFromStringXML(const AXML: WideString); safecall;
  public
    { Public declarations }
    procedure Initialize; override;
  // Здесь начинается описание элементов, добавленных вручную. У них свои секции.  
  private
    FTemplateXML: WideString;
  public
    procedure AfterConstruction; override;
    procedure BeforeDestruction; override;
end;

Порядок секций соблюдать обязательно. Ненужные секции можно пропускать. Если есть две группы секций (согласно п. 2), то порядок должен соблюдаться в каждой из них.
В классах, описанных программистом (в отличие от сгенерированных Delphi) указание спецификаторов области видимости обязательно.
Реализуемые интерфейсы не указываются, если их нет.
Указание класса-предка обязательно, даже если это TObject.

[Virtson]

to be Continued ...

[Antimol]

Сообщение от Virtson

Настоящие правила стилевого оформления исходного кода являются обязательными к исполнению при написании любого нового кода программ на Delphi, в том числе при внесении исправлений в существующий код. Ранее написанный код обязательной стилевой правке не подлежит, хотя она может выполняться при наличии желания, возможности и времени.
[Отобенно данные сведения полезны новичкам. Ведь очень трудно разбираться (тем, кто пытается вам помочь) в чужом коде, да еще плохо оформленном] .

Вот тут описан вариант Стилевого оформления кода в Delphi, конечно можно использовать и не только для Delphi

[W0LF]

Мда... а по-старее тему найти немогли? Не думаю, что ТС нуждаеться уже в вашем ответе))

[Stilet]

ТС нуждаеться уже в вашем ответе

А он и не спрашивал - эта тема а-ля статья.

[psycho-coder]

Хм, с некоторыми моментами я не согласен. А в общем правильно.

[r9m]

1. Если класс целиком написан вручную, то каждая из секций private, protected, public, published должна быть единственной в данном классе.

Да что вы говорите... Что за...? А если мой код пестрит директивами

{$IF NOT DEFINED ....}
{$ELSE}
{$IFEND}

мне отступать от правил embarcadero и пользовать ваши? o-O Вы уж простите )

[Stilet]

А если мой код пестрит директивами

НУ директивы всегда нарушали стройность кода
Но ничего такого в этом страшного конечно же нет.