SupprimeParamètre (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

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)

ChampCauseEntréeSortie

ChampExécuteFermeture

ChampExécuteModification

CoordonnéeEcranVersEditeur

CoordonnéeEditeurVersEcran

CouleurSélection

DictionnaireCharge

DispositionAdapteTaille

DonneFocus

EcranPremier

EnumèreChamp

Fonctions de gestion des champs

PointDAttacheSupprimeTout

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

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

SupprimeParamètre (Fonction)

En anglais : DeleteParameter

Supprime un paramètre ou une série de paramètres sauvés :

soit avec la fonction SauveParamètre,
soit automatiquement grâce à la persistance des données dans les champs.

Attention : Cette opération est irréversible et ne peut pas être annulée.

Versions 15 et supérieures

Cette fonction est désormais disponible pour les applications Android.

Nouveauté 15

Cette fonction est désormais disponible pour les applications Android.

Versions 17 et supérieures

Cette fonction est désormais disponible pour les applications Windows Phone.

Nouveauté 17

Cette fonction est désormais disponible pour les applications Windows Phone.

Versions 18 et supérieures

Cette fonction est désormais disponible en mode Widget Android.

Cette fonction est désormais disponible en mode Windows Store apps.

Nouveauté 18

Cette fonction est désormais disponible en mode Widget Android.

Cette fonction est désormais disponible en mode Windows Store apps.

Cette fonction est désormais disponible en mode Widget Android.

Cette fonction est désormais disponible en mode Windows Store apps.

Versions 19 et supérieures

Cette fonction est désormais disponible pour les applications iPhone/iPad.

Nouveauté 19

Cette fonction est désormais disponible pour les applications iPhone/iPad.

Versions 21 et supérieures

Cette fonction est désormais disponible en mode Universal Windows 10 App.

Nouveauté 21

Cette fonction est désormais disponible en mode Universal Windows 10 App.

Versions 24 et supérieures

Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.

Cette fonction est désormais disponible pour les sites WEBDEV sous Windows.

Nouveauté 24

Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.

Cette fonction est désormais disponible pour les sites WEBDEV sous Windows.

Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.

Cette fonction est désormais disponible pour les sites WEBDEV sous Windows.

Exemple

// Suppression d'un paramètre (syntaxe 1)
SupprimeParamètre("MonParamètre")

// Suppression d'un paramètre (syntaxe 1)
SupprimeParamètre("FEN_Fenêtre1\SAI_Saisie1")

// 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),
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).
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).

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

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

Dans cet exemple, les éléments supprimés sont surlignés.


Code utilisé	Fichier de sauvegarde : Base de registre	Fichier 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

Versions 15 et supérieures
Sous Android, les valeurs persistantes sont sauvegardées dans les préférences partagées ("Shared Preferences") de l’application.
Nouveauté 15
Sous Android, les valeurs persistantes sont sauvegardées dans les préférences partagées ("Shared Preferences") de l’application.
Sous Android, les valeurs persistantes sont sauvegardées dans les préférences partagées ("Shared Preferences") de l’application.
Versions 15 et supérieures
Sous Windows Phone, les valeurs persistantes sont sauvegardées dans les paramètres de l’application ("Isolated Storage Settings").
Nouveauté 15
Sous Windows Phone, les valeurs persistantes sont sauvegardées dans les paramètres de l’application ("Isolated Storage Settings").
Sous Windows Phone, les valeurs persistantes sont sauvegardées dans les paramètres de l’application ("Isolated Storage Settings").
Versions 19 et supérieures
Sous iOS, les valeurs persistantes sont sauvegardées dans les paramètres de l’application ("NSUserDefault").
Nouveauté 19
Sous iOS, les valeurs persistantes sont sauvegardées dans les paramètres de l’application ("NSUserDefault").
Sous iOS, les valeurs persistantes sont sauvegardées dans les paramètres de l’application ("NSUserDefault").
Versions 24 et supérieures
Dans un site WEBDEV, les valeurs persistantes sont enregistrées dans un cookie navigateur.
Nouveauté 24
Dans un site WEBDEV, les valeurs persistantes sont enregistrées dans un cookie navigateur.
Dans un site WEBDEV, les valeurs persistantes sont enregistrées dans un cookie navigateur.

Composante : wd250std.dll

Voir Aussi

Version minimum requise

Version 9

Documentation également disponible pour…

Commentaires

Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 31/10/2019

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