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é :

Versions 20 et supérieures
dans les champs d'une fenêtre (propriété Cadre des champs d'une fenêtre).
Nouveauté 20
dans les champs d'une fenêtre (propriété Cadre des champs d'une fenêtre).
dans les champs d'une fenêtre (propriété Cadre des champs d'une fenêtre).
Versions 22 et supérieures
dans les cellules d'un champ Table d'une fenêtre (propriété Cadre des cellules des champs Table).
Nouveauté 22
dans les cellules d'un champ Table d'une fenêtre (propriété Cadre des cellules des champs Table).
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).
Versions 22 et supérieures
dans les paragraphes d'un document de type Traitement de texte (propriété Cadre sur la mise en page des variables de type docParagraphe).
Nouveauté 22
dans les paragraphes d'un document de type Traitement de texte (propriété Cadre sur la mise en page des variables de type docParagraphe).
dans les paragraphes d'un document de type Traitement de texte (propriété Cadre sur la 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
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

Versions 21 et supérieures

// 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

Nouveauté 21

// 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

Versions 22 et supérieures

// 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

Nouveauté 22

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.

Versions 22 et supérieures

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é.

Nouveauté 22

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é.

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. Versions 21 et supérieures 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. Nouveauté 21 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. 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.
Versions 21 et supérieures CoinBasDroite Nouveauté 21 CoinBasDroite 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.
Versions 21 et supérieures CoinBasGauche Nouveauté 21 CoinBasGauche 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.
Versions 21 et supérieures CoinHautDroite Nouveauté 21 CoinHautDroite 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.
Versions 21 et supérieures CoinHautGauche Nouveauté 21 CoinHautGauche 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. Versions 21 et supérieures En modification, modifie la couleur de tous les bords. En lecture, renvoie : la couleur des bords si ce paramètre est identique pour tous les bords. la constante CouleurIndéfinie si tous les bords n'ont pas la même couleur. Nouveauté 21 En modification, modifie la couleur de tous les bords. En lecture, renvoie : la couleur des bords si ce paramètre est identique pour tous les bords. la constante CouleurIndéfinie si tous les bords n'ont pas la même couleur. En modification, modifie la couleur de tous les bords. En lecture, renvoie : la couleur des bords si ce paramètre 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). Versions 21 et supérieures 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. Nouveauté 21 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. 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). Versions 21 et supérieures 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. Nouveauté 21 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. 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.
Versions 21 et supérieures TraitBas Nouveauté 21 TraitBas 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.
Versions 21 et supérieures TraitDroite Nouveauté 21 TraitDroite 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.
Versions 21 et supérieures TraitGauche Nouveauté 21 TraitGauche 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.
Versions 21 et supérieures TraitHaut Nouveauté 21 TraitHaut 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	Versions 21 et supérieures Effet dans la fonction dCadre Nouveauté 21 Effet dans la fonction dCadre 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.