TTextStrings.AddObject function

Declaration

function AddObject(const S: string; AObject: TObject): Integer
 ; override

Arguments

Function result

Ordinal position where the string and object were stored.

Description

Adds a LineEnding if the value in Text does not already end with one of the end-of-line characters.

Calls BuildArrays when an object instance has been assigned to AObject.

Recalculates the number of lines in the internal line ranges array. If the number of lines is larger than the current capacity for the array, the capacity is doubled. The memory for the line range array is re-allocated to the new capacity, and the unused portion is zero-filled.

The value in AObject is stored in the TTextLineRange instance for the new line. The start and end positions, and the text are stored in the line range information.

The internal line count is incremented prior to exiting from the method.