DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Editeurs / Editeur d'états / Manipulations sous l'éditeur
  • Présentation
  • Comment le faire ?
  • Créer un état en saisie
  • Champ de saisie dans un formulaire
  • Caractéristiques des champs de saisie
  • Evénements associés à un champ de saisie dans un état
  • Champ Interrupteur modifiable dans un formulaire
  • Caractéristiques du champ Interrupteur
  • Evénements associés à un champ Interrupteur dans un état
  • Champ Combo dans un formulaire
  • Caractéristiques des champs Combo
  • Evénements associés à un champ de saisie dans un état
  • Saisie dans le visualisateur de rapports
  • Saisie dans un fichier PDF
  • Saisie dans un état basé sur un formulaire PDF
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
L'éditeur d'états permet de créer des états sous forme de formulaire, incluant différents champs permettant à l'utilisateur d'effectuer une saisie :
  • Champs de saisie.
  • Champs Interrupteur modifiable.
  • Champs Combo.
Il est également possible d'intégrer un champ Lien dans ces formulaires afin que l'utilisateur puisse par exemple accéder à une page d'un site rapidement.
Ces états formulaire peuvent être générés au format PDF.
Vous pouvez ainsi diffuser des états, si nécessaire au format PDF, qui permettent la saisie directe par l'utilisateur dans les zones spécifiées : formulaire administratif (déclaration de revenus, déclarations diverses, carte grise, ...).
Les données peuvent être juste imprimées ou encore mémorisées dans une base de données (lorsque la saisie est réalisée depuis le visualisateur de rapports). L'état devient alors un formulaire de saisie.
Les champs de saisie, Interrupteur ou Combo peuvent être utilisés sur tous les types d'états. Le plus souvent, ces types de champs sont utilisés sur les états de type Formulaire, utilisant par exemple un PDF en fond d'état.
Comment le faire ?

Créer un état en saisie

Pour créer un état en saisie :
  1. Créez un état selon vos besoins (pour plus de détails, consultez Créer un état).
  2. Dans les zones où une saisie doit être effectuée, créez les différents champs nécessaires :
    • Champs de saisie : sous le volet "Création", dans le groupe "Interactions", cliquez sur "Saisie".
    • Champs Interrupteur : sous le volet "Création", dans le groupe "Interactions", cliquez sur "Interrupteur".
    • Champs Combo : sous le volet "Création", dans le groupe "Interactions", cliquez sur "Combo".
  3. Enregistrez l'état.
  4. Lors d'une impression, l'utilisateur pourra saisir et sélectionner des données directement dans les champs de saisie. La saisie dans les différents champs est disponible :
    • dans le visualisateur de rapports.
    • dans les états imprimés au format PDF.
Remarque : Les champs Lien peuvent être également intégrés dans l'état : sous le volet "Création", dans le groupe "Interactions", cliquez sur "Lien". Ces liens pourront être utilisés :
  • dans le visualisateur de rapports.
  • dans les états imprimés au format PDF.
Champ de saisie dans un formulaire

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 présence ou non du cadre autour de la zone de saisie.
  • 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 de données, à une rubrique d'une requête ni à une variable. Pour afficher des informations provenant d'un fichier de données, d'une requête ou d'une variable, 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 est uniquement possible de le rendre visible ou invisible.
  • Il n'est pas possible d'utiliser un type monétaire (le symbole Euro n'est pas géré).
  • Il n'est pas possible de faire des calculs entre les différents champs de saisie.

Evénements associés à un champ de saisie dans un état

Les événements associés à un champ de saisie dans un état sont les suivants :
EvénementCondition d'exécution
InitialisationExécuté à l'ouverture de l'état.
Avant impressionExécuté avant l'impression du champ.
EntréeExécuté lors de l'entrée du curseur de saisie dans le champ.
SortieExécuté lors du changement de champ (touche TAB, changement de champ par la souris, ...).
ModificationExécuté à chaque modification du contenu du champ (saisie ou effacement d'une lettre par exemple).
Champ Interrupteur modifiable dans un formulaire

Caractéristiques du champ Interrupteur

Lors de la création d'un champ Interrupteur dans un état, il est possible de définir :
  • le type du champ, modifiable ou non. Si le champ est modifiable, le champ Interrupteur sera utilisable par l'utilisateur final,
  • le style : couleur de fond, image de fond, couleur de l'interrupteur.
Remarque : Le champ Interrupteur n'est pas lié à une rubrique d'un fichier de données, à une rubrique d'une requête ni à une variable. Pour afficher des informations provenant d'un fichier de données, d'une requête ou d'une variable, il est nécessaire de réaliser une affectation du champ par programmation.

Evénements associés à un champ Interrupteur dans un état

Les événements associés à un champ Interrupteur dans un état sont les suivants :
EvénementCondition d'exécution
InitialisationExécuté à l'ouverture de l'état.
Avant impressionExécuté avant l'impression du champ.
EntréeExécuté lorsque le champ prend le focus.
SortieExécuté lors du changement de champ (touche TAB, changement de champ par la souris, ...).
A chaque modificationExécuté à chaque modification du contenu du champ (sélection d'une option, dé-sélection d'une option par exemple).
Champ Combo dans un formulaire

Caractéristiques des champs Combo

Lors de la création d'un champ Combo dans un état, il est possible de définir :
  • le type du champ : combo avec ou sans saisie,
  • pour les champs Combo avec saisie :
    • le type de saisie,
    • 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 style de la zone de saisie (police, couleur de fond)
  • le style (couleur de fond, libellé).
Remarques :
  • Style de la zone de saisie : Dans cette version, seule la police "Arial" est utilisable.
  • Le champ Combo n'est pas lié à une rubrique d'un fichier de données, à une rubrique d'une requête ni à une variable. Pour afficher des informations provenant d'un fichier de données, d'une requête ou d'une variable, il est nécessaire de réaliser une affectation du champ par programmation.

Evénements associés à un champ de saisie dans un état

Les événements associés à un champ de saisie dans un état sont les suivants :
EvénementCondition d'exécution
InitialisationExécuté à l'ouverture de l'état.
Avant impressionExécuté avant l'impression du champ.
EntréeExécuté lors de l'entrée du curseur de saisie dans le champ.
SortieExécuté lors du changement de champ (touche TAB, changement de champ par la souris, ...).
ModificationExécuté à chaque modification du contenu du champ (saisie ou effacement d'une lettre par exemple).
Saisie dans le visualisateur de rapports
WINDEVWindows Lorsqu'un état est affiché dans le visualisateur de rapports, les champs de saisie, les champs Interrupteur et les champs Combo sont actifs.
Dans ce cas, l'utilisateur pourra saisir les informations voulues puis imprimer l'état dans un des formats proposés. Un message est affiché dans le visualisateur de rapports pour informer l'utilisateur de la possibilité de saisir des informations.
Par défaut, l'utilisateur peut parcourir les champs de saisie grâce à la touche TAB : il parcourt les champs de saisie disponibles de haut en bas et de gauche à droite.
Remarques :
  • Les événements associés aux champs de saisie, champs Interrupteur et Combo sont exécutés lors de leur manipulation dans le visualisateur de rapports.
  • Il est possible d'afficher par programmation des données provenant de la base de données. Il suffit de lier l'état à un fichier de données ou à une requête, puis d'affecter la rubrique voulue au champ dans l'événement "Avant impression" du champ.
  • Il est possible d'enregistrer par programmation des données modifiées par l'utilisateur dans le visualisateur de rapports. Prenons un exemple simple, la modification d'un enregistrement affiché dans l'état. Dans chaque champ dont la valeur doit être modifiée, il suffit de :
    • affecter la valeur saisie à la rubrique,
    • modifier l'enregistrement.
    Ces actions sont réalisées dans l'événement "Sortie de champ".
    Par exemple pour modifier le nom du client, le code correspondant est le suivant :
    Client.Nom = SAI_Nom
    HModifie(Client)
Saisie dans un fichier PDF
Lorsqu'un état est imprimé dans un fichier PDF, les champs de saisie, champs Interrupteur et Combo sont actifs. Dans ce cas, l'utilisateur pourra saisir le contenu des différents champs et imprimer le fichier PDF avec les données saisies et/ou sélectionnées.
Remarques :
  • Les champs de saisie, les champs Interrupteur et Combo permettent de saisir des informations dans le fichier PDF. Ces informations seront prises en compte lors de l'impression. Si l'utilisateur final possède Adobe Acrobat en version complète, les données saisies pourront être enregistrées au format PDF (Acrobat Reader ne permet pas d'enregistrer les fichiers PDF).
  • Il est possible d'afficher par programmation des données provenant de la base de données. Il suffit de lier l'état à un fichier de données ou à une requête, puis d'affecter la rubrique voulue au champ dans l'événement "Initialisation" ou "Avant impression" du champ.
Saisie dans un état basé sur un formulaire PDF
Les champs de saisie et les champs Interrupteur ou Combo sont particulièrement adaptés aux états "Formulaires". Les états "formulaires" sont basés sur un fichier image ou PDF.
Dans le cas d'un formulaire au format PDF contenant plusieurs pages, il est possible de créer un état affichant les différentes pages du PDF (option "Imprimer toutes les pages du PDF" dans l'onglet "Fond" de la description de l'état).
Ces pages sont visibles et modifiables sous l'éditeur d'états : il est possible de positionner les différents champs sur n'importe quelle page de l'état.
Pour plus de détails, consultez Etats sur formulaire.
Liste des exemples associés :
WD Etats 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, ...)
Version minimum requise
  • Version 12
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 13/04/2023

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