iImprimeImage (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Fonctions d'impression

Impression dans un fichier HTML

iChangeSousEtatSource

iEnchaînementAjouteDoc

iEnchaînementAjoutePDF

iEnchaînementAjouteXLS

iImpressionAbandonnée

iImprimeComplémentCorps

iInitRequêteEtatConnexion

iStatusImpressionEtat

Divers
Impression dans un fichier HTML
Impression en PDF

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

iImprimeImage (Fonction)

En anglais : iPrintImage

Envoie au buffer d'impression l'image à imprimer. L'impression n'est pas lancée (seule la fonction iFinImprime permet de lancer l'impression). Le mode d'impression de l'image dépend des paramètres passés à la fonction iImprimeImage.

Pour imprimer une image de fond dans un état, utilisez la fonction iImprimeImage dans l'événement "Avant impression" du bloc haut de page.
Remarque : Avant d'appeler la fonction iImprimeImage, il est conseillé de vérifier l'existence du fichier image (avec la fonction fRep).

Versions 20 et supérieures
Remarque : Cette fonction ne doit pas être utilisée pour imprimer l'image de fond d'un état. Pour définir l'image de fond d'un état, utilisez la propriété ..ImageFond. La propriété ..ImageFondImprimée permet de spécifier si l'image doit être imprimée avec l'état.

Nouveauté 20
Remarque : Cette fonction ne doit pas être utilisée pour imprimer l'image de fond d'un état. Pour définir l'image de fond d'un état, utilisez la propriété ..ImageFond. La propriété ..ImageFondImprimée permet de spécifier si l'image doit être imprimée avec l'état.

Remarque : Cette fonction ne doit pas être utilisée pour imprimer l'image de fond d'un état. Pour définir l'image de fond d'un état, utilisez la propriété ..ImageFond. La propriété ..ImageFondImprimée permet de spécifier si l'image doit être imprimée avec l'état.

Seules les images au format JPEG peuvent être imprimées.

Il est déconseillé d'utiliser des images au format GIF (ce format n'est pas complètement géré par le système Android).

Attention : Les images seront imprimées uniquement si l'imprimante utilisée le permet. Pour plus de détails, consultez Caractéristiques d'une impression sous Terminal Mobile (Pocket PC).

Versions 18 et supérieures

Cette fonction est désormais disponible pour les applications iPhone/iPad.

Nouveauté 18

Cette fonction est désormais disponible pour les applications iPhone/iPad.

Versions 19 et supérieures

Cette fonction est désormais disponible en mode Widget Android.

Cette fonction est désormais disponible pour les applications Android.

Nouveauté 19

Cette fonction est désormais disponible en mode Widget Android.

Cette fonction est désormais disponible pour les applications Android.

Cette fonction est désormais disponible en mode Widget Android.

Cette fonction est désormais disponible pour les applications Android.

Versions 21 et supérieures

Cette fonction est désormais disponible en mode Universal Windows 10 App.

Nouveauté 21

Cette fonction est désormais disponible en mode Universal Windows 10 App.

Exemple

Voir des exemples supplémentaires

// Imprime Fleur.JPG ligne 20 mm, colonne 50 mm sans étirement ni réduction
iImprimeImage("Fleur.JPG", 20, 50)
iFinImprime()

Syntaxe

Impression d'une image dans une zone délimitée Masquer les détails

iImprimeImage(<Nom de l'image> , <X1> , <Y1> , <X2> , <Y2> [, <Echelle>])

<Nom de l'image> : Chaîne de caractères ou variable de type Image

Nom du fichier contenant l'image à imprimer. Ce fichier doit être dans l'un des formats d'images reconnus.
Nom d'une rubrique de type mémo Image.
Versions 17 et supérieures
Nom d'une variable de type Image.
Nouveauté 17
Nom d'une variable de type Image.
Nom d'une variable de type Image.
Ce paramètre doit correspondre à un fichier image au format JPEG.

<X1> : Réel

Coordonnée horizontale (colonne ou abscisse) du coin haut gauche de la position de l'image (en millimètres).
Valeur comprise entre 0 et la largeur de la page (donnée par iLargeurPage).

<Y1> : Réel

Coordonnée verticale (ligne ou ordonnée) du coin haut gauche de la position de l'image (en millimètres).
Valeur comprise entre 0 et la hauteur de la page (donnée par iHauteurPage).

<X2> : Réel

Coordonnée horizontale (colonne ou abscisse) du coin bas droit du cadre dans lequel l'image doit être imprimée (en millimètres).
Valeur comprise entre 0 et la largeur de la page (donnée par iLargeurPage).

<Y2> : Réel

Coordonnée verticale (ligne ou ordonnée) du coin bas droit du cadre dans lequel l'image doit être imprimée (en millimètres).
Valeur comprise entre 0 et la hauteur de la page (donnée par iHauteurPage).

<Echelle> : Entier ou constante de type entier (optionnel)

Paramètre l'échelle du zoom réalisé sur l'image.
iAffichageHomothétique L'image est affichée en <X1> <Y1> sans déformation. Elle occupe soit toute la hauteur définie par <X1> et <X2>, soit toute la largeur définie par <Y1> et <Y2>.
iAffichageHomoCentré L'image est étirée ou réduite pour occuper de manière optimale l'espace défini sans être déformée. Elle est centrée dans la zone définie par <X1>, <Y1>, <X2> et <Y2>.
iAffichageNormal
(Valeur par défaut) L'image est affichée dans la totalité du rectangle défini par <X1>, <Y1>, <X2> et <Y2>. L'image peut être déformée.

Ce paramètre n'est pas supporté.

Impression d'une image à une position définie Masquer les détails

iImprimeImage(<Nom de l'image> , <X1> , <Y1> [, <Echelle>])

<Nom de l'image> : Chaîne de caractères ou variable de type Image

Nom du fichier contenant l'image à imprimer. Ce fichier doit être dans l'un des formats d'images reconnus.
Nom d'une rubrique de type mémo Image.
Versions 17 et supérieures
Nom d'une variable de type Image.
Nouveauté 17
Nom d'une variable de type Image.
Nom d'une variable de type Image.

<X1> : Réel

Coordonnée horizontale (colonne ou abscisse) du coin haut gauche de la position de l'image (en millimètres).
Valeur comprise entre 0 et la largeur de la page (donnée par iLargeurPage).

<Y1> : Réel

Coordonnée verticale (ligne ou ordonnée) du coin haut gauche de la position de l'image (en millimètres).
Valeur comprise entre 0 et la hauteur de la page (donnée par iHauteurPage).

<Echelle> : Entier ou constante de type entier (optionnel)

Échelle du zoom réalisé sur l'image (comprise entre 0 et 999).
Si ce paramètre n'est pas précisé ou égal à 0, l'image est affichée telle quelle en <X1> <Y1> (équivalent à <Échelle> = 100).

Impression d'une partie d'une image Masquer les détails

iImprimeImage(<Nom du fichier> , <X1> , <Y1> , <X2> , <Y2> , <X3> , <Y3> , <X4> , <Y4> [, <Échelle>])

<Nom du fichier> : Chaîne de caractères

Nom du fichier contenant l'image à imprimer. Ce fichier doit être dans l'un des formats d'images reconnus.
Nom d'une rubrique de type mémo Image.
Versions 17 et supérieures
Nom d'une variable de type Image.
Nouveauté 17
Nom d'une variable de type Image.
Nom d'une variable de type Image.

<X1> : Réel

Coordonnée horizontale (colonne ou abscisse) du coin haut gauche de la position de l'image (en millimètres).
Valeur comprise entre 0 et la largeur de la page (donnée par iLargeurPage).

<Y1> : Réel

Coordonnée verticale (ligne ou ordonnée) du coin haut gauche de la position de l'image (en millimètres).
Valeur comprise entre 0 et la hauteur de la page (donnée par iHauteurPage).

<X2> : Réel

Coordonnée horizontale (colonne ou abscisse) du coin bas droit du cadre dans lequel l'image doit être imprimée (en millimètres).
Valeur comprise entre 0 et la largeur de la page (donnée par iLargeurPage).

<Y2> : Réel

Coordonnée verticale (ligne ou ordonnée) du coin bas droit du cadre dans lequel l'image doit être imprimée (en millimètres).
Valeur comprise entre 0 et la hauteur de la page (donnée par iHauteurPage).

<X3> : Réel

Coordonnée horizontale (colonne ou abscisse) du coin haut gauche de la partie de l'image à imprimer (en millimètres).

<Y3> : Réel

Coordonnée verticale (ligne ou ordonnée) du coin haut gauche de la partie de l'image à imprimer (en millimètres).

<X4> : Réel

Coordonnée horizontale (colonne ou abscisse) du coin bas droit de la partie de l'image à imprimer (en millimètres).

<Y4> : Réel

Coordonnée verticale (ligne ou ordonnée) du coin bas droit de la partie de l'image à imprimer (en millimètres).

<Échelle> : Entier ou constante de type entier (optionnel)

Paramètre l'échelle du zoom réalisé sur l'image.
iAffichageHomothétique La partie de l'image est affichée en <X1> <Y1> sans déformation. Elle occupe soit toute la hauteur définie par <X1> et <X2>, soit toute la largeur définie par <Y1> et <Y2>. Si nécessaire, l'image est agrandie proportionnellement.
iAffichageHomoCentré La partie de l'image est étirée ou réduite pour occuper de manière optimale l'espace défini sans être déformée. Elle occupe :
soit toute la hauteur définie par <X1>et <X2> : l'image est centrée horizontalement.
soit toute la largeur définie par <Y1> et <Y2> : l'image est centrée verticalement.
Si nécessaire, l'image est agrandie proportionnellement.
iAffichageNormal
(Valeur par défaut) La partie de l'image (définie par <X3>, <Y3>, <X4> et <Y4>) est affichée dans la totalité du rectangle défini par <X1>, <Y1>, <X2> et <Y2>. L'image peut être déformée.

Remarques

Divers

L'origine (0,0) est située dans le coin supérieur gauche de la feuille. Elle tient compte des marges physiques de l'imprimante.
Si l'image ne rentre pas dans la zone définie et si un centrage a été demandé (<Échelle> = 999), alors l'option de centrage est abandonnée.

Impression dans un fichier HTML

Si la fonction iImprimeImage est utilisée lors d'une impression dans un état (créé avec l'éditeur d'états) au format HTML, l'image imprimée sera déformée.

Impression en PDF

Si seules les coordonnées du point haut gauche de l'image sont indiquées, la largeur de l'image dépend du DPI de l'imprimante.

En impression PDF, le PDF a le même DPI que l'imprimante courante : dans ce cas, la largeur de l'image dans le PDF va correspondre à la largeur de l'image dans l'aperçu.

En impression PDF générique, le PDF a le même DPI que l'écran (pour ne pas dépendre d'une imprimante). L'image risque de ne pas avoir la largeur voulue.

Il est conseillé d'indiquer les coordonnées du point bas droit de l'image, pour avoir toujours le même résultat (en PDF, PDF générique et quelque soit le DPI de l'imprimante).

Composante : wd240prn.dll

Voir Aussi

Version minimum requise

Version 9

Documentation également disponible pour…

Commentaires

Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 18/04/2019

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