DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions de gestion des champs
  • Exemple détaillé de suppression d'un paramètre (syntaxe 1)
  • Cas particuliers
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
SupprimeParamètre (Fonction)
En anglais : DeleteParameter
Supprime un paramètre ou une série de paramètres sauvés :
Attention : Cette opération est irréversible et ne peut pas être annulée.
Exemple
// Suppression d'un paramètre (syntaxe 1)
SupprimeParamètre("MonParamètre")
WINDEVAndroidWidget AndroidiPhone/iPadJava
// Suppression d'un paramètre (syntaxe 1)
SupprimeParamètre("FEN_Fenêtre1\SAI_Saisie1")
WINDEVAndroidWidget AndroidiPhone/iPadJava
// Suppression des paramètres de la fenêtre "FEN_Fen1" (syntaxe 2)
SupprimeParamètre(FEN_Fen1)
// équivalent à : SupprimeParamètre(FEN_Fen1..CheminComplet)
Syntaxe

Supprimer un paramètre sauvé Masquer les détails

<Résultat> = SupprimeParamètre(<Nom du paramètre>)
<Résultat> : Booléen
  • Vrai si la fonction a réussi,
  • Faux dans le cas contraire. En cas d'erreur, il est possible de connaître le détail de l'erreur grâce à la fonction ErreurInfo.
<Nom du paramètre> : Chaîne de caractères
Nom du paramètre à supprimer. Ce paramètre est recherché :
  • soit dans la base de registre (ou le fichier équivalent sur la plateforme d'exécution),
  • WINDEVEtats et RequêtesiPhone/iPadJavaCode Utilisateur (MCU) soit dans le fichier de paramètre spécifié avec la fonction InitParamètre.
Ce nom peut être une valeur ou un chemin complet (les séparateurs acceptés sont le point (.) et le slash (\)). Dans le cas d'un chemin complet, toutes les valeurs situées "en dessous" de ce chemin seront supprimées (voir exemple dans les notes).
Java Si le mode d'initialisation choisi est la base de registre, la fonction SupprimeParamètre n'est sensible ni à la casse, ni à l'accentuation du nom du paramètre (Paramètre et parametre sont équivalents).
WINDEVEtats et RequêtesCode Utilisateur (MCU)

Supprimer tous les paramètres sauvés pour l'élément spécifié Masquer les détails

<Résultat> = SupprimeParamètre(<Nom de l'élément>)
<Résultat> : Booléen
  • Vrai si la fonction a réussi,
  • Faux dans le cas contraire. En cas d'erreur, il est possible de connaître le détail de l'erreur grâce à la fonction ErreurInfo.
<Nom de l'élément> : Chaîne de caractères
Nom du champ ou de la fenêtre dont les paramètres sauvegardés doivent être supprimés. Cet élément est recherché dans le fichier de paramètre spécifié avec la fonction InitParamètre (par défaut, dans la base de registre).
WINDEVEtats et RequêtesUniversal Windows 10 AppAndroidWidget AndroidiPhone/iPadJavaCode Utilisateur (MCU)

Supprimer tous les paramètres sauvegardés Masquer les détails

<Résultat> = SupprimeParamètre()
<Résultat> : Booléen
  • Vrai si la fonction a réussi,
  • Faux dans le cas contraire. En cas d'erreur, il est possible de connaître le détail de l'erreur grâce à la fonction ErreurInfo.
Tous les paramètres sauvegardés pour l'application sont effacés. Au prochain lancement, l'application se comportera comme à son premier lancement.
WINDEVEtats et RequêtesiPhone/iPadJavaCode Utilisateur (MCU) Le fichier de paramètre de l'application spécifié avec la fonction InitParamètre est entièrement vidé. Si les paramètres ont été sauvegardés dans un fichier INI ou XML, ce fichier est supprimé.
Remarques

Exemple détaillé de suppression d'un paramètre (syntaxe 1)

Code utiliséFichier de sauvegarde : Base de registreFichier de sauvegarde : XML
SupprimeParamètre
("Param1")
HKEY_CURRENT_USER
\Software
\<Société>
\<Application>
Param1
Param2
<Param1> Valeur </Param1>
SupprimeParamètre
("Fenetre1\Saisie2\X")
HKEY_CURRENT_USER
\Software
\<Société>
\<Application>
\Fenetre1\
Saisie2
X
Y
<Fenetre1>
<Saisie2>
<X>Valeur </X>
<Y>Valeur </Y>
</Saisie2>
</Fenetre1>
SupprimeParamètre
("Fenetre1\Saisie2")
HKEY_CURRENT_USER
\Software
\<Société>
\<Application>
\Fenetre1
\Saisie2
X
Y
<Fenetre1>
<Saisie2>
<X>Valeur </X>
<Y>Valeur </Y>
</Saisie2>
</Fenetre1>

<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".

Cas particuliers

  • AndroidWidget Android Sous Android, les valeurs persistantes sont sauvegardées dans les préférences partagées ("Shared Preferences") de l'application.
  • Universal Windows 10 App Dans les applications en mode Universal Windows App, les valeurs persistantes sont sauvegardées dans les paramètres de l'application ("Isolated Storage Settings").
  • iPhone/iPad Sous iOS, les valeurs persistantes sont sauvegardées dans les paramètres de l'application ("NSUserDefault").
  • WEBDEV - Code Serveur Dans un site WEBDEV, les valeurs persistantes sont enregistrées dans un cookie navigateur.
Classification Métier / UI : Code neutre
Composante : wd290std.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 03/07/2023

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