DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Table
  • Caractéristiques du champ Table (par défaut)
  • Champ Table par programmation
  • Colonnes
  • 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
Crée un champ Table à partir des rubriques présentes dans un fichier de données (une vue ou une requête). Chaque colonne du champ est associée à une rubrique du fichier de données. La largeur des colonnes est automatiquement adaptée en fonction des données présentes dans le fichier ou la requête.
Cette fonction permet d'obtenir un champ Table adapté au parcours d'un fichier de données spécifique.
// Affiche le contenu du fichier "CLIENTS" dans un champ Table fichier 
ConstruitTableFichier(TABLE_TABLE1, "CLIENTS", taAvecIDAuto)
// Affiche le contenu d'une requête dans un champ Table par programmation
SI HExécuteRequête(REQ_LISTE_CLIENTS_ACTIFS) = Vrai ALORS
	ConstruitTableFichier(TABLE_CLIENTS, ...
			REQ_LISTE_CLIENTS_ACTIFS, taRemplirTable)
FIN
Syntaxe
ConstruitTableFichier(<Champ Table> , <Fichier de données> [, <Options>])
<Champ Table> : Nom de champ
Nom du champ Table (Table fichier ou Table par programmation).
Attention : Ce champ doit exister dans la fenêtre. Il peut avoir été créé avec la fonction ChampCrée.
Si ce paramètre correspond à un champ Table fichier, les enregistrements du fichier de données sont directement visualisés.
<Fichier de données> : Chaîne de caractères
Nom du fichier de données, de la vue ou de la requête servant de base à la création du champ Table.
<Options> : Constante (optionnelle) ou combinaison de constantes
Paramètre le mode de création des colonnes du champ Table.
Fonctionnement avec la constanteFonctionnement par défaut
taAvecBinaireLes rubriques de type binaire (clé composée de liaison par exemple) sont ajoutées dans le champ Table.Par défaut : Les rubriques de type binaire (clé composée de liaison par exemple) ne sont pas ajoutées dans le champ Table.
taAvecIDAutoUne colonne est générée pour l'identifiant automatique.Par défaut : Pas de colonne pour l'identifiant automatique.
taAvecLiaisonDétailUne sous-table est automatiquement générée pour afficher les rubriques des fichiers de données liés dans l'analyse. Par défaut : Aucune fenêtre "détail d'une ligne" n'est affichée.
taColonneMonoligneLes colonnes texte sont créées avec la propriété Multiligne à Faux par défaut. Par défaut : Les colonnes texte correspondant à des rubriques mémo sont multilignes et les autres colonnes texte sont monolignes.
taColonneMultiligneLes colonnes texte sont créées avec la propriété Multiligne à Vrai par défaut. Par défaut : Les colonnes texte correspondant à des rubriques mémo sont multilignes et les autres colonnes texte sont monolignes.
taGardeCléParcoursLa clé de parcours du champ Table fichier n'est pas modifiée (cette clé de parcours est connue grâce à la propriété RubriqueParcourue).Par défaut : La première rubrique clé rencontrée est positionnée comme clé de parcours.
taGardeColonneLes colonnes existantes du champ Table ne sont pas supprimées.Par défaut : Les colonnes existantes sont supprimées.
taLibelléRubriqueUtilise les libellés des rubriques pour les titres des colonnes.Par défaut : Utilise le nom de la rubrique en titre de colonnes.
taParOrdreLogiqueLes colonnes sont créées selon l'ordre logique des rubriques défini sous l'éditeur d'analyses.
Pour les requêtes, l'ordre logique et physique des rubriques est identique.
Par défaut : L'ordre physique des rubriques dans le fichier de données est utilisé.
Pour les requêtes, l'ordre logique et physique des rubriques est identique.
taRemplirTableUn champ Table par programmation sera rempli avec le contenu du fichier de données (Attention : opération longue pouvant saturer la mémoire).Par défaut : Pas de remplissage des champs Table par programmation.
taSaisieIDAutoSaisie autorisée dans la colonne associée à l'identifiant automatique (si elle existe et si le champ Table est en saisie).
taSansAjusteLa largeur des colonnes n'est pas ajustée (pas de lecture des enregistrements).
taSansMémoTexteLes rubriques de type 'mémo texte' ne sont pas ajoutées dans le champ Table.Par défaut : Les rubriques de type 'mémo texte' sont ajoutées dans le champ Table.
taSansMémoImageLes rubriques de type 'mémo image' ne sont pas ajoutées dans le champ Table.Par défaut : Les rubriques de type 'mémo image' sont ajoutées dans le champ Table.
Remarques

Caractéristiques du champ Table (par défaut)

  • Les colonnes du champ Table définies sous l'éditeur sont supprimées.
  • Les modes de saisie définis sous l'éditeur pour le champ Table sont conservés.
  • Pour chaque rubrique du fichier de données, une colonne du type de la rubrique est créée.
  • Aucune colonne n'est créée pour les rubriques de type mémo binaire (une colonne est créée pour les rubriques de type mémo texte ou mémo image).
  • Les propriétés du champ Table et des colonnes sont mises à jour pour permettre le parcours du fichier de données :
    <Champ Table>.FichierParcouru = <Nom du fichier de données>

    et pour chaque colonne :
    <Nom Colonne>.LiaisonFichier = <Nom de la rubrique associée>
    <Nom Colonne>.RubriqueParcourue = <Première clé du fichier de donnée>
WINDEVEtats et RequêtesCode Utilisateur (MCU)

Champ Table par programmation

Si le paramètre <Champ Table> correspond à un champ Table par programmation, aucune donnée n'est affichée (le champ Table est vide) mais les propriétés du champ Table et des colonnes sont affectées comme pour un champ Table fichier.
Pour afficher des données dans le champ Table, il faut alors utiliser la fonction TableAjoute ou la fonction ConstruitTableFichier avec la constante taRemplirTable.
Remarque : La constante taRemplirTable ne permet pas de remplir un champ Table par programmation avec des mémos image. Pour ajouter une image dans un champ Table par programmation, le fichier correspondant doit être présent dans la bibliothèque de l'application (fichier WDL) ou accessible depuis le poste en cours.

Colonnes

Les colonnes créées portent les noms "_COL1", "_COL2", "_COL3", etc. Ces colonnes sont accessibles par programmation via l'opérateur d'indirection { }.
Il n'est pas possible d'écrire :
TABLE_TABLE1._COL1.Largeur = 120 // Génère une erreur "_COL1 inconnu"
Il faut écrire :
{"TABLE_TABLE1._COL1"}..Largeur = 120

Divers

  • La fonction ConstruitTableFichier effectue un parcours dans le fichier de données. L'enregistrement en cours risque d'être modifié après l'utilisation de cette fonction.
  • Le remplissage de la table par la fonction ConstruitTableFichier est réalisé dans un processus parallèle en arrière-plan : si la source de données est une requête, il ne faut pas libérer cette requête avant la fermeture de la fenêtre ou la réinitialisation du champ Table.
Classification Métier / UI : Code UI
Composante : wd300obj.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 23/05/2024

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