Scintilla开源库使用指南(二)

http://www.cnblogs.com/superanyi/archive/2011/04/07/2008636.html

Scintilla开源库使用指南(二)

直达等同篇文章介绍了Scintilla的主导以,这里连续上学Scintilla更多的支配命令和实现细节,完善我们的编辑器;

页边(Margins)和标记(Markers)

代码折叠是当代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号标记指定背景色

?

// 标记和页边演示
void TForm1::example()
{
    // 先写10行文本上去
    for(int i=0; i<10; i++)
        SendEditor(SCI_APPENDTEXT, 12, (sptr_t)"hello world ");
    // 0号页边,宽度为9,显示0号标记(0..0001B)
    SendEditor(SCI_SETMARGINTYPEN,0,SC_MARGIN_SYMBOL);
    SendEditor(SCI_SETMARGINWIDTHN,0, 9);
    SendEditor(SCI_SETMARGINMASKN,0, 0x01);
    // 1号页边,宽度为9,显示1,2号标记(0..0110B)
    SendEditor(SCI_SETMARGINTYPEN,1, SC_MARGIN_SYMBOL);
    SendEditor(SCI_SETMARGINWIDTHN,1, 9);
    SendEditor(SCI_SETMARGINMASKN,1, 0x06);
    // 2号页边,宽度为20,显示行号
    SendEditor(SCI_SETMARGINTYPEN,2, SC_MARGIN_NUMBER);
    SendEditor(SCI_SETMARGINWIDTHN,2, 20);
   
    for(int i=0; i<10; i++)
    {
        // 前10行分别加入0~2号标记
        SendEditor(SCI_MARKERADD, i, i%3);
    }
   
    // 设置标记的前景色
    SendEditor(SCI_MARKERSETFORE,0,0x0000ff);//0-红色
    SendEditor(SCI_MARKERSETFORE,1,0x00ff00);//1-绿色
    SendEditor(SCI_MARKERSETFORE,2,0xff0000);//2-蓝色
}

著力量是:

图片 1

设你无喜欢这些圆圈,可以据此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加入代码折叠功能了…

啊Scintilla加入代码折叠功能

面前早已说了当编辑器有代码折叠功能时,25哀号到31声泪俱下就7独记是用作代码折叠专用号的。在scintilla.h中,我们得以找到其的定义:

#define SC_MARKNUM_FOLDEREND 25  //折叠状态(多级中间)
#define SC_MARKNUM_FOLDEROPENMID 26  //展开状态(多级中间)
#define SC_MARKNUM_FOLDERMIDTAIL 27  //被折叠代码块尾部(多级中间)
#define SC_MARKNUM_FOLDERTAIL 28  //被折叠代码块尾部
#define SC_MARKNUM_FOLDERSUB 29   //被折叠的代码块
#define SC_MARKNUM_FOLDER 30     //折叠状态
#define SC_MARKNUM_FOLDEROPEN 31 //展开状态
显示这些标记的掩码是0xFE000000,同样头文件里已经定义好了

#define SC_MASK_FOLDERS 0xFE000000

要加入代码折叠功能,还有一个最最关键的事情,就是要得到语法解析器(Lexer)的支持,上面的这些标记都是由语法解析器自动添加删除的。一般来说,只要用下面这条命令就可以了让语法解析器支持代码折叠了:

SendEditor(SCI_SETPROPERTY,(sptr_t)"fold",(sptr_t)"1");

?

#define MARGIN_FOLD_INDEX 2
void TForm1::setFold()
{
    SendEditor(SCI_SETPROPERTY,(sptr_t)"fold",(sptr_t)"1");
   
    SendEditor(SCI_SETMARGINTYPEN, MARGIN_FOLD_INDEX, SC_MARGIN_SYMBOL);//页边类型
    SendEditor(SCI_SETMARGINMASKN, MARGIN_FOLD_INDEX, SC_MASK_FOLDERS); //页边掩码
    SendEditor(SCI_SETMARGINWIDTHN, MARGIN_FOLD_INDEX, 11); //页边宽度
    SendEditor(SCI_SETMARGINSENSITIVEN, MARGIN_FOLD_INDEX, TRUE); //响应鼠标消息
   
    // 折叠标签样式
    SendEditor(SCI_MARKERDEFINE, SC_MARKNUM_FOLDER, SC_MARK_CIRCLEPLUS); 
    SendEditor(SCI_MARKERDEFINE, SC_MARKNUM_FOLDEROPEN, SC_MARK_CIRCLEMINUS); 
    SendEditor(SCI_MARKERDEFINE, SC_MARKNUM_FOLDEREND,  SC_MARK_CIRCLEPLUSCONNECTED);
    SendEditor(SCI_MARKERDEFINE, SC_MARKNUM_FOLDEROPENMID, SC_MARK_CIRCLEMINUSCONNECTED);
    SendEditor(SCI_MARKERDEFINE, SC_MARKNUM_FOLDERMIDTAIL, SC_MARK_TCORNERCURVE);
    SendEditor(SCI_MARKERDEFINE, SC_MARKNUM_FOLDERSUB, SC_MARK_VLINE); 
    SendEditor(SCI_MARKERDEFINE, SC_MARKNUM_FOLDERTAIL, SC_MARK_LCORNERCURVE);
   
    // 折叠标签颜色
    SendEditor(SCI_MARKERSETBACK, SC_MARKNUM_FOLDERSUB, 0xa0a0a0);
    SendEditor(SCI_MARKERSETBACK, SC_MARKNUM_FOLDERMIDTAIL, 0xa0a0a0);
    SendEditor(SCI_MARKERSETBACK, SC_MARKNUM_FOLDERTAIL, 0xa0a0a0);
   
    SendEditor(SCI_SETFOLDFLAGS, 16|4, 0); //如果折叠就在折叠行的上下各画一条横线
}
__fastcall TForm1::TForm1(TComponent* Owner)
    : TForm(Owner)
{
    ...
    setFold();
}
void __fastcall TForm1::WndProc(Messages::TMessage &Message)
{
    TForm::WndProc(Message);
   
    if(Message.Msg == WM_NOTIFY){
        SCNotification* notify = (SCNotification*)Message.LParam;
        if(notify->nmhdr.code == SCN_MARGINCLICK &&
            notify->nmhdr.idFrom == SCINT_ID){
            // 确定是页边点击事件
            const int line_number = SendEditor(SCI_LINEFROMPOSITION,notify->position);
            SendEditor(SCI_TOGGLEFOLD, line_number);
        }
    }
}

图片 2

此间TForm1::WndProc方法是Scintilla父窗体即我们的TForm1的窗口处理函数。

代码折叠后我们要透过点击页边上之+和-标记来开辟和折叠代码,所以待页边接收鼠标点击事件:

这里TForm1::WndProc方法是Scintilla父窗体即我们的TForm1的窗口处理函数。

代码折叠后咱们只要经点击页边上的+和-标记来打开和折叠代码,所以需要页边接收鼠标点击事件:

SendEditor(SCI_SETMARGINSENSITIVEN, MARGIN_FOLD_INDEX, TRUE); //响应鼠标消息

这般,当有鼠标点击该页边后,Scintilla就见面向她的父窗体发送代码为SCN_MARGINCLICK的WM_NOTIFY消息,其中的LParam为SCNotification*类型。关于SCNotification的详细信息请参考这里。SCNotification的position成员指出了点击位置对应的行号,最后咱们因而SCI_TOGGLEFOLD命令折叠或进行代码。

采用自定义图形

Scintilla自带的标志样式与VS比起来还有距离,反正偶是怎调整且看小土。Scintilla允许我们协调定义标记的样式,方法是:

  1. 用SCI_MARKERDEFINE命令设置标记的体制也SC_MARK_PIXMAP
  2. 用SCI_MARKERDEFINEPIXMAP命令设置标记使用的图形,这里的图样要求是xpm格式。

怎样获得xpm格式图形

xpm在linux系统下用得比多,它和BMP、jpg一样也是平种植图片格式,有过多器得以拿图纸转换成为xpm格式的,比如自己喜爱的免费看图软件XnView就可以,想必ACDSee也行吧。

xpm比较独特的地方是她好当作头文件直接让C语言调用,吃惊吧?用文本编辑器打开它看看,呵呵,其实它们便是一个数组定义。

假设下面是数额(代码)就是后面就就要动用的minus.xpm和plus.xpm图片文件之内容(从eclipse里挖出来的):

?

/* XPM */
static const char *minus_xpm[] = {
/* width height num_colors chars_per_pixel */
"     9     9       16            1",
/* colors */
"` c #8c96ac",
". c #c4d0da",
"# c #daecf4",
"a c #ccdeec",
"b c #eceef4",
"c c #e0e5eb",
"d c #a7b7c7",
"e c #e4ecf0",
"f c #d0d8e2",
"g c #b7c5d4",
"h c #fafdfc",
"i c #b4becc",
"j c #d1e6f1",
"k c #e4f2fb",
"l c #ecf6fc",
"m c #d4dfe7",
/* pixels */
"hbc.i.cbh",
"bffeheffb",
"mfllkllfm",
"gjkkkkkji",
"da`````jd",
"ga#j##jai",
"f.k##k#.a",
"#..jkj..#",
"hemgdgc#h"
};

?

/* XPM */
static const char *plus_xpm[] = {
/* width height num_colors chars_per_pixel */
"     9     9       16            1",
/* colors */
"` c #242e44",
". c #8ea0b5",
"# c #b7d5e4",
"a c #dcf2fc",
"b c #a2b8c8",
"c c #ccd2dc",
"d c #b8c6d4",
"e c #f4f4f4",
"f c #accadc",
"g c #798fa4",
"h c #a4b0c0",
"i c #cde5f0",
"j c #bcdeec",
"k c #ecf1f6",
"l c #acbccc",
"m c #fcfefc",
/* pixels */
"mech.hcem",
"eldikille",
"dlaa`akld",
".#ii`ii#.",
"g#`````fg",
".fjj`jjf.",
"lbji`ijbd",
"khb#idlhk",
"mkd.ghdkm"
};

演示,使用由定义图形:

?

#include "minus.xpm"
#include "plus.xpm"
void TForm1::setFold()
{
    ...
    // 折叠标签样式
    SendEditor(SCI_MARKERDEFINE, SC_MARKNUM_FOLDER, SC_MARK_PIXMAP);
    SendEditor(SCI_MARKERDEFINE, SC_MARKNUM_FOLDEROPEN, SC_MARK_PIXMAP);
    SendEditor(SCI_MARKERDEFINE, SC_MARKNUM_FOLDEREND,  SC_MARK_PIXMAP);
    SendEditor(SCI_MARKERDEFINE, SC_MARKNUM_FOLDEROPENMID, SC_MARK_PIXMAP);
    SendEditor(SCI_MARKERDEFINE, SC_MARKNUM_FOLDERMIDTAIL, SC_MARK_TCORNERCURVE);
    SendEditor(SCI_MARKERDEFINE, SC_MARKNUM_FOLDERSUB, SC_MARK_VLINE);
    SendEditor(SCI_MARKERDEFINE, SC_MARKNUM_FOLDERTAIL, SC_MARK_LCORNERCURVE);
   
    //
    SendEditor(SCI_MARKERDEFINEPIXMAP, SC_MARKNUM_FOLDER, (sptr_t)plus_xpm);
    SendEditor(SCI_MARKERDEFINEPIXMAP, SC_MARKNUM_FOLDEROPEN, (sptr_t)minus_xpm);
    SendEditor(SCI_MARKERDEFINEPIXMAP, SC_MARKNUM_FOLDEREND, (sptr_t)plus_xpm);
    SendEditor(SCI_MARKERDEFINEPIXMAP, SC_MARKNUM_FOLDEROPENMID, (sptr_t)minus_xpm);
    ...
}

如今,我们的结晶是这么的(与VS有相同合龙了吧^_^):

图片 3

哪支持电动缩进

当VS里编写C++代码时,输入回车换行后会见保持和高达一行的缩进一致,输入”{‘字符后回车还见面拉咱多缩进同次于,输入’}’后还要会半自动退。我们的编辑器也如兑现这功效。

而今重精心打听一下Scintilla的通消息(http://scintilla.sourceforge.net/ScintillaDoc.html#Notifications),除了前方用到的页边点击事件外,还有很多风波很实惠。

心想事成全自动缩进功能我们而关心的风波通报是SCN_CHARADDEDSCN_UPDATEUI

  • 当用户输入一个字符时,SCN_CHARADDED事件触发,SCNotification的ch成员保存了输入的字符。
  • 当更新文档界面时,SCN_UPDATEUI事件触发。输入字符,改变字体风格,改变选区都见面招界面更新

示范代码

改变写TForm1::WndProc,处理及时点儿独事件,我们的编辑器支持电动缩进啦

?

void __fastcall TForm1::WndProc(Messages::TMessage &Message)
{
    TForm::WndProc(Message);
   
    if(Message.Msg == WM_NOTIFY)
    {
        ...
        // 处理自动缩进
        static int LastProcessedChar = 0;
        //在CharAdded事件中记录最后输入的字符
        if(notify->nmhdr.code == SCN_CHARADDED)
        {
            LastProcessedChar = notify->ch;
        }
        // 在UpdateUI事件中处理缩进
        if(notify->nmhdr.code == SCN_UPDATEUI && LastProcessedChar!=0)
        {
            int pos = SendEditor(SCI_GETCURRENTPOS); //取得当前位置
            int line = SendEditor(SCI_LINEFROMPOSITION,pos); //取得当前行
            //如果最后输入的字符是右括号的话就自动让当前行缩进和它匹配的左括号所在行一致
            if( strchr("})>]",LastProcessedChar) &&
                isspace(SendEditor(SCI_GETCHARAT,pos-2)) && //要求右括号左边是空白字符
                LastProcessedChar!=0)
            {
                //找前一个单词起始位置,这里用它来确定右括号左边是否全是空白字符
                int startpos = SendEditor(SCI_WORDSTARTPOSITION,pos-1,false);
                int linepos = SendEditor(SCI_POSITIONFROMLINE,line); //当前行起始位置
                if(startpos == linepos) //这样相当于判断右括号左边是否全是空白字符
                {
                    int othpos = SendEditor(SCI_BRACEMATCH,pos-1); //得到对应的左括号所在的位置
                    int othline = SendEditor(SCI_LINEFROMPOSITION,othpos);  //左括号所在行
                    int nIndent = SendEditor(SCI_GETLINEINDENTATION,othline);//左括号所在行的缩进值
                    // 替换右括号前面的空白字符,使之与左括号缩进一致
                    char space[1024];
                    memset(space,' ',1024);
                    SendEditor(SCI_SETTARGETSTART, startpos);
                    SendEditor(SCI_SETTARGETEND, pos-1);
                    SendEditor(SCI_REPLACETARGET,nIndent,(sptr_t)space);
                }
            }
            // 如果输入的是回车,则保持与上一行缩进一致
            // 如果上一行最后有效字符为左括号,就多缩进四个空格
            if(LastProcessedChar == ' ')
            {
                if(line > 0)
                {
                    // 得到上一行缩进设置
                    int nIndent = SendEditor(SCI_GETLINEINDENTATION,line-1);
                    // 查找上一行最后一个有效字符(非空白字符)
                    int nPrevLinePos = SendEditor(SCI_POSITIONFROMLINE,line-1);
                    int c = ' ';
                    for(int p = pos-2;
                        p>=nPrevLinePos && isspace(c);
                        p--, c=SendEditor(SCI_GETCHARAT,p));
                    // 如果是左括号,就多缩进四格
                    if(c && strchr("{([<",c)) nIndent+=4;
                    // 缩进...
                    char space[1024];
                    memset(space,' ',1024);
                    space[nIndent] = 0;
                    SendEditor(SCI_REPLACESEL, 0, (sptr_t)space);
                }
            }
            LastProcessedChar = 0;
        }
    }
}

脚是代码中因故到的Scintilla命令的略介绍

  • SCN_CHARADDED事件记录最后输入的字符,在SCN_UPDATEUI事件中拍卖缩进。
  • 当输入回车时(LastProcessedChar == ‘
    ‘),我们仅仅待保证新行和前边一行的缩进相同便得了。
  • SCI_GETLINEINDENTATION命令可以得到指定行的缩进数(即行首的空格数目)。
  • SCI_REPLACESEL命令用指定字符串替换选择区域
  • SCI_GETCURRENTPOS命令取得时岗位
  • SCI_GETCHARAT命令取得指定位置的字符
  • SCI_LINEFROMPOSITION命令取得指定位置所在的行号
  • SCI_POSITIONFROMLINE命令取得指定行号的起首位置
  • SCI_WORDSTARTPOSITION命令取得指定位置所在单词的苗头位置,如xxx|xx,(|代表指定位置),那么它见面回到|xxxxx的职位。同样还有SCI_WORDENDPOSITION命令。
  • SCI_BRACEMATCH取得括号的旁一半岗位,如指定位置的字符是’}’时,它回到匹配的'{‘所在的职。
  • SCI_SETTARGETSTART和SCI_SETTARGETEND设置TARGET的起首与始止位置,SCI_REPLACETARGET命令用指定字符串替换TARGET指定范围外之字符。

VS的代码完成与函数提示功能是蛮值得赞颂的,它们得以极大地提高我们的编程效率(造成自身本写代码时屡屡只有记住前四个假名,如果以对象后点了略微数点后非起提示就会心慌意乱之说-_-),尽管发生经常为会见失灵。

开呢IDE这个意义是纯属不可知少D。即使你仅仅打算开只编辑器,如果起此功效那也是一模一样良优点啊~~(目前成千上万代码编辑器都并未这意义的游说)。

有关函数提示的几独指令以SCI_CALLTIP作为前缀,这里仅介绍我们将要以的几独命(更多命令见:http://scintilla.sourceforge.net/ScintillaDoc.html#CallTips)

  • SCI_CALLTIPSHOW(int posStart, const char *definition)
    显示提示。posStart表示显示位置,definition是展示的情
  • SCI_CALLTIPCANCEL 取消提示
  • SCI_CALLTIPACTIVE 如果手上编辑器中发出提示信息,返回1,否则返回0
  • SCI_CALLTIPSETHLT(int highlightStart, int highlightEnd)
    设置提醒中的高亮位置,在VS里我们输入函数实参时函数提示会高亮当前输入的参数名为。

在咱们先后中进入提示的最佳时机是SCN_CHARADDED(见上同样节约)事件。当用户输入错误圆括号'(‘时,取得括号左边的函数称作,然后显示出拖欠函数的完全定义。

脚的代码实现了CreateWindow和MoveWindow两只API的函数提示

?

//我们要高亮的两个函数
const size_t FUNCSIZE=2;
char* g_szFuncList[FUNCSIZE]={ //函数名
    "CreateWindow(",
    "MoveWindow("
};
char* g_szFuncDesc[FUNCSIZE]={ //函数信息
    "HWND CreateWindow("
    "LPCTSTR lpClassName,"
    " LPCTSTR lpWindowName,"
    " DWORD dwStyle, "
    " int x,"
    " int y,"
    " int nWidth,"
    " int nHeight, "
    " HWND hWndParent,"
    " HMENU hMenu,"
    " HANDLE hInstance,"
    " PVOID lpParam"
    ")",
    "BOOL MoveWindow("
    "HWND hWnd,"
    " int X,"
    " int Y,"
    " int nWidth,"
    " int nHeight,"
    " BOOL bRepaint"
    ")"
};
void __fastcall TForm1::WndProc(Messages::TMessage &Message)
{
    TForm::WndProc(Message);
    if(Message.Msg == WM_NOTIFY)
    {
        SCNotification* notify = (SCNotification*)Message.LParam;
        ...
        if(notify->nmhdr.code == SCN_CHARADDED)
        {
            ...
            // 函数提示功能
            static const char* pCallTipNextWord = NULL;//下一个高亮位置
            static const char* pCallTipCurDesc = NULL;//当前提示的函数信息
            if(notify->ch == '(') //如果输入了左括号,显示函数提示
            {
                char word[1000]; //保存当前光标下的单词(函数名)
                TextRange tr;    //用于SCI_GETTEXTRANGE命令
                int pos = SendEditor(SCI_GETCURRENTPOS); //取得当前位置(括号的位置)
                int startpos = SendEditor(SCI_WORDSTARTPOSITION,pos-1);//当前单词起始位置
                int endpos = SendEditor(SCI_WORDENDPOSITION,pos-1);//当前单词终止位置
                tr.chrg.cpMin = startpos;  //设定单词区间,取出单词
                tr.chrg.cpMax = endpos;
                tr.lpstrText = word;
                SendEditor(SCI_GETTEXTRANGE,0, sptr_t(&tr));
                  
                for(size_t i=0; i<FUNCSIZE; i++) //找找有没有我们认识的函数?
                {
                    if(memcmp(g_szFuncList[i],word,sizeof(g_szFuncList[i])) == 0)
                    {     //找到啦,那么显示提示吧
                        pCallTipCurDesc = g_szFuncDesc[i]; //当前提示的函数信息
                        SendEditor(SCI_CALLTIPSHOW,pos,sptr_t(pCallTipCurDesc));//显示这个提示
                        const char *pStart = strchr(pCallTipCurDesc,'(')+1; //高亮第一个参数
                        const char *pEnd = strchr(pStart,',');//参数列表以逗号分隔
                        if(pEnd == NULL) pEnd = strchr(pStart,')');//若是最后一个参数,后面是右括号
                        SendEditor(SCI_CALLTIPSETHLT,
                            pStart-pCallTipCurDesc, pEnd-pCallTipCurDesc);
                        pCallTipNextWord = pEnd+1;//指向下一参数位置
                        break;
                    }
                }
            }
            else if(notify->ch == ')') //如果输入右括号,就关闭函数提示
            {
                SendEditor(SCI_CALLTIPCANCEL);
                pCallTipCurDesc = NULL;
                pCallTipNextWord = NULL;                
            }
            else if(notify->ch == ',' && SendEditor(SCI_CALLTIPACTIVE) && pCallTipCurDesc)
            {
                //输入的是逗号,高亮下一个参数
                const char *pStart = pCallTipNextWord;
                const char *pEnd = strchr(pStart,',');
                if(pEnd == NULL) pEnd = strchr(pStart,')');
                if(pEnd == NULL) //没有下一个参数啦,关闭提示
                    SendEditor(SCI_CALLTIPCANCEL);
                else
                {
                    SendEditor(SCI_CALLTIPSETHLT,pStart-pCallTipCurDesc, pEnd-pCallTipCurDesc);
                    pCallTipNextWord = pEnd+1;
                }
            }
        }//if(notify->nmhdr.code == SCN_CHARADDED)
        ...
    }//if(Message.Msg == WM_NOTIFY)
}

图片 4

自然,这个提示作用相当山寨啦。比如函数称及括号中发生空格提示就未出了,函数嵌套调用时才会唤起最后一个函数的参数。关于要改善,大家各显神通吧。

另外,还有一个提外话,在其实的用中,我们的函数信息不容许象这里一样是描摹好的,而是基于用户的输入动态变化的函数称呼和信息列表。这就是关系到一个C++代码解析的题材(还好,只要解析函数声明就尽了),对于这一点,牛X的同室可以好写解析代码;次牛X的可设想用WAVE,Spirit,Regex相当库帮助解析;象偶这种无牛之同桌,则可以设想下CTAGS工具在后台线程中生成tag文件,我们于tag文件里取就足以了(当然,效率嘛~~可以参见C++Builder的函数提示效率-_-)。

代码完成及函数提示的用法类似,前缀是SCI_AUTOC,具体命令见:http://scintilla.sourceforge.net/ScintillaDoc.html\#Autocompletion

?

void __fastcall TForm1::WndProc(Messages::TMessage &Message)
{
    TForm::WndProc(Message);
    if(Message.Msg == WM_NOTIFY)
    {
        ...
        if(notify->nmhdr.code == SCN_CHARADDED)
        {
            ...
            if(notify->ch == '.')
            {
                char word[1000]; //保存当前光标下的单词
                TextRange tr;    //用于SCI_GETTEXTRANGE命令
                int pos = SendEditor(SCI_GETCURRENTPOS); //取得当前位置
                int startpos = SendEditor(SCI_WORDSTARTPOSITION,pos-1);//当前单词起始位置
                int endpos = SendEditor(SCI_WORDENDPOSITION,pos-1);//当前单词终止位置
                tr.chrg.cpMin = startpos;  //设定单词区间,取出单词
                tr.chrg.cpMax = endpos;
                tr.lpstrText = word;
                SendEditor(SCI_GETTEXTRANGE,0, sptr_t(&tr));
                if(strcmp(word,"file.") == 0) //输入file.后提示file对象的几个方法
                {
                    SendEditor(SCI_AUTOCSHOW,0,
                        sptr_t(
                            "close "
                            "eof "
                            "good "
                            "open "
                            "rdbuf "
                            "size"
                        ));
                }
            }
            ...

图片 5

SCI_AUTOCSHOW命令的率先只参数表示既输入了有些个字符。这对代码自动完成是坏有帮的,比如我们可以为此它们帮忙用户输入长串的单词,如:

?

if(strcmp(word,"Create") == 0)
{
    SendEditor(SCI_AUTOCSHOW,6,//已经输入了6位字符
        sptr_t(
            "CreateBitmap "
            "CreateDC "
            "CreateHandle "
            "CreateWindow "
            "CreateWindowEx"
        ));
}

支撑中文

Scintilla默认用的是ANSI编码,所以编辑中文之类的多字节编码时,会错半只字符的问题。我们好采用SCI_SETCODEPAGE命令设置使用的编码。

以支持多语言,建议使用UTF8编码:

  1. // UTF-8编码
  2. SendEditor(SCI_SETCODEPAGE,SC_CP_UTF8);