HideCursor Property

Applies to TestComplete 15.47, last modified on January 20, 2023

Specifies whether the component displays the caret.

Declaration

componentPropObj.HideCursor
Read-Write Property Boolean
componentPropObj     One of the objects listed in the Applies To section  

Applies To

This property applies to the following objects:

TcxButtonEditProperties

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.

See Also

ReadOnly Property
ViewStyle Property

Highlight search results