DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Editeurs / Editeur d'états / Manipulations sous l'éditeur
  • Présentation
  • Comment le faire ?
  • Ancrer un champ dans un état
  • Mode d'impression d'un état et ancrage
  • Visualisateur de rapports : état avec ancrage
  • Connaître les caractéristiques de l'ancrage par programmation
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
Présentation
Les ancrages permettent de définir le comportement des champs lors d'un redimensionnement.
Dans un état, l'ancrage permet d'adapter intelligemment le document quand l'utilisateur passe du mode Portrait au mode Paysage ou encore quand il change le format du papier (A4, A3, ...).
Par exemple, une impression au format A4 un peu "serrée" (et donc moyennement lisible) sera parfaitement lisible au format A3.
La gestion de l'ancrage d'un champ est constituée de deux paramètres :
  • L'ancrage du champ : ce paramètre permet de définir la modification à appliquer au champ en fonction du changement de la taille de l'état. Le champ peut se déplacer vers la gauche, s'agrandir en largeur.
  • Le taux d'ancrage : ce paramètre permet de gérer le pourcentage de déplacement ou d'étirement du champ. Grâce à ce paramètre, il est possible par exemple de :
    • laisser un champ centré en largeur dans l'état quel que soit sa taille,
    • agrandir proportionnellement certains champs de l'état.
Ces paramètres peuvent être configurés sous l'éditeur d'états.
Remarques :
  • Par programmation, diverses propriétés WLangage sont disponibles pour connaître les caractéristiques d'ancrage définies sous l'éditeur. Ces propriétés ne permettent pas de modifier les ancrages définis sous l'éditeur.
  • L'ancrage est disponible uniquement sur les champs (il n'est pas disponible sur les blocs).
Comment le faire ?

Ancrer un champ dans un état

Pour ancrer un champ dans un état :
  1. Sélectionnez un ou plusieurs champs à ancrer.
  2. Définissez l'ancrage du ou des champs :
    • soit dans l'onglet "UI" de la fenêtre de description du champ (option "Description" du menu contextuel du champ),
    • soit grâce à l'option "Ancrage" du menu contextuel du champ.
      Remarque : Si le mode d'impression de l'état n'est pas adapté aux ancrages, il est possible de changer directement le mode d'impression depuis cette fenêtre.
  3. Dans cette fenêtre, choisissez le type d'ancrage à utiliser. Les options les plus courantes sont présentées sous forme d'icônes :
    Aucun ancrageLe champ n'est pas modifié lorsque la taille de l'état est modifiée. Aucune option d'ancrage n'est sélectionnée.
    LargeurLe champ s'étire vers la droite lorsque l'état s'agrandit. Pour faire varier la vitesse d'étirement du champ par rapport à l'état, utilisez le taux d'ancrage en largeur.
    DroiteLe champ se déplace vers la droite lorsque l'état s'agrandit. Pour que le champ se déplace plus ou moins vite, utilisez le taux d'ancrage à droite.
    Centré en largeurLe champ reste centré en largeur dans l'état quelle que soit la largeur de l'état.
    HauteurLe champ s'étire vers le bas lorsque la hauteur de l'état s'agrandit. Pour faire varier la vitesse d'étirement du champ par rapport à l'état, utilisez le taux d'ancrage en hauteur.
    Largeur et HauteurLe champ s'étire vers la droite et vers le bas lorsque l'état s'agrandit. Pour faire varier la vitesse d'étirement du champ par rapport à l'état, utilisez le taux d'ancrage en hauteur et le taux d'ancrage en largeur.
    Hauteur et DroiteLe champ s'étire vers le bas et se déplace vers la droite lorsque l'état s'agrandit.
    Pour que le champ se déplace plus ou moins vite, utilisez le taux d'ancrage à droite.
    Pour faire varier la vitesse d'étirement du champ par rapport à l'état, utilisez le taux d'ancrage en hauteur.
    BasLe champ se déplace vers le bas lorsque l'état est agrandi vers le bas. Pour que le champ se déplace plus ou moins vite, utilisez le taux d'ancrage en bas.
    Largeur et BasLe champ s'étire vers la droite et se déplace vers le bas lorsque l'état s'agrandit.
    Pour que le champ se déplace plus ou moins vite, utilisez le taux d'ancrage en bas.
    Pour faire varier la vitesse d'étirement du champ par rapport à l'état, utilisez le taux d'ancrage en largeur.
    Droite et BasLe champ se déplace vers la droite et vers le bas lorsque l'état s'agrandit. Pour que le champ se déplace plus ou moins vite, utilisez le taux d'ancrage en bas et le taux d'ancrage à droite.
    Centré horizontal en basLe champ reste centré en largeur dans l'état quelle que soit la largeur de l'état. Cependant, le champ est ancré en bas, et se déplace vers le bas lorsque l'état s'agrandit.
    Pour que le champ se déplace plus ou moins vite, utilisez le taux d'ancrage en bas.
    Centré en hauteurLe champ reste centré en hauteur dans l'état quelle que soit la hauteur de l'état.
    Centré vertical à droiteLe champ reste centré en hauteur dans l'état quelle que soit la hauteur de l'état. Cependant, le champ est ancré à droite, et se déplace vers la droite lorsque l'état est élargi.
    Pour que le champ se déplace plus ou moins vite, utilisez le taux d'ancrage à droite.
    CentréLe champ reste centré en hauteur et en largeur dans l'état quelle que soit la taille de l'état.
  4. Définissez si nécessaire les différents taux d'ancrage.
  5. Validez.
Pour afficher les signes d'ancrage dans le champ (flèches rouges), sous le volet "Affichage", dans le groupe "Visualisation", cochez l'option "Ancrages et Auto-extensibilité".
Remarques :
  • Les champs auto-extensibles sont affichés sous l'éditeur d'états avec un signe spécifique : un trait avec une flèche vers le bas.
  • A l'exécution, un champ auto-extensible s'agrandira automatiquement en hauteur si sa taille est trop petite pour afficher en entier son contenu.

Mode d'impression d'un état et ancrage

Par défaut, les ancrages ne sont pas automatiquement activés dans les états.
Un état peut s'imprimer selon trois modes d'impression :
  • Imprimer l'état tel quel : Dans ce cas, le contenu qui déborde de l'état ne sera pas imprimé.
  • Étirer ou réduire automatiquement au format supporté : L'état s'étire ou se réduit automatiquement pour s'adapter au format du papier.
  • Étirer ou réduire en appliquant les ancrages : L'état s'adapte au format choisi en utilisant les ancrages définis.
Ces modes d'impression peuvent être sélectionnés ou modifiés dans l'onglet "Options" de la fenêtre de description de l'état.
Visualisateur de rapports : état avec ancrage
Lorsque des ancrages sont définis dans un état, le visualisateur de rapports propose automatiquement une liste permettant de choisir le mode d'affichage de l'état.
Choix présent dans le volet "Imprimer" du ruban
Les choix proposés correspondent :
  • au format de papier par défaut de l'état proposé en mode portrait et en mode paysage.
  • aux formats de papier gérés par l'imprimante par défaut du poste.
Rappel : Les fonctions WLangage iGroupeXXX permettent de personnaliser la combo du visualisateur de rapports en proposant plusieurs états. Pour plus de détails, consultez Visualisateur de rapports : Proposer plusieurs états.
Connaître les caractéristiques de l'ancrage par programmation
Par programmation, il est possible de connaître les caractéristiques d'ancrage des champs grâce à diverses propriétés WLangage :
AncrageLa propriété Ancrage permet de gérer l'ancrage d'un champ dans une fenêtre, une page ou un état.
TauxAncrageBasLa propriété TauxAncrageBas permet de :
  • Connaître le taux d'ancrage en déplacement d'un champ sur l'axe vertical.
  • Modifier le taux d'ancrage en déplacement d'un champ sur l'axe vertical.
TauxAncrageDroiteLa propriété TauxAncrageDroite permet de :
  • Connaître le taux d'ancrage en déplacement d'un champ sur l'axe horizontal.
  • Modifier le taux d'ancrage en déplacement d'un champ sur l'axe horizontal.
TauxAncrageHauteurLa propriété TauxAncrageHauteur permet de :
  • Connaître le taux d'ancrage en hauteur d'un champ.
  • Modifier le taux d'ancrage en hauteur d'un champ.
TauxAncrageLargeurLa propriété TauxAncrageLargeur permet de :
  • Connaître le taux d'ancrage en agrandissement d'un champ (ou d'une colonne de table) sur l'axe horizontal.
  • Modifier le taux d'ancrage en agrandissement d'un champ (ou d'une colonne de table) sur l'axe horizontal.
Version minimum requise
  • Version 19
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 17/10/2022

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