Vcl.ValEdit.TValueListEditor.InsertRow
Delphi
function InsertRow(const KeyName, Value: string; Append: Boolean): Integer;
C++
int __fastcall InsertRow(const System::UnicodeString KeyName, const System::UnicodeString Value, bool Append);
Properties
| Type | Visibility | Source | Unit | Parent |
|---|---|---|---|---|
| function | public | Vcl.ValEdit.pas Vcl.ValEdit.hpp |
Vcl.ValEdit | TValueListEditor |
Description
Inserts a row in the value list editor and a corresponding string into the associated TStrings object.
Call InsertRow to add a name/value pair to the value list editor and the TStrings object it is editing.
InsertRow adds a string of the form
KeyName=Value
to the Strings property and updates the display to reflect the change.
If the current row of the value list editor is empty (has no name or value portion), InsertRow assigns the new KeyName and Value to the current row. Otherwise, if the Append parameter is true, the new string appears after the currently selected row, while if Append is false, the new string appears before the currently selected row.
Note: InsertRow inserts the specified row regardless of the value of KeyOptions. The keyAdd member of KeyOptions controls only whether the user can add new rows by pressing the Insert key or navigating past the last row.