|
|
|
|
|
|
|
|
|
|
- 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'une table (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 tables, 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.
|
<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é.
<Table> : Chaîne de caractères optionnelle Nom de la table dont le contexte doit être restauré. Si ce nom n'est pas spécifié, la fonction HRetourPosition va manipuler la dernière table utilisée 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'une table réinitialisent les numéros de contexte (par exemple HCrée, 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 une même table.
Classification Métier / UI: Code métier
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|