|
|
|
|
|
|
|
|
|
|
- Réinitialisation des positions
- Divers
- Principe de repositionnement pour les Connecteurs Natifs (également appelés Accès Natifs)
HRetourPosition (Fonction) En anglais : HRestorePosition
 Non disponible avec ce type de connexion
Restaure le contexte précédemment sauvegardé d'un fichier de données (fonction HSauvePosition) : enregistrement en cours, filtre, pointeurs de lecture. La fonction HRetourPosition permet de restaurer : - le numéro de l'enregistrement manipulé,
- les différents pointeurs dans l'index (sauvegarde pour chaque clé de la position dans l'index),
- le filtre en cours (uniquement si la constante correspondante hRPFiltre est spécifiée).
Cette fonction peut être utilisée indifféremment avec les fichiers de données, les vues HFSQL ou les requêtes.
HLitRecherchePremier(Client, Nom, Nom)
TANTQUE HTrouve(Client) = Vrai
nPos = HSauvePosition(Client, Nom)
HLitRecherche(Client, Nom, Nom2)
SI HTrouve() = Vrai ALORS Compteur = Compteur + 1
HRetourPosition(nPos)
HLitSuivant(Client, Nom)
FIN
Syntaxe
Restaurer la position spécifiée Masquer les détails
<Résultat> = HRetourPosition(<Position> [, <Option>])
<Résultat> : Booléen - Vrai si la restauration de la position indiquée a été effectuée,
- Faux dans le cas contraire. La fonction HErreur permet d'obtenir plus d'informations sur le problème rencontré.
<Position> : Entier Position à restaurer. Valeur retournée par la fonction HSauvePosition. <Option> : Constante ou combinaison de constante optionnelle Permet de paramétrer la restauration : | | | hRPConserve | La position n'est pas libérée (d'autres appels à la fonction HRetourPosition pourront être réalisés sur cette position). | hRPDéfaut
(valeur par défaut) | La position est libérée. La position sauvegardée est restaurée. | | hRPFiltre | Restaure le filtre posé au moment de l'appel à la fonction HSauvePosition. | | hRPHF5 | Si la position sauvegardée a été supprimée ou modifiée, cette position est tout de même restaurée.
Si la constante hRPHF5 n'est pas précisée et que la sauvegarde a été réalisée sur plusieurs rubriques, le repositionnement est fait sur le numéro d'enregistrement en cours au moment de l'appel à la fonction HSauvePosition.
|
Restaurer un fichier de données Masquer les détails
<Résultat> = HRetourPosition([<Fichier de données>])
<Résultat> : Booléen - Vrai si la restauration du contexte a été effectuée,
- Faux dans le cas contraire. La fonction HErreur permet d'obtenir plus d'informations sur le problème rencontré.
<Fichier de données> : Chaîne de caractères optionnelle Nom du fichier de données dont le contexte doit être restauré. Si ce nom n'est pas spécifié, la fonction HRetourPosition va manipuler le dernier fichier de données utilisé par la dernière fonction de gestion HFSQL (fonction commençant par la lettre H). Remarques Réinitialisation des positions Attention : toutes les fonctions entraînant l'ouverture ou la fermeture d'un fichier de données réinitialisent les numéros de contexte (par exemple HCréation, HFerme, ...). Si l'enregistrement sauvegardé par la fonction HSauvePosition a été supprimé, la fonction HRetourPosition conservera le contexte en cours mais se positionnera sur l'enregistrement suivant l'enregistrement supprimé.
Divers - Le nombre d'appels à la fonction HSauvePosition n'est pas limité.
- Il est possible d'imbriquer les fonctions HSauvePosition et HRetourPosition pour un même fichier de données.
Classification Métier / UI : Code métier
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|