|
|
|
|
|
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.
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îne | Les 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).
| paramIni | Les 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.
Ce fichier est créé dans le répertoire "/Library" de l'application. 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. Si le répertoire n'est pas précisé, le fichier est créé dans le répertoire "/Library" de l'application. Ce fichier est créé dans le dossier "$HOME/.local/share".
| paramRegistre | Les 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.
| paramXML | Les 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.
Ce fichier est créé dans le répertoire "/Library" de l'application. 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. Si le répertoire n'est pas précisé, le fichier est créé dans le répertoire "/Library" de l'application. 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 :
|
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
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|