Rumah > Artikel > pembangunan bahagian belakang > Scintilla使用指南(1) - 简介
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 37961d9e5b435f62b44829086cbb8551 未使用参数,强烈建议将其设置为0,以保证与将来版本的兼容
数据类型
在Scintilla中,使用了如下几种数据结构:
CharacterRange
字符范围数据结构,与WIN32数据结构CHARRANGE相同。
struct CharacterRange { long cpMin; long cpMax; };
TextRange
文本范围数据结构,主要用于从Scintilla组件获取指定范围的文本,与WIN32数据结构TEXTRANGE相同。
struct TextRange { struct CharacterRange chrg; char *lpstrText; };
TextToFind
搜索文本数据结构,与WIN32数据结构FINDTEXTEX相同。
struct TextToFind {struct CharacterRange chrg; // 搜索范围char *lpstrText; // 搜索文本struct CharacterRange chrgText; // 匹配文本};
SCNotification
事件通知数据结构。在Windows中,Scintilla将向它的父窗口发送WM_NOTIFY消息;在GTK+中,Scintilla将向它的父窗口发送notify信号。
struct NotifyHeader { // 与WIN32数据结构NMHDR相同 void *hwndFrom; // 发送通知的窗口句柄 uptr_t idFrom; // 发送通知的控件ID unsigned int code; // SCN_*通知事件代码 }; struct SCNotification { struct NotifyHeader nmhdr; // SCN_STYLENEEDED, SCN_DOUBLECLICK, SCN_MODIFIED, SCN_DWELLSTART, // SCN_DWELLEND, SCN_CALLTIPCLICK, SCN_HOTSPOTCLICK, SCN_HOTSPOTDOUBLECLICK int position; int ch; // SCN_CHARADDED, SCN_KEY // SCN_KEY, SCN_DOUBLECLICK, SCN_HOTSPOTCLICK, SCN_HOTSPOTDOUBLECLICK int modifiers; int modificationType; // SCN_MODIFIED // SCN_MODIFIED, SCN_USERLISTSELECTION, SCN_AUTOCSELECTION const char *text; int length; // SCN_MODIFIED int linesAdded; // SCN_MODIFIED int message; // SCN_MACRORECORD uptr_t wParam; // SCN_MACRORECORD sptr_t lParam; // SCN_MACRORECORD int line; // SCN_MODIFIED, SCN_DOUBLECLICK int foldLevelNow; // SCN_MODIFIED int foldLevelPrev; // SCN_MODIFIED int margin; // SCN_MARGINCLICK int listType; // SCN_USERLISTSELECTION, SCN_AUTOCSELECTION int x; // SCN_DWELLSTART, SCN_DWELLEND int y; // SCN_DWELLSTART, SCN_DWELLEND };
与MFC的集成
对于MFC应用程序向导创建的多文档程序,只需添加很少的代码,就可以将Scintilla控件嵌入到View中。假设工程名为EasyEdit,则相关的类分别为CEasyEditApp、CEasyEditDoc、CEasyEditView、CChildFrame。
首先,在CEasyEditApp中添加私有成员变量HMODULE m_hmodule和虚函数int ExitInstance(),并增加加载DLL代码和释放DLL代码:
BOOL CEasyEditApp::InitInstance() { m_hmodule = LoadLibrary(_T("SciLexer.dll")); if (NULL == m_hmodule) { ::MessageBox(NULL, _T("The Scintilla DLL could not be loaded."), _T("Error loading Scintilla"), MB_OK | MB_ICONERROR); } … return TRUE; }; int CEasyEditApp::ExitInstance() { // TODO: 在此添加专用代码和/或调用基类 if (m_hmodule) { FreeLibrary(m_hmodule); } return CWinApp::ExitInstance(); }
然后,在CEasyEditView中,增加WM_PAINT消息处理函数void OnPaint(),并在BOOL PreCreateWindow(CREATESTRUCT& cs)和void OnPaint()函数中增加代码:
BOOL CEasyEditView::PreCreateWindow(CREATESTRUCT& cs) { // TODO: 在此处通过修改 // CREATESTRUCT cs 来修改窗口类或样式 cs.lpszClass = _T("Scintilla"); return CView::PreCreateWindow(cs); } void CEasyEditView::OnPaint() { // CPaintDC dc(this); // device context for painting // TODO: 在此处添加消息处理程序代码 // 不为绘图消息调用CView::OnPaint() Default(); }
这样,Scintilla控件就已经集成到View中了。
为了处理Scintilla控件发送的事件通知,在CChildFrame中,增加WM_NOTIFY消息处理函数BOOL OnNotify(WPARAM wParam, LPARAM lParam, LRESULT* pResult):
BOOL CChildFrame::OnNotify(WPARAM wParam, LPARAM lParam, LRESULT* pResult) { // TODO: 在此添加专用代码和/或调用基类 SCNotification *pSCNotification = (SCNotification*)lParam; CEasyEditView *pView = (CEasyEditView*)GetActiveView(); switch (pSCNotification->nmhdr.code) { … } return CMDIChildWnd::OnNotify(wParam, lParam, pResult); }
以上就是Scintilla,简介的内容,更多相关内容请关注PHP中文网(www.php.cn)!