Specifies whether the component displays the caret.
Declaration
| Read-Write Property | Boolean |
| componentPropObj | One of the objects listed in the Applies To section |
Applies To
This property applies to the following objects:
Description
Use the HideCursor property to specify whether the component displays the caret within the edit field. If the caret is hidden, the component’s text cannot be changed in the edit field.
Property Value
True, if the component hides the caret or False otherwise.
Remarks
Setting the HideCursor property to True forbids user input into the edit field of the component. The component’s text can only be changed from script code (for instance, it can be changed by an event handler that processes button presses). This is similar to the situation when the ReadOnly property is True, but the difference is that in read-only mode the component does not hide the cursor thus giving a user the possibility to copy the component’s text to the clipboard.
Note that the ViewStyle and HideCursor properties depends on each other. HideCursor is only True if ViewStyle is not equal to vsNormal and vice versa. For instance, if ViewStyle is vsNormal (or 0) and you assign True to HideCursor, the ViewStyle property value will be changed to vsHideCursor. If you assign vsNormal to the ViewStyle property, HideCursor is automatically changed to False.