iAperçu (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français (historique)

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

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

iAperçu (Fonction)

En anglais : iPreview

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, ...
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.

Exemple

Voir des exemples supplémentaires

// 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")

// 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()

// 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.
iImprimante Impression directe sur l'imprimante

<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.

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.
Nouveauté 2025
i2PagesAvecCouverture
iapZoom2PagesAvecCouverture
Aperçu affichant 2 pages en même temps, avec la première page en couverture (la première page est une page de droite).
i100
iapZoom100 Aperçu avec un zoom de 100%.
iapZoomLargeurPage Aperç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 le visualisateur de rapports.
Valeur de 10 à 999 Aperç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).

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.

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 :

soit de personnaliser uniquement les boutons affichés dans la fenêtre (fonction iParamètreAperçu).
soit de personnaliser entièrement la fenêtre d'aperçu (utilisation d'un gabarit, ...). Pour plus de détails, consultez Personnaliser la fenêtre d'aperçu avant impression.

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

Fin d'impression

La fonction iFinImprime doit nécessairement être appelée pour terminer l'édition sauf après un appel à la fonction iImprimeEtat.

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.

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.

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 "TrueType"), 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.

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 : wd300prn.dll

Voir Aussi

Version minimum requise

Version 9

Documentation également disponible pour…

Commentaires

Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 29/10/2024

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