Modifie une colonne dans un champ "Table horizontale".
Remarque : La fonction <Table>.ModifieColonne peut être utilisée indifféremment sur :
- un champ Table horizontale de type "fichier" ou "par programmation".
- un champ Table horizontale monosélection ou multisélection.
Syntaxe
<Champ Table>.ModifieColonne(<Indice> [, <Élément ligne 1> [... [, <Élément ligne N>]]])
<Champ Table> : Nom de champ
Nom du champ Table horizontale à manipuler.
<Indice> : Entier
Indice de la colonne à modifier. La première colonne a pour indice 1. | |
| Indice égal à -1. | La colonne en cours est modifiée. Aucun effet si aucune colonne n'est sélectionnée. |
| Indice supérieur au nombre de colonnes du champ Table. | Une erreur du WLangage est générée. |
<Élément ligne 1> : Chaîne de caractères optionnelle
Premier élément de la première ligne à modifier dans la colonne. La valeur de cet élément remplace la valeur existante. Chaque élément correspond à une ligne dans le champ Table. Chaque type d'élément modifié doit être compatible avec le type de la ligne concernée.
Si aucun des paramètres <Elément ligne X> n'est spécifié, la fonction <Table>.ModifieColonne n'a aucun effet.
<Élément ligne N> : Chaîne de caractères optionnelle
Nième élément de la Nième ligne à modifier dans la colonne. La valeur de cet élément remplace la valeur existante. Chaque élément correspond à une ligne dans le champ Table. Chaque type d'élément modifié doit être compatible avec le type de la ligne concernée.
Si aucun des paramètres <Elément ligne X> n'est spécifié, la fonction <Table>.ModifieColonne n'a aucun effet.
Remarques
Caractéristique des éléments de la colonne
- Pour modifier uniquement la valeur d'un élément dans une colonne, utilisez la syntaxe suivante :
ChampTable.Nomligne[IndiceColonne] = NouvelleValeur
- Si un élément correspond au résultat d'un calcul, mettez l'expression numérique entre parenthèses. Par exemple :
TABLE_TableCalcul.ModifieColonne((53+29),(83-21))
Table fichier : Modifications dans le fichier de données lié
Si la saisie en cascade est activée, le fichier de données lié au champ Table fichier est automatiquement modifié lorsque l'utilisateur passe à la colonne suivante.
Si la saisie en cascade n'est pas activée, le fichier de données lié au champ Table fichier n'est pas modifié. Pour écrire l'enregistrement dans le fichier de données, exécutez la fonction
<Table>.Enregistre après la fonction
<Table>.ModifieColonne.
Rappel : L'option "saisie en cascade" peut être sélectionnée :
- Lors de la création d'un champ Table.
- Dans l'onglet "Détail" de la fenêtre de description du champ Table sous l'éditeur de fenêtres.
Modifications réalisées dans un champ Table fichier
Pour modifier une colonne d'un champ Table fichier, il est conseillé de :
- modifier directement l'enregistrement dans le fichier avec la fonction <Source>.Modifie,
- utiliser la fonction <Table>.Affiche pour ré-actualiser le champ Table.
Fonction <Table>.ModifieColonne et propriété Modifié
La fonction
<Table>.ModifieColonne n'a aucune influence sur la propriété
Modifié. La propriété
Modifié permet de savoir si la colonne en cours a été modifiée directement par l'utilisateur (saisie directe dans le champ Table).
Composante : wd280obj.dll