Scintilla使用指南(二)

 使用概述

如何使用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