DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
  • Position par rapport à une rubrique clé ou non clé
  • Position dans un parcours filtré
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
Positionne sur un enregistrement à partir de la position approximative d'une de ses rubriques. L'enregistrement est lu.
Cette fonction peut être utilisée indifféremment avec les fichiers de données, les vues HFSQL ou les requêtes.
Attention : La fonction <Source>.Positionne permet uniquement de se positionner. Pour connaître la position en cours, utilisez la fonction <Source>.PositionCourante.
Exemple
Client.Positionne(Nom, 500)
Syntaxe
<Résultat> = <Source>.Positionne([<Rubrique>, ] <Position> [, <Précision>])
<Résultat> : Booléen
  • Vrai si le positionnement a été effectué,
  • Faux dans le cas contraire. La fonction HErreur permet d'obtenir plus d'informations sur le problème rencontré. Si aucun enregistrement ne correspond, la fonction <Source>.EnDehors renvoie Vrai et aucun enregistrement n'est lu.
<Source> : Type correspondant à la source spécifiée
Nom du fichier de données, de la vue ou de la requête manipulé.
<Rubrique> : Chaîne de caractères optionnelle
Nom de la rubrique utilisée.
Si ce nom n'est pas spécifié, la fonction <Source>.Positionne va manipuler la dernière rubrique utilisée par la dernière fonction de gestion HFSQL (fonction commençant par la lettre H).
<Position> : Entier
Position approximative à fixer. Cette position doit être comprise dans l'intervalle [1;1000].
<Précision> : Entier optionnel
Fixe la précision avec laquelle la position est effectuée. Attention : Plus la précision est élevée, et plus le temps de positionnement est important.
hPrécisionElevéePrécision élevée.
hPrécisionFaiblePrécision faible.
hPrécisionMoyenne
(valeur par défaut)
Précision moyenne.
Remarques

Position par rapport à une rubrique clé ou non clé

  • Pour une rubrique clé, la position est relative à l'ordre de l'enregistrement dans l'index de cette rubrique.
  • Pour une rubrique non clé, la position est relative au numéro de l'enregistrement dans le fichier de données (voir la fonction <Source>.NumEnr).

Position dans un parcours filtré

Si un filtre avec bornes est défini (la fonction <Source>.Filtre sans chaîne de condition mais avec les bornes minimales et maximales), la position est relative aux enregistrements sélectionnés par le filtre.
Si une chaîne de condition est donnée à la fonction <Source>.Filtre, la position ne tient pas compte du filtre.
Composante : wd300hf.dll
Version minimum requise
  • Version 25
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 20/06/2023

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