C++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-蓝色
}

显示力量是:

C++ 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);
        }
    }
}

C++ 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有平等合龙了吧^_^):

C++ 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)
}

C++ 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"
                        ));
                }
            }
            ...

C++ 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);