編輯框控件的一些用法

編輯框(Edit Box)控件實際上是一個簡易的正文編輯器，用戶可以在編輯框中輸入并編輯正文。編輯框既可以是單行的，也可以是多行的，多行編輯框是從零開始編行號的．在一個多行編輯框中，除了最后一行外，每一行的結(jié)尾處都有一對回車換行符（用＂\r\n＂表示）．這對回車換行符是正文換行的標(biāo)志，在屏幕上是不可見的．

編輯框控件會向父窗口發(fā)出如表6.5所示的控件通知消息.　

表6.5

MFC的CEdit類封裝了編輯框控件。CEdit類的成員函數(shù)Create負(fù)責(zé)創(chuàng)建按鈕控件，該函數(shù)的聲明為

BOOL Create( DWORD dwStyle, const RECT& rect, CWnd* pParentWnd, UINT nID );

參數(shù)dwStyle指定了編輯框控件風(fēng)格，如表6.6所示，dwStyle可以是這些風(fēng)格的組合。rect指定了編輯框的位置和尺寸。pParentWnd指定了父窗口，不能為NULL。編輯框的ID由nID指定。如果創(chuàng)建成功，該函數(shù)返回TRUE，否則返回FALSE．

表6.6 編輯框控件的風(fēng)格

除了上表中的風(fēng)格外，一般還要為控件指定WS_CHILD、WS_VISIBLE、WS_TABSTOP和WS_BORDER窗口風(fēng)格，WS_BORDER使控件帶邊框。創(chuàng)建一個普通的單行編輯框應(yīng)指定風(fēng)格為WS_CHILD|WS_VISIBLE|WS_TABSTOP |WS_BORDER|ES_LEFT|ES_AUTOHSCROLL，這將創(chuàng)建一個帶邊框、左對齊正文、可水平滾動的單行編輯器。要創(chuàng)建一個普通多行編輯框，還要附加ES_MULTILINE|ES_WANTRETURN|ES_AUTOVSCROLL |WS_HSCROLL| WS_VSCROLL風(fēng)格，這將創(chuàng)建一個可水平和垂直滾動的，帶有水平和垂直滾動條的多行編輯器。

對于用對話框模板編輯器創(chuàng)建的編輯框控件，可以在控件的屬性對話框中指定表6.6中列出的控件風(fēng)格。例如，在屬性對話框中選擇Multi-line項，相當(dāng)與指定了ES_MULTILINE風(fēng)格。

編輯框支持剪貼板操作。CEdit類提供了一些與剪貼板有關(guān)的成員函數(shù)，如表6.7所示。

表6.7 與剪切板有關(guān)的CEdit成員函數(shù)

可以用下列CEdit或CWnd類的成員函數(shù)來查詢編輯框。在學(xué)習(xí)下面的函數(shù)時，讀者會經(jīng)常遇到術(shù)語字符索引．字符的字符索引是指從編輯框的開頭字符開始的字符編號，它是從零開始編號的．也就是說，字符索引實際上是指當(dāng)把整個編輯正文看作一個字符串?dāng)?shù)組時，該字符所在的數(shù)組元素的下標(biāo)．

int GetWindowText( LPTSTR lpszStringBuf, int nMaxCount ) const;
void GetWindowText( CString& rString ) const;
這兩個函數(shù)均是CWnd類的成員函數(shù)，可用來獲得窗口的標(biāo)題或控件中的正文。第一個版本的函數(shù)用lpszStringBuf參數(shù)指向的字符串?dāng)?shù)組作為拷貝正文的緩沖區(qū)，參數(shù)nMaxCount可以拷貝到緩沖區(qū)中的最大字符數(shù)，該函數(shù)返回以字節(jié)為單位的實際拷貝字符數(shù)（不包括結(jié)尾的空字節(jié)）。第二個版本的函數(shù)用一個CString對象作為緩沖區(qū)。

int GetWindowTextLength( ) const;
CWnd的成員函數(shù)，可用來獲得窗口的標(biāo)題或控件中的正文的長度。

DWORD GetSel( ) const;
void GetSel( int& nStartChar, int& nEndChar ) const;
兩個函數(shù)都是CEdit的成員函數(shù)，用來獲得所選正文的位置。GetSel的第一個版本返回一個DWORD值，其中低位字說明了被選擇的正文開始處的字符索引，高位字說明了選擇的正文結(jié)束處的后面一個字符的字符索引，如果沒有正文被選擇，那么返回的低位和高位字節(jié)都是當(dāng)前插入符所在字符的字符索引。GetSel的第二個版本的兩個參數(shù)是兩個引用，其含義與第一個版本函數(shù)返回值的低位和高位字相同。

int LineFromChar( int nIndex = –1 ) const;
CEdit的成員函數(shù)，僅用于多行編輯框，用來返回指定字符索引所在行的行索引（從零開始編號）。參數(shù)nIndex指定了一個字符索引，如果nIndex是-1，那么函數(shù)將返回選擇正文的第一個字符所在行的行號，若沒有正文被選擇，則該函數(shù)會返回當(dāng)前的插入符所在行的行號。

int LineIndex( int nLine = –1 ) const;
CEdit的成員函數(shù)，僅用于多行編輯框，用來獲得指定行的開頭字符的字符索引，如果指定行超過了編輯框中的最大行數(shù)，該函數(shù)將返回-1。參數(shù)nLine是指定了從零開始的行索引，如果它的值為-1，則函數(shù)返回當(dāng)前的插入符所在行的字符索引。

int GetLineCount( ) const;
CEdit的成員函數(shù)，僅用于多行編輯框，用來獲得正文的行數(shù)。如果編輯框是空的，那么該函數(shù)的返回值是1。

int LineLength( int nLine = –1 ) const;
CEdit的成員函數(shù)，用于獲取指定字符索引所在行的字節(jié)長度（行尾的回車和換行符不計算在內(nèi)）。參數(shù)nLine說明了字符索引．如果nLine的值為-1，則函數(shù)返回當(dāng)前行的長度（假如沒有正文被選擇），或選擇正文占據(jù)的行的字符總數(shù)減去選擇正文的字符數(shù)（假如有正文被選擇）。若用于單行編輯框，則函數(shù)返回整個正文的長度。

int GetLine( int nIndex, LPTSTR lpszBuffer ) const;
int GetLine( int nIndex, LPTSTR lpszBuffer, int nMaxLength ) const;
CEdit的成員函數(shù)，僅用于多行編輯框，用來獲得指定行的正文（不包括行尾的回車和換行符）。參數(shù)nIndex是行號，lpszBuffer指向存放正文的緩沖區(qū)，nMaxLength規(guī)定了拷貝的最大字節(jié)數(shù)，若。函數(shù)返回實際拷貝的字節(jié)數(shù)，若指定的行號大于編輯框的實際行數(shù)，則函數(shù)返回0。需要注意的是，GetLine函數(shù)不會在緩沖區(qū)中字符串的末尾加字符串結(jié)束符(NULL)．

下列CWnd或CEdit類的成員函數(shù)可用來修改編輯框控件。

void SetWindowText( LPCTSTR lpszString );
CWnd的成員函數(shù)，可用來設(shè)置窗口的標(biāo)題或控件中的正文。參數(shù)lpszString可以是一個CString對象，或是一個指向字符串的指針。

void SetSel( DWORD dwSelection, BOOL bNoScroll = FALSE );
void SetSel( int nStartChar, int nEndChar, BOOL bNoScroll = FALSE );
CEdit的成員函數(shù)，用來選擇編輯框中的正文。參數(shù)dwSelection的低位字說明了選擇開始處的字符索引，高位字說明了選擇結(jié)束處的字符索引。如果低位字為0且高位字節(jié)為-1，那么就選擇所有的正文，如果低位字節(jié)為-1，則取消所有的選擇．參數(shù)bNoScroll的值如果是FALSE，則滾動插入符并使之可見，否則就不滾動．參數(shù)nStartChar和nEndChar的含義與參數(shù)dwSelection的低位字和高位字相同．

void ReplaceSel( LPCTSTR lpszNewText, BOOL bCanUndo = FALSE );
CEdit的成員函數(shù)，用來將所選正文替換成指定的正文．參數(shù)lpszNewText指向用來替換的字符串．參數(shù)bCanUndo的值為TRUE說明替換是否可以被撤消的．

在調(diào)用上述函數(shù)時，如果涉及的是一個多行編輯框，那么除了LineLength和GetLine函數(shù)外，都要把回車和換行符考慮在內(nèi)．例如，假設(shè)在編輯框中有如下幾行正文：

abcd

efg

ij

那么字母＂e＂的字符索引是6而不是4，因為＂abcd＂后面還有一對回車換行符．調(diào)用LineLength(7)會返回第二行的長度3．調(diào)用LineIndex(2)會得到11．調(diào)用LineFromChar(8)會返回1．如果沒有選擇任何正文，并且插入符在字母＂e＂上，那么調(diào)用GetSel返回值的低位和高位字都是6．

通過分析上述函數(shù)，我們可以總結(jié)出一些查詢和設(shè)置編輯框的方法．

調(diào)用CWnd的成員函數(shù)GetWindowText和SetWindowText可以查詢和設(shè)置編輯框的整個正文，在上一章的Register程序中，我們就使用過這兩個函數(shù)．

如果想對多行編輯框逐行查詢，那么應(yīng)該先調(diào)用GetLineCount獲得總行數(shù)，然后再調(diào)用GetLine來獲取每一行的正文．下面一段代碼演示了如何對多行編輯框進行逐行查詢．

char buf[40];

int total=MyEdit.GetLineCount();

int i,length;

for(i=0;i

{

length=MyEdit.GetLine(i,buf,39);

buf[length]=0; //加字符串結(jié)束符

. . . . . .}

可以利用LineIndex和LineFromChar來在字符索引和字符的行列坐標(biāo)之間相互轉(zhuǎn)換．下列代碼演示了在已知字符索引的情況下，如何獲得對應(yīng)的行列坐標(biāo)：
int row,column;
row=MyEdit.LineFromChar(charIndex);
column=charIndex-MyEdit.LineIndex(row);
下列代碼演示了在已知字符的行列坐標(biāo)的情況下，如何獲得對應(yīng)的字符索引：
int charIndex;
charIndex=MyEdit.LineIndex(row)+column;
不難看出字符索引與對應(yīng)的行列坐標(biāo)的關(guān)系是：字符索引=LineIndex(行坐標(biāo))+列坐標(biāo)．

對于選擇正文的查詢和設(shè)置，應(yīng)該利用函數(shù)GetSel、SetSel和ReplaceSel．

可以利用GetSel和SetSel來查詢和設(shè)置插入符的位置．SetSel可以使編輯框滾動到插入符的新位置．
要獲取插入符的行列坐標(biāo)，可用下面的代碼實現(xiàn)：
MyEdit.SetSel(-1,0); //取消正文的選擇
int start,end,row,column;
MyEdit.GetSel(start,end); //start或end的值就是插入符的字符索引
row=MyEdit.LineFromChar(start); //獲取插入符的行坐標(biāo)
column=start-MyEdit.LineIndex(row); //獲取插入符的列坐標(biāo)
下面的代碼演示了如何把插入符移到指定的行和列：
MyEdit.SetSel(-1,0); //取消正文的選擇
int charIndex=MyEdit.LineIndex(row)+column;
MyEdit.SetSel(charIndex,charIndex);

可以利用ReplaceSel函數(shù)在 插入符處插入正文，典型的代碼如下所示：
MyEdit.SetSel(-1,0); //取消正文的選擇
MyEdit.ReplaceSel(“......”);

可以利用ReplaceSel清除編輯框中的正文，典型的代碼如下所示：
MyEdit.SetSel(0,-1); //選擇全部正文
MyEdit.ReplaceSel(“”);

posted on 2007-12-21 17:00 isabc 閱讀(5029) 評論(1)  編輯 收藏 引用 所屬分類: VC Demo