ValeurMémorisée (Propriété)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Aide / WLangage / Propriétés WLangage / Propriétés des fenêtres, des pages et de leurs champs

Limites

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

ValeurMémorisée (Propriété)

En anglais : StoredValue

La propriété ValeurMémorisée permet de connaître la valeur actuellement mémorisée par :

une ligne d'un champ Liste (y compris Liste image) ou d'un champ Combo.
un champ de saisie de type "Jetons de texte".
une ligne d'un champ Table.
une ligne de la saisie assistée d'un champ de saisie (si la ligne est sélectionnée).

La valeur actuellement mémorisée peut correspondre :

pour les champs Liste, Liste image et Combo fichier : à la valeur de la rubrique mémorisée définie sous l'éditeur de fenêtres (onglet "Contenu" de la description du champ) :
.
pour les champs Liste, Liste image et Combo par programmation : à la valeur définie en programmation par la fonction gValeurMémorisée.
Rappel : Pour que la récupération de la valeur définie par la fonction gValeurMémorisée soit active :
- soit utilisez la fonction gValeurMémoriséeActive.
- soit cochez l'option "Retourne la valeur spécifiée avec la fonction gValeurMémorisée" (onglet "Détail" de la description du champ).
Remarque : Cette propriété permet par exemple de récupérer les valeurs mémorisées dans le cas d'un champ Liste multisélection.
pour les champs de saisie de type "Jetons de texte" : à la valeur du jeton.
pour une ligne d'un champ Table par programmation : à la valeur mémorisée de la ligne. Pour ce type de champ, il est également possible d'affecter la valeur mémorisée de la ligne.
pour une ligne d'un champ Table sur variable, alimenté par un tableau de structures, à une structure du tableau.
pour une ligne de saisie assistée d'un champ de saisie : la valeur mémorisée associée à la ligne. Cette valeur a été définie soit lors de l'ajout de la ligne (fonction SaisieAssistéeAjoute), soit avec une variable de type SaisieAssistée.

Exemple

// Valeurs sélectionnées dans un champ Liste multisélection
i est un entier = 1
iLigneSélectionnée est un entier
iLigneSélectionnée = ListeSelect(LISTE_Cedex, 1)
TANTQUE iLigneSélectionnée <> -1
Trace(LISTE_Cedex[iLigneSélectionnée].ValeurMémorisée)
i++
iLigneSélectionnée = ListeSelect(LISTE_Cedex, i)
FIN

// Connaître la valeur mémorisée lors de la sélection du 3ème élément du champ Liste
Info("La valeur mémorisée est " + LISTE_Cedex[3].ValeurMémorisée)

// Connaître la valeur mémorisée par le champ de saisie de type "Jetons de texte"
Info("La valeur mémorisée est " + SAI_Jeton.ValeurMémorisée)
// Renvoie par exemple :
// JETON_AJOUTÉ+RC+JETON_AJOUTÉ2

SaisieAssistéeAjoute(SAI_Saisie1, "Valeur affichée", "Valeur mémorisée")

// Evénement "Sélection d'une valeur dans la liste de saisie assistée"
// ----------------------------------------------------
PROCÉDURE Sélection(MaSélection est un SaisieAssistée)
Trace(MaSélection.ValeurMémorisée)
// Renvoie "valeur mémorisée"

Syntaxe

Connaître la valeur mémorisée d'un champ Liste, Liste image ou Combo Masquer les détails

<Valeur mémorisée> = <Champ manipulé>[<Indice de l'élément>].ValeurMémorisée

<Valeur mémorisée> : Chaîne de caractères

Valeur qui sera mémorisée si l'utilisateur sélectionne l'élément du champ spécifié.

<Champ manipulé> : Nom de champ

Nom du champ Liste, Liste image ou Combo à manipuler.

<Indice de l'élément> : Entier

Indice de l'élément du champ (Liste, Liste image, Combo) dont la valeur mémorisée doit être connue.

Connaître la valeur mémorisée d'un champ de saisie de type "Jetons de texte" Masquer les détails

<Valeur mémorisée> = <Champ de saisie>.ValeurMémorisée

<Valeur mémorisée> : Chaîne de caractères

Valeur mémorisée. Si le champ a plusieurs jetons, ce paramètre est de la forme :
<Valeur du Jeton 1> + RC + ... + <Valeur du Jeton N>

<Champ de saisie> : Nom de champ

Nom du champ de saisie de type "Jetons de texte" à manipuler.

Non disponible en code navigateur

Connaître la valeur mémorisée d'une ligne d'un champ Table Masquer les détails

<Valeur mémorisée> = <Champ Table>[<Indice de la ligne>].ValeurMémorisée

<Valeur mémorisée> : Chaîne de caractères

Valeur mémorisée pour la ligne.

<Champ Table> : Nom de champ

Nom du champ Table à manipuler.

<Indice de la ligne> : Entier

Indice de la ligne dont la valeur mémorisée doit être connue.

Non disponible en code navigateur

Connaître la valeur mémorisée d'une ligne de saisie assistée Masquer les détails

<Valeur mémorisée> = <Elément>.ValeurMémorisée

<Valeur mémorisée> : Chaîne de caractères

Valeur mémorisée pour la ligne.

<Elément> : Variable de type SasisieAssistée ou Nom du champ

Variable de type SaisieAssistée contenant les caractéristiques de la ligne sélectionnée.
Utilisée dans l'événement "Sélection d'une valeur dans la liste de saisie assistée", cette variable contient les caractéristiques de la ligne sélectionnée.
Nom du champ de saisie dans lequel la ligne a été sélectionnée.

Remarques

Limites

La propriété ValeurMémorisée s'applique uniquement :