Vide (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

Champ Zone répétée, Liste, Combo et Table
Champ Graphe
Utilisation de la propriété Vide sur un état
Propriété Vide et tableaux, tableaux associatifs
Limites

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

Vide (Propriété)

En anglais : Empty

La propriété Vide permet de savoir si :

un champ Zone répétée, Table, Liste ou Combo est vide. Le champ peut être un champ fichier ou mémoire.
un champ Graphe ne contient aucune série.
un champ d'un état est vide (champ lié à une rubrique).
un tableau (ou un tableau associatif) ne contient aucun élément.
un élément d'un tableau associatif existe ou non.
une file, une liste ou une pile ne contient aucun élément.

Pour un état, la propriété Vide permet de savoir si la valeur de la rubrique liée à un champ, pour l'enregistrement en cours d'impression, est renseignée ou non.

Exemple

// Ce champ devient visible
// si la valeur de la rubrique liée au champ "SAI_Téléphone"
// n'est pas renseignée pour l'enregistrement en cours
SI SAI_Téléphone.Vide = Faux ALORS
SAI_Téléphone.Visible = Faux
FIN

// Si le champ Table "TABLE_TableClient" est vide,
// ajout d'une nouvelle ligne dans ce champ
SI TABLE_TableClient.Vide = Vrai ALORS
TableAjouteLigne(TABLE_TableClient, "Dubois", "Pierre")
FIN

Syntaxe

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

<Résultat> : Booléen

Vrai si l'élément spécifié est vide,
Faux dans le cas contraire.

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

Nom de l'élément à manipuler.

Remarques

Champ Zone répétée, Liste, Combo et Table

La propriété Vide permet de savoir si le champ est vide (la propriété Vide renvoie Vrai) ou non.

Cette propriété s'applique aux champs Table, Table hiérarchique, Liste, Liste image, Combo et Zone répétée (voir paragraphe Limites).

Champ Graphe

La propriété Vide permet de savoir si le champ Graphe ne contient aucune série (la propriété Vide renvoie Vrai).

Utilisation de la propriété Vide sur un état

Pour un état, la propriété Vide permet de savoir si la valeur de la rubrique liée à un champ, pour l'enregistrement en cours d'impression, est renseignée ou non.

Remarque : Si la valeur de la rubrique liée au champ spécifié, pour l'enregistrement en cours d'impression, correspond à une chaîne vide (""), cette valeur n'est pas considérée comme vide.

Propriété Vide et tableaux, tableaux associatifs

La propriété Vide permet de savoir :

Si un tableau ou un tableau associatif est vide (propriété Vide renvoie Vrai).
Exemple :
// Tableau associatif de tailles de fichiers
taTailleFichier est tableau associatif d'entiers
...
SI taTailleFichier.Vide = Faux ALORS
Info("Le tableau contient au moins un élément")
FIN
Si un élément d'un tableau associatif existe ou non. Dans le cas d'un tableau associatif sans doublons, la propriété Vide est à Faux si l'élément existe. Dans le cas d'un tableau associatif avec doublons, la propriété Vide est à Faux si au moins un élément existe.
Exemple :
// Tableau associatif d'entiers
// indexé sur des chaînes et avec doublons
taIDParClient est tableau associatif d'entiers
// Ajout de l'identifiant du client "A"
taIDParClient["A"] = 55
// Ajout de l'identifiant du client "B"
taIDParClient["B"] = 321

SI taIDParClient["A"].Vide = Faux ALORS
Info("Il existe au moins un élément A")
FIN