Scintilla是一个开源的编辑组件,它不仅具有通常的编辑功能,而且还提供了语法样式、代码折叠、标签、代码自动完成和提示等功能。
Windows版本的Scintilla,是一个标准的Windows组件,用户可以通过SendMessage函数发送消息,与其进行交互。SendMessage函数接口如下所示:
LRESULT SendMessage( HWND hWnd, UINT Msg, WPARAM wParam, LPARAM lParam ); |
GTK+版本的Scintilla,采用和Windows版本相似的方式,进行消息传递。下面的介绍,将以Windows版本为主。
Scintilla提供了大量的消息API,每个消息可以带有0个、1个或2个参数。SendMessage函数中的消息,通常带有2个参数:wParam和lParam,因此对于没有使用的参数,强烈建议将其设置为0,以保证与将来版本的兼容。对于大多数SCI_SETxxxxx设置类消息,都会有一个对应的SCI_GETxxxxx查询消息。
参数类型
消息中的参数类型,如下表所示:
参数类型 |
参数说明 |
bool |
0表示FALSE,1表示TRUE |
int |
32位有符号整数 |
const char* |
常量字符串指针,字符串可能以0结尾,或者通过另一个参数指明长度 |
char* |
字符缓冲区指针,Scintilla将会用查询到的字符数据进行填充。在一些情况下,通过另一个参数,指明了缓冲区大小;在另一些情况下,你必须保证缓冲区足够大,可以容纳查询到的字符数据。如果你传入了一个空指针0,消息将返回查询到的字符数据大小。 |
colour |
RGB格式的颜色值。每种颜色取值0 - 255,red、green、blue按如下方式组合,得到colour值:colour = red | (green << 8) | (blue << 16)。0x000000,黑色;0xff0000,蓝色;0x00ff00,绿色;0x0000ff,红色;0xffffff,白色。 |