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

在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）！