 |
Cette page est également disponible pour : WINDEV Mobile, WINDEV, WEBDEV, Etats & Requêtes
| Version affichée : |
|
| HSauvePosition (Fonction)
En anglais : HSavePosition | |
| // Recherche d'un enregistrement
HLitRecherchePremier(CLIENT, NOM, Nom)
TANTQUE HTrouve(CLIENT) = Vrai
// Sauve le contexte en cours
nPos = HSauvePosition(CLIENT, NOM)
// Vérification d'un client d'un autre nom
HLitRecherche(CLIENT, NOM, Nom2)
SI HTrouve() = Vrai ALORS Compteur = Compteur + 1
// Restaure le contexte
HRetourPosition(nPos)
HLitSuivant(CLIENT, NOM)
FIN
|
|
<Résultat> = HSauvePosition([<Nom du fichier> [, <Nom de la rubrique>]] [, <Options>])
<Résultat> : Entier - Numéro de la position sauvegardée,
- -1 en cas d'erreur.
<Nom du fichier> : Chaîne de caractères optionnelle (avec ou sans guillemets) Nom du fichier de données, de la vue ou de la requête manipulé. Si ce nom n'est pas spécifié, la fonction HSauvePosition va manipuler le dernier fichier de données utilisé par la dernière fonction de gestion HyperFileSQL (fonction commençant par la lettre H). <Nom de la rubrique> : Chaîne de caractères optionnelle (avec ou sans guillemets) Nom de la rubrique utilisée. Si ce paramètre n'est pas spécifié, la fonction HSauvePosition sauve les positions de toutes les rubriques pour lesquelles un parcours est en cours.
<Options> : Constante optionnelle de type entier Permet de paramétrer la sauvegarde : | | | | hSauveRubriques | Sauve les valeurs des rubriques en mémoire au moment de l'utilisation de la fonction HSauvePosition. Ces valeurs seront restaurées lors de l'appel à la fonction HRetourPosition. | |
|
|
| Exemples de gestion de position dans un fichier de données Les fonctions HSauvePosition et HRetourPosition peuvent être utilisées par exemple dans les cas suivants :- parcours d'un fichier de données selon une clé (visualisation fiche à fiche), appel d'une autre fenêtre pour visualisation sous forme de table. La gestion des positions permet de revenir simplement sur le bon enregistrement dans le parcours fiche à fiche.
- visualisation d'un fichier dans une table. Sélection d'un enregistrement pour un accès fiche à fiche. La gestion des positions permet de revenir à l'affichage de la table en étant correctement positionné dans le fichier de données.
|
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, ...). |
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.
- Si l'enregistrement pointé lors de l'appel à la fonction HSauvePosition est supprimé, il n'est plus possible d'appeler la fonction HRetourPosition.
|
|
| | | |
| |
|
Version minimum requise : 9
Communauté : 0 annotation   Connectez-vous pour ajouter une annotation | Conditions Générales du service d'annotations
| |
| |
| | | |