SelText Property

Applies To   See Also

Returns the text that the user selected in a text-entry area of a control, or returns an empty string ("") if no characters are selected. Specifies the string containing the selected text. Not available at design time; read-write at run time.

Syntax

[Form.]Control.SelText[= cString]

Settings

cString

Specifies the string containing the selected text or consists of an empty string if no characters are selected. Selected text appears shaded.

Remarks

Use this property with the SelLength and SelStart properties for tasks such as:

• Setting the insertion point within a string of characters.
  
  
• Establishing an insertion range that limits where the insertion point can go.
  
  
• Selecting a specific group of characters (substrings) in a control.
  
  
• Clearing text.

When working with these properties, be aware of the following behaviors:

• Setting SelLength to less than 0 causes a run-time error.
  
  
• Setting SelStart to greater than the text length sets the property to the existing text length. Changing SelStart changes the selection to an insertion point and sets SelLength to 0.
  
  
• Setting SelText to a new value sets SelLength to 0 and replaces the selected text with the new string.