RiverSoftAVG Products Help

Zoom Window Out
Larger Text | Smaller Text
Hide Page Header
Show Expanding Text
Printable Version
Send Mail Feedback
Save Permalink URL

Navigation: Code Documentation > RSCommon > RSGenerics.Collections > Classes > TStringList<T>

TStringList<T> Properties

Scroll Prev Top Next More

Name

Description

protected property

Assigning

Specifies whether the list is being assigned to or not.

public property

CaseSensitive

Controls whether strings are located, sorted, and identified as duplicates in a case-sensitive or case-insensitive manner.

Use CaseSensitive to indicate whether strings in the list should be compared in a case-sensitive or case-insensitive manner. Set CaseSensitive to True to make the string list locate, check for duplicates, and sort its strings in a case-sensitive manner. Set CaseSensitive to False to make the string list perform these operations case-insensitively.

Note
By default, the CaseSensitive property is set to False.

public property

DataValues

Returns the TValueCollection that is used to create enumerators

public property

Data[Integer]

Specifies the generic item that is associated with the string and object given by the Index parameter.

public property

Duplicates

Specifies whether duplicate strings can be added to sorted lists.

Set Duplicates to specify what should happen when an attempt is made to add a duplicate string to a sorted list. The CaseSensitive property controls whether two strings are considered duplicates if they are identical except for differences in case.

The value of Duplicates should be one of the following.:

dupIgnore

Ignore attempts to add duplicate strings to the list.

dupError

raise an EStringListError exception when an attempt is made to add duplicate strings to the sorted list.

dupAccept

Permit duplicate strings in the sorted list.

public property

OnChange

Occurs immediately after the list of strings changes.

Write an OnChange event handler to respond to changes in the list of strings. For example, if the string list is associated with a control, the OnChange event handler could tell the control to repaint itself whenever the content of the list changes.

Whenever strings in the list are added, deleted, moved, or modified, the following events take place:

• An OnChanging event occurs before the change.

• The strings are added, deleted, moved, or modified.

• An OnChange event occurs.

Note
OnChange occurs for every change made to the list, regardless of whether the application calls BeginUpdate and EndUpdate around a series of changes.

public property

OnChanging

Occurs immediately before the list of strings changes.

Write an OnChanging event handler to prepare for changes in the list of strings. For example, if the string list is associated with a control, the OnChanging event handler could tell the control to disable repaints until the RSGenerics.Collections.TStringList<T>.OnChange event is triggered, notifying the control that the list has finished changing.

Whenever strings in the list are added, deleted, moved, or modified, the following events take place:

• An OnChanging event occurs before the change.

• The strings are added, deleted, moved, or modified.

• An OnChange event occurs.

Note
OnChanging occurs for every change made to the list, regardless of whether the application calls BeginUpdate and EndUpdate around a series of changes.

public property

OwnsObjects

Specifies whether to free the associated Object when a string is deleted from the string list.

public property

Sorted

Specifies whether the strings in the list should be automatically sorted.

Set Sorted to true to cause the strings in the list to be automatically sorted in ascending order. Set Sorted to false to allow strings to remain where they are inserted. When Sorted is false, the strings in the list can be put in ascending order at any time by calling the Sort method.

When Sorted is true, do not use Insert to add strings to the list. Instead, use Add, which will insert the new strings in the appropriate position. When Sorted is false, use Insert to add strings to an arbitrary position in the list, or Add to add strings to the end of the list.

Note
The CaseSensitive property controls whether the strings in the list are sorted based on a case-sensitive or case-insensitive comparison. The sort order takes into account the locale of the system on which the application is running.

Top