DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Table
  • Conditions d'utilisation
  • Cas particuliers
  • Astuce pour les champs Table et Table hiérarchique fichier
  • Connecteur Natif SQL Server
  • Divers
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
Rafraîchit l'affichage d'un champ Table ou Table hiérarchique à partir d'une position donnée :
  • pour un champ Table ou Table hiérarchique "fichier" : les modifications effectuées sur le fichier de données lié sont répercutées dans le champ.
  • pour un champ Table ou Table hiérarchique "par programmation" : les colonnes calculées sont re-calculées.
Exemple
// Rafraîchissement du champ "TABLE_TableProduit" à partir du début
TableAffiche(TABLE_TableProduit, taDébut)
Syntaxe
TableAffiche(<Champ Table> [, <Position>])
<Champ Table> : Nom de champ
Nom du champ à rafraîchir. Ce champ peut correspondre :
  • à un champ Table,
  • à un champ Table hiérarchique.
Si ce paramètre correspond à une chaîne vide (""), le champ auquel appartient l'événement en cours est rafraîchi.
<Position> : Entier, caractère ou constante (optionnel)
Indique la position de départ du rafraîchissement. Si ce paramètre n'est pas spécifié :
  • Dans le cas d'un champ "fichier", la fonction se comporte comme si la constante taInit avait été passée en paramètre.
  • Dans le cas d'un champ "par programmation", la fonction n'a aucun effet.
Ce paramètre peut correspondre à :
  • Un entier. Le rafraîchissement est effectué à partir de cette position. La ligne sélectionnée dans le champ n'est pas modifiée.
    Dans le cas d'un champ "fichier", l'événement "Affichage de la ligne" <Position> est exécuté. La ligne en cours dans le champ correspond à l'enregistrement en cours dans le fichier de données.
    Dans le cas d'un champ "par programmation", la ligne <Position> est ré-affichée.
  • Un caractère ou une constante :
    Champ Table ou Table hiérarchique FichierChamp Table ou Table hiérarchique Fichier chargé en mémoireChamp Table ou Table hiérarchique par programmation
    taDébut
    (Valeur par défaut)
    • Rafraîchit le champ en se positionnant au début du champ.
    • La première ligne du champ est sélectionnée. Cette ligne correspond au premier enregistrement du fichier de données.
    Aucun effet.Aucun effet.
    taCourantBandeau
    • Rafraîchit le champ à partir de la position du bandeau de sélection.
    • La position du bandeau de sélection n'est pas modifiée. L'enregistrement courant dans le fichier de données correspondra à l'enregistrement sélectionné dans le champ (après exécution de la fonction TableAffiche).
    • Ré-affiche le champ en ré-initialisant les valeurs des colonnes calculées.
    • La ligne sélectionnée est inchangée.
    • Ré-affiche le champ en re-calculant les valeurs des colonnes calculées.
    • La ligne sélectionnée est inchangée.
    taCourantEnreg
    • Ré-exécute la requête liée si nécessaire.
    • Prend en compte des enregistrements ajoutés, modifiés, supprimés par d'autres postes.
    • Sélectionne l'enregistrement courant (si le parcours défini dans le champ se fait sur une clé unique). Si l'enregistrement courant est supprimé ou ne correspond pas au filtre, sélectionne l'enregistrement suivant non supprimé.
      S'il y a des doublons sur la rubrique de parcours, la ligne sélectionnée parmi les doublons sera indéterminée.
    • La position de l'ascenseur est conservée tant que la sélection reste visible.
    • Exécute les événements de début et de fin d'initialisation, puis l'événement "Sélection de la ligne" pour la ligne sélectionnée (même si elle n'est pas modifiée).
    AndroidiPhone/iPadJavaPHP Cette constante n'est pas disponible.
    Aucun effet.Aucun effet.
    taCourantPremier
    • Rafraîchit le champ à partir de l'enregistrement courant dans le fichier de données.
    • La première ligne du champ est sélectionnée. Cette ligne correspond à l'enregistrement courant.
    • Ré-affiche le champ en recalculant les valeurs des colonnes calculées.
    • La ligne sélectionnée est inchangée.
    taInit
    • Exécute les codes d'initialisation du champ (code d'initialisation et de fin d'initialisation).
    • Exécute le code d'initialisation des colonnes du champ.
    • Remplit le champ.
    • La première ligne du champ Table est sélectionnée. Cette ligne correspond à l'enregistrement en cours dans le fichier de données lors de la fin du code d'initialisation du champ.
    Aucun effet. Aucun effet.
    taPrécédent
    • Rafraîchit le champ en se positionnant au début du champ de la page précédente (équivalent à l'utilisation de la réglette pour accéder à la page précédente).
    • La première ligne visible du champ est sélectionnée. Cette ligne correspond à l'enregistrement courant dans le fichier de données.
    WINDEVAndroidiPhone/iPad Cette constante n'est pas disponible.
    Aucun effet.Aucun effet.
    taRéExécuteRequête
    • Ré-exécute la requête liée au champ. Pour plus de détails, consultez Champ Table et requêtes.
    • Rafraîchit le champ en se positionnant au début du champ.
    • La première ligne du champ est sélectionnée. Cette ligne correspond au premier enregistrement dans le résultat de la requête.
    Attention : Seule la requête liée au champ est exécutée. Si des options spécifiques ont été précisées avec la fonction HExécuteRequête (par exemple, utilisation de la constante hModifieFichier), ces options ne sont pas prises en compte.
    Aucun effet.Aucun effet.
    taSuivant
    • Rafraîchit le champ en se positionnant au début du champ Table de la page suivante (équivalent à l'utilisation de la réglette pour accéder à la page suivante).
    • La première ligne visible du champ est sélectionnée. Cette ligne correspond à l'enregistrement courant dans le fichier de données.
    WINDEVAndroidiPhone/iPad Cette constante n'est pas disponible.
    Aucun effetAucun effet.
Remarques

Conditions d'utilisation

La fonction TableAffiche peut être utilisée indifféremment 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.
WEBDEV - Code Serveur La page contenant le champ est réactualisée.
WEBDEV - Code ServeurPHP Rappel : La multisélection n'est pas disponible sur les champs Table "classique".

Cas particuliers

La fonction TableAffiche est sans effet :
  • Si le paramètre <Position> est un entier et si cet entier est invalide.
  • Si le paramètre <Position> est un entier et si le paramètre <Champ Table> est un champ Table fichier en mode "ascenseur à rebond".
Rappel : L'ascenseur à rebond est un ancien mode de fonctionnement. Lorsqu'un ascenseur est à rebond, la cage de l'ascenseur revient au milieu de l'ascenseur à chaque clic sur les boutons de l'ascenseur (ou en utilisant la touche flèche haut ou flèche bas). Pour qu'un ascenseur soit à rebond, décochez l'option "Ascenseur proportionnel" dans l'onglet "Détail" de la fenêtre de description du champ.
WEBDEV - Code Serveur La fonction TableAffiche est sans effet si le paramètre <Position> est un entier et si cet entier est invalide.

Astuce pour les champs Table et Table hiérarchique fichier

Pour afficher un calcul dans une colonne calculée ou pour mettre en forme une cellule (par exemple "fond rouge si valeur supérieure à 50"), utilisez l'événement "Affichage de ligne" du champ.
WINDEVWEBDEV - Code ServeurCode Utilisateur (MCU)AjaxConnecteurs Natifs (Accès Natifs)

Connecteur Natif SQL Server

Si la fonction TableAffiche manipule un champ lié à un fichier de données accédé par le Connecteur Natif SQL Server, il est conseillé d'utiliser les constantes taCourantPremier et taDébut.
WINDEVWEBDEV - Code ServeurEtats et RequêtesJavaCode Utilisateur (MCU)Ajax

Divers

La constante taDepuisFichier est identique à la constante taCourantPremier. Cette constante est conservée par compatibilité avec les versions précédentes et apparaît en orange sous l'éditeur de code.
Composante : wd300obj.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 13/01/2023

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