Источник: webdelphi
Одним из нововведений в Delphi 2010 является встроенный форматировщик исходного кода. Не знаю как Вы, а я был очень рад, что наконец-то можно не заморачиваться над чужими листингами в поисках истины, вручную добавлять пробелы, переносы строк и т.д. и т.п.
Теперь всю эту муторную работу целиком и полностью берет на себя Formatter Delphi 2010.
В целом можно сказать, что настройки по умолчанию рассчитаны на то, что максимальное количество пользователей будут использовать форматтер без каких либо дополнительных настроек. Однако, как ни крути, а у каждого есть свои предпочтения в оформлении, каждый привык к своему виду исходного кода. Несмотря на то, что настройки по форматеру Delphi максимально снабжены пояснениями, я решил немного покопаться в его настройках и составить подробное описание этого замечательного нового инструмента Delphi. И вот, что у меня в итоге получилось.
1. Общие сведения о Delphi Formatter
Для того, чтобы получить доступ к настройкам форматировщика исходного кода Delphi необходимо в главном меню выбрать:
Tools -> Options -> Formatter -> Delphi
Все опции содержаться в четырех разделах:
- Indentation - отступы
- Spaces - пробелы
- Line Breaks - переносы строк
- Capitalization - капитализация
Каждый раздел состоит из ряда секций. Рассмотрим более подробно все настройки у Formatter"а.
2. Настройки форматировщика исходного кода Delphi
Раздел Indentation (отступы)
Секция General
Continuation ident (продолжение отступа)
тип значения : число
значение по умолчанию: 2
описание: определяет дополнительный абзац, который добавляется для продолжения строк, когда выражение продолжается на нескольких строках.
Do not indent after position (не делать отступ после позиции)
тип значения : число
значение по умолчанию: 40
описание: определяет позицию для отступа. Отступ будет вставляться только до позиции, не превышающей это значение
Indent Begin and End keywords (отступы для ключевых слов begin…end)
тип значения : true/false
значение по умолчанию: false
описание: если true, то перед begin и end будет делаться отступ
Indent bloks between Begin and End (отступы блоков между begin и end)
тип значения : true/false
значение по умолчанию: true
описание: если true, то для блоков кода между ключевыми словами begin и end будет делаться отступ
Indent class definition body (отступы в теле определения класса)
тип значения : true/false
значение по умолчанию: false
описание: если true, то в теле класса будут делаться отступы для каждой секции
Indent comments (отступы комментариев)
тип значения : true/false
значение по умолчанию: true
описание: если true, то комментарии будут оформлены в соответствии с окружающим текстом
Indent Compiler directives (отступы директив компилятора)
тип значения : true/false
значение по умолчанию: false
описание: если False, то все директивы компилятора будут располагаться по левому краю без отступов
Indent interface, implementation, and other sections (отступы в секциях)
тип значения : true/false
значение по умолчанию: false
описание: если true, то весь код в секциях модуля (interface, implementation и т.д.) будет сопровождаться отступами
Indent nested routines (отступы вложенных процедур)
тип значения : true/false
значение по умолчанию: true
описание: если true, то весь код вложенных процедур будет с отступами по отношению к главной процедуре
Indent routine bodies (отступы тела процедуры)
тип значения : true/false
значение по умолчанию: false
описание: если true, то тело процедуры будет оформляться дополнительными отступами
Секция Indentation for case statements
(отступы конструкции case)
Indent case contents (отступы содержимого конструкции case)
тип значения : true/false
значение по умолчанию: true
описание: если true, то всё содержимое конструкции после метки case будет дополнено отступами относительно слова case .
Indent case labels (отступы меток)
тип значения : true/false
значение по умолчанию: true
описание: если true, то метки конструкции будут дополняться отступами
Indent Else in case statements (отступы else в конструкции case)
тип значения : true/false
значение по умолчанию: false
описание: если true, то else в конструкции будет дополнен отступами
Секция Indentation for labels (отступы меток)
Indent labels (отступы меток)
тип значения : выбор из списка
значение по умолчанию: Decrease one indent (отделение одним отступом)
описание:
To left margin - метка помещается в крайний левый столбец
Decrease one indent - метка помещается через одну строку после оператора goto
None - метка помещается на том же уровне, что и оператор goto