PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Conditions d'utilisation
  • Caractéristiques d'une ligne
  • Position de la ligne ajoutée
  • Limites : Nombre maximum de lignes affichées
  • Divers
  • Ajout de lignes
  • Saisie en chaîne
  • Champ Table/Table hiérarchique fichier : Modifications dans le fichier de données lié
  • Champ Table/Table hiérarchique fichier : Ajout de plusieurs lignes
  • Ajout dans un champ Table fichier et déclenchement d'un trigger
  • Champ Table/Table hiérarchique fichier en saisie
  • Ajout d'image
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Ajoute une ligne dans :
  • un champ Table,
  • un champ Table hiérarchique,
  • WINDEVWindows Mobile un champ "Combo avec table" (champ Table affiché dans un champ Combo).
Remarque : Il est conseillé d'utiliser la fonction <Table>.AjouteLigne. La fonction <Table>.AjouteLigne permet d'ajouter :
  • des caractères TAB dans les colonnes,
  • des valeurs de n'importe quel type dans les colonnes.
Versions 18 et supérieures
WEBDEV - Code ServeurPHP Cette fonction permet désormais de manipuler les champs Table hiérarchique dans les sites WEBDEV et PHP.
Nouveauté 18
WEBDEV - Code ServeurPHP Cette fonction permet désormais de manipuler les champs Table hiérarchique dans les sites WEBDEV et PHP.
WEBDEV - Code ServeurPHP Cette fonction permet désormais de manipuler les champs Table hiérarchique dans les sites WEBDEV et PHP.
Versions 19 et supérieures
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code Navigateur pour les champs Table en mode navigateur.
Nouveauté 19
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code Navigateur pour les champs Table en mode navigateur.
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code Navigateur pour les champs Table en mode navigateur.
Versions 20 et supérieures
Android Cette fonction est désormais disponible pour les applications Android.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 20
Android Cette fonction est désormais disponible pour les applications Android.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Android Cette fonction est désormais disponible pour les applications Android.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Exemple
// Ajout de "Dubois", "Pierre" et "21/06/72"
// à la fin du champ "TABLE_TableClient"
ResAjout = TABLE_TableClient.Ajoute("Dubois" + TAB + "Pierre" + TAB + "21/06/72")
Syntaxe
<Résultat> = <Champ Table>.Ajoute([<Ligne>])
<Résultat> : Booléen
  • Vrai si l'élément a été ajouté,
  • Faux dans le cas contraire.
<Champ Table> : Nom de champ
Nom du champ à manipuler. Ce champ peut correspondre à :
  • un champ Table.
  • un champ Table hiérarchique.
  • WINDEVWindows Mobile un champ Combo avec table.
<Ligne> : Chaîne de caractères optionnelle
Ligne à ajouter. Cette ligne est de la forme :
<Elément de la colonne 1> + TAB + <Elément de la colonne 2> + TAB + ...

Si ce paramètre n'est pas spécifié, une ligne vide est ajoutée dans le champ. Pour un champ fichier, les valeurs par défaut définies dans le fichier de données lié sont alors prises en compte.
Remarques

Conditions d'utilisation

La fonction <Table>.Ajoute peut être utilisée indifféremment sur :
  • un champ fichier ou mémoire,
  • un champ monosélection ou multisélection.
    WEBDEV - Code ServeurPHP Rappel : Les champs multisélections sont disponibles uniquement en Ajax. WEBDEV - Code ServeurPHP Rappel : La multisélection n'est pas disponible sur les champs Table en mode classique.
WEBDEV - Code ServeurPHP Cette fonction est disponible pour les champs Table en mode Ajax, les champs Table en mode classique et les champs Table hiérarchique.
WEBDEV - Code Navigateur Cette fonction est disponible uniquement pour les champs Table en mode navigateur.
WEBDEV - Code NavigateurAndroidiPhone/iPad Le champ Table hiérarchique n'est pas disponible.
AndroidiPhone/iPad Les champs Table fichier ne sont pas disponibles en saisie. La fonction <Table>.Ajoute ne peut pas être utilisée sur un champ Table fichier.

Caractéristiques d'une ligne

  • Chaque élément ajouté est converti dans le type de la colonne concernée.
  • Pour ne pas spécifier de valeur pour un élément, utilisez une chaîne vide ("") ou 0 (selon le type de la colonne). Par exemple :
    TABLE_TableClient.Ajoute("Dubois" + TAB + "Pierre" + TAB + "" + TAB + "21/06/72")
  • Si un élément correspond au résultat d'un calcul, mettez l'expression numérique entre parenthèses. Par exemple :
    TABLE_TableCalcul.Ajoute((53+29) + TAB + (83-21))

Position de la ligne ajoutée

Par défaut, la ligne est ajoutée à la fin des lignes affichées par le champ.
Cas particulier :
  • Si le champ est trié avec la fonction <Table>.Trie, la ligne ajoutée est positionnée dans le champ en fonction du tri en cours.
  • Si le champ est trié par l'utilisateur, le tri n'est pas pris en compte lors de l'ajout de la ligne. La ligne est ajoutée à la fin du champ.
AndroidiPhone/iPad Cas particulier :
  • Si le champ est trié avec la fonction <Table>.Trie, la ligne ajoutée est positionnée dans le champ en fonction du tri en cours.
  • Si le champ est trié par l'utilisateur, la ligne ajoutée est positionnée dans le champ en fonction du tri en cours.

Limites : Nombre maximum de lignes affichées

Le nombre maximum de lignes pouvant être affichées dans un champ Table ou Table hiérarchique est limité uniquement par la mémoire vive disponible (maximum théorique : 2 milliards de lignes).
Il est cependant déconseillé d'utiliser des champs Table ou Table hiérarchique avec un nombre de lignes important pour des raisons de performance (temps nécessaire pour remplir le champ par exemple) et d'utilisabilité.

Divers

  • Pour ajouter une ligne dans un champ Table ou Table hiérarchique à une position spécifique, utilisez la fonction <Table>.InsèreLigne.
  • Si la ligne ajoutée est la première ligne du champ, la ligne ajoutée devient la ligne en cours.
WINDEVWEBDEV - Code ServeurWindows MobileJavaPHP

Ajout de lignes

La propriété ..Nouveau permet de savoir si la ligne en cours vient d'être créée par la fonction <Table>.Ajoute (..Nouveau = Vrai).
WINDEVWEBDEV - Code ServeurWindows MobileJavaPHP

Saisie en chaîne

Pour effectuer une saisie en chaîne, utilisez la fonction <Table>.Ajoute dans l'événement "Sortie d'une ligne" du champ Table de la façon suivante :
SI TABLE_TableClient..Nouveau ALORS
TABLE_TableClient.Ajoute()
FIN
WEBDEV - Code ServeurPHP Ce fonctionnement est disponible uniquement pour les champs Table en mode Ajax.
WINDEVWEBDEV - Code ServeurWindows MobileJavaPHP

Champ Table/Table hiérarchique 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 est automatiquement modifié lorsque l'utilisateur passe à la ligne suivante.
  • Si la saisie en cascade n'est pas activée, le fichier de données lié au champ n'est pas modifié. Pour écrire le contenu de la ligne ajoutée dans le fichier de données lié, il est nécessaire d'utiliser la fonction <Table>.Enregistre après la fonction <Table>.Ajoute.
Remarques :
  • L'option "Saisie en cascade (Ajout)" peut être sélectionnée dans l'onglet "Détail" de la description du champ.
  • Java La saisie en cascade n'est pas disponible sur les champs Table fichier à accès direct. Cette option est disponible uniquement sur les champs Table mémoire et sur les champs Table fichier chargé en mémoire.
  • Versions 19 et supérieures
    WEBDEV - Code Serveur La saisie en cascade est disponible uniquement sur les champs Table fichier Ajax.
    Nouveauté 19
    WEBDEV - Code Serveur La saisie en cascade est disponible uniquement sur les champs Table fichier Ajax.
    WEBDEV - Code Serveur La saisie en cascade est disponible uniquement sur les champs Table fichier Ajax.
WINDEVWEBDEV - Code ServeurWindows MobileJavaPHP

Champ Table/Table hiérarchique fichier : Ajout de plusieurs lignes

A chaque appel de la fonction <Table>.Ajoute dans un champ Table ou Table hiérarchique fichier, une ligne virtuelle est créée dans le champ. Les informations seront enregistrées dans le fichier de données lié uniquement que lors de l'appel de la fonction <Table>.Enregistre.
Si la fonction <Table>.Ajoute est appelée successivement dans le même traitement sans être suivie de la fonction <Table>.Enregistre, seul le PREMIER appel est effectif (les appels suivants sont ignorés). Une seule ligne est ajoutée dans le champ Table/Table hiérarchique fichier.
WEBDEV - Code ServeurPHP Ce fonctionnement est disponible uniquement pour les champs Table fichier Ajax.
WINDEVWEBDEV - Code ServeurWindows MobileJavaCode Utilisateur (MCU)

Ajout dans un champ Table fichier et déclenchement d'un trigger

Il est possible de déclencher un trigger lors de l'ajout d'un enregistrement dans un champ Table fichier. Pour plus de détails, consultez la documentation de HDécritTrigger.
WEBDEV - Code Serveur Ce fonctionnement est disponible uniquement pour les champs Table fichier Ajax.
WINDEVWindows MobileJavaCode Utilisateur (MCU)

Champ Table/Table hiérarchique fichier en saisie

Si la fonction <Table>.Ajoute est appelée :
  • Dans un événement du champ, le curseur est automatiquement positionné sur la première colonne à saisir dans la ligne ajoutée.
  • Dans un événement n'appartenant pas au champ (ou dans un autre traitement), utilisez la fonction RepriseSaisie pour reprendre la saisie dans le champ Table ou Table hiérarchique.

Ajout d'image

Pour ajouter une image dans un champ Table ou Table hiérarchique :
  • WINDEV spécifiez directement le nom et le chemin complet de l'image à ajouter.
    Par exemple :
    TABLE_MaTable.Ajoute("C:\MesDocuments\MonImage.BMP")
  • WEBDEV - Code ServeurPHP spécifiez le chemin et le nom de l'image à ajouter. Le chemin est relatif au répertoire "<Nom_Projet>_WEB".
    Par exemple :
    // Ajoute l'image située dans le répertoire "WB_MonAppli_WEB"
    TABLE_MaTable.Ajoute("MonImage.BMP")
Remarque : Pour afficher correctement l'image ajoutée, la colonne doit être de type Image.
Composante : wd240obj.dll
Version minimum requise
  • Version 23
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire