- Les différents types de champs
- Description rapide des différents types de champs
- Champ Libellé
- Champ Calculé
- Champ Image
- Champ Code-barres
- Champ Pré-défini
- Champ Graphe
- Champ Forme
- Champ Interrupteur
- Champ Etat Interne
- Champ Lien URL
- Champ de saisie
Les différents types de champs Plusieurs types de champs peuvent être manipulés dans un état réalisé avec l'éditeur d'états : Remarques : - Pour plus de détails sur un type de champ particulier (caractéristiques spécifiques, propriétés et fonctions associées, etc.), consultez directement l'aide de ce type de champ en cliquant sur son nom.
- Pour permettre des interactions avec les utilisateurs, l'éditeur d'états propose également plusieurs champs spécifiques : Pour plus de détails, consultez Etats avec saisie.
Description rapide des différents types de champs Champ Libellé Le champ "Libellé" permet d'afficher différents types de données : - texte, RTF, HTML, Markdown,
- numérique, monétaire, monétaire + Euro,
- date,
- heure, durée.
Pour spécifier le type des données affichées dans le champ : - Affichez l'onglet "Général" de la fenêtre de description du champ Libellé (option "Description" du menu contextuel du champ).
- Sélectionnez le type d'information affiché (combo "Type").
- Validez.
Les données affichées peuvent contenir : - soit le contenu d'une rubrique (ou d'une variable) de la source de données de l'état.
Remarque : La rubrique ou la variable liée au champ est définie dans l'onglet "Liaison" de la fenêtre de description du champ. - soit le contenu d'un autre champ de l'état.
- soit une valeur déterminée par programmation.
Pour insérer la valeur d'une rubrique ou d'un champ de l'état dans le texte du champ Libellé, saisissez le nom de la rubrique ou du champ entre les caractères [% et %]. Par exemple, le libellé du champ peut correspondre à : Le fournisseur [%NomFournisseur%] vend le produit [%NomProduit%] pour [%PrixTTC%]. Les rubriques NomFournisseur, NomProduit et PrixTTC seront remplacées par leur valeur à l'exécution de l'état. Remarque : Si le champ Libellé doit afficher un texte sur plusieurs lignes, il suffit de choisir le type "Texte multiligne". Dans ce cas, la taille du champ doit être suffisante. Rappel : L'option "Auto-extensible" (onglet "UI" de la fenêtre de description du champ) permet d'augmenter automatiquement la taille du champ en fonction de son contenu lors de l'impression. Modifier le libellé d'un champ Libellé Le libellé d'un champ "Libellé" peut être modifié : - soit par programmation (propriété Libellé).
- soit sous l'éditeur d'états. Dans ce cas, deux méthodes sont possibles :
- Méthode 1 :
- Sélectionnez le champ. Les poignées de sélection apparaissent autour du champ.
- Cliquez une nouvelle fois sur le champ. Le curseur de la souris se transforme en curseur de saisie.
- Saisissez le nouveau libellé du champ.
- Modifiez si nécessaire la mise en forme du libellé :
- dans le cas d'un libellé de type texte : grâce aux options de mise en forme présentes sous le volet "Modification", dans le groupe "Édition rapide" du ruban :
- dans le cas d'un libellé de type RTF : grâce à la barre de mise en forme qui s'affiche au-dessus du champ :
- Méthode 2 :
- Sélectionnez le champ.
- Affichez la fenêtre de description du champ (option "Description" du menu contextuel du champ).
- Saisissez le nouveau libellé dans chaque langue gérée par le champ.
- Modifiez si nécessaire la mise en forme du libellé dans l'onglet "Style".
Champ Libellé multilingue Si votre application ou votre site est multilingue, il est possible de saisir un libellé différent pour chaque langue gérée par l'état. Selon la langue d'exécution du projet, le libellé correspondant sera imprimé. Champ Libellé de type "Monétaire + Euro" Si le champ Libellé est de type "Monétaire + Euro", il est possible de gérer : - la devise mémorisée : devise des données présentes dans la source de données de l'état. Si le champ est manipulé par programmation, la devise de la valeur sera la devise mémorisée.
- la devise affichée : devise utilisée pour afficher la valeur lors de l'impression de l'état. Cette devise peut être différente de la devise mémorisée. La conversion est automatiquement réalisée.
- le double-affichage : il est possible de relier deux champs de type "Monétaire + Euro" entre eux. Dans ce cas, l'éditeur d'états distingue deux types de champs :
- le champ de base : ce champ contient la valeur présente dans la source de données de l'état.
- le champ suiveur : ce champ permet d'afficher la valeur du champ de base dans la devise voulue.
Pour plus de détails, consultez le type Monétaire + Euro. Champ Calculé Le champ "Calculé" permet de réaliser des calculs dans un état. Ces calculs peuvent être réalisés : - sur une rubrique de la source de données.
- sur un champ présent dans l'état.
- par programmation.
Exemples :
Champ "Calculé" spécifique : "Monétaire + Euro"Si le champ "Calculé" est de type "Monétaire + Euro", il est possible de gérer : - la devise mémorisée : devise des données présentes dans la source de données de l'état. Si le champ est manipulé par programmation, la devise de la valeur sera la devise mémorisée.
- la devise affichée : devise utilisée pour afficher la valeur lors de l'impression de l'état. Cette devise peut être différente de la devise mémorisée. La conversion est automatiquement réalisée.
- le double-affichage : il est possible de relier deux champs de type "Monétaire + Euro" entre eux. Dans ce cas, l'éditeur d'états distingue deux types de champs :
- le champ de base : ce champ contient la valeur présente dans la source de données de l'état.
- le champ suiveur : ce champ permet d'afficher la valeur du champ de base dans la devise voulue.
Champ Image Le champ "Image" permet d'afficher une image dans l'état. L'image affichée dans le champ peut : - être sélectionnée directement depuis la fenêtre de description du champ (onglet "Général") en cliquant sur le bouton
: - L'option "Parcourir" permet de sélectionner un fichier image disponible depuis votre poste.
- L'option "Catalogue" permet de choisir une image présente dans le catalogue d'images de WINDEV.
- correspondre au contenu d'une rubrique de la source de données (par exemple, si la source de données est un fichier HFSQL, la rubrique peut être de type mémo Image ou de type chaîne de caractères contenant le chemin complet de l'image). Le champ "Image" est alors lié à cette rubrique.
Remarque : La rubrique (ou la variable) liée au champ est définie dans l'onglet "Liaison" de la fenêtre de description du champ.
Images multilinguesSi votre application ou votre site est multilingue, il est possible de sélectionner une image différente pour chaque langue gérée par l'état. Cette option est intéressante par exemple lorsque les images contiennent du texte. Selon la langue d'exécution du projet, l'image correspondante sera imprimée.
Pour sélectionner une image par langue, cliquez sur le bouton et sélectionnez l'option "Multilingue". Champ Pré-défini Le champ "Pré-défini" permet d'afficher des informations courantes sans avoir à les programmer. Il est ainsi possible d'insérer dans un état un champ "Pré-défini" pour afficher les informations suivantes : - Date système,
- Heure système,
- Numéro de la page en cours,
- Nombre de pages total de l'état,
- Numéro de la page en cours par rapport au nombre de pages total de l'état.
Exemple :
Pour modifier le type d'information affiché dans un champ "Pré-défini" :- Affichez l'onglet "Général" de la fenêtre de description du champ "Pré-défini" (option "Description" du menu contextuel du champ).
- Sélectionnez le type d'information affiché (combo "Type").
- Validez.
Champ Graphe Le champ "Graphe" permet de visualiser et d'imprimer un graphe dans vos états. Les types de graphes disponibles sont les suivants : - Secteur (Camembert), beignet, hémicycle.
- Histogramme (groupé ou empilé, vertical ou horizontal).
- Courbe, aire.
- Nuage de points, radar.
- Graphe à bulles.
- Graphe boursier (Chandelier, MinMax ou BarCharts).
Remarques : Ce champ n'est pas disponible. Pour afficher un graphe dans un état, il est possible de : - Créer un graphe dans une fenêtre via un champ Graphe.
- Sauver une image du graphe avec la fonction grSauveImage.
- Afficher cette image dans un champ Image de l'état.
![iPhone/iPad iPhone/iPad](https://doc.pcsoft.fr/ext/images/fr/IPHONE.png?1493160723) ![Widget IOS Widget IOS](https://doc.pcsoft.fr/ext/images/fr/WIDGETIOS.png?1313293721) Seuls les champs Graphe créés à partir de la version 17 (ou mis à jour) sont disponibles. - Les différentes séries du champ Graphe peuvent être liées à une variable de type Tableau.
Informations spécifiques à la création du graphe Lors de la création d'un graphe, un assistant est automatiquement exécuté. Cet assistant permet de saisir les informations nécessaires à la création du champ Graphe. Ces informations sont les suivantes : - le type du graphe (boursier, camembert, histogramme, ...).
- les paramètres du graphe : titre, légende, graphe en relief, affichage des étiquettes, ...
- les paramètres des axes : titres, quadrillage, ...
- les caractéristiques des séries :
- la source et les données affichées par les étiquettes de catégorie (programmation, fichier de données, requête, tableau WLanÂgage, source de données de l'état).
- le libellé de la série (utilisé pour les étiquettes de séries) :
- la source de la série (programmation, fichier de données, requête, tableau WLangage, source de donÂnées de l'état)
- les données affichées par la série.
- l'épaisseur du trait, la couleur et le type de points.
Remarque : si la source de données correspond à la source de données de l'état, il est possible de définir : - le bloc d'alimentation,
- le champ ou la rubrique correspondant à la série,
- le mode de sélection des données.
Champ Forme Un champ "Forme" permet d'insérer des formes géométriques dans un état. Il est ainsi possible d'insérer par exemple : - des lignes horizontales ou verticales,
- des cercles,
- des rectangles (Ã bords droits ou arrondis).
Le style, l'épaisseur et la couleur du trait sont entièrement paramétrables. Champ Interrupteur Un champ "Interrupteur" correspond à une case à cocher. Si la valeur du champ est à Vrai, la case est cochée : ![Case cochée Case cochée](https://doc.pcsoft.fr/fr-FR/images/image.awp?langid=5&name=Interrupteur_CaseCochee.gif&-1655741150) Si la valeur du champ est à Faux, la case est décochée : ![Case décochée Case décochée](https://doc.pcsoft.fr/fr-FR/images/image.awp?langid=5&name=Interrupteur_CaseDecochee.gif&864979503) Un champ "Interrupteur" peut être lié à une rubrique ou une variable de la source de données de l'état. Par exemple, si la source de données correspond à un fichier HFSQL, la rubrique peut être de type booléen ou de type interrupteur. La taille, la couleur de fond et la couleur de la case à cocher sont entièrement paramétrables. Exemple :
Remarque : La rubrique ou la variable liée au champ est définie dans l'onglet "Liaison" de la fenêtre de description du champ. Champ Etat Interne Grâce aux champs de type "Etat interne", il est possible d'imprimer plusieurs états (états secondaires) dans un seul état (état principal) sans programmation. Par exemple, l'état principal suivant est composé de deux états secondaires imprimés côte à côte : - un état affichant les données sous forme de tableau.
- un état affichant les données sous forme de graphe.
Pour plus de détails sur les états internes, consultez Etat interne. Avantages des états internes par rapport aux états imbriqués L'éditeur d'états permet également d'imprimer simultanément plusieurs états grâce aux états imbriqués. Cependant, les états imbriqués sont moins simples d'utilisation. En effet, les états imbriqués nécessitent : - l'utilisation de la fonction iImprimeEtat pour lancer l'impression de l'état secondaire.
- l'obligation d'imprimer l'état imbriqué à la suite de l'état principal. Il n'est pas possible d'imprimer ces états côte à côte.
Les états internes permettent d'imprimer sans programmation plusieurs états : - soit les uns en dessous des autres,
- soit les uns à côté des autres.
Champ Lien URL Un champ "Lien URL" permet d'insérer des liens dans un état. Il est ainsi possible d'insérer par exemple : - un lien vers une adresse email,
- un lien vers une adresse de site Internet,
- ...
Le champ "Lien URL" est actif uniquement si l'état est imprimé dans un fichier HTML. Dans les autres cas, le champ "Lien URL" est visible mais inactif. Dans le cas d'une impression au format PDF, seuls les liens correspondant à une adresse d'un site ou d'une page sont actifs. Remarque : La rubrique ou la variable liée au champ est définie dans l'onglet "Liaison" de la fenêtre de description du champ. Champ de saisie Un champ de saisie permet de saisir et d'afficher du texte dans un état. Il est ainsi possible d'utiliser un champ de saisie : - pour permettre à l'utilisateur de saisir des informations à imprimer,
- pour permettre à l'utilisateur de modifier les informations à imprimer,
- ...
Le champ de saisie est actif uniquement si l'état est affiché en mode "Aperçu avant impression" ou s'il est imprimé dans un fichier PDF. Dans les autres cas, le champ de saisie est visible mais inactif. Caractéristiques des champs de saisie Lors de la création d'un champ de saisie dans un état, il est possible de définir : - le type du champ (texte, numérique, date, heure),
- le masque associé : les masques proposés sont les masques gérés par le format PDF. Ils sont disponibles pour les numériques, les dates et les heures.
- la taille de saisie, c'est-à -dire le nombre maximum de caractères autorisé dans le champ. Si ce paramètre correspond à 0, il n'y a aucune limite.
- le cadrage horizontal,
- la valeur initiale,
- le style du libellé et de la zone de saisie.
Remarques : - Champ de saisie multiligne : si l'utilisateur saisit plus de lignes que ce qui est visible, les lignes non visibles ne seront pas imprimées. Lors de la saisie, les champs de saisie gèrent un ascenseur vertical.
- Style de la zone de saisie : Dans cette version, seule la police "Arial" est utilisable.
- Le champ de saisie n'est pas lié à une rubrique d'un fichier ou d'une requête. Pour afficher des informations provenant d'un fichier ou d'une requête, il est nécessaire de réaliser une affectation du champ par programmation.
- Le cadre de la zone de saisie n'est pas paramétrable (épaisseur, couleur, ...).
- Il n'est pas possible d'utiliser un type monétaire (le symbole Euro n'est pas géré).
![iPhone/iPad iPhone/iPad](https://doc.pcsoft.fr/ext/images/fr/IPHONE.png?1493160723) ![Widget IOS Widget IOS](https://doc.pcsoft.fr/ext/images/fr/WIDGETIOS.png?1313293721) Ce type de champ n'est pas disponible (Acrobat sur iOS ne gère pas la saisie).
Pour plus de détails, consultez Etats avec saisie.
Liste des exemples associés :
|
Exemples didactiques (WINDEV) : WD Etats
[ + ] Cet exemple montre les différentes méthodes pour réaliser un état : - impressions basées sur différentes sources de données (requêtes, variables, ...) - impressions basées sur des champs (Table, Tableur, TCD, ...) - impression d'états composés - impressions spécifiques (portrait / paysage, état avec filigrane, état avec code-barres, ...)
|
Documentation également disponible pour…
|
|
|