Scintilla使用指南(二)

类别:VC语言 点击:0 评论:0 推荐:

 使用概述

如何使用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控件的编辑窗口,现在就可以在该窗口上输入文本了。

 

本文地址:http://com.8s8s.com/it/it304.htm