Vcl.ValEdit.TValueListEditor.InsertRow

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

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

C++

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

Propriétés

Type Visibilité  Source Unité  Parent
function public
Vcl.ValEdit.pas
Vcl.ValEdit.hpp
Vcl.ValEdit TValueListEditor

Description

Insère une ligne dans l'éditeur de liste de valeurs et une chaîne correspondante dans l'objet TStrings associé.

Appelez InsertRow pour ajouter une paire nom/valeur à l'éditeur de liste de valeurs et à l'objet TStrings qu'il modifie.

InsertRow ajoute une chaîne de la forme

NomClé=Valeur

à la propriété Strings et actualise l'affichage afin de refléter la modification.

Si la ligne en cours de l'éditeur de liste de valeurs est vide (dépourvue de partie nom ou valeur), InsertRow lui affecte les nouvelles valeurs KeyName et Value. Sinon, si le paramètre Append a la valeur true, la nouvelle chaîne apparaît après la ligne actuellement sélectionnée alors que si Append a la valeur false, la nouvelle chaîne apparaît avant la chaîne actuellement sélectionnée.

Remarque :  InsertRow insère la ligne spécifiée, indépendamment de la valeur de KeyOptions. L'option keyAdd de KeyOptions détermine uniquement si l'utilisateur peut ajouter de nouvelles lignes en appuyant sur la touche Inser ou en naviguant au-delà de la dernière ligne.

Voir aussi