Valeur (Propriété)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Aide

Valeur d'un champ Libellé
Valeur d'un champ Calculé dans un état
Valeur d'un champ Code-barres
Valeur d'un champ Image
Valeur d'un champ Libellé ou d'un champ prédéfini d'un état
Valeur d'un champ RTF
Valeur d'une fenêtre ou d'une page
Valeur d'un champ de saisie
Valeur d'un champ Bouton
Valeur d'un champ Interrupteur ou d'une option d'un champ Interrupteur
Valeur d'un champ Sélecteur
Valeur d'un champ Liste, Liste image ou Table
Valeur d'une cellule d'un champ Table
Valeur d'un champ Combo
Valeur d'un champ Arbre ou champ Table hiérarchique
Valeur d'un champ Jauge, d'un champ Potentiomètre, d'un champ Spin ou d'un champ Ascenseur
Valeur d'un champ Onglet
Valeur d'un menu ou d'une option de menu
Valeur d'un champ Graphe
Valeur d'un champ Notation
Valeur d'un champ ActiveX
Valeur d'un champ HTML
Valeur d'un champ Multimédia
Valeur d'un champ Carte
Limites

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

Valeur (Propriété)

En anglais : Value

La propriété Valeur permet de :

Connaître et modifier la valeur d'un champ d'un état.
Connaître et modifier la valeur d'un champ ou le titre d'une fenêtre.
Connaître l'identifiant d'un flux.
Connaître et modifier la valeur d'un champ ou le titre d'une page.
Connaître et modifier le fichier multimédia lié à un champ Multimédia.
Centrer la carte présente dans un champ Carte sur une position spécifique.
Versions 18 et supérieures
Connaître la valeur associée à une valeur d'une variable de type Enumération.
Nouveauté 18
Connaître la valeur associée à une valeur d'une variable de type Enumération.
Connaître la valeur associée à une valeur d'une variable de type Enumération.
Versions 23 et supérieures
Connaître l'identifiant ou le handle associé à un champ Conteneur natif.
Nouveauté 23
Connaître l'identifiant ou le handle associé à un champ Conteneur natif.
Connaître l'identifiant ou le handle associé à un champ Conteneur natif.

Remarque : La propriété Valeur est rarement utilisée et peut être remplacée par une syntaxe équivalente (voir Remarques).

Versions 15 et supérieures

Cette propriété est désormais disponible pour les applications Android.

Nouveauté 15

Cette propriété est désormais disponible pour les applications Android.

Versions 17 et supérieures

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

Nouveauté 17

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

Versions 18 et supérieures

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

Cette propriété est désormais disponible pour les états dans les applications iPhone/iPad.

Cette propriété est désormais disponible en mode Widget Android.

Nouveauté 18

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

Cette propriété est désormais disponible pour les états dans les applications iPhone/iPad.

Cette propriété est désormais disponible en mode Widget Android.

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

Cette propriété est désormais disponible pour les états dans les applications iPhone/iPad.

Cette propriété est désormais disponible en mode Widget Android.

Versions 20 et supérieures

Cette propriété est désormais disponible pour les champs Table et les colonnes de table dans les applications Android et dans les applications iPhone/iPad.

Nouveauté 20

Cette propriété est désormais disponible pour les champs Table et les colonnes de table dans les applications Android et dans les applications iPhone/iPad.

Versions 21 et supérieures

Cette propriété est désormais disponible en mode Apple Watch.

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

Nouveauté 21

Cette propriété est désormais disponible en mode Apple Watch.

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

Cette propriété est désormais disponible en mode Apple Watch.

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

Exemple

// Modifier le fichier image associé au champ Image "IMG_Image"
IMG_Image.Valeur = "C:\MesImages\Image.BMP"

Syntaxe

Connaître la valeur d'un élément Masquer les détails

<Résultat> = <Elément manipulé>.Valeur

<Résultat> : Tout type

Ce résultat dépend du type de l'élément.

<Elément manipulé> : Type de l'élément

Nom de l'élément à manipuler.

Modifier la valeur d'un élément Masquer les détails

<Elément manipulé>.Valeur = <Nouvelle valeur>

<Elément manipulé> : Type de l'élément

Nom de l'élément à manipuler.

<Nouvelle valeur> : Tout type

Nouvelle valeur de l'élément spécifié. Ce paramètre dépend du type de l'élément spécifié.

Remarques

Valeur d'un champ Libellé

La propriété Valeur permet de récupérer ou de modifier le texte d'un champ Libellé.

<Résultat> est une chaîne de caractères.

Pour récupérer le texte d'un champ Libellé, les syntaxes suivantes sont équivalentes :

ResLibellé = <Champ Libellé>.Valeur
ResLibellé = <Champ Libellé>
ResLibellé = <Champ Libellé>.Libellé

Valeur d'un champ Calculé dans un état

La propriété Valeur permet de récupérer ou de modifier la valeur d'un champ Calculé dans un état.

Le type du <Résultat> dépend du type du champ Calculé.

Pour récupérer la valeur d'un champ Calculé, les syntaxes suivantes sont équivalentes :

ResValeur = <Champ Calculé>.Valeur

ResValeur = <Champ Calculé>

Valeur d'un champ Code-barres

La propriété Valeur permet de récupérer ou de modifier la valeur d'un champ Code-barres. La valeur d'un champ Code-barres correspond à la chaîne de caractères représentée sous forme d'un code-barres.

<Résultat> est une chaîne de caractères.

Pour récupérer la valeur d'un champ Code-barres, les syntaxes suivantes sont équivalentes :

ResValeur = <Champ Code-barres>.Valeur

ResValeur = <Champ Code-barres>

Valeur d'un champ Image

La propriété Valeur permet de connaître ou de modifier le fichier image associé à un champ Image.

<Résultat> est une chaîne de caractères contenant le chemin du fichier image.

Pour connaître le fichier image associé à un champ Image, les syntaxes suivantes sont équivalentes :

ResImage = <Champ Image>.Valeur

ResImage = <Champ Image>

Valeur d'un champ Libellé ou d'un champ prédéfini d'un état

La propriété Valeur permet de connaître ou de modifier le contenu du champ.

En affectation, le type de la valeur passée à la propriété Valeur dépend du type de la rubrique associé au champ.

Si la rubrique est du type numérique, il est nécessaire de lui affecter un nombre tout en vérifiant que le masque de saisie soit adapté (propriété MasqueSaisie).

Pour un champ de type date, il est nécessaire de l'affecter avec une date.

Valeur d'un champ RTF

La propriété Valeur permet de récupérer ou de modifier le contenu d'un champ RTF. Ce contenu contient les caractères spéciaux spécifiques au format RTF.

<Résultat> est une chaîne de caractères.

Pour récupérer le contenu d'un champ RTF, les syntaxes suivantes sont équivalentes :

ResRTF = <Champ RTF>.Valeur

ResRTF = <Champ RTF>

Valeur d'une fenêtre ou d'une page

La propriété Valeur permet de récupérer ou de modifier le titre d'une fenêtre ou d'une page.

<Résultat> est une chaîne de caractères.

La propriété Valeur est équivalente à la propriété Titre.

Pour connaître le titre d'une fenêtre ou d'une page, les syntaxes suivantes sont équivalentes :

ResTitre = <Nom de la fenêtre ou de la page>.Valeur

ResTitre = <Nom de la fenêtre ou de la page>

ResTitre = <Nom de la fenêtre ou de la page>.Titre

Valeur d'un champ de saisie

La propriété Valeur permet de récupérer ou de modifier la valeur saisie dans un champ de saisie.

<Résultat> est de type :

chaîne de caractères si le sous-type du champ de saisie correspond à "Texte", "Date" ou "Heure",
entier ou réel si le sous-type du champ de saisie correspond à "Numérique",
numérique si le sous-type du champ de saisie correspond à "Monétaire" ou "Monétaire + Euro".

Pour connaître la valeur saisie dans un champ de saisie, les syntaxes suivantes sont équivalentes :

ResValeur = <Champ de saisie>.Valeur

ResValeur = <Champ de saisie>

Valeur d'un champ Bouton

La propriété Valeur permet de récupérer ou de modifier le texte d'un champ Bouton.

Si le champ Bouton spécifié contient une image, seul le texte du champ Bouton est retourné. Il n'est pas possible d'affecter un dessin à un champ Bouton.

<Résultat> est une chaîne de caractères.

La propriété Valeur est équivalente à la propriété Libellé.

Pour connaître le texte d'un champ Bouton, les syntaxes suivantes sont équivalentes :

ResBouton = <Champ Bouton>.Valeur

ResBouton = <Champ Bouton>

ResBouton = <Champ Bouton>.Libellé

Valeur d'un champ Interrupteur ou d'une option d'un champ Interrupteur

La propriété Valeur permet de :

Cocher ou décocher une option d'un champ Interrupteur.
Savoir si une option d'un champ Interrupteur est cochée ou décochée

<Résultat> est un booléen :

Vrai si l'option est cochée,
Faux dans le cas contraire.

Pour savoir si une option d'un champ Interrupteur est cochée ou non, les syntaxes suivantes sont équivalentes :

ResCoché = <Champ Interrupteur>[<Numéro de l'option>].Valeur

ResCoché = <Champ Interrupteur>[<Numéro de l'option>]

ResCoché = <Nom de l'option>.Valeur

ResCoché = <Nom de l'option>

Remarque : Si le paramètre <Numéro de l'option> n'est pas spécifié, la première option est sélectionnée par défaut.

Valeur d'un champ Sélecteur

La propriété Valeur permet de :

Connaître l'option active d'un champ Sélecteur.
Sélectionner une option.

<Résultat> est un entier.

Pour connaître l'option active d'un champ Sélecteur, les syntaxes suivantes sont équivalentes :

ResOption = <Champ Sélecteur>.Valeur

ResOption = <Champ Sélecteur>

Remarque : Par défaut, un champ Sélecteur est toujours positionné sur une position (1 par défaut). Pour afficher un champ Sélecteur sans option par défaut, il suffit d'affecter la valeur du champ à -1 lors de son initialisation :

// Initialiser la valeur du champ "SEL_Client" avec sa valeur d'origine
SEL_Client.ValeurInitiale = -1

Valeur d'un champ Liste, Liste image ou Table

Deux cas distincts se présentent.

Le champ Liste (champ Liste image ou champ Table) est un champ mémoire OU la propriété RubriqueMémorisée correspond à une chaîne vide ("").
La propriété Valeur permet de :
- Connaître la ligne sélectionnée. Si aucune ligne n'est sélectionnée, la propriété Valeur retourne -1. Si le champ est multisélection, le numéro de la dernière ligne sélectionnée est renvoyé.
  Pour connaître la ligne sélectionnée, les syntaxes suivantes sont équivalentes :
  
  ResLigne = <Nom du champ>.Valeur
  
  ResLigne = <Nom du champ>
- Déplacer la sélection en indiquant le numéro de la nouvelle ligne à sélectionner. La ou les lignes précédemment sélectionnées sont dé-sélectionnées.
Le champ Liste (champ Liste image ou champ Table) est un champ fichier ET la propriété RubriqueMémorisée n'est pas vide.
La propriété Valeur permet de connaître la rubrique mémorisée pour l'enregistrement associé à la ligne sélectionnée. Si aucune ligne n'est sélectionnée, la propriété Valeur retourne une chaîne vide ("").
Pour connaître la rubrique mémorisée associée à la ligne sélectionnée, les syntaxes suivantes sont équivalentes :

ResRubMem = <Nom du champ>.Valeur

ResRubMem = <Nom du champ>.RubriqueMémorisée

Les champs Liste image ne sont pas disponibles.

Valeur d'une cellule d'un champ Table

La propriété Valeur permet de connaître ou de modifier la valeur d'une cellule d'un champ Table.

<Résultat> est une chaîne de caractères.

Pour connaître la valeur d'une cellule, les syntaxes suivantes sont équivalentes :

ResCellule = <Champ Table>[<Numéro de ligne>][<Numéro de colonne>].Valeur

ResCellule = <Champ Table>[<Numéro de ligne>][<Numéro de colonne>]

ResCellule = <Colonne>[<Numéro de ligne>].Valeur

ResCellule = <Colonne>[<Numéro de ligne>]

Cas particulier : Valeur d'une cellule de la ligne en cours
Si seul le nom de la colonne est spécifié, la propriété Valeur permet de :

Connaître la valeur de la cellule identifiée par la colonne spécifiée et par la ligne en cours dans le champ Table. Si aucune ligne n'est en cours, une chaîne vide ("") est renvoyée.
Modifier la valeur de la cellule identifiée par la colonne spécifiée et par la ligne en cours dans le champ Table.

<Résultat> est une chaîne de caractères.

Pour connaître la valeur de la cellule identifiée par la colonne spécifiée et par la ligne en cours dans le champ Table, les syntaxes suivantes sont équivalentes :

ResColonne = <Nom de la colonne>.Valeur

ResColonne = <Nom de la colonne>

Valeur d'un champ Combo

Deux cas distincts se présentent.

Le champ Combo est en saisie ET la propriété RubriqueMémorisée correspond à une chaîne vide ("").
La propriété Valeur permet de :
- Connaître la valeur de l'élément sélectionné. Si aucun élément n'est sélectionné, la propriété Valeur retourne une chaîne vide ("").
  Pour connaître la valeur de l'élément sélectionné, les syntaxes suivantes sont équivalentes :
  
  ResValeur = <Champ Combo>.Valeur
  
  ResValeur = <Champ Combo>
- Modifier la valeur de l'élément sélectionné.
Le champ Combo n'est pas en saisie OU la propriété RubriqueMémorisée n'est pas vide.
La propriété Valeur permet de connaître le numéro de l'élément sélectionné.
Pour connaître le numéro de l'élément sélectionné, les syntaxes suivantes sont équivalentes :

ResElément = <Champ Combo>.Valeur
ResElément = <Champ Combo>[<Champ Combo>]
ResElément = <Champ Combo>

Versions 19 et supérieures

Valeur d'un champ Arbre ou champ Table hiérarchique

Deux cas distincts se présentent.

Le champ est un champ mémoire OU la propriété RubriqueMémorisée correspond à une chaîne vide ("").
La propriété Valeur permet de :
- Connaître la ligne sélectionnée. Si aucune ligne n'est sélectionnée, la propriété Valeur retourne -1. Si le champ est multisélection, le numéro de la dernière ligne sélectionnée est renvoyé.
  Pour connaître la ligne sélectionnée, les syntaxes suivantes sont équivalentes :
  
  ResLigne = <Nom du champ>.Valeur
  
  ResLigne = <Nom du champ>
- Déplacer la sélection en indiquant le numéro de la nouvelle ligne à sélectionner. La ou les lignes précédemment sélectionnées sont dé-sélectionnées.
Le champ est un champ fichier ET la propriété RubriqueMémorisée n'est pas vide.
La propriété Valeur permet de connaître la rubrique mémorisée pour l'enregistrement associé à la ligne sélectionnée. Si aucune ligne n'est sélectionnée, la propriété Valeur retourne une chaîne vide ("").
Pour connaître la rubrique mémorisée associée à la ligne sélectionnée, les syntaxes suivantes sont équivalentes :

ResRubMem = <Nom du champ>.Valeur

ResRubMem = <Nom du champ>.RubriqueMémorisée

Nouveauté 19

Valeur d'un champ Arbre ou champ Table hiérarchique

Deux cas distincts se présentent.

Le champ est un champ mémoire OU la propriété RubriqueMémorisée correspond à une chaîne vide ("").
La propriété Valeur permet de :
- Connaître la ligne sélectionnée. Si aucune ligne n'est sélectionnée, la propriété Valeur retourne -1. Si le champ est multisélection, le numéro de la dernière ligne sélectionnée est renvoyé.
  Pour connaître la ligne sélectionnée, les syntaxes suivantes sont équivalentes :
  
  ResLigne = <Nom du champ>.Valeur
  
  ResLigne = <Nom du champ>
- Déplacer la sélection en indiquant le numéro de la nouvelle ligne à sélectionner. La ou les lignes précédemment sélectionnées sont dé-sélectionnées.
Le champ est un champ fichier ET la propriété RubriqueMémorisée n'est pas vide.
La propriété Valeur permet de connaître la rubrique mémorisée pour l'enregistrement associé à la ligne sélectionnée. Si aucune ligne n'est sélectionnée, la propriété Valeur retourne une chaîne vide ("").
Pour connaître la rubrique mémorisée associée à la ligne sélectionnée, les syntaxes suivantes sont équivalentes :

ResRubMem = <Nom du champ>.Valeur

ResRubMem = <Nom du champ>.RubriqueMémorisée

Valeur d'un champ Arbre ou champ Table hiérarchique

Deux cas distincts se présentent.

Le champ est un champ mémoire OU la propriété RubriqueMémorisée correspond à une chaîne vide ("").
La propriété Valeur permet de :
- Connaître la ligne sélectionnée. Si aucune ligne n'est sélectionnée, la propriété Valeur retourne -1. Si le champ est multisélection, le numéro de la dernière ligne sélectionnée est renvoyé.
  Pour connaître la ligne sélectionnée, les syntaxes suivantes sont équivalentes :
  
  ResLigne = <Nom du champ>.Valeur
  
  ResLigne = <Nom du champ>
- Déplacer la sélection en indiquant le numéro de la nouvelle ligne à sélectionner. La ou les lignes précédemment sélectionnées sont dé-sélectionnées.
Le champ est un champ fichier ET la propriété RubriqueMémorisée n'est pas vide.
La propriété Valeur permet de connaître la rubrique mémorisée pour l'enregistrement associé à la ligne sélectionnée. Si aucune ligne n'est sélectionnée, la propriété Valeur retourne une chaîne vide ("").
Pour connaître la rubrique mémorisée associée à la ligne sélectionnée, les syntaxes suivantes sont équivalentes :

ResRubMem = <Nom du champ>.Valeur

ResRubMem = <Nom du champ>.RubriqueMémorisée

Valeur d'un champ Jauge, d'un champ Potentiomètre, d'un champ Spin ou d'un champ Ascenseur

La propriété Valeur permet de connaître ou de modifier la valeur d'un champ Jauge, Potentiomètre, Spin ou Ascenseur.

<Résultat> est un réel.

Pour connaître la valeur d'un champ Jauge, Potentiomètre, Spin ou Ascenseur, les syntaxes suivantes sont équivalentes :

ResValeur = <Nom du champ>.Valeur

ResValeur = <Nom du champ>

Valeur d'un champ Onglet

La propriété Valeur permet de connaître le numéro du volet de l'onglet actif ou d'activer un volet du champ Onglet.

<Résultat> est un entier.

Pour connaître le numéro du volet de l'onglet actif, les syntaxes suivantes sont équivalentes :

ResVolet = <Champ Onglet>.Valeur

ResVolet = <Champ Onglet>

Valeur d'un menu ou d'une option de menu

La propriété Valeur permet de connaître le numéro associé au menu ou à l'option de menu en cours.

Remarque : Le numéro associé à un menu ou à une option de menu est défini dans l'onglet "Général" de la description du menu ou de l'option de menu.

<Résultat> est un entier.

Pour connaître le numéro associé au menu ou à l'option de menu en cours, les syntaxes suivantes sont équivalentes :

ResMenu = <Nom du menu ou de l'option de menu>.Valeur

ResMenu = <Nom du menu ou de l'option de menu>

Valeur d'un champ Graphe

La propriété Valeur permet uniquement de connaître le nom d'un champ Graphe.

<Résultat> est une chaîne de caractères.

Pour connaître le nom d'un champ Graphe, les syntaxes suivantes sont équivalentes :

Res_NomGraphe = <Champ Graphe>.Valeur

Res_NomGraphe = <Champ Graphe>

Valeur d'un champ Notation

La propriété Valeur permet d'initialiser et de connaître la valeur d'un champ Notation.

Cette valeur correspond au nombre de "pictogrammes" affichés dans le champ.

Exemple :

NOTE_Nation1.Valeur = 4.5

Valeur d'un champ ActiveX

La propriété Valeur permet de connaître l'identifiant COM (ProgId) de l'ActiveX manipulé.

Valeur d'un champ HTML

La propriété Valeur permet de connaître l'adresse associée à la page HTML affichée dans le champ. Si la page :

est une page construite directement en HTML, la valeur correspond à "about:blank".
est une page d'un site, la valeur correspond à l'adresse de la page (par exemple www.pcsoft.fr).
est un fichier HTML, la valeur correspond à l'adresse du fichier.

La propriété Valeur renvoie l'URL du site mais ne peut pas renvoyer le code HTML du champ. Cette propriété ne peut pas être utilisée pour associer un fichier htm local au champ HTML.

Valeur d'un champ Multimédia

La propriété Valeur permet de connaître le nom du fichier multimédia lié à un champ Multimédia. Cette propriété permet également de modifier le fichier multimédia lié au champ :

Le fichier indiqué par la propriété Valeur est associé au champ, chargé et joué (équivalent à la fonction MultimédiaJoue).
Si la valeur du champ correspond à une chaîne vide (""), la lecture est arrêtée et le fichier est déchargé de la mémoire.

Versions 17 et supérieures

Valeur d'un champ Carte

La propriété Valeur permet de centrer la carte (présente dans un champ Carte) sur la position correspondant à une variable de type géoPosition.

Exemple :

// Centre la carte affichée par le champ "CARTE_Position" sur une position géographique
MaPosition est une géoPosition

CARTE_Position.Valeur = MaPosition

Remarques :

L'utilisation de la propriété Valeur est équivalente à la fonction CarteAffichePosition. Seule différence : lors de l'utilisation de la fonction CarteAffichePosition, le positionnement sur la position demandée est réalisé à l'aide d'une animation.

Nouveauté 17

Valeur d'un champ Carte

La propriété Valeur permet de centrer la carte (présente dans un champ Carte) sur la position correspondant à une variable de type géoPosition.

Exemple :

// Centre la carte affichée par le champ "CARTE_Position" sur une position géographique
MaPosition est une géoPosition

CARTE_Position.Valeur = MaPosition

Remarques :

L'utilisation de la propriété Valeur est équivalente à la fonction CarteAffichePosition. Seule différence : lors de l'utilisation de la fonction CarteAffichePosition, le positionnement sur la position demandée est réalisé à l'aide d'une animation.

Valeur d'un champ Carte

La propriété Valeur permet de centrer la carte (présente dans un champ Carte) sur la position correspondant à une variable de type géoPosition.

Exemple :

// Centre la carte affichée par le champ "CARTE_Position" sur une position géographique
MaPosition est une géoPosition

CARTE_Position.Valeur = MaPosition

Remarques :

L'utilisation de la propriété Valeur est équivalente à la fonction CarteAffichePosition. Seule différence : lors de l'utilisation de la fonction CarteAffichePosition, le positionnement sur la position demandée est réalisé à l'aide d'une animation.

Limites

Pour les états, la propriété Valeur ne peut pas être utilisée sur :

un état.
un bloc d'état.
un champ Interrupteur.
un champ Forme.
un champ Agenda.
un champ Planning.
un champ Diagramme de Gantt.
Versions 21 et supérieures
un champ Signature.
Nouveauté 21
un champ Signature.
un champ Signature.

Dans une fenêtre, la propriété Valeur ne peut pas être utilisée sur :

une option de sélecteur.
un volet d'onglet.
un groupe de champs.

La propriété Valeur s'applique uniquement aux éléments suivants :

Champ Bouton.
Champ Libellé.
Champ Image.
Fenêtre.

Voir Aussi

Version minimum requise

Version 9

Documentation également disponible pour…

Commentaires

Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 19/03/2021

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