Etat (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 diverses

Etat (Editeur d'états) : 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

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

Etat (Propriété)

En anglais : State

La propriété Etat permet de connaître et de modifier l'état d'affichage :

d'un champ d'une fenêtre, d'une page ou d'un état.
d'un bloc d'un état,
d'une fenêtre.

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'un champ "conteneur" (champ Onglet, Fenêtre interne, Disposition, etc.),
d'une cellule ou d'une ligne d'un champ Table,
d'une option de menu.

Dans une page, la propriété Etat permet de connaître et de modifier l'état d'affichage :

d'un champ, ou d'un groupe de champs,
d'un champ "conteneur" (champ Onglet, Page interne, Disposition, etc.),
d'un groupe de champs.

Dans un état, la propriété Etat permet de connaître et de modifier la visibilité d'un champ ou d'un bloc. 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.

Exemple

// Le champ LIB_Libellé1 devient actif
LIB_Libellé1.Etat = Actif

// 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>"
	DonneFocusEtRetourUtilisateur(COMBO_Combo1)
FIN

// Grise la 4ème ligne du champ 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

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
Actif Champ actif et en saisie.
AffichageSansSélection Pour les champs Table uniquement : Champ affiché, sans aucune saisie possible.

Dans ce cas, l'utilisateur ne pourra pas sélectionner une ligne du champ 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 Inactif Champ 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 champs Table).
Grisé Champ grisé.
Ligne ou cellule d'un champ Table, Table hiérarchique, Liste, Liste image, Combo, Zone répétée
Actif Champ actif et en saisie (si le champ Table est en saisie).
AffichageSansSélection Champ affiché, sans aucune saisie ou action possible. L'utilisateur ne pourra pas sélectionner une ligne du champ à l'aide de la souris ou des flèches. Une ligne pourra être sélectionnée uniquement en programmation (par exemple, grâce à la fonction TableSelectPlus pour les champs Table).

Cette ligne sera sélectionnée grâce au bandeau de sélection.
Grisé Champ grisé
Fonctionnalité non gérée.
Fenêtres
Actif Fenêtre manipulable par l'utilisateur.
AffichageSeulement Les 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.
HorsEcran Fenêtre active mais placée à des coordonnées négatives

<Nom de l'élément> : Chaîne de caractères

Nom du champ, de la ligne de table, de la cellule, du groupe de champs ou de la fenêtre.

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> : Chaîne de caractères

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
Actif Champ actif et en saisie.
AffichageSansSélection Pour les champs Table uniquement : Champ affiché, sans aucune saisie possible.

Dans ce cas, l'utilisateur ne pourra pas sélectionner une ligne du champ 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 Inactif Champ 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 champs Table).
Grisé Champ grisé.
Ligne ou cellule d'un champ Table, Table hiérarchique, Liste, Liste image, Combo, Zone répétée
Actif Champ actif et en saisie (si le champ Table est en saisie).
AffichageSansSélection Champ affiché, sans aucune saisie ou action possible. L'utilisateur ne pourra pas sélectionner une ligne du champ à l'aide de la souris ou des flèches. Une ligne pourra être sélectionnée uniquement en programmation (par exemple, grâce à la fonction TableSelectPlus pour les champs Table).

Cette ligne sera sélectionnée grâce au bandeau de sélection.
Grisé Champ grisé
Fonctionnalité non gérée.
Fenêtres
Actif Fenêtre manipulable par l'utilisateur.
AffichageSeulement Les 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.
HorsEcran Fenêtre active mais placée à des coordonnées négatives

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 Visible Champ actif et en saisie.
Grisé Champ grisé.
Inactif Champ de saisie visible mais uniquement en affichage (utilisable uniquement avec les champs de saisie).
Invisible Invisible (il est conseillé d'utiliser la propriété Visible).
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

Nom du champ ou du groupe de champs.

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

<Nom du champ> : Chaîne de caractères

Nom du champ ou du groupe de champs.

<Nouvel état> : Constante de type entier

Nouvel état de l'objet.
Actif ou Visible Champ actif et en saisie.
Grisé Champ grisé.
Inactif Champ de saisie visible mais uniquement en affichage (utilisable uniquement avec les champs de saisie).
Invisible Invisible (il est conseillé d'utiliser la propriété Visible).
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.

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.
Actif Champ ou bloc visible.
Invisible Champ ou bloc invisible (il est conseillé d'utiliser la propriété Visible).

<Nom de l'élément> : Chaîne de caractères

Nom du champ ou du bloc d'état.

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

<Nom de l'élément> : Chaîne de caractères

Nom du champ ou du bloc d'état.

<Nouvel état> : Constante de type entier

Nouvel état actuel de l'objet.
Actif Champ ou bloc visible.
Invisible Champ ou bloc invisible (il est conseillé d'utiliser la propriété Visible).

Remarques

Etat (Editeur d'états) : 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.

Etat d'une colonne d'un champ Table

Si la propriété Etat est appliquée à une colonne d'un champ Table, 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 'en saisie'.

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.

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.

Champs Sélecteur/Interrupteur et leurs options

Il est possible de modifier l'état du champ ou uniquement d'une option du champ 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 :

Une option est grisée.
Le champ Sélecteur/Interrupteur est grisé.
Le champ Sélecteur/Interrupteur redevient actif. L'option est toujours grisée.

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.

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.

La propriété Etat utilisée sur une option de menu contextuel permet de rendre cette option invisible.

Limites

La propriété Etat n'a aucun effet sur les états créés avec l'éditeur d'états.

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.

La propriété Etat est sans effet sur les champs HTML.

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.

Voir Aussi

Version minimum requise

Version 9

Documentation également disponible pour…

Commentaires

Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 16/05/2024

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