DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions d'impression
  • Quand utiliser la fonction iAperçu ?
  • Aperçu avant impression
  • Fin d'impression
  • Polices imprimantes
  • Ré-exécution de l'état
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
Avertissement
A partir de la version 25, la fonction iDestination doit être privilégiée. Cette fonction propose une impression via le visualisateur de rapports (appelé aperçu avant impression dans les versions précédentes), via la mini-fenêtre d'aperçu, ainsi que toutes les destinations d'impression.
Paramètre la fenêtre d'aperçu avant impression. Il est possible d'imprimer :
  • directement sur l'imprimante (syntaxe 1).
  • dans une fenêtre d'aperçu (syntaxe 2). L'utilisateur peut ainsi visualiser le résultat de l'impression à l'écran, page par page. Dans cette fenêtre, il est possible de :
    • faire défiler les pages (page suivante et page précédente si elles existent),
    • lancer l'impression,
    • modifier l'échelle de l'aperçu,
    • afficher la première ou la dernière page,
    • connaître le numéro de la page en cours, ...
  • WINDEV dans une mini-fenêtre d'aperçu (syntaxe 3). Ce mini-aperçu permet dans un seul écran de visualiser la page ou les pages à imprimer, de définir l'imprimante à utiliser, l'utilisation ou non de la couleur, le nombre de copies, ...
Remarque de compatibilité
Dans les versions précédentes, la fonction iAperçu permettait également de choisir la destination de l'impression. Ces syntaxes ont été conservées pour compatibilité mais la fonction iDestination doit être désormais privilégiée pour cet usage.
Remarque : Par défaut, si les ressources du poste en cours deviennent critiques pour afficher la totalités des pages dans l'aperçu, un message d'avertissement est affiché par défaut (à partir de 1000 pages). Il est possible de ne pas afficher le message ou de paramétrer le nombre de pages avant l'affichage de ce message grâce à la fonction iParamètreAperçu.
WEBDEV - Code Serveur Cette fenêtre d'aperçu n'est pas disponible dans cette version.
WINDEVEtats et RequêtesCode Utilisateur (MCU)
// Impression dans un aperçu en configurant le titre de la fenêtre d'aperçu
SI iConfigure() = Vrai ALORS iAperçu(iPage, "Liste des fonctions")
WINDEVEtats et RequêtesCode Utilisateur (MCU)
// Ouverture de l'aperçu : 
// au premier lancement : aperçu en zoom arrière
// aux autres lancements : en conservant les valeurs du dernier aperçu
iAperçu()
WINDEVEtats et RequêtesCode Utilisateur (MCU)
// Ouverture du mini aperçu 
iAperçu(iMiniAperçu)
Syntaxe

Imprimer directement sur l'imprimante Masquer les détails

iAperçu([<Destination> [, <Nom du document>]])
<Destination> : Constante optionnelle de type entier
Destination de l'impression.
iImprimanteImpression directe sur l'imprimante
WEBDEV - Code Serveur Pour effectuer une impression directement sur une imprimante reliée au serveur, une configuration spécifique est nécessaire. Pour plus de détails, consultez Configuration du serveur pour réaliser une impression.
<Nom du document> : Chaîne de caractères optionnelle
Nom à donner à l'impression. Ce nom permettra d'identifier l'impression dans la liste des documents traités par l'imprimante.
WINDEVEtats et RequêtesCode Utilisateur (MCU)

Imprimer dans une fenêtre d'aperçu Masquer les détails

iAperçu([<Zoom> [, <Titre de la fenêtre d'aperçu> [, <Boutons d'impression> [, <Position horizontale> [, <Position verticale> [, <Largeur> [, <Hauteur>]]]]]]])
<Zoom> : Constante optionnelle de type entier
Zoom à l'ouverture de la fenêtre d'aperçu.
i2Pages
iapZoom2Pages
Aperçu affichant 2 pages en même temps.
i100
iapZoom100
Aperçu avec un zoom de 100%.
iapZoomLargeurPageAperçu affichant la largeur entière de la page.
iPage
iapZoomPage
Aperçu en zoom arrière : la page sera totalement affichée dans la fenêtre de zoom.
iZoomDéfaut
iapZoomDéfaut
(valeur par défaut)
Correspond :
  • lors d'une première utilisation, à iapZoomPage.
  • lors des utilisations suivantes, au dernier zoom défini par l'utilisateur dans l'aperçu avant impression.
Valeur de 10 à 999Aperçu avec le zoom indiqué.
Si ce paramètre n'est pas précisé, la valeur prise par défaut correspond :
  • lors de la première utilisation de la fonction, à iapZoomPage.
  • lors des utilisations suivantes, au zoom défini par l'utilisateur dans l'aperçu avant impression.
<Titre de la fenêtre d'aperçu> : Chaîne de caractères optionnelle
Titre affiché dans la barre de titre de la fenêtre. Si ce paramètre n'est pas précisé, le titre par défaut correspondra à "Prévisualisation de l'état " suivi du nom de l'état.
Si l'utilisateur a la possibilité de générer des fichiers (Word, PDF, ...) depuis le visualisateur de rapports, le titre de l'aperçu sera automatiquement proposé comme nom de fichier. Si ce paramètre n'est pas précisé, le nom du fichier correspondra au nom de l'état.
<Boutons d'impression> : Booléen optionnel
  • Vrai (par défaut) pour afficher les boutons permettant à l'utilisateur de lancer l'impression,
  • Faux pour ne pas afficher les boutons.
<Position horizontale> : Entier optionnel
Position horizontale de la fenêtre d'aperçu (en pixels). Par défaut, la position horizontale correspond à 100 pixels.
<Position verticale> : Entier optionnel
Position verticale de la fenêtre d'aperçu (en pixels). Par défaut, la position verticale correspond à 100 pixels.
<Largeur> : Entier optionnel
Dimensions de la fenêtre d'aperçu (en pixels). Par défaut, les dimensions de cette fenêtre sont 640 (largeur) et 480 (hauteur).
<Hauteur> : Entier optionnel
Dimensions de la fenêtre d'aperçu (en pixels). Par défaut, les dimensions de cette fenêtre sont 640 (largeur) et 480 (hauteur).
WINDEVEtats et RequêtesCode Utilisateur (MCU)

Imprimer dans une mini-fenêtre d'aperçu Masquer les détails

iAperçu([<Destination> [, <Titre de la mini-fenêtre d'aperçu>]])
<Destination> : Constante de type entier
Destination de l'impression :
iMiniAperçu
Affiche l'impression dans une mini-fenêtre d'aperçu.
<Titre de la mini-fenêtre d'aperçu> : Chaîne de caractères optionnelle
Titre affiché dans la barre de titre de la mini-fenêtre d'aperçu.
Si ce paramètre n'est pas précisé, le titre par défaut correspondra à "Prévisualisation de l'état " suivi du nom de l'état.
Si l'utilisateur a la possibilité de générer des fichiers (Word, PDF, ...) depuis le mini-aperçu avant impression, le titre de l'aperçu sera automatiquement proposé comme nom de fichier. Si ce paramètre n'est pas précisé, le nom du fichier correspondra au nom de l'état.
Remarques

Quand utiliser la fonction iAperçu ?

La fonction iAperçu doit être la première fonction d'impression appelée. Elle doit donc figurer avant les fonctions iImprime, iCréePolice, etc. Mais la fonction iAperçu doit être appelée après les fonctions iConfigure ou iParamètre.
Remarque : La fonction iDestination doit être appelée avant l'exécution d'un état (avec iImprimeEtat) pour choisir la destination de l'exécution de l'état.
WINDEVEtats et RequêtesCode Utilisateur (MCU)

Aperçu avant impression

1. Personnalisation de la fenêtre d'aperçu
WINDEV offre la possibilité de personnaliser l'interface de la fenêtre d'aperçu avant impression de votre projet. Il est possible :Remarque : Si l'aperçu avant impression donne la possibilité d'envoyer un email, il est possible de paramétrer les caractéristiques de l'email grâce à la fonction iParamètreExport.
2. Valeurs de zoom
  • Il est déconseillé de donner une valeur de zoom inférieure à 33%, sinon les boutons de la fenêtre d'aperçu seront totalement écrasés et illisibles.
  • En mode "zoom arrière", selon la police demandée (par exemple, certaines polices ayant une taille inférieure à 14), la police utilisée par Windows pour afficher le texte n'est pas proportionnelle à la police d'impression. Cela se traduit par un affichage "incorrect"; cependant, l'impression sur papier sera correcte.
3. Abandon de visualisation
Lors de la visualisation d'un état, les fonctions iImprime et iImprimeMot retournent Faux si l'utilisateur a cliqué sur le bouton "Abandon". Pour tester l'abandon de la visualisation, il suffit d'écrire:
SI iImprime(Texte) = Faux ALORS RETOUR
WINDEVCode Utilisateur (MCU)

Fin d'impression

La fonction iFinImprime doit nécessairement être appelée pour terminer l'édition sauf après un appel à la fonction iImprimeEtat.
WINDEV La fonction iFinImprime annule la visualisation à l'écran.
Les prochaines impressions seront effectuées sur l'imprimante, sauf si la fonction iAperçu est à nouveau exécutée.
WINDEV Il ne faut pas appeler la fenêtre de configuration (fonction iConfigure) entre deux sorties d'écrans successives sans avoir préalablement appelé la fonction iFinImprime.
WINDEVWEBDEV - Code Serveur

Polices imprimantes

Les constructeurs d'imprimante installent des polices sur les imprimantes. Ces polices sont appelées police "imprimante". Au contraire des polices logicielles (telles que "True Type"), ces polices sont directement accessible par l'imprimante, elles n'ont pas besoin d'être téléchargées.
Dans les listes des polices, les polices imprimantes sont identifiées par une icône "imprimante" présent devant le nom de la police.
Si vous utilisez des polices d'imprimante, ces polices ne sont interprétées que par l'imprimante.
WINDEV Attention : l'utilisation de polices d'imprimante peut entraîner des effets d'affichage en aperçu avant impression. Lors de l'aperçu avant impression, l'affichage des polices est géré par Windows. Ne sachant pas gérer ces polices spécifiques, Windows utilise la police écran la plus proche pour l'aperçu avant impression.
Exemple : Le code suivant imprime des codes barres sur l'imprimante, mais à l'écran il y a du texte.
iAperçu(iPage)
iCréePolice(1, 20, iNormal, "Interleaved 2of5", Noir, 0)
iCréePolice(2, 20, iNormal, "UPC/EAN", Noir, 0)
iImprime(iPolice(1) + "Test police imprimante")
iImprime(iPolice(2) + "Test police imprimante")
iFinImprime()

Ré-exécution de l'état

L'état affiché dans le visualisateur de rapports est automatiquement ré-exécuté lorsque l'état est imprimé ou exporté depuis le visualisateur de rapports. Les événements WLangage associés à l'état sont ré-exécutés.
Dans ce cas, les données affichées dans l'état peuvent être modifiées (prise en compte de données modifiées par d'autres utilisateurs par exemple).
Il est conseillé d'initialiser les variables utilisées par l'état dans le code d'initialisation de l'état (et non dans le champ Bouton qui lance le visualisateur de rapports).
Remarque : Les fonctions WLangage utilisées dans votre état peuvent renvoyer un résultat différent lors de la ré-exécution de l'état. Par exemple, si des fonctions WLangage de votre état manipulent la fenêtre en cours, lors de la ré-exécution de l'état, la fenêtre en cours correspondra à la fenêtre du visualisateur de rapports.
Classification Métier / UI : Code neutre
Composante : wd290prn.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 21/06/2023

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