DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE
Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions de gestion des champs
WINDEV
WindowsLinuxJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac Catalyst
Autres
Procédures stockées
InitParamètre (Fonction)
En anglais : InitParameter
Initialise la gestion des valeurs persistantes. Spécifie l'endroit où seront conservées :
  • les valeurs des champs persistants.
  • la taille et la position sauvegardée des champs et des fenêtres.
  • les valeurs gérées par les fonctions SauveParamètre et ChargeParamètre.
Remarque : L'initialisation des valeurs persistantes est "globale". Ainsi, si un composant initialise la gestion des valeurs persistantes, la gestion des valeurs persistantes sera initialisée pour l'application utilisant le composant.
Exemple
WINDEVCode Utilisateur (MCU) 
// Paramétrage des valeurs persistantes 
// dans un fichier .XML qui dépend de l'utilisateur 
InitParamètre(paramXML, "Param_" + USER + ".xml")
WINDEVCode Utilisateur (MCU) 
// Paramétrage des valeurs persistantes
// dans une clé de la base de registre avec un n° de version
InitParamètre(paramRegistre, ProjetInfo(piRegistre) + "\3.51")
// autre possibilité :
InitParamètre(paramRegistre, "HKEY_CURRENT_USER\Software\DDSoft\DDTool\3.51")
WINDEVCode Utilisateur (MCU) 
// Paramétrage des valeurs persistantes
// Paramétrage par une chaîne
MaChaîne est une chaîne
MaChaîne = fChargeTexte("MonFichier.xml")
InitParamètre(paramChaîne, MaChaîne)
Syntaxe
<Résultat> = InitParamètre(<Mode d'initialisation> [, <Source des valeurs>])
<Résultat> : Chaîne de caractères
Mode d'initialisation utilisé avant l'appel de la fonction InitParamètre. <Résultat> est de la forme :
<Mode d'initialisation> + TAB + <Source des valeurs>
<Mode d'initialisation> : Constante de type Entier
Type d'enregistrement des données persistantes :
paramChaîneLes paramètres seront lus dans une chaîne XML. Le paramètre <Source des valeurs> (obligatoire) doit être une variable de type chaîne.
Dans ce cas, les paramètres ne sont pas sauvés dans un fichier XML mais dans la variable de type chaîne.
Cette constante peut par exemple être utilisée pour récupérer des paramètres provenant d'un serveur HTTP (paramètres obtenus par exemple grâce à la fonction HTTPRequête).
paramIniLes paramètres seront sauvegardés dans une section [Global] d'un fichier au format .INI.
Si cette option est choisie :
  • par défaut, le nom du fichier INI est <Nom du projet>.INI. Ce fichier est créé dans le répertoire de l'exécutable.

    WINDEVLinux Ce fichier est créé dans le dossier "$HOME/.local/share".
  • le paramètre <Source des valeurs> correspond au nom du fichier .INI à utiliser.
    Si le répertoire n'est pas précisé, le fichier est créé dans le répertoire de l'exécutable.

    WINDEVLinux Ce fichier est créé dans le dossier "$HOME/.local/share".
paramRegistreLes paramètres seront sauvegardés dans la base de registre.
Si cette option est choisie :
  • par défaut, l'entrée utilisée correspond au résultat de ProjetInfo(piRegistre) (c'est-à-dire HKEY_CURRENT_USER\Software\<Société>\<Nom du projet>)
    <Société> correspond à la société indiquée lors de la création de l'exécutable. Si ce nom n'est pas renseigné, <Société> correspond à "Applications WinDev".
  • en mode Test, le chemin utilisé dans la base de registre est le suivant : HKEY_CURRENT_USER\SOFTWARE\PC SOFT\WinDev\30\ModeTest\<Nom du projet>.
  • le paramètre <Source des valeurs> correspond à l'entrée de la base de registre à utiliser.
Java Le paramètre <Source des valeurs> sera ignoré. Si ce mode est choisi pour stocker des données persistantes, le support d'enregistrement varie en fonction du système d'exploitation sur lequel l'application s'exécute. Par exemple, sous Windows, les données sont enregistrées dans la base de registre (HKEY_CURRENT_USER\Software\JavaSoft\Prefs) et sous Mac OSX, les données sont sauvées dans les préférences système.
WINDEVLinux Ce paramètre n'est pas supporté dans cette version.
paramXMLLes paramètres seront sauvegardés dans un fichier au format .XML.
Si cette option est choisie :
  • par défaut, le nom du fichier XML est <Nom du projet>.XML. Ce fichier est créé dans le répertoire de l'exécutable.

    WINDEVLinux Ce fichier est créé dans le dossier "$HOME/.local/share".
  • le paramètre <Source des valeurs> correspond au nom du fichier .XML à utiliser.
    Si le répertoire n'est pas précisé, le fichier est créé dans le répertoire de l'exécutable.

    WINDEVLinux Ce fichier est créé dans le dossier "$HOME/.local/share".
<Source des valeurs> : Chaîne de caractères optionnelle
Ce paramètre dépend du mode d'initialisation choisi.
Liste des exemples associés :
WD Persistance Exemples didactiques (WINDEV) : WD Persistance
[ + ] Cet exemple montre l'utilisation des fonctions InitParamètre, ChargeParamètre, SauveParamètre.
Ces fonctions permettent de configurer la sauvegarde de champs, de variables et de tout autre paramètre.
Cet exemple est décomposé en trois parties :
- La configuration
- La gestion manuelle de variables (Fonctions SauveParamètre et ChargeParamètre)
- L'optimisation
1°) Configuration

La fenêtre de configuration vous permet de modifier l'emplacement de la sauvegarde des paramètres (Base de registre, fichier INI, fichier XML) ainsi que son chemin (clé de registre ou le chemin du fichier).
2°) Gestion Manuelle de variables
La gestion manuelle vous permet de sauvegarder le contenu de variables grâce à la fonction SauveParamètre et de les restaurer grâce à la fonction ChargeParamètre. Chaque paramètre est identifié par un nom. Ces valeurs sont sauvegardées à l'emplacement défini dans la fenêtre de configuration.
3°) L'optimisation
Cette fenêtre vous explique comment optimiser votre code pour éviter les lenteurs dues à la restauration des valeurs sauvegardées. En effet, lors de la restauration de la valeur d'un champ, son code de modification est exécuté. Si vous avez des traitements longs (Requêtes paramétrées ou autres), cette fenêtre vous montre comment accélérer le chargement de la fenêtre.
Classification Métier / UI : Code neutre
Composante : wd300std.dll
Voir Aussi
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Alias et sauvegarde des paramètres
Attention, si vous utilisez des Alias sur les fenêtres les paramètres mémorisés automatiquement (taille, position de fenêtre et champs avec mémorisation activés) seront sauvegardés sous cet Alias. Donc si cet alias est généré aléatoirement, au chargement de la fenêtre les paramètres seront perdus.



Toutefois, si vous nommez vos alias de fenêtre sous la forme suivante : "ALIAS_XXXX" alors Windev utilisera le nom de la fenêtre pour sauvegarder les paramètres. Je n'ai pas trouvé cette information dans l'aide donc je laisse cette information ici.
Sylvain LAFFONT
05 juin 2023

Dernière modification : 18/09/2024

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