Scintilla使用(编辑器篇)(2) - 全文检索和修改
2012-08-23 16:59
253 查看
在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)表示一个非法位置。
出于性能考虑,所有文本行具有相同的高度:当前样式中最大字体的高度。
获取文本:
(1) 当text为0时,返回整个文档长度len + 1;
(2) 当length为0时,返回0;
(3) 当text不为0且length大于0时,返回length – 1,text被填充为从位置0开始的length – 1个字符和一个0终结符。如果length大于文档长度,多出的位置将被填充为空字符0。
2) SCI_SETTEXT(<unused>, const char *text)
设置文档文本为text,text是以0结尾的常量字符串。如果text为0,返回FALSE(0),否则返回TRUE(1)。
设置保存点,文档状态将变为unmodified,返回TRUE(1)。SCI_SETSAVEPOINT消息将会触发SCN_SAVEPOINTREACHED事件通知。当文档状态变为modified时,将会触发SCN_SAVEPOINTLEFT事件通知。
获取指定行文本,返回指定行文本长度(包括行结束符)。行号line从0开始,如果行号大于最大行号,将返回0。当text为0时,直接返回指定行文本长度;当text不为0时,text将被填充为指定行文本,但并不会自动设置结束符0。
替换选择文本,text是以0结尾的常量字符串。当没有文本被选择时,将在当前位置插入文本。替换后,光标将处于插入文本之后,并自动滚动视图,以使文本可见。当text为0时,返回FALSE(0),否则返回TRUE(1)。
设置文档为只读,返回TRUE(1)。文档处于只读状态时,当文档发生修改,将会触发SCN_MODIFYATTEMPTRO事件通知。
2) SCI_GETREADONLY
获取文档只读状态,返回TRUE(1)或FALSE(0)。
获取指定范围文本,如果tr为0,返回0,否则返回文本长度(不包括0终结符),并填充tr.lpstrText为指定范围的文本和一个0终结符。当tr.chrg.cpMax为-1时,表示到文档结束位置。你必须确保tr.lpstrText字符缓冲区足够大((tr.chrg.cpMax - tr.chrg.cpMin) + 1)。
获取指定范围样式文本,与SCI_GETTEXTRANGE类似,但所需字符缓冲区大小是SCI_GETTEXTRANGE的2倍(2 * (tr.chrg.cpMax - tr.chrg.cpMin) + 2)。Scintilla将会自动追加2个0终结符到tr.lpstrText尾部。
分配足够大的缓冲区,以容纳指定大小的字节,返回TRUE(1)。只有当指定大小大于当前缓冲区大小时,才会重新分配缓冲区,否则不做任何处理。
在当前位置插入指定文本的指定长度,s是以0结尾的常量字符串,返回0。插入文本后,当前位置处于插入文本之后,但视图并不会自动进行滚动,以使其可见。
在当前位置插入样式文本,处理方式和SCI_ADDTEXT相似,返回0。
在文档尾部插入文本,处理方式和SCI_ADDTEXT相似,返回0。
在指定位置插入文本,处理方式和SCI_ADDTEXT相似,返回0。当pos为-1时,表示在当前位置插入。
除非文档只读,否则删除文档所有字符,返回0。
清除文档所有样式信息,返回0。这通常用在需要重新设置文档样式的时候。
返回指定位置的字符。当position小于0或大于文档结束位置时,返回0。
返回指定位置的样式。当position小于0或大于文档结束位置时,返回0。
设置字节中样式位宽,返回TRUE(1)。默认为5个bit,最大可以设置为7位,剩余的bit位将被用来表示字符指示器。
2) SCI_GETSTYLEBITS
返回字节中样式位宽。
将目标字符串转换为UTF8编码格式,返回编码文本长度,并将编码后的字节填充到s中。此消息只在GTK+平台提供。
将UTF8格式字符串转换为文档编码格式,返回转换后的字节长度,并将转换后的字节填充到encoded中。此消息只在GTK+平台提供。
设置文档编码长度,返回0。
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; |
设置文档文本为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(<unused>, 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(<unused>, 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(<unused>, 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, <unused>)分配足够大的缓冲区,以容纳指定大小的字节,返回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。
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
1) SCI_SETSTYLEBITS(int bits)设置字节中样式位宽,返回TRUE(1)。默认为5个bit,最大可以设置为7位,剩余的bit位将被用来表示字符指示器。
2) SCI_GETSTYLEBITS
返回字节中样式位宽。
SCI_TARGETASUTF8 *
SCI_TARGETASUTF8(<unused>, char *s)将目标字符串转换为UTF8编码格式,返回编码文本长度,并将编码后的字节填充到s中。此消息只在GTK+平台提供。
SCI_ENCODEDFROMUTF8 *
SCI_ENCODEDFROMUTF8(const char *utf8, char *encoded)将UTF8格式字符串转换为文档编码格式,返回转换后的字节长度,并将转换后的字节填充到encoded中。此消息只在GTK+平台提供。
SCI_SETLENGTHFORENCODE
SCI_SETLENGTHFORENCODE(int bytes)设置文档编码长度,返回0。
相关文章推荐
- Scintilla使用指南(2) - 全文检索和修改收藏
- Scintilla使用指南(2) - 全文检索和修改
- MySQL大数量可以考虑使用-全文检索Sphinx
- Vim编辑器的修改和编辑的常规操作,gcc编译,gdb调试工具,shell使用基础
- SQL Server 2000中全文检索的使用
- 全文检索技术介绍与使用方法
- 使用eclipse3.8搭建maven web开发环境,达到在eclipse编辑器中修改保存任何代码,都能直接启动tomcat预览效果的目的
- FCKeditor 2.0在线编辑器的设置与修改以及使用
- 使用solr搭建你的全文检索
- git commit命令的使用与git默认编辑器的修改
- Solr全文检索服务器搭建与基本使用介绍
- 使用PostgreSQL进行中文全文检索
- 使用SvnQuery对SVN库进行全文检索【未完待续】
- 使用Android中sqlite表的全文检索
- 怎么使用SQL Server 2000全文检索-数据库专栏,SQL Server
- 全文检索技术与Lucene的使用
- 使用Solr构建企业级的全文检索(四)---------写入文档
- 如何使用Oracle全文检索功能
- sphinx PHP全文检索使用教程
- 关于SQLServer2000的全文检索使用心得