Scintilla使用指南(2) - 全文检索和修改

黄舟

发布时间：2017-01-17 10:26:25

2573人浏览过

来源于php中文网

原创

在scintilla中，每个字符后面，都跟有一个表示字符样式的字节，字符字节和样式字节一起组成一个字符单元。样式字节的8个bit，分为两部分：字符样式和字符指示器。通过sci_indicatorfillrange消息可以设置一段文本的字符指示器。默认低5位为字符样式，高3位为字符指示器。因此，可以有32种字符样式。3个互相独立的字符指示器，可以用来指示语法错误、不赞成的名字和坏的缩进等信息。可以使用sci_setstylebits消息设置字符样式位最大到7个bit位，剩下的将被分配给字符指示器。
position指示了scintilla中的字符或字符前空白点的位置。第一个字符的position是0，第二个是1，依此类推。假如文档包含了nlen个字符，则最后一个字符的position是nlen – 1。光标存在于两个字符之间，能够被定位到第一个字符之前（0）和最后一个字符之后（nlen）。
当两个字符被当作一个字符处理时，光标是无法存在于两个字符之间的。这种情况，通常发生在中文等多字节字符或行结束符为crlf时。常量invalid_position（-1）表示一个非法位置。
出于性能考虑，所有文本行具有相同的高度：当前样式中最大字体的高度。

SCI_GETTEXT, SCI_SETTEXT

1） SCI_GETTEXT(int length, char *text)
获取文本：
（1）当text为0时，返回整个文档长度len + 1；
（2）当length为0时，返回0；
（3）当text不为0且length大于0时，返回length – 1，text被填充为从位置0开始的length – 1个字符和一个0终结符。如果length大于文档长度，多出的位置将被填充为空字符0。

unsigned int len = SendMessage(SCI_GETTEXT, 0, 0);
char *chText = new char[len];
SendMessage(SCI_GETTEXT, len, (LPARAM)chText);
…
delete [] chText;

2） SCI_SETTEXT(, const char *text)
设置文档文本为text，text是以0结尾的常量字符串。如果text为0，返回FALSE（0），否则返回TRUE（1）。

SCI_SETSAVEPOINT
SCI_SETSAVEPOINT

设置保存点，文档状态将变为unmodified，返回TRUE（1）。SCI_SETSAVEPOINT消息将会触发SCN_SAVEPOINTREACHED事件通知。当文档状态变为modified时，将会触发SCN_SAVEPOINTLEFT事件通知。

SCI_GETLINE

SCI_GETLINE(int line, char *text)
获取指定行文本，返回指定行文本长度（包括行结束符）。行号line从0开始，如果行号大于最大行号，将返回0。当text为0时，直接返回指定行文本长度；当text不为0时，text将被填充为指定行文本，但并不会自动设置结束符0。

unsigned int len = SendMessage(SCI_GETLINE, 1, 0);
char *chText = new char[len + 1];
memset(chText, 0, len + 1);SendMessage(SCI_GETLINE, 1, (LPARAM)chText);
…delete [] chText;

SCI_REPLACESEL

SCI_REPLACESEL(, const char *text)
替换选择文本，text是以0结尾的常量字符串。当没有文本被选择时，将在当前位置插入文本。替换后，光标将处于插入文本之后，并自动滚动视图，以使文本可见。当text为0时，返回FALSE（0），否则返回TRUE（1）。

SCI_SETREADONLY, SCI_GETREADONLY

1） SCI_SETREADONLY(bool readOnly)
设置文档为只读，返回TRUE（1）。文档处于只读状态时，当文档发生修改，将会触发SCN_MODIFYATTEMPTRO事件通知。
2） SCI_GETREADONLY
获取文档只读状态，返回TRUE（1）或FALSE（0）。

SCI_GETTEXTRANGE

SCI_GETTEXTRANGE(, TextRange *tr)
获取指定范围文本，如果tr为0，返回0，否则返回文本长度（不包括0终结符），并填充tr.lpstrText为指定范围的文本和一个0终结符。当tr.chrg.cpMax为-1时，表示到文档结束位置。你必须确保tr.lpstrText字符缓冲区足够大（(tr.chrg.cpMax - tr.chrg.cpMin) + 1）。

SCI_GETSTYLEDTEXT

SCI_GETSTYLEDTEXT(, TextRange *tr)
获取指定范围样式文本，与SCI_GETTEXTRANGE类似，但所需字符缓冲区大小是SCI_GETTEXTRANGE的2倍（2 * (tr.chrg.cpMax - tr.chrg.cpMin) + 2）。Scintilla将会自动追加2个0终结符到tr.lpstrText尾部。

SCI_ALLOCATE

SCI_ALLOCATE(int bytes, )
分配足够大的缓冲区，以容纳指定大小的字节，返回TRUE（1）。只有当指定大小大于当前缓冲区大小时，才会重新分配缓冲区，否则不做任何处理。

SCI_ADDTEXT

SCI_ADDTEXT(int length, const char *s)
在当前位置插入指定文本的指定长度，s是以0结尾的常量字符串，返回0。插入文本后，当前位置处于插入文本之后，但视图并不会自动进行滚动，以使其可见。

SCI_ADDSTYLEDTEXT

SCI_ADDSTYLEDTEXT(int length, cell *s)
在当前位置插入样式文本，处理方式和SCI_ADDTEXT相似，返回0。

SCI_APPENDTEXT

SCI_APPENDTEXT(int length, const char *s)
在文档尾部插入文本，处理方式和SCI_ADDTEXT相似，返回0。

南方数据企业网站管理系统11 bulid 080901 全屏修正版

南方数据企业网站管理系统 V11.0全屏版新增功能:1.首页模板布局做了全新的调整;2.新增了企业网站广告管理系统,可以在后台随意增加和修改Banner广告、对联广告、浮动广告、弹出广告;3.新增了QQ在线资讯功能，同时还有N种模板选择;4.更换了网站统计管理系统；5.对菜单进行了加粗处理,显得更美观;6.后台使用了全新的静态编辑器,提高了后台打开编辑器的速度;7.新增了一个模板;8.修改了中英文

下载

SCI_INSERTTEXT

SCI_INSERTTEXT(int pos, const char *text)
在指定位置插入文本，处理方式和SCI_ADDTEXT相似，返回0。当pos为-1时，表示在当前位置插入。

SCI_CLEARALL

SCI_CLEARALL
除非文档只读，否则删除文档所有字符，返回0。

SCI_CLEARDOCUMENTSTYLE

SCI_CLEARDOCUMENTSTYLE
清除文档所有样式信息，返回0。这通常用在需要重新设置文档样式的时候。

SCI_GETCHARAT

SCI_GETCHARAT(int position)
返回指定位置的字符。当position小于0或大于文档结束位置时，返回0。

SCI_GETSTYLEAT

SCI_GETSTYLEAT(int position)
返回指定位置的样式。当position小于0或大于文档结束位置时，返回0。

SCI_SETSTYLEBITS, SCI_GETSTYLEBITS