PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Caractéristiques du champ Table (par défaut)
  • Champ Table mémoire
  • Colonnes
  • 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
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.
Versions 16 et supérieures
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
Nouveauté 16
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
// 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 mémoire
SI HExécuteRequête(REQ_LISTE_CLIENTS_ACTIFS) = Vrai ALORS
ConstruitTableFichier(TABLE_CLIENTS, ...
REQ_LISTE_CLIENTS_ACTIFS, taRemplirTable)
FIN
Syntaxe
ConstruitTableFichier(<Nom de la table> , <Nom du fichier> [, <Options>])
<Nom de la table> : Chaîne de caractères (avec ou sans guillemets)
Nom du champ Table (Table fichier ou Table mémoire).
Attention : Ce champ doit exister dans la fenêtre.
Versions 19 et supérieures
Il peut avoir été créé avec la fonction ChampCrée.
Nouveauté 19
Il peut avoir été créé avec la fonction ChampCrée.
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.
<Nom du fichier> : Chaîne de caractères (avec ou sans guillemets)
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.
Versions 23 et supérieures
taAvecLiaisonDétail
Nouveauté 23
taAvecLiaisonDétail
taAvecLiaisonDétail
Une sous-table est automatiquement générée pour afficher les rubriques des fichiers de données liés dans l'analyse.
Windows Mobile Cette constante n'est pas disponible.
Par défaut : Aucune fenêtre "détail d'une ligne" n'est affichée.
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 mémoire 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 champ Table mémoire.
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 :
    <Nom champ Table>..FichierParcouru = <Nom du Fichier>

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

Champ Table mémoire

Si le paramètre <Nom de la table> correspond à un champ Table mémoire, 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 mémoire avec des mémos image. Pour ajouter une image dans un champ Table mémoire, 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 trop tôt.
Composantes
WINDEVEtats et Requêtes wd230obj.dll
Windows Mobile wp230obj.dll
Linux wd230obj.so
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire