文本(或文字)控件是“文本框控件”的简称,它通常用于输入和编辑文字。它属于标准Windows编辑控件的一个子类,所以它支持所有编辑控件消息。这儿讲述的技术也适用于由其他厂商设计的,以Windows编辑控件类为基础的其他控件。

　　本文将介绍文本控件的消息,这些消息显著扩展了控件本身的能力,使我们在程序中能够更灵活的控制控件,不必只仅仅依赖于Visual Basic所提供的属性或事件,这些消息在进行子类处理中很有用处。下面先介绍控件的消息,然后介绍它们的一些应用。

下表列出了文本控件的常用通知消息:

消息名称 消息说明

EN_CHANGE 编辑控件的内容一旦发生改变，就发送这条消息。

EN_ERRSPACE 任何时候只要由于内存不足以完成一项编辑操作，就发送这条消息。

EN_HSCROLL 只要用户单击了从属于一个编辑控件的水平滚动条的任何地方，就会发送这条消息。注意这条消息是在控件更新显示之前发送出去的。

EN_KILLFOCUS 一旦控件丢失了输入焦点，则发出这条消息。

EN_MAXTEXT 只要用户输人的文字试图超出由EM_LIMITTEXT消息规定购界限，或试图超出由VB Maxlength属性规定的界限，就会发送这条消息。此外，倘若不允许自动进行水平滚动，同时插入点要超出控件的宽度；或者不允许自动自动滚动，同时插入点要超出接件的高度，那么也会触发这条消息。

EN_SETFOCUS 一旦控件接收到了输入焦点，就发出这条消息。

EN_UPDATE 这条消息在控件显示出已改变的文字之前发出。它与EN_CHANGE通知消息相似，只是它发生于更新文本显示出来之前。

EN_VSCROLL 只要用户单击了从属于一个编辑控件的垂直滚动条的任何地方，就会发送这条消息。注意这条消息是在控件更新显示之前发送出去的。

下表列出了文本控件的常用消息:

消息名称 消息说明

EM_CANUNDO 决定前一次编辑操作是否能够撤消

EM_EMPTYUNDOBUFFER 清除控件的撤消缓冲区，使其不可能撤消前一次编辑操作

EM_UNDO 撤消前一次编辑操作

EM_FMTLINES 决定是否在取回的文本宇串中包含软回车字符

EM_GETLIMITTEXT 获取一个编辑控件中文本的最大长度

EM_GETMARGINS 获取编辑控件的左、右边距(不得用于NT3．51)

EM_GETRECT 获取一个编辑控件的格式化矩形

EM_LIMITTEXT 限制编辑耀件甲购文本长度

EM_SETLIMITTEXT 限制编辑控件中的文本长度(不得用于NT3．51)

EM_SETMARGINS 设置编辑控件的左、右边距(不得用于NT3．51)

EM_SETRECT 为一个编辑控件设置格式化矩形

EM_SETRECTNP 与EM_SETRECT类似，只是控件此时不会重画

EM_SETTABSTOPS 设置编辑控件中的制表站间距

EM_CHARFROMPOS 判断编辑控件指定位置处的字符(不适用于NT3．51)

EM_GETFIRSTVISIBLEIN 判断编辑控件中显示的第一行

EM_GETLINE 从编辑控件取回…行的内容

EM_GETLINECOUNT 判断一个编辑控件的总行数

EM_GETMODIFY 判断编辑控件的内容是否已发生变化

EM_GETPASSWORDCHAR 取得编辑控件的密码字符

EM_GETSEL 判断编辑控件中一段选定内容的起点与终点

EM_LINEFROMCHAR 判断是哪一行显示了某个特殊字符

EM_LINEINDEX 判断指定行第一个字符的编号

EM_LINELENGTH 判断一行长度

EM_LINESCROLL 滚动编辑控件

EM_POSFROMCHAR 判断指定字符在编辑控件的位置(用于NT3．51)

EM_REPLACESEL 用指定文本替换编辑控件中的当前选定内容

EM_SETMODIFY 用于设置或清除一个编辑控件的修改标志

EM_SETPASSWORDCHAR 为指定的控件设置密码字符

EM_READONLY 决定是否将编辑控件设为只读

EM_SETSEL 设置编辑控件中一段选定内容的起点一终点

　　下面将介绍文本框控件消息的一些应用:

下面的函数将返回控件的文本行数,如果控件的文本为空也会返回1。

Function GetLineCount(CTextBox As TextBox) As Long

　　GetLineCount = SendMessage(CTextBox.hWnd, EM_GETLINECOUNT, 0, 0)

End Function

下面的函数将返回控件中显示的第一行的行号。

Function GetFirstVisableLine(CTextBox As TextBox) As Long

　　GetFirstVisableLine = SendMessageBynum(CTextBox.hwnd, EM_GETFIRSTVISIBLELINE, 0, 0)

End Function

下面的函数将返回控件能显示的行数。

Function GetVisibleLines(CTextBox As TextBox) As Long

Dim rc As RECT

Dim hDC&, lfont&, oldfont&

Dim di&, lc&

Dim tm As TEXTMETRIC

　lc = SendMessage(CTextBox.hwnd, EM_GETRECT, 0, rc)

　lfont = SendMessage(CTextBox.hwnd, WM_GETFONT, 0, 0)

　hDC = GetDC(CTextBox.hwnd)

　If lfont <> 0 Then oldfont = SelectObject(hDC, lfont)

　　di = GetTextMetrics(hDC, tm)

　If lfont <> 0 Then lfont = SelectObject(hDC, oldfont)

　　GetVisibleLines = (rc.bottom - rc.top) / tm.tmHeight

　　di = ReleaseDC(CTextBox.hwnd, hDC)

End Function

下面的函数能够滚动控件,不过在滚动之前最好判断控件的文本行数和能够显示的行数,以免滚动时发生混乱。函数SendMessageBynum是一个SendMessage函数的安全声明函数,其定义与SendMessage函数完全相同,只是函数名不同。

Function ScrollTextBox(CTextBox As TextBox, nVal As Long, Optional nVertical As Boolean = True) As Long

　If nVertical Then

　　ScrollTextBox = SendMessageBynum(CTextBox.hwnd, EM_LINESCROLL, 0, nVal)

　Else

　　ScrollTextBox = SendMessageBynum(CTextBox.hwnd, EM_LINESCROLL, nVal, 0)

　End If

End Function

下面的函数能够返回控件指定行的文本。SendMessageBystring与SendMessageBynum类似。

Function GetLineText(CTextBox As TextBox, LineIndex As Long) As String

　Dim lc&, linechar&

　linechar = SendMessageBynum(CTextBox.hwnd, EM_LINEINDEX, LineIndex, 0)

　lc = SendMessageBynum(CTextBox.hwnd, EM_LINELENGTH, linechar, 0) + 1

　GetLineText = String$(lc + 2, 0)

　Mid$(GetLineText, 1, 1) = Chr(lc And &HFF)

　Mid$(GetLineText, 2, 1) = Chr(lc \ &H100)

　lc = SendMessageBystring(CTextBox.hwnd, EM_GETLINE, LineIndex, GetLineText)

　GetLineText = left(GetLineText, lc)

End Function

下面的函数可以设置控件的左边距。

Public Const EM_SETMARGINS& = &HD3

Public Const EC_LEFTMARGIN& = &H1

Function SetMargins(CTextBox As TextBox, nVal As Long) As Long

　SetMargins = SendMessageBynum(CTextBox.hwnd, EM_SETMARGINS, EC_LEFTMARGIN, nVal)

End Function