Scintilla使用指南(2) - 全文檢索與修改

黄舟
發布: 2023-03-04 21:10:01
原創
2266 人瀏覽過

在Scintilla中,每個字元後面,都跟有一個表示字元樣式的位元組,字元位元組和樣式位元組一起組成一個字元單元。樣式位元組的8個bit,分為兩個部分:字元樣式和字元指示器。透過SCI_INDICATORFILLRANGE訊息可以設定一段文字的字元指示器。預設低5位元為字元樣式,高3位元為字元指示器。因此,可以有32種字元樣式。 3個互相獨立的字元指示器,可以用來指示語法錯誤、不贊成的名字和壞的縮排等資訊。可以使用SCI_SETSTYLEBITS訊息設定字元樣式位最大到7個bit位,剩下的將被指派給字元指示器。
Position指示了Scintilla中的字元或字元前空白點的位置。第一個字元的position是0,第二個是1,依此類推。假如文檔包含了nLen個字符,則最後一個字符的position是nLen – 1。遊標存在於兩個字元之間,能夠被定位到第一個字元之前(0)和最後一個字元之後(nLen)。
當兩個字元被當作一個字元處理時,遊標是無法存在於兩個字元之間的。這種情況,通常發生在中文等多位元組字元或行結束符為CRLF時。常數INVALID_POSITION(-1)表示一個非法位置。
出於效能考慮,所有文字行具有相同的高度:目前樣式中最大字體的高度。

SCI_GETTEXT, SCI_SETTEXT
登入後複製

1) SCI_GETTEXT(int length, char *text)
取得文字:
(1) 當text為0時,傳回整個文件長度len + 1;
(2) 當length為0時,傳回0;
(3) 當text不為0且length大於0時,返回length – 1,text被填充為從位置0開始的length – 1個字元和一個0終結符。如果length大於文件長度,多出的位置將被填入空字元0。

unsigned int len = SendMessage(SCI_GETTEXT, 0, 0);
char *chText = new char[len];
SendMessage(SCI_GETTEXT, len, (LPARAM)chText);
…
delete [] chText;
登入後複製

2) SCI_SETTEXT(, const char *text)
設定文檔文字為text,text是以0結尾的常數字串。如果text為0,回傳FALSE(0),否則回傳TRUE(1)。

SCI_SETSAVEPOINT
SCI_SETSAVEPOINT
登入後複製

設定保存點,文件狀態將變成unmodified,回傳TRUE(1)。 SCI_SETSAVEPOINT訊息將會觸發SCN_SAVEPOINTREACHED事件通知。當文件狀態變成modified時,將會觸發SCN_SAVEPOINTLEFT事件通知。

SCI_GETLINE

SCI_GETLINE(int line, char *text)
取得指定行文本,傳回指定行文本長度(包含行結束符)。行號line從0開始,如果行號大於最大行號,將回傳0。當text為0時,直接返回指定行文本長度;當text不為0時,text將被填入指定行文本,但並不會自動設定結束符0。

unsigned int len = SendMessage(SCI_GETLINE, 1, 0);
char *chText = new char[len + 1];
memset(chText, 0, len + 1);SendMessage(SCI_GETLINE, 1, (LPARAM)chText);
…delete [] chText;
登入後複製

SCI_REPLACESEL

SCI_REPLACESEL(, const char *text)
替換選擇文本,text是以0結尾的常數字串。當沒有文字被選擇時,將在目前位置插入文字。替換後,遊標將處於插入文字之後,並自動捲動視圖,以使文字可見。當text為0時,傳回FALSE(0),否則回傳TRUE(1)。

SCI_SETREADONLY, SCI_GETREADONLY

1) SCI_SETREADONLY(bool readOnly)
設定文件為唯讀,回傳TRUE(1)。文件處於唯讀狀態時,當文件發生修改,將會觸發SCN_MODIFYATTEMPTRO事件通知。
2) SCI_GETREADONLY
取得文件唯讀狀態,回傳TRUE(1)或FALSE(0)。

SCI_GETTEXTRANGE

SCI_GETTEXTRANGE(, TextRange *tr)
取得指定範圍文本,如果tr為0,返回0,否則返回文本長度(不包括00的文字和一個0終結符。當tr.chrg.cpMax為-1時,表示到文檔結束位置。你必須確保tr.lpstrText字元緩衝區夠大((tr.chrg.cpMax - tr.chrg.cpMin) + 1)。

SCI_GETSTYLEDTEXT

SCI_GETSTYLEDTEXT(, TextRange *tr)
取得指定範圍樣式文本,與SCI_GETTEXTRANGE類似,但所需字元緩衝區大小是SCI_GETTEXTRANGE (2GETTEXTRAN.chg(TgRd.B. .chrg.cpMin) + 2)。 Scintilla將會自動追加2個0終結符到tr.lpstrText尾部。

SCI_ALLOCATE

SCI_ALLOCATE(int bytes, )
分配足夠大的緩衝區,以容納指定大小的位元組,傳回TRUE(1)。只有當指定大小大於目前緩衝區大小時,才會重新分配緩衝區,否則不做任何處理。

SCI_ADDTEXT

SCI_ADDTEXT(int length, const char *s)
在目前位置插入指定文字的指定長度,s是以0結尾的常數字串,傳回0。插入文字後,目前位置處於插入文字之後,但視圖並不會自動進行捲動,使其可見。

SCI_ADDSTYLEDTEXT

SCI_ADDSTYLEDTEXT(int length, cell *s)
在目前位置插入樣式文本,處理方式和SCI_ADDTEXT相似,返回0。

SCI_APPENDTEXT

SCI_APPENDTEXT(int length, const char *s)
在文檔尾部插入文本,處理方式和SCI_ADDTEXT相似,返回0。

SCI_INSERTTEXT

SCI_INSERTTEXT(int pos, const char *text)
在指定位置插入文本,處理方式和SCI_ADDTEXT相似,返回0。當pos為-1時,表示在目前位置插入。

SCI_CLEARALL

SCI_CLEARALL
除非文檔只讀,否則刪除文檔所有字符,返回0。

SCI_CLEARDOCUMENTSTYLE

SCI_CLEARDOCUMENTSTYLE
清除文檔所有樣式信息,返回0。這通常用在需要重新設定文檔樣式的時候。

SCI_GETCHARAT

SCI_GETCHARAT(int position)
傳回指定位置的字元。當position小於0或大於文件結束位置時,傳回0。

SCI_GETSTYLEAT

SCI_GETSTYLEAT(int position)
傳回指定位置的樣式。當position小於0或大於文件結束位置時,傳回0。

SCI_SETSTYLEBITS, SCI_GETSTYLEBITS

1) SCI_SETSTYLEBITS(int bits)
設定位元組中樣式位寬,傳回TRUE(1)。預設為5個bit,最大可以設定為7位,剩餘的bit位將用來表示字元指示器。
2) SCI_GETSTYLEBITS
返回位元組中樣式位寬。

SCI_TARGETASUTF8 *

SCI_TARGETASUTF8(, char *s)
將目標字串轉換為UTF8編碼格式,傳回編碼文字長度,並將編碼後的位元組填入s中。此訊息只在GTK+平台提供。

SCI_ENCODEDFROMUTF8 *

SCI_ENCODEDFROMUTF8(const char *utf8, char *encoded)
將UTF8格式字串轉換為文件編碼格式,傳回轉換後的字節長度,並將轉換後的位元組長度填入轉換後的字節長度,並將轉換後的位元組長度填入轉換後的字節長度,並將轉換後的位元組長度填入轉換後的字節長度,並將轉換後的字節長度填入轉換後的字節長度,並將轉換後的字節長度填入轉換後。此訊息只在GTK+平台提供。

SCI_SETLENGTHFORENCODE

SCI_SETLENGTHFORENCODE(int bytes)
設定文檔編碼長度,回傳0。

以上就是Scintilla使用指南(2) - 全文檢索和修改的內容,更多相關內容請關注PHP中文網(www.php.cn)!


來源:php.cn
本網站聲明
本文內容由網友自願投稿,版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容,請聯絡admin@php.cn
熱門教學
更多>
最新下載
更多>
網站特效
網站源碼
網站素材
前端模板