PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Champ/bloc visible ou invisible
  • Etat d'un groupe de champs
  • Etat d'une colonne d'un champ Table
  • Onglets et champs d'un volet d'onglet
  • Boîte à outils et champs d'un volet
  • Champs Sélecteur/Interrupteur et leurs options
  • Champ actif rendu ou non invisible
  • Options de menu
  • Limites
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
La propriété ..Etat peut être utilisée :
  • dans un état.
  • dans une fenêtre.
  • dans une page.
WINDEVWEBDEV - Code ServeurEtats et RequêtesiPhone/iPadWindows MobileUniversal Windows 10 App Dans un état, la propriété ..Etat permet de connaître et de modifier l'état d'affichage :
  • d'un champ,
  • d'un bloc d'état.
Remarque : Dans un état, la propriété ..Etat permet uniquement de gérer la visibilité d'un champ ou d'un bloc (un champ ou un bloc ne peut pas être grisé). Dans ce cas, cette propriété est conservée uniquement par compatibilité avec WINDEV 5.5 et WEBDEV 1.5. Pour gérer la visibilité d'un champ ou d'un bloc dans un état, il est conseillé d'utiliser la propriété ..Visible.
WINDEVWINDEV Mobile Dans une fenêtre, la propriété ..Etat permet de connaître et de modifier l'état d'affichage :
  • d'une fenêtre,
  • d'un champ ou d'un groupe de champs,
  • d'une cellule ou d'une ligne de table,
  • d'une option de menu.
WEBDEV - Code ServeurWEBDEV - Code Navigateur Dans une page, la propriété ..Etat permet de connaître et de modifier l'état d'affichage :
  • d'un champ.
  • d'un groupe de champs.
PHP La modification de l'état d'un champ est possible uniquement pour les champs de type "Automatique" ou "Dynamique" (onglet "Détail" de la description du champ). Pour gérer la visibilité d'un champ, utilisez la propriété ..Visible.
PHP La modification de l'état d'un champ est possible uniquement pour les champs de type "Automatique" ou "Dynamique" (onglet "IHM" de la description du champ). Pour gérer la visibilité d'un champ, utilisez la propriété ..Visible.
Versions 16 et supérieures
Universal Windows 10 App Cette propriété est désormais disponible pour les applications Windows Phone.
Nouveauté 16
Universal Windows 10 App Cette propriété est désormais disponible pour les applications Windows Phone.
Universal Windows 10 App Cette propriété est désormais disponible pour les applications Windows Phone.
Versions 15 et supérieures
Android Cette propriété est désormais disponible pour les applications Android.
Nouveauté 15
Android Cette propriété est désormais disponible pour les applications Android.
Android Cette propriété est désormais disponible pour les applications Android.
Versions 17 et supérieures
iPhone/iPad Cette propriété est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
iPhone/iPad Cette propriété est désormais disponible pour les applications iPhone/iPad.
iPhone/iPad Cette propriété est désormais disponible pour les applications iPhone/iPad.
Versions 18 et supérieures
Universal Windows 10 App Cette propriété est désormais disponible en mode Windows Store apps.
iPhone/iPad Cette propriété est désormais disponible pour les champs ou les blocs d'un état dans les applications iPhone/iPad.
Nouveauté 18
Universal Windows 10 App Cette propriété est désormais disponible en mode Windows Store apps.
iPhone/iPad Cette propriété est désormais disponible pour les champs ou les blocs d'un état dans les applications iPhone/iPad.
Universal Windows 10 App Cette propriété est désormais disponible en mode Windows Store apps.
iPhone/iPad Cette propriété est désormais disponible pour les champs ou les blocs d'un état dans les applications iPhone/iPad.
Versions 20 et supérieures
AndroidiPhone/iPad 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
AndroidiPhone/iPad 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.
AndroidiPhone/iPad 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
Universal Windows 10 App Cette propriété est désormais disponible en mode Universal Windows 10 App.
Apple Watch Cette propriété est désormais disponible en mode Apple Watch.
Nouveauté 21
Universal Windows 10 App Cette propriété est désormais disponible en mode Universal Windows 10 App.
Apple Watch Cette propriété est désormais disponible en mode Apple Watch.
Universal Windows 10 App Cette propriété est désormais disponible en mode Universal Windows 10 App.
Apple Watch Cette propriété est désormais disponible en mode Apple Watch.
Versions 22 et supérieures
WEBDEV - Code Navigateur Cette propriété est désormais disponible en code navigateur.
Nouveauté 22
WEBDEV - Code Navigateur Cette propriété est désormais disponible en code navigateur.
WEBDEV - Code Navigateur Cette propriété est désormais disponible en code navigateur.
Exemple
WINDEVWEBDEV - Code ServeurEtats et RequêtesAndroidiPhone/iPadWindows MobileUniversal Windows 10 AppJavaPHPAjaxCode Utilisateur (MCU)
// Le champ LIB_Libellé1 devient actif
LIB_Libellé1..Etat = Actif
WINDEVWEBDEV - Code ServeurAndroidWindows MobileUniversal Windows 10 AppJavaPHPAjaxCode Utilisateur (MCU)
// Le champ SAI_Saisie1 devient actif
SAI_Saisie1..Etat = Actif
// Modification du contenu de la combo si elle est active
SI COMBO_Combo1..Etat = Actif ALORS
        COMBO_Combo1 = "<Saisir ICI>"
        RepriseSaisie(COMBO_Combo1)
FIN
WINDEV
// Grise la 4ème ligne de la table
TABLE_Client[4]..Etat = Grisé
// Grise la 1ère cellule de la colonne 2
COL_COL2[1]..Etat = Grisé
// Rend la 5ème ligne ni cliquable ni saisissable
TABLE_Client[5]..Etat = AffichageSansSélection
// Rend la 2ème cellule de la colonne 3 ni cliquable ni saisissable
COL_COL3[2]..Etat = AffichageSansSélection
// Rend la cellule active
COL_COL3[2]..Etat = Actif
Syntaxe
WINDEVWEBDEV - Code ServeurEtats et RequêtesiPhone/iPadWindows MobileUniversal Windows 10 App

Connaître l'état d'un élément dans un état Masquer les détails

<Etat en cours> = <Nom de l'élément>..Etat
<Etat en cours> : Constante de type entier
Etat actuel de l'objet.
ActifChamp ou bloc visible.
InvisibleChamp ou bloc invisible (il est conseillé d'utiliser la propriété ..Visible).
<Nom de l'élément> : Chaîne de caractères (avec ou sans guillemets)
Nom du champ ou du bloc d'état.
WINDEVWEBDEV - Code ServeurEtats et RequêtesiPhone/iPadWindows MobileUniversal Windows 10 App

Modifier l'état d'un élément dans un état Masquer les détails

<Nom de l'élément>..Etat = <Nouvel état>
<Nom de l'élément> : Chaîne de caractères (avec ou sans guillemets)
Nom du champ ou du bloc d'état.
<Nouvel état> : Constante de type entier
Nouvel état actuel de l'objet.
ActifChamp ou bloc visible.
InvisibleChamp ou bloc invisible (il est conseillé d'utiliser la propriété ..Visible).
WINDEVAndroidiPhone/iPadApple WatchWindows MobileUniversal Windows 10 AppJavaCode Utilisateur (MCU)

Connaître l'état d'un élément dans une fenêtre ou l'état d'une fenêtre Masquer les détails

<Etat en cours> = <Nom de l'élément>..Etat
<Etat en cours> : Constante de type entier
Etat actuel de l'objet.
Champs d'une fenêtre
ActifChamp actif et en saisie.
AffichageSansSélectionPour les champs Table uniquement : Champ affiché, sans aucune saisie possible.

Dans ce cas, l'utilisateur ne pourra pas sélectionner une ligne de la table à l'aide de la souris ou des flèches. Une ligne pourra être sélectionnée uniquement en programmation, grâce à la fonction TableSelectPlus. Cette ligne sera sélectionnée grâce au bandeau de sélection.
AffichageSeulement ou InactifChamp affiché, sans aucune saisie ou action possible.
Pour les champs Table, Table hiérarchique et Zone répétée , l'utilisateur pourra sélectionner une ligne. Il sera également possible de la sélectionner par programmation (par exemple grâce à la fonction TableSelectPlus pour les tables).
GriséChamp grisé.
Ligne ou cellule d'une table, table hiérarchique, liste, liste image, combo, zone répétée
ActifChamp actif et en saisie (si la table est en saisie).
AffichageSansSélectionChamp affiché, sans aucune saisie ou action possible. L'utilisateur ne pourra pas sélectionner une ligne de la table à l'aide de la souris ou des flèches. Une ligne pourra être sélectionnée uniquement en programmation, grâce à la fonction TableSelectPlus.

Cette ligne sera sélectionnée grâce au bandeau de sélection.
GriséChamp grisé
Java Fonctionnalité non gérée.
Fenêtres
ActifFenêtre manipulable par l'utilisateur.
AffichageSeulementLes champs de la fenêtre ne sont plus accessibles en modification. L'utilisateur pourra cependant modifier la ligne sélectionnée dans les champs Table, Table hiérarchique ou Zone répétée. La fenêtre ne peut pas être déplacée.
GriséGrise tous les champs de la fenêtre.
HorsEcranFenêtre active mais placée à des coordonnées négatives
<Nom de l'élément> : Chaîne de caractères (avec ou sans guillemets)
Nom du champ, de la ligne de table, de la cellule, du groupe de champs ou de la fenêtre.
WINDEVAndroidiPhone/iPadApple WatchWindows MobileUniversal Windows 10 AppJavaCode Utilisateur (MCU)

Modifier l'état d'un élément dans une fenêtre ou l'état d'une fenêtre Masquer les détails

<Nom de l'élément>..Etat = <Nouvel état>
<Nom de l'élément> : Chaîne de caractères (avec ou sans guillemets)
Nom du champ, de la ligne de table, de la cellule, du groupe de champs ou de la fenêtre.
<Nouvel état> : Constante de type entier
Nouvel état de l'élément.
Champs d'une fenêtre
ActifChamp actif et en saisie.
AffichageSansSélectionPour les champs Table uniquement : Champ affiché, sans aucune saisie possible.
Dans ce cas, l'utilisateur ne pourra pas sélectionner une ligne de la table à l'aide de la souris ou des flèches. Une ligne pourra être sélectionnée uniquement en programmation, grâce à la fonction TableSelectPlus. Cette ligne sera sélectionnée grâce au bandeau de sélection.
AffichageSeulement ou InactifChamp affiché, sans aucune saisie ou action possible.
Pour les champs Table, Table hiérarchique et Zone répétée, l'utilisateur pourra sélectionner une ligne. Il sera également possible de la sélectionner par programmation (par exemple grâce à la fonction TableSelectPlus pour les tables).
GriséChamp grisé
Ligne ou cellule d'une table, table hiérarchique, liste, liste image, combo, zone répétée
ActifChamp actif et en saisie (si la table est en saisie).
AffichageSansSélectionChamp affiché, sans aucune saisie ou action possible. L'utilisateur ne pourra pas sélectionner une ligne de la table à l'aide de la souris ou des flèches. Une ligne pourra être sélectionnée uniquement en programmation, grâce à la fonction TableSelectPlus.
Cette ligne sera sélectionnée grâce au bandeau de sélection.
GriséChamp grisé.
Fenêtres
ActifFenêtre manipulable par l'utilisateur.
AffichageSeulementLes champs de la fenêtre ne sont plus accessibles en modification. L'utilisateur pourra cependant modifier la ligne sélectionnée dans les champs Table, Table hiérarchique ou Zone répétée. La fenêtre ne peut pas être déplacée.
GriséGrise tous les champs de la fenêtre.
HorsEcranFenêtre active mais placée à des coordonnées négatives.
WEBDEV - Code ServeurPHPAjax

Connaître l'état d'un champ d'une page Masquer les détails

<Etat en cours> = <Nom du champ>..Etat
<Etat en cours> : Constante de type entier
Etat actuel de l'objet.
Actif ou VisibleChamp actif et en saisie.
GriséChamp grisé.
InactifChamp de saisie visible mais uniquement en affichage (utilisable uniquement avec les champs de saisie).
InvisibleInvisible (il est conseillé d'utiliser la propriété ..Visible).
Remarque : sur les champs de type Liste et Combo, l'état 'Inactif' se comporte comme l'état 'grisé'.
<Nom du champ> : Chaîne de caractères (sans guillemets)
Nom du champ ou du groupe de champs.
WEBDEV - Code ServeurWEBDEV - Code NavigateurPHPAjax

Connaître l'état d'un champ d'une page Masquer les détails

<Etat en cours> = <Nom du champ>..Etat
<Etat en cours> : Constante de type entier
Etat actuel de l'objet.
Actif ou VisibleChamp actif et en saisie.
GriséChamp grisé.
InactifChamp de saisie visible mais uniquement en affichage (utilisable uniquement avec les champs de saisie).
InvisibleInvisible (il est conseillé d'utiliser la propriété ..Visible).
WEBDEV - Code Navigateur Cette constante n'est pas disponible. Utilisez la propriété ..Visible.
Remarque : sur les champs de type Liste et Combo, l'état 'Inactif' se comporte comme l'état 'grisé'.
<Nom du champ> : Chaîne de caractères (sans guillemets)
Nom du champ ou du groupe de champs.
WEBDEV - Code ServeurPHPAjax

Modifier l'état d'un champ d'une page Masquer les détails

<Nom du champ>..Etat = <Nouvel état>
<Nom du champ> : Chaîne de caractères (sans guillemets)
Nom du champ ou du groupe de champs.
<Nouvel état> : Constante de type entier
Nouvel état de l'objet.
Actif ou VisibleChamp actif et en saisie.
GriséChamp grisé
InactifChamp de saisie visible mais uniquement en affichage (utilisable uniquement avec les champs de saisie).
InvisibleChamp invisible (il est conseillé d'utiliser la propriété ..Visible).
Remarques :
  • Sur les champs de type Liste et Combo, l'état 'Inactif' se comporte comme l'état 'Grisé'.
  • Le changement d'état peut donner des résultats légèrement différents suivant le navigateur utilisé. Par exemple l'état grisé sera plus visible sous Internet Explorer et Chrome, que sous Firefox.
WEBDEV - Code ServeurWEBDEV - Code NavigateurPHPAjax

Modifier l'état d'un champ d'une page Masquer les détails

<Nom du champ>..Etat = <Nouvel état>
<Nom du champ> : Chaîne de caractères (sans guillemets)
Nom du champ ou du groupe de champs.
<Nouvel état> : Constante de type entier
Nouvel état de l'objet.
Actif ou VisibleChamp actif et en saisie.
GriséChamp grisé
InactifChamp de saisie visible mais uniquement en affichage (utilisable uniquement avec les champs de saisie).
InvisibleChamp invisible (il est conseillé d'utiliser la propriété ..Visible).
WEBDEV - Code Navigateur Cette constante n'est pas disponible. Utilisez la propriété ..Visible.
Remarques :
  • Sur les champs de type Liste et Combo, l'état 'Inactif' se comporte comme l'état 'Grisé'.
  • Le changement d'état peut donner des résultats légèrement différents suivant le navigateur utilisé. Par exemple l'état grisé sera plus visible sous Internet Explorer et Chrome, que sous Firefox.
Remarques

Champ/bloc visible ou invisible

Dans un état, l'état d'un champ ou d'un bloc se limite à être visible ou non. Pour gérer la visibilité d'un champ, il est conseillé d'utiliser la propriété ..Visible. Cette propriété optimise la gestion de la visibilité des champs.

Etat d'un groupe de champs

  • Connaître l'état d'un groupe de champs : l'état renvoyé correspond à l'état du premier champ du groupe.
  • Modifier l'état d'un groupe de champs : tous les champs du groupe sont modifiés et correspondent au nouvel état.
WINDEVWEBDEV - Code ServeurEtats et RequêtesAndroidiPhone/iPadWindows MobileJavaPHPAjaxCode Utilisateur (MCU)

Etat d'une colonne d'un champ Table

Si la propriété ..Etat est appliquée à une colonne, c'est toute la colonne qui change d'état (et non pas une cellule de la colonne uniquement).
Attention : la propriété ..Etat permet uniquement de restreindre l'état de la colonne défini dans la fenêtre de description. Par exemple, si la colonne est en affichage, il n'est pas possible de rendre une cellule de la colonne saisissable.
Versions 20 et supérieures
AndroidiPhone/iPad Les champs Table sont désormais disponibles dans les applications iOS et Android.
Nouveauté 20
AndroidiPhone/iPad Les champs Table sont désormais disponibles dans les applications iOS et Android.
AndroidiPhone/iPad Les champs Table sont désormais disponibles dans les applications iOS et Android.
WINDEVAndroidiPhone/iPadWindows MobileUniversal Windows 10 AppJavaCode Utilisateur (MCU)

Onglets et champs d'un volet d'onglet

L'état d'un champ présent dans un volet d'onglet dépend de l'état du volet d'onglet :
  • Si le volet n'est pas sélectionné, le champ est invisible.
  • Si le volet est sélectionné et invisible, le champ est invisible.
  • Si le volet est sélectionné et grisé, le champ est grisé.
  • Si le volet est sélectionné et inactif, le champ est inactif.
  • Si le volet est sélectionné et actif, le champ peut être actif, inactif, grisé ou invisible.
WINDEVWindows MobileCode Utilisateur (MCU)

Boîte à outils et champs d'un volet

L'état d'un champ présent dans un volet de la boîte à outils dépend de l'état du volet:
  • Si le volet n'est pas sélectionné, le champ est invisible.
  • Si le volet est sélectionné et invisible, le champ est invisible.
  • Si le volet est sélectionné et grisé, le champ est grisé.
  • Si le volet est sélectionné et inactif, le champ est inactif.
  • Si le volet est sélectionné et actif, le champ peut être actif, inactif, grisé ou invisible.
WINDEVAndroidiPhone/iPadWindows MobileUniversal Windows 10 AppJavaCode Utilisateur (MCU)

Champs Sélecteur/Interrupteur et leurs options

Il est possible de modifier l'état du champ ou uniquement d'une option du sélecteur/interrupteur. Une option peut être active ou grisée.
  • Pour modifier l'état d'un champ Sélecteur :
    SEL_Select1..Etat = Grisé
  • Pour modifier l'état d'une option d'un champ Sélecteur :
    SEL_Select1[2]..Etat = Grisé
Attention : L'état d'une option dépend de l'état du champ Sélecteur. Ainsi, si les opérations suivantes sont effectuées :
  1. Une option est grisée.
  2. Le champ Sélecteur/Interrupteur est grisé.
  3. Le champ Sélecteur/Interrupteur redevient actif. L'option est toujours grisée.
WINDEVAndroidiPhone/iPadWindows MobileUniversal Windows 10 AppJavaCode Utilisateur (MCU)

Champ actif rendu ou non invisible

Un champ (actif, grisé, en affichage) peut être rendu invisible avec la propriété ..Visible.
Lorsque le champ est invisible il perd toutes les caractéristiques de son état précédent : le champ est invisible et ne peut pas être utilisé. La seule manière d'exécuter son code est d'utiliser la fonction ExécuteTraitement. En particulier, il est impossible d'utiliser les lettres d'appel d'un champ invisible. Par exemple, un bouton actif rendu invisible ne fonctionne pas via l'utilisation des lettres d'appel.
Pour retrouver l'état précédent du champ, il suffit de ré-utiliser la propriété ..Visible.
WINDEVWindows Mobile

Options de menu

La propriété ..Etat permet de définir si l'option de menu est Active ou grisée. Pour définir si l'option de menu est visible, utilisez la propriété ..Visible.
Versions 20 et supérieures
iPhone/iPad La propriété ..Etat = Grisé utilisée sur une option de menu contextuel permet de rendre cette option invisible.
Nouveauté 20
iPhone/iPad La propriété ..Etat = Grisé utilisée sur une option de menu contextuel permet de rendre cette option invisible.
iPhone/iPad La propriété ..Etat = Grisé utilisée sur une option de menu contextuel permet de rendre cette option invisible.
Windows Mobile Pour optimiser la taille du framework WINDEV Mobile installé sur le terminal mobile (Pocket PC), seules les propriétés sont disponibles pour manipuler par programmation les options de menu.
Le tableau des équivalences est le suivant :
Fonctions disponibles
sous WINDEV standard
Propriétés équivalentes
MenuDémarque
MenuMarquage
MenuMarque
Cochée
MenuEtatEtat
MenuInvisibleVisible
MenuSelectMoinsEtat
MenuSelectPlusEtat
MenuLibelléLibellé

Limites

WINDEVWEBDEV - Code ServeurEtats et RequêtesiPhone/iPadWindows MobileUniversal Windows 10 App La propriété ..Etat n'a aucun effet sur les états.
Java La propriété ..Etat s'applique uniquement aux éléments suivants :
  • Bouton.
  • Libellé.
  • Champ de saisie.
  • Image.
  • Interrupteur.
  • Sélecteur.
  • Liste.
  • Combo.
  • Arbre.
  • Onglet.
  • Fenêtre.
  • Table.
  • Colonne de table.
  • Superchamp.
Universal Windows 10 App La propriété ..Etat est sans effet sur les champs HTML.
WEBDEV - Code Navigateur La propriété ..Etat est sans effet sur les éléments suivants :
  • Table,
  • Table hiérarchique,
  • Zone répétée
  • Zone répétée linéaire
  • Colonne de table.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire