页边(Margins)和标记(Markers)

朴灿烈づ我的快乐病毒、 2022-05-16 14:09 162阅读 0赞

# 页边(Margins)和标记(Markers) #

来自[http://www.cppprog.com/2009/1111/176.html][http_www.cppprog.com_2009_1111_176.html]

代码折叠是现代IDE和代码编辑器的必备功能，如果现在推出一个不支持折叠的编辑器，那是要被BS地~~。为了不被BS，很有必要先“研究”一下Scintilla的页边(Margins)和标记(Markers)功能。

*  **页 边(Margins)**：页边是位于文本显示区左边的一竖条区域，它可以用于显示行号、书签、断点标记等东东。Scintilla最多可以有5个页边（从左 到右的编号为0~4），每个页边可以使用SCI\_SETMARGINTYPEN命令确定是用于显示行号还是符号。我们可以用 SCI\_SETMARGINWIDTHN命令控制一个页边的宽度，如果设置为0，则表示不显示该页边。默认是只显示宽度为16的1号页边。
 *  **标 记(Markers)**：标记，不用说也知道是用来标记文本位置（确切地说，是文本行）的。我们可以使用32种标记（编号0~31），我们可以自由决定这 32种标记的意义，如标记0用来表示断点、标记1~10表示书签、标记20表示语法错误行等等。不过，如果编辑器要支持代码折叠功能，我们得把标记 25~31留出来，把这7个标记作为代码折叠专用标记（后面还会讲到）。

### 告诉页边显示哪些标记 ###

当页边不是设定为显示行号时（由SCI\_SETMARGINTYPEN命令设置），那么它就会显示标记。刚才说过Scintilla有32种标记，一般来说不会让一个页边来显示所有的标记，而是只显示部分标记。

在一个页边里可以显示哪几种标记由SCI\_SETMARGINMASKN命令设置，它的参数是一个32位掩码（mask）值，掩码值的第n位为1时表示该页边可显示n号标记。

所有页边相关的命令以SCI\_SETMARGIN或SCI\_GETMARGIN作为前缀，如：

*  SCI\_SETMARGINTYPEN(int margin, int type) 设置页边显示行号还是符号，type可以是SC\_MARGIN\_SYMBOL或SC\_MARGIN\_NUMBER
 *  SCI\_SETMARGINWIDTHN(int margin, int pixelWidth) 设置页边宽度
 *  SCI\_SETMARGINMASKN(int margin, int mask) 设置页边掩码
 *  SCI\_SETMARGINSENSITIVEN(int margin, bool sensitive) 设置页边是否接受鼠标点击事件

所有标记相关的命令以SCI\_MARKER作为前缀，如：

*  SCI\_MARKERADD(int line, int markerNumber) 在指定行加入一个markerNumber号标记
 *  SCI\_MARKERDEFINE(int markerNumber, int markerSymbols) 定义markerNumber号标记的样式
 *  SCI\_MARKERDELETE(int line, int markerNumber) 在指定行上的删除markerNumber号标记
 *  SCI\_MARKERDELETEALL(int markerNumber) 删除文本中所有markerNumber号标记
 *  SCI\_MARKERSETFORE(int markerNumber, int colour) 为markerNumber号标记指定前景色
 *  SCI\_MARKERSETBACK(int markerNumber, int colour) 为markerNumber号标记指定背景色

### 演示代码 ###

1.  // 标记和页边演示
2.  void TForm1::example()
3.  \{
4.  // 先写10行文本上去
5.  for(int i=0; i<10; i++)
6.  SendEditor(SCI\_APPENDTEXT, 12, (sptr\_t)"hello world ");
7.  // 0号页边，宽度为9，显示0号标记(0..0001B)
8.  SendEditor(SCI\_SETMARGINTYPEN,0,SC\_MARGIN\_SYMBOL);
9.  SendEditor(SCI\_SETMARGINWIDTHN,0, 9);
10. SendEditor(SCI\_SETMARGINMASKN,0, 0x01);
11. // 1号页边，宽度为9，显示1,2号标记(0..0110B)
12. SendEditor(SCI\_SETMARGINTYPEN,1, SC\_MARGIN\_SYMBOL);
13. SendEditor(SCI\_SETMARGINWIDTHN,1, 9);
14. SendEditor(SCI\_SETMARGINMASKN,1, 0x06);
15. // 2号页边，宽度为20，显示行号
16. SendEditor(SCI\_SETMARGINTYPEN,2, SC\_MARGIN\_NUMBER);
17. SendEditor(SCI\_SETMARGINWIDTHN,2, 20);
18. 
19. for(int i=0; i<10; i++)
20. \{
21. // 前10行分别加入0~2号标记
22. SendEditor(SCI\_MARKERADD, i, i%3);
23. \}
24. 
25. // 设置标记的前景色
26. SendEditor(SCI\_MARKERSETFORE,0,0x0000ff);//0-红色
27. SendEditor(SCI\_MARKERSETFORE,1,0x00ff00);//1-绿色
28. SendEditor(SCI\_MARKERSETFORE,2,0xff0000);//2-蓝色
29. \}

#### 显示效果是： ####

如果你不喜欢这些圆圈，可以用SCI\_MARKERDEFINE命令改变标记的样式，可选的有：

SC_MARK_CIRCLE, SC_MARK_ROUNDRECT, SC_MARK_ARROW, SC_MARK_SMALLRECT,
    SC_MARK_SHORTARROW, SC_MARK_EMPTY, SC_MARK_ARROWDOWN, SC_MARK_MINUS,
    SC_MARK_PLUS, SC_MARK_VLINE, SC_MARK_LCORNER, SC_MARK_TCORNER, SC_MARK_BOXPLUS,
    SC_MARK_BOXPLUSCONNECTED, SC_MARK_BOXMINUS, SC_MARK_BOXMINUSCONNECTED,
    SC_MARK_LCORNERCURVE, SC_MARK_TCORNERCURVE, SC_MARK_CIRCLEPLUS,
    SC_MARK_CIRCLEPLUSCONNECTED, SC_MARK_CIRCLEMINUS, SC_MARK_CIRCLEMINUSCONNECTED,
    SC_MARK_BACKGROUND, SC_MARK_DOTDOTDOT, SC_MARK_ARROWS, SC_MARK_PIXMAP,
    SC_MARK_FULLRECT, SC_MARK_LEFTRECT, SC_MARK_CHARACTER

默认是SC\_MARK\_CIRCLE，小圆圈。你可以试试其它的。（注意SC\_MARK\_CHARACTER比较特殊，它和一个ASCII码加起来决定标记显示为一个对应的ASCII字符）

有了这些基础，我们可以动手为Scintilla加入代码折叠功能了...

[http_www.cppprog.com_2009_1111_176.html]: http://www.cppprog.com/2009/1111/176.html