delphi - 如何在代码编辑器中跟踪代码折叠？

Question

我正在编写一个标记特定行的插件，并将尝试在代码编辑器上为特定行绘制突出显示标记。为此，我需要计算特定代码行(即缓冲区中的行)在屏幕上的位置。

Delphi 代码编辑器可以通过 IOTAEditView 的 BottomRow 和 TopRow 属性访问屏幕上可见的行。然而，在较新的 IDE 版本中，代码区域和方法可以折叠 - 即，多行折叠为一行。线条突出显示绘制的第一步是了解哪些线条可见以及它们位于何处，为此，我可能需要跟踪编辑器的哪些部分折叠，哪些部分不折叠。似乎有 OTAPI 方法可以调用代码折叠(省略)，但不知道它何时发生。

但是，一些插件(例如 Castalia)确实可以管理此操作。怎么办？

Answer 1

IDE 编辑器控件有一个方法，IsLineElided。 Elision[*] 是 IDE 的内部术语，表示当某行是折叠区域、方法或其他结构的一部分时被隐藏的行。在 UI 中，这称为“折叠”，如“代码折叠”，但内部术语与呈现给用户的 UI 术语不同是很常见的。

此方法不可公开访问；它是内部 TEditControl 类的方法。要使用它，您需要调用 IDE 方法。与许多 IDE hack 不同，您不需要 Hook 它，因为您不需要更改它的行为 - 只需调用它即可。

• 损坏的名称:@Editorcontrol@TCustomEditControl@LineIsElided$qqri
• 方法原型(prototype):TLineIsElidedProc = function(Self: TObject; LineNum: Integer): Boolean;
• 位于 coreide*.bpl 文件中。

例如，

PFLineIsElided := GetProcAddress(CoreIDEHandle, StrIDELineIsElidedName);

您可以通过 reading loaded modules 获取核心 IDE BPL 句柄。第一个参数应该是编辑器窗口 - 不是 ToolsAPI 编辑 View ，而是内部编辑器。本文显示the relationship between the editor control and IOTAEditView .

您现在可以询问插件是否删除了一行(即，它是否隐藏？)，如下所示:

if PFLineIsElided(FCodeEditor, 123) then ...

但是，将它们放在一起以查看哪些区域被折叠 - 或者更确切地说，由于仍然绘制任何折叠区域的顶线，因此找到一条或多条线被省略后的线 - 需要更多的逻辑。最好的方法是迭代 View 中屏幕上的行，IOTAEditView.TopRow 和 BottomRow。如果您正在查看的那一行后面的行被折叠，但您正在查看的那一行没有折叠，那么您正在查看的那一行就是折叠区域的代表行(具有 +/的行) - 装订线中的符号。)

请注意，如果您在代码编辑器上绘画，逻辑行号(代码装订线中打印的行号)和标称行号( View 中屏幕上可见的行)之间的区别对您来说很重要，并且代码省略是什么控制着这个。当代码折叠时，逻辑行号和名义行号将不匹配:编辑 View 总是按顺序绘制名义行号，但如果中间有折叠区域，逻辑行号就会有间隙。

进一步阅读:一个大article about integrating with the code editor ，其中一节讨论了代码折叠和处理行号。这是 Parnassus 博客上关于 Delphi 插件/向导与代码编辑器集成的两个主题之一。尽管它涵盖的不仅仅是折叠代码，但如果您正在编写需要处理此类内容的 IDE 插件，那么那里有很多有用的 Material 。 (免责声明:我的博客。)

[*] As an aside, elision is an auto-antonym: a word that has two meanings that are opposites (the common example is 'cleave'.) One meaning of elision is omission or removal, and another meaning is joining or merging.