PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Cadrer un texte entre deux figures (un cercle et un rectangle)
  • Centré verticalement
  • Contrôle d'affichage
  • Couleur de fond
  • Composante
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget iOSApple WatchCatalystUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Construit une séquence de caractères contenant un texte cadré ou une image cadrée.
WINDEVUniversal Windows 10 AppWindows Mobile 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.
Versions 21 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Versions 22 et supérieures
Procédures stockées Cette fonction est désormais disponible dans le code des procédures stockées.
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
WEBDEV - Code ServeurLinux Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.
WEBDEV - Code ServeurWindows Cette fonction est désormais disponible pour les sites WEBDEV sous Windows.
Nouveauté 22
Procédures stockées Cette fonction est désormais disponible dans le code des procédures stockées.
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
WEBDEV - Code ServeurLinux Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.
WEBDEV - Code ServeurWindows Cette fonction est désormais disponible pour les sites WEBDEV sous Windows.
Procédures stockées Cette fonction est désormais disponible dans le code des procédures stockées.
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
WEBDEV - Code ServeurLinux Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.
WEBDEV - Code ServeurWindows Cette fonction est désormais disponible pour les sites WEBDEV sous Windows.
Exemple
WINDEVWindows Mobile
// Cadrage à droite des 20 premiers éléments dans la liste "LISTE_ListeClient"
POUR Indice = 1 A 20
        ListeAjoute(LISTE_ListeClient, gCadrage("D", Nom[Indice]))
FIN
WINDEVUniversal Windows 10 AppWindows Mobile
// 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 AppWindows Mobile 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.
"D"Cadrage à droite.
"C"Cadrage centré.
"G"Cadrage à gauche.
Versions 21 et supérieures
"X"
Nouveauté 21
"X"
"X"
Même cadrage horizontal que l'élément précédent.
"H"Alignement vertical en haut.
"V"Alignement vertical au milieu.
"B"Alignement vertical en bas.
Versions 21 et supérieures
"Y"
Nouveauté 21
"Y"
"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 :
WINDEVWindows Mobile 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)).
WINDEVWindows Mobile 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

Jusqu'à la version 21, la fonction gCadrage était disponible dans la composante wdxxxobj. A partir de la version 22, cette fonction est désormais disponible dans la composante wdxxxmdl.
Composante : wd250mdl.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire