Cadre (Type de variable)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Caractéristiques par défaut d'un cadre
Propriétés WLangage utilisables avec le type Cadre
Type du trait du cadre

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

Déclaration et utilisation d'une variable

Cadre (Type de variable)

En anglais : Border

Le type Cadre permet de manipuler un cadre par programmation. Les caractéristiques de ce cadre peuvent être modifiées à l'aide de différentes propriétés du WLangage.

Un type Cadre peut être utilisé :

dans les champs d'une fenêtre (propriété Cadre des champs d'une fenêtre).
dans les cellules d'un champ Table d'une fenêtre (propriété Cadre des cellules des champs Table).
dans les champs d'un état (propriété Cadre des champs d'un état).
dans les fonctions de dessin (fonction dCadre).
dans les cellules Excel (propriété Cadre des cellules d'un document Excel).
dans les paragraphes d'un document de type Traitement de texte (propriété Cadre sur les options de mise en page des variables de type docParagraphe).

Remarque : Pour plus de détails sur la déclaration de ce type de variable et l'utilisation des propriétés WLangage, consultez Déclaration d'une variable.

Exemple

// Définition des caractéristiques du cadre pour les champs de l'état
MonCadre est un Cadre
MonCadre.Couleur = RougeClair
MonCadre.Epaisseur = 5

// Utilisation du cadre pour le champ NumNbPage de l'état
NumNbPage.Cadre = MonCadre
// Modification d'une caractéristique du cadre du champ NumNbPage
NumNbPage.Cadre.Epaisseur = 1

// Récupération des caractéristiques du cadre du champ NumNbPage
MonCadre2 est un Cadre = NumNbPage.Cadre

// Définition des caractéristiques du cadre
MonCadre est un Cadre
MonCadre.Couleur = RougeClair
MonCadre.Epaisseur = 5

// Utilisation du cadre pour le champ NumNbPage de l'état
NumNbPage.Cadre = MonCadre
// Modification d'une caractéristique du cadre du champ NumNbPage
NumNbPage.Cadre.CoinHautGauche.Largeur = 2
NumNbPage.Cadre.CoinHautGauche.Hauteur = 3

// Paramètre le cadre
MonCadre est un Cadre
MonCadre.Couleur = RougeClair
MonCadre.Epaisseur = 5

// Spécificité du trait bas
MonCadre.TraitBas.Type = TraitTiret
MonCadre.TraitBas.Couleur = RougeFoncé

// Applique le cadre à la cellule 2, 2 (2ème ligne, 2ème colonne)
TABLE_MaTable[2,2].Cadre = MonCadre
// ou
TABLE_MaTable.COL_SansNom2[2].Cadre = MonCadre

Remarques

Caractéristiques par défaut d'un cadre

Par défaut, dans un état, un cadre a les caractéristiques suivantes :

épaisseur 0. Le cadre est visible si l'épaisseur est supérieure à 0. Le cadre est invisible si l'épaisseur vaut 0.
couleur noir.
trait continu.
coins non arrondis.
tous les bords du cadre sont affichés.

Par défaut, dans une feuille XLS, le cadre d'une cellule a les mêmes caractéristiques. Cependant, dans le cas d'une cellule XLS, l'épaisseur ainsi que l'arrondi des coins ne sont pas gérés.

Par défaut, dans une cellule d'un champ Table, un cadre a les caractéristiques suivantes :

épaisseur 0. Le cadre est visible si l'épaisseur est supérieure à 0. Le cadre est invisible si l'épaisseur vaut 0.
couleur transparente.
trait continu.
coins non arrondis.
aucun bord du cadre n'est affiché.

Pour définir les caractéristiques d'un cadre par programmation, utilisez les propriétés de gestion des cadres.

Propriétés WLangage utilisables avec le type Cadre

Les propriétés suivantes peuvent être utilisées pour manipuler une variable de type Cadre.

Nom de la propriété	Type manipulé	Effet

Arrondi	Réel	Valeur de l'arrondi des coins du cadre. Correspond au rayon de l'arrondi. En modification, modifie l'arrondi de tous les coins. En lecture, renvoie : la largeur et la hauteur des coins si ces paramètres sont identiques pour tous les coins. la constante ArrondiIndéfini si tous les coins n'ont pas la même largeur et hauteur. Non géré : dans les cellules XLS. dans les paragraphes des document de type Traitement de texte.
Bords	Constante de type entier	Renvoie et modifie la présence des bords du cadre. Cette propriété peut correspondre à une combinaison des options suivantes : BordAucun : le cadre n'a aucun bord. BordBas : le cadre a un bord bas. BordDroite : le cadre a un bord droit. BordGauche : le cadre a un bord gauche. BordHaut : le cadre a un bord haut. BordTous : tous les bords du cadre sont affichés.
CoinBasDroite		Caractéristiques du coin bas droit du cadre : Propriété Largeur : largeur du coin du cadre (réel). Propriété Hauteur : hauteur du coin du cadre (réel). Non géré dans les cellules XLS.
CoinBasGauche		Caractéristiques du coin bas gauche du cadre : Propriété Largeur : largeur du coin du cadre (réel). Propriété Hauteur : hauteur du coin du cadre (réel). Non géré dans les cellules XLS.
CoinHautDroite		Caractéristiques du coin haut droit du cadre : Propriété Largeur : largeur du coin du cadre (réel). Propriété Hauteur : hauteur du coin du cadre (réel). Non géré dans les cellules XLS.
CoinHautGauche		Caractéristiques du coin haut gauche du cadre : Propriété Largeur : largeur du coin du cadre (réel). Propriété Hauteur : hauteur du coin du cadre (réel). Non géré dans les cellules XLS.
Couleur	Entier	Couleur du cadre. Cette couleur peut correspondre à : une couleur RVB (obtenue avec la fonction RVB), une couleur prédéfinie. Cette propriété peut être utilisée : En modification : la couleur de tous les bords est modifiée. En lecture, cette propriété renvoie : la couleur des bords si cette couleur est identique pour tous les bords. la constante CouleurIndéfinie si tous les bords n'ont pas la même couleur.
Epaisseur	Réel	Renvoie et modifie l'épaisseur du cadre (en millimètres dans les impressions et en pixels dans les fonctions graphiques). En modification, modifie l'épaisseur de tous les bords. En lecture, renvoie : l'épaisseur des bords si ce paramètre est identique pour tous les bords. la constante EpaisseurIndéfinie si tous les bords n'ont pas la même épaisseur. Non géré dans les cellules XLS.
Trait	Constante de type Entier	Renvoie et modifie le type du trait du cadre (voir paragraphe suivant). En modification, modifie le type de trait de tous les bords. En lecture, renvoie : le type de trait des bords si ce paramètre est identique pour tous les bords. la constante TypeIndéfini si tous les bords n'ont pas le même trait.
TraitBas		Caractéristiques du trait bas du cadre : Propriété Couleur : Couleur du trait : Cette couleur peut correspondre soit à une couleur RVB (obtenue avec la fonction RVB), soit à une couleur prédéfinie. Propriété Epaisseur (Réel) : Epaisseur du trait (en millimètres dans les impressions et en pixels dans les fonctions graphiques). Propriété Type (constante de type Entier) : Type du trait (voir paragraphe suivant). Non géré dans les cellules XLS.
TraitDroite		Caractéristiques du trait droit du cadre : Propriété Couleur : Couleur du trait : Cette couleur peut correspondre soit à une couleur RVB (obtenue avec la fonction RVB), soit à une couleur prédéfinie. Propriété Epaisseur (Réel) : Epaisseur du trait (en millimètres dans les impressions et en pixels dans les fonctions graphiques). Propriété Type (constante de type Entier) : Type du trait (voir paragraphe suivant). Non géré dans les cellules XLS.
TraitGauche		Caractéristiques du trait gauche du cadre : Propriété Couleur : Couleur du trait : Cette couleur peut correspondre soit à une couleur RVB (obtenue avec la fonction RVB), soit à une couleur prédéfinie. Propriété Epaisseur (Réel) : Epaisseur du trait (en millimètres dans les impressions et en pixels dans les fonctions graphiques). Propriété Type (constante de type Entier) : Type du trait (voir paragraphe suivant). Non géré dans les cellules XLS.
TraitHaut		Caractéristiques du trait haut du cadre : Propriété Couleur : Couleur du trait : Cette couleur peut correspondre soit à une couleur RVB (obtenue avec la fonction RVB), soit à une couleur prédéfinie. Propriété Epaisseur (Réel) : Epaisseur du trait (en millimètres dans les impressions et en pixels dans les fonctions graphiques). Propriété Type (constante de type Entier) : Type du trait (voir paragraphe suivant). Non géré dans les cellules XLS.

Ces propriétés peuvent être utilisées :

soit directement sur la variable Cadre. Exemple :

MonCadre est un Cadre
MonCadre.Couleur = RougeClair
MonCadre.Epaisseur = 5
soit sur la propriété Cadre de l'élément manipulé.

// Modification d'une caractéristique du cadre de l'élément NumNbPage
NumNbPage.Cadre.Epaisseur = 1

Remarque : Il est également possible d'affecter directement les caractéristiques d'un cadre défini par programmation à un élément :

Type du trait du cadre

La propriété Type permet de définir et de connaître le type du trait du cadre. Les constantes disponibles sont les suivantes (attention ces constantes ont des effets différents si le cadre est utilisé dans un état ou pour une cellule d'un document Excel).


Constante	Effet dans Excel	Effet dans un état	Effet dans la fonction dCadre
TraitAucun	Aucun trait.	Aucun trait.	Aucun trait.
TraitContinu		avec l'épaisseur définie en millimètres.
TraitContinuEpais		avec l'épaisseur définie en millimètres.
TraitContinuMoyen		avec l'épaisseur définie en millimètres.
TraitDouble		avec l'épaisseur définie en millimètres.
TraitMixte		avec l'épaisseur définie en millimètres.
TraitMixteMoyen		avec l'épaisseur définie en millimètres.
TraitMixteTiretDouble		avec l'épaisseur définie en millimètres.
TraitMixteTiretDoubleMoyen		avec l'épaisseur définie en millimètres.
TraitPointillé		avec l'épaisseur définie en millimètres
TraitPointilléMoyen		avec l'épaisseur définie en millimètres
TraitTiret		avec l'épaisseur définie en millimètres.
TraitTiretMoyen		avec l'épaisseur définie en millimètres.