ComponentOne True DBInput Pro 8.0
HighlightText Property (TDBMask)

 

Reference> TDBMask Control> TDBMask Control Properties> HighlightText Property (TDBMask)

HighlightText Property (TDBMask)

This property allows you to select the contents of the control when receiving focus. You can also use the CursorPosition property in combination to determine which field to select and locate the cursor on.

Syntax

control.HighlightText= value

Read/Write at run time and design time.

Values

Design Time

Run Time

0 - None (Default)

dbiHighlightNone

1 - Field

dbiHighlightField

2 - All

dbiHighlightAll

Remarks

If set HighlightText to 0-None and the CursorPosition property to 0-Default, the selection will be determine by the settings of the SelStart, SelLength properties. Note that as soon as you click on the control, the SelStart and the SelLength settings are changed to the position clicked on.

If set HighlightText to 1-Field and the CursorPosition property to 0-Default, a non-literal field determined by the SelStart property setting will be selected. However, if the SelStart position happens to locate on a literal, the next non-literal field will be selected. If the next non-literal field does not exist, then the previous field will be selected. Note that as soon as you click on the control, the SelStart setting is changed to the position clicked on.

When set to 2 - All, the entire contents will be selected when first receiving focus, and the settings in the CursorPosition property will be ignored.

When setting the control for free format entry, the enter text, Null, and the Era expression may cause the control to be unable to determine the correct field to highlight. Therefore, in these cases, all text will be treated as one field and both the 1-Field and the 2-All will highlight the entire contents of the control when receiving focus.

By default, the cursor will be placed on the first character of the first non-literal field.

See Also

CursorPosition Property (TDBMask)

HighlightText Property (TDBNumber)

HighlightText Property (TDBNumLite)

HighlightText Property (TDBText)

SelStart Property (TDBMask)

SelLength Property (TDBMask)

Format Property (TDBMask)

 

 


Copyright (c) GrapeCity, inc. All rights reserved.

Product Support Forum  |  Documentation Feedback