PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Exemples de gestion de position dans un fichier de données
  • Réinitialisation des positions
  • Divers
  • Repositionnement par OLE DB et Accès Natif MySQL, DB2 et Informix
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
HSauvePosition (Fonction)
En anglais : HSavePosition
ODBCNon disponible avec ce type de connexion
Mémorise le contexte en cours d'un fichier de données : enregistrement en cours, filtre, pointeurs de lecture. Il est ainsi possible de suspendre momentanément le traitement en cours, d'utiliser le fichier de données par ailleurs (pour effectuer des vérifications par exemple). Le contexte sauvegardé pourra être restitué grâce à la fonction HRetourPosition. Le traitement principal pourra alors continuer.
La fonction HSauvePosition permet de sauvegarder :
  • 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. Il sera nécessaire d'utiliser la constante HRPFiltre dans la fonction HRetourPosition pour retrouver le filtre sauvegardé.
Cette fonction peut être utilisée indifféremment avec les fichiers de données, les vues HFSQL ou les requêtes.
Versions 15 et supérieures
Android Cette fonction est désormais disponible pour les applications Android.
Nouveauté 15
Android Cette fonction est désormais disponible pour les applications Android.
Android Cette fonction est désormais disponible pour les applications Android.
Versions 17 et supérieures
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Versions 18 et supérieures
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Nouveauté 18
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
Versions 21 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Exemple
// 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
Syntaxe
<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 HFSQL (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.
Hyper File 5.5 Le paramètre <Nom de la rubrique> ne sera pas pris en compte : la position sera sauvegardée pour toutes les rubriques sur lesquelles un parcours est en cours.
<Options> : Constante optionnelle de type entier
Permet de paramétrer la sauvegarde :
hSauveRubriquesSauve 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.
AndroidWidget AndroidJava Ce paramètre n'est pas supporté.
Remarques

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.
WINDEVWEBDEV - Code ServeurPHPOLE DBAccès Natifs

Repositionnement par OLE DB et Accès Natif MySQL, DB2 et Informix

Si la base de données ou l'état du parcours (parcours ré-initialisé par exemple) ne permettent pas de se repositionner directement sur l'enregistrement, le repositionnement est effectué dans le cache des enregistrement lus.
Les fonctions suivantes réinitialisent le parcours :
Ce fonctionnement est également observé en Java.
Composantes
WINDEVWEBDEV - Code ServeurEtats et Requêtes wd220hf.dll
Windows Mobile wp220hf.dll
Java wd220java.jar
Linux wd220hf.so
Android wd220android.jar
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire