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 Image
  • Valeur d'un champ Libellé ou d'un champ prédéfini d'un état
  • 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'un champ Combo
  • Valeur d'un champ Graphe
  • Valeur d'un champ Notation
  • Valeur d'un champ HTML
  • Valeur d'un champ Carte
  • 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.
  • AndroidiPhone/iPadWidget IOS Centrer la carte présente dans un champ Carte sur une position spécifique.
  • Connaître la valeur associée à une valeur d'une variable de type Enumération.
  • AndroidiPhone/iPadWidget IOS 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).
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
Universal Windows 10 AppAndroidWidget AndroidiPhone/iPadWidget IOSApple Watch

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é
Universal Windows 10 AppiPhone/iPadWidget IOS

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é>
Universal Windows 10 AppAndroidWidget AndroidiPhone/iPadWidget IOSApple Watch

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>
Universal Windows 10 AppiPhone/iPadWidget IOS

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.
Universal Windows 10 AppAndroidWidget AndroidiPhone/iPadWidget IOSApple Watch

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
Universal Windows 10 AppAndroidiPhone/iPadWidget IOSApple Watch

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>
Universal Windows 10 AppAndroidWidget AndroidiPhone/iPadWidget IOSApple Watch

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.
Universal Windows 10 AppAndroidiPhone/iPadWidget IOS

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
Universal Windows 10 AppAndroidiPhone/iPadWidget IOS

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
AndroidiPhone/iPadWidget IOS Les champs Liste image ne sont pas disponibles.
Android

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>
Universal Windows 10 AppiPhone/iPadWidget IOS

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>
AndroidiPhone/iPadWidget IOS

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
Universal Windows 10 App

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.
Universal Windows 10 App 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.
AndroidiPhone/iPadWidget IOS

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

Universal Windows 10 AppiPhone/iPadWidget IOS 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.
Widget Android La propriété Valeur s'applique uniquement aux éléments suivants :
  • Champ Bouton.
  • Champ Libellé.
  • Champ Image.
  • Fenêtre.
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