使用概述
如何使用scinitlla控件呢?scintilla控件需要两个头文件,Scintilla.h和SciLexer.h,这里定义了消息宏,所用到的数据结构类型等等。在所要用到的cpp文件中包括这两个头文件即可。
scinitlla控件与主程序交互通信是通过消息传递的。在窗体类中,创建一个scinitlla控件,然后发送消息给控件,以达到不同的目的。有的时候,我们也需要控件的反馈,比如当用户点击编辑器左边栏时,我们希望控件能通知父窗体,这时,父窗体接收到一个WM_NOTIFY消息,它的参数lParam可以转化为结构体SCNotification的指针类型,结构体SCNotification是由控件头文件定义的,该结构体定义如下:
struct SCNotification {
struct NotifyHeader nmhdr;
int position;
// SCN_STYLENEEDED, SCN_MODIFIED, SCN_DWELLSTART,
// SCN_DWELLEND, SCN_CALLTIPCLICK,
// SCN_HOTSPOTCLICK, SCN_HOTSPOTDOUBLECLICK
int ch; // SCN_CHARADDED, SCN_KEY
int modifiers; // SCN_KEY, SCN_HOTSPOTCLICK, SCN_HOTSPOTDOUBLECLICK
int modificationType; // SCN_MODIFIED
const char *text; // SCN_MODIFIED
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
int foldLevelNow; // SCN_MODIFIED
int foldLevelPrev; // SCN_MODIFIED
int margin; // SCN_MARGINCLICK
int listType; // SCN_USERLISTSELECTION
int x; // SCN_DWELLSTART, SCN_DWELLEND
int y; // SCN_DWELLSTART, SCN_DWELLEND
};
上面的SCN_MODIFIED, SCN_MARGINCLICK,SCN_STYLENEEDED等都是控件定义不同的消息宏,通过该结构体,可以知道控件通知父窗体的内容,
具体的代码实现会在下面的内容叙述的。
在创建控件之前,必不可少的一步就是加载动态库scilexer.dll,在WinApp类的InitInstance()方法中,加入
m_hDll = LoadLibrary(_T("SciLexer.dll"));
其中m_hDll是定义的App类的成员变量,同时,在ExitInstance() 方法中,加入
// unload scintilla dll
if (m_hDll != NULL)
FreeLibrary(m_hDll);
这样才能使用功能强大的scintilla控件,否则是会出现无法创建控件的错误的。
那么如何创建scintilla控件?在MFC中,我们一般的做法是建立一个CWND窗体类,封装与scintilla控件通信的一系列实现,然后在视图类中加一个该窗体类的成员变量,通过窗体类来实现控件的各种操作,如创建、初始化等。这时起封装作用的窗体类看作是控件,这就是在设计模式中称为PROXY的模式。
我们建立一个CScintillaWnd类,如下:
class CScintillaWnd : public CWnd
{
public:
CScintillaWnd();
virtual ~CScintillaWnd();
BOOL Create (LPCTSTR lpszWindowName, DWORD dwStyle, const RECT& rect, CWnd* pParentWnd, UINT nID);
}
#define STR_SCINTILLAWND _T("Scintilla")
BOOL CScintillaWnd::Create (LPCTSTR lpszWindowName, DWORD dwStyle, const RECT& rect, CWnd* pParentWnd, UINT nID)
{
return CWnd::CreateEx(WS_EX_CLIENTEDGE, STR_SCINTILLAWND, lpszWindowName, dwStyle, rect, pParentWnd,(UINT)nID))
}
这样就创建了控件,在视图类中,加入CScintillaWnd类型的成员变量,例如:
private:
CScintillaWnd m_wndScintilla;
在视图类的OnCreate()函数中,加入:
if (!m_wndScintilla.Create(_T("Title"), WS_CHILD | WS_VISIBLE, CRect(0,0,0,0), this, 10000))
{
AfxMessageBox("can't create scintilla!");
return -1;
}
return 0;
同时,在OnSize()函数中,加入:
if (m_wndScintilla.GetSafeHwnd())
m_wndScintilla.MoveWindow(0, 0, cx, cy);
这样保证控件与视图对齐,否则会发生找不到控件的现象。
执行了上述几步之后,在视图类中,应该可以看到scintilla控件的编辑窗口,现在就可以在该窗口上输入文本了。