Vcl.ValEdit.TValueListEditor.InsertRow

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function InsertRow(const KeyName, Value: string; Append: Boolean): Integer;

C++

int __fastcall InsertRow(const System::UnicodeString KeyName, const System::UnicodeString Value, bool Append);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
Vcl.ValEdit.pas
Vcl.ValEdit.hpp
Vcl.ValEdit TValueListEditor

Beschreibung

Fügt eine Zeile im Wertelisteneditor und den entsprechenden String im zugehörigen TStrings-Objekt hinzu.

Rufen Sie InsertRow auf, um ein Namens-/Wertepaar im Wertelisteneditor und im bearbeiteten TStrings-Objekt hinzuzufügen.

InsertRow fügt einen String im Format

KeyName=Value

in die Eigenschaft Strings ein und aktualisiert die Anzeige, damit die Änderung berücksichtigt wird.

Ist die aktuelle Zeile im Wertelisteneditor leer (keinen Namens- oder Wertebestandteil), weist InsertRow der aktuellen Zeile die neuen Werte aus KeyName und Value zu. Andernfalls wird der neue String hinter der aktuell ausgewählten Zeile eingefügt, wenn der Parameter Append den Wert true hat. Hat Append den Wert false, wird der neue String vor der aktuell ausgewählten Zeile eingefügt.

Anmerkung:  InsertRow fügt die angegebene Zeile unabhängig vom Wert von KeyOptions ein. Der Wert keyAdd in KeyOptions steuert, ob der Benutzer durch Drücken der Taste Einfg oder durch Navigieren hinter die letzte Zeile neue Zeilen einfügen kann.

Siehe auch