iImprimePDF (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions d'impression

Aperçu de l'impression PDF

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

iImprimePDF (Fonction)

En anglais : iPrintPDF

Imprime le contenu :

d'un fichier PDF.
d'un buffer contenant un PDF.
d'un champ Lecteur PDF.

Quelle est la destination de l'impression ?

Lorsque cette fonction est utilisée, une fenêtre système s'affiche permettant à l'utilisateur de sélectionner l'imprimante à utiliser, le nombre de copies, etc.
Lorsque cette fonction est utilisée, une fenêtre système s'affiche à l'utilisateur permettant de sélectionner l'imprimante à utiliser, etc.
Attention : Cette fonction doit être utilisée dans le thread principal de l'application.
L'impression est réalisée sur l'imprimante par défaut. Il est possible de choisir l'imprimante à utiliser grâce à la fonction iConfigure.
La fonction iDestination permet de réaliser un aperçu avant impression du fichier PDF (voir Remarques).

Exemple

SI iImprimePDF("MonFichier.PDF") ALORS
Info("Impression réussie")
FIN

// Impression du bon de commande
NomFichier = fRepDonnées() + [fSep()] + ChaîneConstruit("BDC_%1.PDF", NuméroCommande)
iDestination(iPDFGénérique, NomFichier)
iImprimeEtat(ETAT_BonDeCommande, NuméroCommande, NuméroCommande)
// Test de l'existence du fichier
SI fFichierExiste(NomFichier) = Faux ALORS
	Erreur("Le fichier PDF n'a pas été généré")
	RETOUR
FIN
// Confirmation pour afficher le PDF
SI OuiNon(Oui, "Afficher le bon de commande généré (format PDF) ?") = Oui ALORS
	// Affichage du bon de commande généré
	LanceAppliAssociée(NomFichier)
SINON
	iImprimePDF(NomFichier)
FIN

// Impression d'un buffer
MonBufferPDF est un Buffer
MonBufferPDF = fChargeBuffer("C:\temp\Monfichier.pdf")
SI iImprimePDF(MonBufferPDF) ALORS
Info("Impression réussie")
FIN

Syntaxe

Imprimer un fichier PDF Masquer les détails

<Résultat> = iImprimePDF(<Nom du fichier PDF> [, <Mot de passe> [, <Dimensionnement> [, <Liste des pages>]]])

<Résultat> : Booléen

Vrai si l'impression a été effectuée,
Faux dans le cas contraire. Pour connaître le libellé de l'erreur, utilisez la fonction ErreurInfo avec la constante errMessage.
Attention : L'impression est asynchrone : lors de l'appel de la fonction, la fenêtre de paramétrage de l'impression s'affiche. Il n'est pas possible de savoir si l'impression a été annulée ou si une erreur s'est produite pendant l'impression.

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

Nom et chemin du fichier PDF à imprimer. Ce paramètre peut correspondre à un chemin complet ou relatif par rapport au répertoire en cours (connu avec la fonction fRepEnCours). Ce paramètre est sensible à la casse.
Rappel : Sous les iPhone/iPad, une application a uniquement le droit d'écrire dans son répertoire d'installation ou dans un de ses sous-répertoires.

<Mot de passe> : Chaîne de caractères

Mot de passe d'ouverture du fichier PDF,
Chaîne vide ("") si le fichier n'a pas de mot de passe.
Ce paramètre n'est pas disponible.

<Dimensionnement> : Constante de type Entier

Taille d'impression :
iHomothétique Agrandissement ou réduction homothétique des pages du fichier PDF afin qu'elles s'adaptent au format de sortie en ignorant les marges physiques.
Cette constante correspond à l'option "Ajuster à la taille du papier" proposée par les logiciels d'impression de fichiers PDF.
iHomothétiqueSansAgrandissement Réduction homothétique des pages du fichier PDF afin qu'elles s'adaptent au format de sortie en ignorant les marges physiques. Les pages utilisant un format inférieur conservent leur format et sont centrées.
Cette constante correspond à l'option "Réduire à la taille du papier" proposée par les logiciels d'impression de fichiers PDF.
iHomothétiqueSansAgrandissementZoneImprimable Réduction homothétique des pages du fichier PDF afin qu'elles s'adaptent au format de sortie en prenant en compte les marges physiques. Les pages utilisant un format inférieur conservent leur format et sont centrées.
Cette constante correspond à l'option "Réduire aux marges de l'imprimante" proposée par les logiciels d'impression de fichiers PDF.
iTailleRéelle Impression à la taille réelle. Les pages utilisant un format :
plus petit que le format de sortie sont centrées dans la page.
plus grand que le format de sortie sont tronquées et sont centrées dans la page.

Ce paramètre n'est pas disponible.

<Liste des pages> : Chaîne de caractères

Liste des pages à imprimer. Il est possible d'indiquer des plages de pages à imprimer séparées par une virgule, chaque plage étant de la forme 'X-Y' où X et Y sont des numéros de pages.
Ce paramètre n'est pas disponible.

Imprimer un buffer correspondant à un fichier PDF Masquer les détails

<Résultat> = iImprimePDF(<Nom du buffer> [, <Mot de passe> [, <Dimensionnement> [, <Liste des pages>]]])

<Résultat> : Booléen

Vrai si l'impression a été effectuée,
Faux dans le cas contraire.
Attention : L'impression est asynchrone : lors de l'appel de la fonction, la fenêtre de paramétrage de l'impression s'affiche. Il n'est pas possible de savoir si l'impression a été annulée ou si une erreur s'est produite pendant l'impression.

<Nom du buffer> : Buffer

Nom de la variable Buffer correspondant au fichier PDF à imprimer.

<Mot de passe> : Chaîne de caractères

Mot de passe d'ouverture du fichier PDF,
Chaîne vide ("") si le fichier n'a pas de mot de passe.

<Dimensionnement> : Constante de type Entier

Taille d'impression :
iHomothétique Agrandissement ou réduction homothétique des pages du fichier PDF afin qu'elles s'adaptent au format de sortie en ignorant les marges physiques.
Cette constante correspond à l'option "Ajuster à la taille du papier" proposée par les logiciels d'impression de fichiers PDF.
iHomothétiqueSansAgrandissement Réduction homothétique des pages du fichier PDF afin qu'elles s'adaptent au format de sortie en ignorant les marges physiques. Les pages utilisant un format inférieur conservent leur format et sont centrées.
Cette constante correspond à l'option "Réduire à la taille du papier" proposée par les logiciels d'impression de fichiers PDF.
iHomothétiqueSansAgrandissementZoneImprimable Réduction homothétique des pages du fichier PDF afin qu'elles s'adaptent au format de sortie en prenant en compte les marges physiques. Les pages utilisant un format inférieur conservent leur format et sont centrées.
Cette constante correspond à l'option "Réduire aux marges de l'imprimante" proposée par les logiciels d'impression de fichiers PDF.
iTailleRéelle Impression à la taille réelle. Les pages utilisant un format :
plus petit que le format de sortie sont centrées dans la page.
plus grand que le format de sortie sont tronquées et sont centrées dans la page.

Ce paramètre n'est pas disponible.

<Liste des pages> : Chaîne de caractères

Liste des pages à imprimer. Il est possible d'indiquer des plages de pages à imprimer séparées par une virgule, chaque plage étant de la forme 'X-Y' où X et Y sont des numéros de pages.

Imprimer le contenu d'un champ Lecteur PDF Masquer les détails

<Résultat> = iImprimePDF(<Champ Lecteur PDF> [, <Dimensionnement> [, <Liste des pages>]])

<Résultat> : Booléen

Vrai si l'impression a été effectuée,
Faux dans le cas contraire.
Attention : L'impression est asynchrone : lors de l'appel de la fonction, la fenêtre de paramétrage de l'impression s'affiche. Il n'est pas possible de savoir si l'impression a été annulée ou si une erreur s'est produite pendant l'impression.

<Champ Lecteur PDF> : Chaîne de caractères

Nom du champ Lecteur PDF affichant le fichier PDF à imprimer.

<Dimensionnement> : Constante de type Entier

Taille d'impression :
iHomothétique Agrandissement ou réduction homothétique des pages du fichier PDF afin qu'elles s'adaptent au format de sortie en ignorant les marges physiques.
Cette constante correspond à l'option "Ajuster à la taille du papier" proposée par les logiciels d'impression de fichiers PDF.
iHomothétiqueSansAgrandissement Réduction homothétique des pages du fichier PDF afin qu'elles s'adaptent au format de sortie en ignorant les marges physiques. Les pages utilisant un format inférieur conservent leur format et sont centrées.
Cette constante correspond à l'option "Réduire à la taille du papier" proposée par les logiciels d'impression de fichiers PDF.
iHomothétiqueSansAgrandissementZoneImprimable Réduction homothétique des pages du fichier PDF afin qu'elles s'adaptent au format de sortie en prenant en compte les marges physiques. Les pages utilisant un format inférieur conservent leur format et sont centrées.
Cette constante correspond à l'option "Réduire aux marges de l'imprimante" proposée par les logiciels d'impression de fichiers PDF.
iTailleRéelle Impression à la taille réelle. Les pages utilisant un format :
plus petit que le format de sortie sont centrées dans la page.
plus grand que le format de sortie sont tronquées et sont centrées dans la page.

Ce paramètre n'est pas disponible.

<Liste des pages> : Chaîne de caractères

Liste des pages à imprimer. Il est possible d'indiquer des plages de pages à imprimer séparées par une virgule, chaque plage étant de la forme 'X-Y' où X et Y sont des numéros de pages.

Remarques

Aperçu de l'impression PDF

Le fichier PDF à imprimer peut être affiché dans le visualisateur de rapports. Il suffit d'utiliser la fonction iDestination avec la constante iVisualisateur avant la fonction iImprimePDF.

Par exemple :

// Imprime le PDF dans le visualisateur de rapports
iDestination(iVisualisateur)
iImprimePDF("c:\tmp\Convention.pdf")

Classification Métier / UI : Code neutre

Composante : wd300etatexe.dll

Voir Aussi

Version minimum requise

Version 18

Documentation également disponible pour…

Commentaires

Erreur sous IOS (WindevMobile)

Contrairement à la documentation V28, sous IOS , on obtient une erreur :
Cette syntaxe de la fonction 'iImprimePDF' n'est pas disponible pour la cible 'iOS'.
Vous pouvez désactiver le code pour la configuration courante grâce à une condition de compilation (<COMPILE SI ...>).
:-(

13 jan. 2023

Dernière modification : 05/07/2024

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