PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

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
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.
Versions 17 et supérieures
Android Cette fonction est désormais disponible pour les applications Android.
Nouveauté 17
Android Cette fonction est désormais disponible pour les applications Android.
Android Cette fonction est désormais disponible pour les applications Android.
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.
Versions 19 et supérieures
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 19
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 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
WINDEVEtats et RequêtesAndroidWidget AndroidiPhone/iPadWindows MobileUniversal Windows 10 AppCode Utilisateur (MCU)
// Paramétrage des valeurs persistantes
// dans un fichier .XML qui dépend de l'utilisateur
InitParamètre(paramXML, "Param_" + USER + ".xml")
WINDEVEtats et RequêtesWindows MobileUniversal Windows 10 AppCode 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")
WINDEVEtats et RequêtesAndroidWidget AndroidiPhone/iPadWindows MobileUniversal Windows 10 AppCode 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 :
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.
    iPhone/iPad Ce fichier est créé dans le répertoire "/Library" de l'application.
  • le paramètre <Source des valeurs> correspond au nom du fichier .INI à utiliser. La taille du fichier est limité à 64 Ko sous Windows 98 ou Me.
    Si le répertoire n'est pas précisé, le fichier est créé dans le répertoire de l'exécutable.
    iPhone/iPad Si le répertoire n'est pas précisé, le fichier est créé dans le répertoire "/Library" de l'application.
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\24\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.
Versions 17 et supérieures
AndroidWidget Android Le paramètre <Source des valeurs> sera ignoré. Si ce mode est choisi pour stocker des données persistantes, les données sont sauvées dans les préférences systèmes.
Nouveauté 17
AndroidWidget Android Le paramètre <Source des valeurs> sera ignoré. Si ce mode est choisi pour stocker des données persistantes, les données sont sauvées dans les préférences systèmes.
AndroidWidget Android Le paramètre <Source des valeurs> sera ignoré. Si ce mode est choisi pour stocker des données persistantes, les données sont sauvées dans les préférences systèmes.
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.
    iPhone/iPad Ce fichier est créé dans le répertoire "/Library" de l'application.
  • 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.
    iPhone/iPad Si le répertoire n'est pas précisé, le fichier est créé dans le répertoire "/Library" de l'application.
Windows Mobile Ce paramètre n'est pas supporté dans cette version.
Versions 17 et supérieures
AndroidWidget Android Ce paramètre est supporté uniquement à partir de la version 2.2 de Android. Si ce paramètre est utilisé dans une version antérieure, une erreur fatale sera déclenchée.
Nouveauté 17
AndroidWidget Android Ce paramètre est supporté uniquement à partir de la version 2.2 de Android. Si ce paramètre est utilisé dans une version antérieure, une erreur fatale sera déclenchée.
AndroidWidget Android Ce paramètre est supporté uniquement à partir de la version 2.2 de Android. Si ce paramètre est utilisé dans une version antérieure, une erreur fatale sera déclenchée.
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).
Windows Mobile Ce paramètre n'est pas supporté dans cette version.
Versions 17 et supérieures
AndroidWidget Android Ce paramètre est supporté uniquement à partir de la version 2.2 de Android. Si ce paramètre est utilisé dans une version antérieure, une erreur fatale sera déclenchée.
Nouveauté 17
AndroidWidget Android Ce paramètre est supporté uniquement à partir de la version 2.2 de Android. Si ce paramètre est utilisé dans une version antérieure, une erreur fatale sera déclenchée.
AndroidWidget Android Ce paramètre est supporté uniquement à partir de la version 2.2 de Android. Si ce paramètre est utilisé dans une version antérieure, une erreur fatale sera déclenchée.
<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 / IHM : Code neutre
Composante : wd240std.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire