DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions de manipulation des chaînes graphiques
  • Cadrer un texte entre deux figures (un cercle et un rectangle)
  • Centré verticalement
  • Contrôle d'affichage
  • Couleur de fond
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Construit une séquence de caractères contenant un texte cadré ou une image cadrée.
WINDEVUniversal Windows 10 App Dans une fenêtre, cette séquence de caractères permet de cadrer un texte ou une image :
  • dans un élément d'un champ Liste ou Combo.
  • dans la barre de titre et/ou de message d'une fenêtre.
  • dans un champ Libellé.
Remarque : La fonction gCadrage fonctionne uniquement pour l'affichage d'images (fonction gImage) et pour l'affichage de texte.
Exemple
WINDEV
// Cadrage à droite des 20 premiers éléments dans la liste "LISTE_ListeClient"
POUR Indice = 1 À 20
ListeAjoute(LISTE_ListeClient, gCadrage("D", Nom[Indice]))
FIN
WINDEVUniversal Windows 10 App
// Cadrage horizontal et vertical dans un champ Libellé
LIB_Libellé1 = gCadrage("GV", "BOB")
LIB_Libellé1 = gCadrage("GB", "BOB")
Syntaxe
<Résultat> = gCadrage(<Type de cadrage> , <Chaîne à cadrer> [, <X1> [, <X2>]])
<Résultat> : Chaîne de caractères
Séquence de caractères définissant le cadrage d'un texte ou d'une image.
WINDEVUniversal Windows 10 App Cette séquence de caractères peut être :
WEBDEV - Code Serveur Cette séquence de caractères n'est pas interprétée par les champs en WEBDEV. Cette fonction peut être utilisée pour formater la chaîne renvoyée par un Webservice WEBDEV consommé par une application WINDEV ou WINDEV Mobile.
<Type de cadrage> : Caractère
Type de cadrage des éléments à cadrer. Les alignements verticaux doivent obligatoirement être spécifiés après le cadrage horizontal.
"B"Alignement vertical en bas.
"C"Cadrage centré.
"D"Cadrage à droite.
"G"Cadrage à gauche.
"H"Alignement vertical en haut.
"V"Alignement vertical au milieu.
"X"Même cadrage horizontal que l'élément précédent.
"Y"Même alignement vertical que l'élément précédent.
<Chaîne à cadrer> : Chaîne de caractères
Élément(s) à cadrer. Ce paramètre peut contenir des fonctions de mise en forme graphique (fonctions commençant par la lettre "g") permettant de :
  • ajouter des dessins au texte,
  • modifier la mise en forme du texte (couleur de fond, couleur de texte, etc.).
<X1> : Réel optionnel
Position horizontale du bord gauche du rectangle de référence de la zone de cadrage. Si ce paramètre n'est pas spécifié, la position verticale sera égale à 0 (voir Notes).
<X2> : Réel optionnel
Position horizontale du bord droit du rectangle de référence de la zone de cadrage. Si ce paramètre n'est pas spécifié, la position verticale sera égale au bord droit de l'élément dans lequel la chaîne sera affichée (voir Notes).
Remarques

Cadrer un texte entre deux figures (un cercle et un rectangle)

Pour réaliser cette opération, il suffit d'indiquer les paramètres <x1> et <x2>. Par exemple :
WINDEV Exemple pour un champ Liste :
ListeInsère(LISTE_Ville, gCercle(0, 0, 15, 15, BleuClair) + ...
gCoord(15, 0) + gCadrage("C", "Avignon", 15, 80) + ...
gRectangle(80, 0, 115, 15, RougeClair))
 
ListeInsère(LISTE_Ville, gCercle(0, 0, 15, 15, BleuClair) + ...
gCoord(15, 0) + gCadrage("C", "Lyon", 15, 80) + ...
gRectangle(80, 0, 115, 15, RougeClair))
 
ListeInsère(LISTE_Ville, gCercle(0, 0, 15, 15, BleuClair) + ...
gCoord(15, 0) + gCadrage("C", "Montpellier", 15, 80) + ...
gRectangle(80, 0, 115, 15, RougeClair))

Centré verticalement

Les éléments affichés dans le rectangle de référence de la zone de cadrage est centré verticalement par rapport à la hauteur de l'élément affichant la séquence de caractères (par exemple, par rapport à la hauteur de la ligne du champ Liste (ou Combo)).
WINDEV Rappel : Pour un champ Liste (ou Combo), la hauteur de la ligne du champ est définie dans la fenêtre "Détail" du champ.

Contrôle d'affichage

La fonction gCadrage contrôle l'affichage dans la zone décrite. Tout affichage d'images ou de texte qui sort de la zone de cadrage sera tronqué.

Couleur de fond

Le rectangle de référence dans lequel s'effectue le cadrage est rempli avec la couleur de fond courante.
Composante : wd290mdl.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

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