Text and Typing

Sets and reads the text of a RichTextBox, as plain text and as RTF, and limits what the user can type into it.

RichTextBox1.Text = "one" & vbCrLf & "two"
Debug.Print RichTextBox1.TextLength; InStr(RichTextBox1.Text, vbCr); InStr(RichTextBox1.Text, vbLf)
RichTextBox1.UseCrLf = True
Debug.Print RichTextBox1.TextLength; InStr(RichTextBox1.Text, vbCrLf)
' Output:
'  7  4  0
'  8  4

Paragraphs

The control ends each paragraph with one carriage return, vbCr. A vbCrLf in a text that the program assigns becomes one vbCr, so Text and TextLength count one character for each line break. With UseCrLf set to True, Text and TextLength give each line break as vbCrLf, as a TextBoxW does. The selection and the places of characters are counted in the control’s own characters, with one for each line break, whatever UseCrLf says.

Plain text and RTF

TextRTF is the whole text with its formatting, in the Rich Text Format, and an assignment to it replaces the text and its formatting with the document assigned. Text is the same text without its formatting.

With TextMode set to RtfTextModePlainText the control holds plain text, in one format for the whole of it. A format given to a part of the text, such as SelBold, does not change it, and an assignment to TextRTF leaves the control empty; TextRTF still returns the text as a document. A change of TextMode empties the control.

RichTextBox1.TextMode = RtfTextModePlainText
RichTextBox1.Text = "ab cd"
RichTextBox1.SelStart = 0
RichTextBox1.SelLength = 2
RichTextBox1.SelBold = True             ' has no effect on plain text
Debug.Print RichTextBox1.SelBold
RichTextBox1.TextMode = RtfTextModeRichText
Debug.Print "[" & RichTextBox1.Text & "]"
' Output:
' False
' []

Changes and the Modified flag

The control raises Change each time its text changes: the user typed, deleted, pasted or took a change back, or the program assigned Text, TextRTF, SelText or SelRTF. An assignment to Text raises it even when the new text is the old one, which a TextBoxW does not.

Modified says whether the text has changed since the program last assigned Text. An assignment to Text sets it to False; typing, an assignment to SelText and an assignment to TextRTF set it to True.

What the user may type

MaxLength limits what the user types and pastes: a character typed into a full box is refused, and the control raises MaxText. It does not limit what the program assigns to Text, TextRTF or SelText, unlike the MaxLength of a TextBoxW. With MaxLength 0, the default, the user can type up to 65,536 characters, the limit that Windows gives a rich edit control.

RichTextBox1.MaxLength = 3
RichTextBox1.Text = "ab"
RichTextBox1.SelStart = 2
RtbTextSendMessage RichTextBox1.hWnd, &H102, AscW("c"), 0   ' WM_CHAR, as a key would
RtbTextSendMessage RichTextBox1.hWnd, &H102, AscW("d"), 0   ' refused: the box is full
Debug.Print RichTextBox1.Text
' Output:
' abc

RtbTextSendMessage in this sample is the Windows function SendMessageW, declared by the program.

With Locked set to True the user can select and copy the text and cannot change it. The program still can, with Text, TextRTF and SelText.

The Insert key switches OverTypeMode on and off, as in a TextBoxW with AllowOverType; here AllowOverType is True by default. While it is on, a character that the user types replaces the character after the insertion point.

A box for a password shows one character in place of each character of the text, the one in PasswordChar or the dot of Windows with UseSystemPasswordChar, as a TextBoxW does. Text returns the real text.

Properties

AllowOverType

Whether the Insert key switches OverTypeMode on and off. Boolean. Default: True. Setting it to False also sets OverTypeMode to False.

IMEMode

The state of the Input Method Editor while the box has the focus. A member of CCIMEModeConstants. Default: CCIMEModeNoControl. Another value raises run-time error 380.

Locked

Whether the user is kept from changing the text. Boolean. Default: False. The user can still select and copy the text, and the program can still change it.

MaxLength

The greatest number of characters that the user can type or paste into the box. Long. Default: 0, with which the limit is 65,536 characters. See What the user may type.

A negative value raises run-time error 380.

Modified

Whether the text has changed since the program last assigned Text. Boolean. See Changes and the Modified flag. The program can set it as well.

MultiLine

Whether the box holds several paragraphs and wraps a line that is too long. Boolean. A control newly drawn on a form has True. With False the box holds one line, which scrolls sideways, and has no scroll bars.

It is set at design time: an assignment while the program runs raises run-time error 382, MultiLine property is read-only at run time.

OverTypeMode

Whether a character that the user types replaces the character after the insertion point. Boolean. Default: False. It can be True only while AllowOverType is True: otherwise an assignment of True leaves it False.

PasswordChar

The character that the box shows in place of each character of its text. String. An empty string shows the text itself.

While the box has no password character, it returns an empty string, as the PasswordChar of a TextBoxW does. A string of more than one character raises run-time error 380. An assignment does nothing while UseSystemPasswordChar is True.

Text

The text of the box, without its formatting. String. A control newly drawn on a form has its own name. Paragraphs end with vbCr, or with vbCrLf while UseCrLf is True.

An assignment replaces the whole text, raises Change and sets Modified to False. It replaces protected text as well.

TextLength

The number of characters in Text. Long, read-only.

TextMode

Whether the box holds formatted text or plain text. A member of RtfTextModeConstants. Default: RtfTextModeRichText. A change empties the box. See Plain text and RTF.

Another value raises run-time error 380.

TextRTF

The whole text with its formatting, as a document in the Rich Text Format. String. It is the control’s default member.

An assignment replaces the text and its formatting with the document, raises Change and sets Modified to True. While the text holds protected text, the assignment raises ModifyProtected, and changes nothing unless the handler allows it.

UseCrLf

Whether Text and TextLength give each line break as vbCrLf rather than vbCr. Boolean. Default: False.

UseSystemPasswordChar

Whether the box shows the password dot of Windows in place of each character of its text. Boolean. Default: False. While it is True the control ignores PasswordChar. A change makes the control’s window again, with the same text, so hWnd returns another handle afterwards.

WantReturn

Whether the Enter key starts a new paragraph in a multi-line box on a form that has a default button. Boolean. Default: True. With False the key presses the default button.

Events

Change

Raised when the text has changed. See Changes and the Modified flag.

Syntax: object_Change( )

MaxText

Raised when the user types or pastes more characters than MaxLength allows. The box keeps what fits and refuses the rest.

Syntax: object_MaxText( )

RtfTextModeConstants

The values of TextMode.

Member Value Description
RtfTextModeRichText 0 Formatted text: each character and each paragraph can have a format of its own.
RtfTextModePlainText 1 Plain text, in one format for the whole of it.

See Also

  • RichTextBox control
  • Selection – SelText and SelRTF, the text of the selection
  • TextBoxW control – the password characters and the Insert key, which work as they do here