Современные техники подсветки кода в Delphi IDE: отслеживание кодовой подстановки и складывание областей

Delphi , Синтаксис , API реализация

При разработке плагинов для Delphi IDE, которые взаимодействуют с редактором кода, важно учитывать возможность складывания кодовых областей и методов. Это позволяет пользователям упростить восприятие большого объема кода, сжимая его в более компактные блоки. Однако для плагинов, которые занимаются подсветкой определенных строк, необходимо отслеживать видимые и скрытые участки кода.

Проблема отслеживания подстановки кода

Разработчики плагинов сталкиваются с проблемой определения видимых строк кода и их позиций на экране. В более новых версиях IDE Delphi кодовые области и методы могут быть скрыты (складываются), что затрудняет подсветку определенных строк. Для решения этой задачи необходимо знать, какие строки и где расположены, а также отслеживать, какие части редактора сложены, а какие нет.

Решение проблемы с использованием метода IsLineElided

Для решения данной проблемы можно использовать метод IsLineElided, который является внутренним термином IDE для обозначения скрытых строк, которые являются частью сложенного региона, метода или другой структуры. Этот метод не является публичным, но доступен для вызова через внутренний класс TCustomEditControl.

Для использования метода IsLineElided, необходимо вызвать метод IDE, который не требует изменения поведения, а только вызова. Метод имеет следующую сигнатуру:

TLineIsElidedProc = function(Self: TObject; LineNum: Integer): Boolean;

Мангled имя метода: @Editorcontrol@TCustomEditControl@LineIsElided$qqri. Обратите внимание, что для получения адреса этой функции необходимо использовать GetProcAddress, передав имя функции, расположенное в файле coreide*.bpl.

Пример кода для получения адреса функции:

PFLineIsElided := GetProcAddress(CoreIDEHandle, StrIDELineIsElidedName);

Теперь, зная, что строка скрыта (складывается), можно итеративно пройтись по строкам в видимой области, чтобы выявить сложенные участки.

if PFLineIsElided(FCodeEditor, 123) then
  // Действия при условии, что строка сложена

Для идентификации сложенных областей достаточно проитерировать строки в видимой области, начиная с IOTAEditView.TopRow и заканчивая BottomRow. Если строка после проверяемой строки сложена, а проверяемая - нет, то проверяемая строка будет являться видимой строкой для сложенного региона.

Важность различий между логическими и номинальными номерами строк

При подсветке кода важно помнить о различии между логическими и номинальными номерами строк. Когда код складывается, логические и номинальные номера строк не совпадают: в редакторе всегда выводятся номинальные номера строк, но если есть сложенный регион, они не будут последовательными.

Заключение

Использование метода IsLineElided является ключевым для плагинов, которые требуют отслеживания сложенных областей в Delphi IDE, особенно при разработке функций подсветки кода. Для более глубокого понимания этого процесса рекомендуется прочитать специализированные материалы, включая статьи о взаимодействии с редактором кода в Delphi IDE, где рассматриваются различные аспекты интеграции плагинов, включая обработку складывания кода.

Создано по материалам из источника по ссылке.

Рассмотрение современных техник подсветки кода в Delphi IDE, включая отслеживание видимости строк и складывание областей, а также использование метода `IsLineElided` для определения сложенных строк кода.

Комментарии и вопросы

Получайте свежие новости и обновления по Object Pascal, Delphi и Lazarus прямо в свой смартфон. Подпишитесь на наш Telegram-канал delphi_kansoftware и будьте в курсе последних тенденций в разработке под Linux, Windows, Android и iOS

:: Главная :: API реализация ::