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 constante | Fonctionnement par défaut |
|---|
| taAvecBinaire | Les 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. |
| taAvecIDAuto | Une colonne est générée pour l'identifiant automatique. | Par défaut : Pas de colonne pour l'identifiant automatique. |
| 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. | Par défaut : Aucune fenêtre "détail d'une ligne" n'est affichée. |
| taGardeCléParcours | La 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. |
| taGardeColonne | Les colonnes existantes du champ Table ne sont pas supprimées. | Par défaut : Les colonnes existantes sont supprimées. |
| taLibelléRubrique | Utilise les libellés des rubriques pour les titres des colonnes. | Par défaut : Utilise le nom de la rubrique en titre de colonnes. |
| taParOrdreLogique | Les 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. |
| taRemplirTable | Un 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. |
| taSaisieIDAuto | Saisie autorisée dans la colonne associée à l'identifiant automatique (si elle existe et si le champ Table est en saisie). | |
| taSansAjuste | La largeur des colonnes n'est pas ajustée (pas de lecture des enregistrements). | |
| taSansMémoTexte | Les 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émoImage | Les 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>
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
- 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.
Composante : wd280obj.dll