DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Propriétés WLangage / Propriétés diverses
  • 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 Onglet
  • Valeur d'un champ Graphe
  • Valeur d'un champ Notation
  • Valeur d'un champ Tiroir
  • Valeur d'un champ HTML
  • Valeur d'un champ Carte
  • Valeur d'un champ Chemin de navigation
  • Bouton, Lien et iFrame : propriété URL et propriété Valeur
  • Champ Upload
  • Champ Potentiomètre d'intervalle
  • Valeur d'un champ Bandeau défilant
  • Limites
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
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.
  • WEBDEV - Code ServeurWEBDEV - Code Navigateur Connaître les fichiers gérés par un champ Upload.
  • WEBDEV - Code ServeurWEBDEV - Code NavigateurPHP Connaître et modifier le plan actuellement affiché dans un champ Bandeau défilant.
  • WEBDEV - Code ServeurWEBDEV - Code Navigateur Centrer la carte présente dans un champ Carte sur une position spécifique.
  • WEBDEV - Code ServeurWEBDEV - Code NavigateurPHP Connaître et modifier la valeur inférieure de l'intervalle actuellement sélectionné dans un champ Potentiomètre d'intervalle.
  • Connaître la valeur associée à une valeur d'une variable de type Enumération.
Remarque : La propriété Valeur est rarement utilisée et peut être remplacée par une syntaxe équivalente (voir Remarques).
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
WEBDEV - Code ServeurPHPAjax

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é
WEBDEV - Code Serveur

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é>
WEBDEV - Code ServeurPHPAjax

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>
WEBDEV - Code ServeurPHPAjax

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>
WEBDEV - Code Serveur

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.
WEBDEV - Code ServeurPHPAjax

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>
WEBDEV - Code ServeurPHPAjax

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
WEBDEV - Code ServeurWEBDEV - Code NavigateurPHPAjax

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>
WEBDEV - Code ServeurWEBDEV - Code NavigateurPHPAjax

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é
WEBDEV - Code Navigateur Sur un champ Bouton Image sans image de survol, la propriété Valeur permet de modifier l'image du champ Bouton. Il est conseillé d'utiliser plutôt la propriété Image pour modifier l'image du champ Bouton.

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.
WEBDEV - Code ServeurWEBDEV - Code NavigateurPHPAjax

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
WEBDEV - Code ServeurPHPAjax

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 par programmation 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
WEBDEV - Code Serveur Rappel : le champ Liste image n'est pas disponible pour WEBDEV.
WEBDEV - Code ServeurPHPAjax

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>
WEBDEV - Code ServeurWEBDEV - Code NavigateurPHPAjax

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>
WEBDEV - Code Navigateur

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>
WEBDEV - Code Navigateur La propriété Valeur permet de connaître le numéro du volet de l'onglet actif en code Navigateur.
WEBDEV - Code ServeurPHPAjax

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>
WEBDEV - Code ServeurWEBDEV - Code Navigateur

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
WEBDEV - Code Navigateur

Valeur d'un champ Tiroir

La propriété Valeur permet de savoir si le champ Tiroir est déroulé (1) ou enroulé (0) et permet de modifier son état.
Exemple :
// Enroule le champ Tiroir si celui-ci est déroulé
SI TIR_Tiroir1.Valeur = 1 ALORS TIR_Tiroir1.Valeur = 0
WEBDEV - Code ServeurAjax

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.
WEBDEV - Code ServeurWEBDEV - Code Navigateur

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.
  • WEBDEV - Code Serveur La propriété Valeur permet uniquement de modifier la position dans un champ Carte.
  • WEBDEV - Code Navigateur La propriété Valeur permet de connaître et de modifier la position dans un champ Carte.
WEBDEV - Code ServeurPHPAjax

Valeur d'un champ Chemin de navigation

La propriété Valeur permet de connaître l'indice de l'élément du champ Chemin de navigation sur lequel l'utilisateur a cliqué.
WEBDEV - Code ServeurPHPAjax

Bouton, Lien et iFrame : propriété URL et propriété Valeur

La propriété URL a le même effet que la propriété Valeur sur les champs Bouton, Lien et iFrame. Ces propriétés permettent de connaître l'adresse associée au champ.
WEBDEV - Code ServeurWEBDEV - Code NavigateurAjax

Champ Upload

La propriété Valeur permet de connaître la liste des fichiers sélectionnés dans un champ Upload multifichier. Les différents noms de fichiers sont séparés par des RC (Retour Chariot). Dans le cas d'un champ Upload monofichier, seul le nom du fichier sélectionné est renvoyé.
WEBDEV - Code Serveur Le nom des fichiers correspond au chemin et nom du fichier temporaire uploadé. Par exemple : C\WebDep\Temp\Fichier.upl
Cette propriété doit être utilisée dans le traitement de Réception des fichiers uploadés. Dans les autres cas, cette propriété renvoie une chaîne vide ("").
Cette propriété est équivalente à la propriété Contenu en code serveur sur le champ Upload.
WEBDEV - Code Navigateur Le nom des fichiers correspond au nom du fichier affiché sur le navigateur. Par exemple : MonImage.jpg

WEBDEV - Code ServeurWEBDEV - Code NavigateurPHPAjax

Champ Potentiomètre d'intervalle

La propriété Valeur permet de connaître et de modifier la borne inférieure de l'intervalle actuellement sélectionné dans un champ Potentiomètre d'intervalle. Dans ce cas, cette propriété est équivalente à la propriété ValeurInférieure.
Les mêmes règles s'appliquent.

WEBDEV - Code ServeurWEBDEV - Code NavigateurPHPAjax

Valeur d'un champ Bandeau défilant

La propriété Valeur permet de :
  • connaître le numéro du plan affiché dans un champ Bandeau défilant.
  • d'afficher un plan spécifique dans un champ Bandeau défilant.
<Résultat> est un entier.
Pour connaître le numéro du plan affiché dans le champ Bandeau défilant, les syntaxes suivantes sont équivalentes :
ResPlan = <Champ Bandeau défilant>.Valeur

ResPlan = <Champ Bandeau défilant>

Limites

WEBDEV - Code Serveur 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.
  • un champ Signature.
WEBDEV - Code ServeurWEBDEV - Code Navigateur La propriété Valeur ne peut pas être utilisée sur :
  • une option de sélecteur,
  • un groupe de champs.
WEBDEV - Code Navigateur La propriété Valeur fonctionne uniquement sur les champs suivants :
  • Champ Libellé.
  • Champ d'affichage formaté.
  • Champ Bouton.
  • Champ de saisie,
  • Champ Liste.
  • Champ Combo,
  • Champ Interrupteur.
  • Champ Sélecteur.
  • Champ Vignette.
  • Champ iFrame.
  • Champ Tiroir.
  • Champ Onglet.
  • Champ Upload (monosélection et multisélection).
  • Champ Jauge.
  • Champ Planning.
  • Champ Potentiomètre (linéaire et d'intervalle).
  • Champ Bandeau défilant.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 17/10/2023

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