PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE


  • 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/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Rafraîchit l'affichage d'un champ Table ou Table hiérarchique à partir d'une position donnée :
  • un champ Table fichier : les modifications effectuées sur le fichier de données lié sont répercutées dans le champ.
  • un champ Table mémoire : les colonnes calculées sont re-calculées.
Versions 16 et supérieures
Linux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
Nouveauté 16
Linux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
Linux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
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 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
// 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 mémoire, 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 mémoire, la ligne <Position> est ré-affichée.
  • Un caractère ou une constante :
    Champ Table ou Table hiérarchique FichierChamp Table ou Table fichier chargée en mémoireChamp Table ou Table hiérarchique Mémoire
    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).
    PHP Cette constante n'est pas disponible.
    Versions 16 et supérieures
    PHP Cette constante est disponible en PHP.
    Nouveauté 16
    PHP Cette constante est disponible en PHP.
    PHP Cette constante est disponible en PHP.
    • 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/iPadWindows Mobile 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.
    PHP Cette constante n'est pas disponible.
    Versions 16 et supérieures
    PHP Cette constante est désormais disponible.
    Nouveauté 16
    PHP Cette constante est désormais disponible.
    PHP Cette constante est désormais disponible.
    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/iPadWindows Mobile 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 fichier ou mémoire.
  • un champ monosélection ou multisélection.
WEBDEV - Code Serveur La page contenant le champ est réactualisée.
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 "classique".
Versions 20 et supérieures
AndroidiPhone/iPad Cette fonction est disponible uniquement pour les champs Table. Le champ Table hiérarchique n'est pas disponible.
Nouveauté 20
AndroidiPhone/iPad Cette fonction est disponible uniquement pour les champs Table. Le champ Table hiérarchique n'est pas disponible.
AndroidiPhone/iPad Cette fonction est disponible uniquement pour les champs Table. Le champ Table hiérarchique n'est pas disponible.

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 ServeurAjaxCode Utilisateur (MCU)Connecteurs 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êtesJavaAjaxCode Utilisateur (MCU)

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 : wd240obj.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire