DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Table
  • Conditions d'utilisation
  • Suppression dans un champ Table ou Table hiérarchique fichier
  • Intégrité référentielle et champ Table ou Table hiérarchique fichier
  • Suppression dans un champ Table fichier et Trigger
  • Gestion des erreurs
  • Blocage du fichier de données lié
  • Suppression dans un champ Table par programmation avec un filtre de type "Contient"
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Supprime une ligne dans un champ Table, un champ Table hiérarchique (ou une table affichée dans un champ Combo) avec une animation. La durée de cette animation est paramétrable :
  • dans l'onglet "Style" de la fenêtre de description du champ Table :
    • Dans l'onglet "Style", sélectionnez l'élément "Animation de champ".
    • Dans la liste des animations, sélectionnez "Modification par TableXXXAvecAnimation()" et cliquez sur le bouton "Paramètres".
  • dans la fenêtre de description du projet :
    • Dans l'onglet "Avancé", cliquez sur le bouton "Animations des champs".
    • Dans la zone "Champ table et zone répétée", sélectionnez "Modification par TableXXXAvecAnimation()" et cliquez sur le bouton "Paramètres".
Remarque : Cette fonction est identique à la fonction TableSupprime. La seule différence est la gestion de l'animation.
Exemple
// Suppression de la ligne 5 dans le champ "TABLE_Produit"
TableSupprimeAvecAnimation(TABLE_Produit, 5)
// Supprimer toutes les lignes sélectionnées dans un champ Table
i est un entier
NbSelection est un entier = TableSelectOccurrence(TABLE_MaTable)
POUR i = NbSelection À 1 PAS -1
TableSupprimeAvecAnimation(TABLE_MaTable, TableSelect(TABLE_MaTable, i))
FIN
Syntaxe
TableSupprimeAvecAnimation(<Champ Table> [, <Indice>])
<Champ Table> : Nom de champ
Nom du champ à manipuler. Ce champ peut correspondre à :
  • un champ Table.
  • un champ Table hiérarchique.
  • un champ Combo avec table.
Si ce paramètre correspond à une chaîne vide (""), le champ Table manipulé sera celui auquel appartient l'événement en cours.
<Indice> : Entier optionnel
Indice de la ligne à supprimer.
Si ce paramètre n'est pas précisé, la ou les lignes sélectionnées sont supprimées. Si ce paramètre n'est pas précisé et si aucune ligne n'est sélectionnée, la fonction TableSupprimeAvecAnimation n'a aucun effet.
Remarques

Conditions d'utilisation

La fonction TableSupprimeAvecAnimation peut être utilisée sur :
  • un champ Table ou Table hiérarchique fichier.
  • un champ Table ou Table hiérarchique par programmation.
  • un champ monosélection ou multisélection.
L'animation n'est pas jouée dans les cas suivants :
  • si les animations sont désactivées (fonction AnimationActive).
  • si la fonction est utilisée dans les événements suivants de la fenêtre : "Déclarations globales", "Fin d'initialisation" ou "Fermeture".
  • si l'application est en mode TSE.
  • si la suppression est effectuée en dehors de la zone visible (en-dessous ou au-dessus). Dans ce cas, la suppression est réalisée et la fonction rend la main immédiatement.
La fonction ne rend la main qu'à la fin de l'animation.

Suppression dans un champ Table ou Table hiérarchique fichier

La fonction TableSupprimeAvecAnimation supprime l'enregistrement correspondant dans le fichier de données associé au champ. Si des rubriques sont reliées à d'autres fichiers de données, aucune modification n'est effectuée automatiquement sur ces fichiers de données liés.

Intégrité référentielle et champ Table ou Table hiérarchique fichier

Si la gestion de l'intégrité référentielle est active (fonction HGèreIntégrité), testez la fonction HErreurIntégrité après l'appel de la fonction TableSupprimeAvecAnimation pour vérifier l'intégrité.
Si une erreur d'intégrité est détectée, la ligne n'est pas supprimée et reste visible dans le champ.

Suppression dans un champ Table fichier et Trigger

Il est possible de déclencher un trigger lors de la suppression d'un enregistrement dans un champ Table fichier. Pour plus de détails, consultez la documentation de la fonction HDécritTrigger.

Gestion des erreurs

En cas d'échec de la suppression, la variable ErreurDétectée est à Vrai. Pour plus de détails sur l'erreur, il est possible d'utiliser la fonction ErreurInfo.
Exemple de cas d'erreur : Suppression d'une ligne dont l'indice correspond à une ligne non sélectionnée dans la partie visible du champ Table.

Blocage du fichier de données lié

Si le fichier de données est bloqué dans le traitement en cours, la fonction TableSupprimeAvecAnimation supprime la ligne spécifiée et débloque le fichier de données.

Suppression dans un champ Table par programmation avec un filtre de type "Contient"

La fonction TableSupprimeAvecAnimation utilisée sur un champ Table par programmation utilisant un filtre de type "Contient" fait apparaître des enregistrements qui ne correspondent pas au filtre. Les filtres définis par les FAA (Fonctionnalités Automatiques de vos Applications) sont annulés.
Composante : wd290obj.dll
Version minimum requise
  • Version 22
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 15/05/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale