piMaxChars - DfBaseTextEdit

Sets or returns maximum number of visible characters

Type: Property

Access: Read/Write

Data Type: Integer

Parameters: None

Syntax 
 Property Integer piMaxChars

Read Access: Get piMaxChars to IntegerVariable
Write Access: Set piMaxChars to IntegerVariable/Value


Description

The default maximum number of visible characters for the control is 64 KB (65536 bytes or characters).

Note:
piMaxChars determines the maximum number of visible characters the user can enter into the control. However, when getting the value or saving the value to a database field, the value will contain additional non-visible characters. Each time the user presses Enter or Shift+Enter to break the line, this will be counted as a single visible character, but the value will contain 2 characters, a linefeed character (ASCII 10) followed by a carriage return character (ASCII 13).



OnMaxText fires when the maximum number of visible characters of the control is exceeded.

Sample

This sample retrieves the maximum number of visible characters of control oTextEdit1 to iMaxChars.

integer iMaxChars
get piMaxChars of oTextEdit1 to iMaxChars


Sample

This sample sets the maximum number of characters of control oTextEdit1 to 128 KB.

set piMaxChars of oTextEdit1 to (128 * 1024)


Note:
The maximum number of visible characters set by piMaxChars will not be the same as CharCount or the length of Value. This is why the cDbTextEdit class does not automatically set piMaxChars.