Scintilla使用指南(1) - 简介

红太狼 2022-05-15 19:49 250阅读 0赞

# Scintilla使用指南(1) - 简介 #

本文来自CSDN博客：[http://blog.csdn.net/jack\_china2008/archive/2008/06/08/2525358.aspx][http_blog.csdn.net_jack_china2008_archive_2008_06_08_2525358.aspx]

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，白色。  
  
alpha  
alpha通道值，表示颜色的半透明度，取值范围为：0（完全透明，SC\_ALPHA\_TRANSPARENT）- 255（不透明，SC\_ALPHA\_OPAQUE）。值256（C\_ALPHA\_NOALPHA）表示不使用alpha通道。并不是所有平台都支持alpha通道，并且只有一部分消息实现了alpha效果。消息默认alpha值为256，不使用alpha通道。  
  
<unused>  
未使用参数，强烈建议将其设置为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);

[http_blog.csdn.net_jack_china2008_archive_2008_06_08_2525358.aspx]: http://blog.csdn.net/jack_china2008/archive/2008/06/08/2525358.aspx

Scintilla使用指南(1) - 简介

发表评论取消回复

还没有评论，来说两句吧...

相关阅读

相关 React 简介：初学者指南

相关 Proxmox VE 6.0管理指南——1.简介

相关 Electron使用指南 - [08] 项目简介

相关 RxJava使用说明1-简介

相关【Unity3D 官方移动游戏优化指南】1.简介

相关 ZooKeeper使用（1）- 简介

相关为Scintilla加入代码折叠功能

相关 Scintilla使用指南(1) - 简介

相关 Scintilla使用指南(3) - 搜索和替换

相关 Scintilla使用指南(2) - 全文检索和修改