PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE
  • Ordre des rubriques
  • Affichage du résultat dans un champ Liste ou Combo
  • Type HFSQL
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
Renvoie la liste des rubriques :
  • présentes dans un fichier de données (d'une requête ou d'une vue) reconnu par le moteur HFSQL. Les fichiers de données définis par les fonctions HDéclare, HDéclareExterne et HDécritFichier sont pris en compte.
Exemple
// Récupérer les rubriques d'un fichier de données de l'analyse en cours
ListeDesRubriques est une chaîne
ListeDesRubriques = HListeRubrique(Client, hLstDétail)
 
// Ajoute la liste des rubriques dans COMBO_COMBO1
ListeAjoute(COMBO_COMBO1, ListeRubrique)
// Exécution d'une requête "SELECT *" et interrogation des rubriques
sdListeVILLE est une Source de Données
sListeRub est une chaîne
sContenuEnreg est une chaîne
sReq est une chaîne = "SELECT * FROM CODEPOSTAUX WHERE CODEPOSTAL ='34000'"
 
// Exécution de la requête
HExécuteRequêteSQL(sdListeVILLE, hRequêteDéfaut, sReq)
// Liste des rubriques de la requête.
sListeRub = HListeRubrique(sdListeVILLE)
 
// Parcours de la requête
POUR TOUT sdListeVILLE
sContenuEnreg = ""
// Pour chaque enregistrement, il faut parcourir les rubriques
POUR TOUTE CHAÎNE sUneRubrique DE sListeRub SÉPARÉE PAR RC
sContenuEnreg += {"sdListeVILLE." + sUneRubrique, indRubrique}
FIN
Info("Contenu de l'enregistrement : " + sContenuEnreg)
FIN
Syntaxe

Lister les rubriques d'un fichier de données Masquer les détails

<Résultat> = HListeRubrique(<Fichier de données> [, <Chemin du WDD> [, <Mot de passe du WDD> [, <Options>]]])
<Résultat> : Chaîne de caractères
Liste des rubriques présentes dans le fichier de données spécifié. Les différentes descriptions de chaque rubrique sont séparées par RC (Retour Chariot). En fonction de la constante utilisée, le résultat est plus ou moins détaillé :
hLstDétail non précisé<Nom de la rubrique 1> + RC + <Nom de la rubrique 2> + RC + ...
hLstDétail précisé<Nom de la rubrique 1> + TAB + <Type> + TAB + <Type HFSQL> + TAB + <Taille> + TAB + <Nombre d'indices> + TAB + <Libellé> + RC + ...
hLstDétailPlus<Nom de la rubrique 1> + TAB + <Type> + TAB + <Type HFSQL> + TAB + <Taille> + TAB + <Nombre d'indices> + TAB + <Libellé> + TAB + <Partie entière des rubriques numériques> + TAB + <Partie décimale des rubriques numériques> + RC + ...
Où :
  • <Nom de rubrique X> : Nom de la rubrique
  • <Type> : Type de la rubrique : "T" pour texte (et monétaire) ou "N" pour numérique
  • <Type HFSQL> : Type HFSQL de la rubrique. Pour plus de détails, voir les Notes.
  • <Taille> : Taille de la rubrique
  • <Nombre d'indices> : Nombre d'éléments du tableau
  • <Libellé> : Libellé de la rubrique.
  • <Partie entière des rubriques numériques> : Nombre de chiffres de la partie entière des rubriques numériques
  • <Partie décimale des rubriques numériques> : Nombre de chiffres de la partie décimale des rubriques numériques
<Fichier de données> : Chaîne de caractères
Nom du fichier de données (de la requête ou de la vue) dont les rubriques doivent être listées.
Si un nom de requête est spécifié, cette requête doit être en cours d'exécution (fonctions HExécuteRequête ou HExécuteRequêteSQL) pour que la fonction HListeRubrique fonctionne. Dans le cas contraire, une erreur du WLangage est générée.
<Chemin du WDD> : Chaîne de caractères optionnelle
Chemin complet de l'analyse (c'est-à-dire du ficher .WDD) dans laquelle le fichier de données est décrit. Si ce paramètre n'est pas précisé ou est égal à une chaîne vide (""), le fichier de données est recherché dans l'analyse en cours.
<Mot de passe du WDD> : : Chaîne de caractères optionnelle
Mot de passe défini pour l'analyse. Si aucun mot de passe n'est défini, ce paramètre doit être égal à une chaîne vide ("").
<Options> : Constante ou combinaison de constantes optionnelle de type entier
Type de liste à effectuer :
hLstCléListe les rubriques clés (clés non composées uniquement)
Hyper File 5.5 Cette constante n'est pas prise en compte.
hLstCléComposéeListe les rubriques clés composées uniquement
Hyper File 5.5 Cette constante n'est pas prise en compte.
hLstDétailInformations détaillées (idem versions antérieures).
hLstDétailPlusPour les numériques, ajoute le nombre de chiffres de la partie entière et de la partie décimale.
Hyper File 5.5 Cette constante n'est pas prise en compte.
hLstMémoListe les rubriques mémo
Hyper File 5.5 Cette constante n'est pas prise en compte.
hLstNormal
(valeur par défaut)		Correspond à hLstRubrique + hLstMémo + hLstClé
hLstOrdreLogiqueTrie la liste dans l'ordre logique des rubriques (ignorée si hLstTriée est précisée)
Hyper File 5.5 Cette constante n'est pas prise en compte.
hLstRubriqueListe les rubriques non clé et non mémo
hLstRubriqueOrigineUtilisée sur un fichier journal (xxxJNL.fic), liste les rubriques du fichier original (qui a été journalé). Par exemple, sur le fichier ClientJNL.Fic, liste les rubriques du fichier CLIENT.
Hyper File 5.5 Cette constante n'est pas prise en compte.

hLstToutListe tous les types de rubrique (hLstRubrique + hLstMémo + hLstClé + hLstClécomposée)
Hyper File 5.5 Cette constante n'est pas prise en compte.
hLstTriéeTrie la liste par ordre alphabétique
Hyper File 5.5 Cette constante n'est pas prise en compte.
Remarques

Ordre des rubriques

Les rubriques listées dans <Résultat> sont triées en fonction de l'ordre physique des rubriques dans le fichier de données (sauf si la constante hLstTriée est utilisée).

Affichage du résultat dans un champ Liste ou Combo

<Résultat> peut être directement affecté à un champ Liste ou Combo grâce à la fonction ListeAjoute. Chaque ligne contiendra la description d'une rubrique.

Type HFSQL

Les types HFSQL possibles sont les suivants :
0type inconnu1identifiant automatique sur 8 octets
2rubrique texte3rubrique de type entier signé sur 2 octets
4rubrique de type entier signé sur 1 octet5rubrique de type entier signé sur 4 octets
6rubrique de type réel simple (sur 4 octets)7rubrique de type réel double (sur 8 octets)
8rubrique de type numéro d'enregistrement (entier non signé)9rubrique de type entier non signé sur 2 octets
10rubrique de type date sur 611rubrique de type heure
12rubrique de type entier non signé sur 1 octet13rubrique de type réel turbo
14rubrique de type date sur 815rubrique de type mémo texte
16rubrique de type mémo binaire 4.017rubrique de type monétaire
18rubrique de type mémo binaire, mémo Image,
mémo Son, mémo OLE ou mémo binaire autre		19rubrique de type entier signé sur 8 octets
20rubrique de type entier non signé sur 8 octets21rubrique de type image
22rubrique de type entier non signé sur 4 octets23rubrique de type chaîne binaire
24rubrique de type date+heure25rubrique de type durée
26rubrique de type caractère27rubrique de type booléen
28rubrique de type identifiant automatique (sur 4 octets)29rubrique de type texte Unicode
30rubrique de type mémo texte Unicode31rubrique de type numérique haute précision
32rubrique de type Enumération33rubrique de type Combinaison
34rubrique de type UUID sur 128 bits35rubrique de type UUID automatique sur 128 bits
36rubrique de type UUID sur 256 bits37rubrique de type UUID automatique sur 256 bits
Classification Métier / UI : Code métier
Composante : wd280hf.dll
Voir Aussi
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Constantes pour les types de rubriques
on peut utiliser les constantes hRubXXX décrites dans la page http://doc.pcsoft.fr/fr-FR/?Type, au lieu d'utiliser les valeurs 0 à 31
John
18 mai 2010