DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions d'impression
  • Aperçu de l'impression 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
Imprime le contenu :
  • d'un fichier PDF.
  • WINDEVWEBDEV - Code ServeurAndroidWidget Android d'un buffer contenant un PDF.
  • WINDEVAndroid d'un champ Lecteur PDF.
Quelle est la destination de l'impression ?
  • iPhone/iPad 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.
  • AndroidWidget Android 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.
  • WINDEVWEBDEV - Code Serveur 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.
    WINDEV 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
iPhone/iPad
// 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
WINDEVWEBDEV - Code Serveur
// 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.
AndroidWidget Android 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.
AndroidWidget AndroidiPhone/iPad Ce paramètre n'est pas disponible.
<Dimensionnement> : Constante de type Entier
Taille d'impression :
iHomothétiqueAgrandissement 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étiqueSansAgrandissementRé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étiqueSansAgrandissementZoneImprimableRé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éelleImpression à 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.

AndroidWidget AndroidiPhone/iPad 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.
AndroidWidget AndroidiPhone/iPad Ce paramètre n'est pas disponible.
WINDEVWEBDEV - Code ServeurEtats et RequêtesAndroidWidget AndroidCode Utilisateur (MCU)

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.
AndroidWidget Android 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étiqueAgrandissement 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étiqueSansAgrandissementRé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étiqueSansAgrandissementZoneImprimableRé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éelleImpression à 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.

AndroidWidget Android 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.
WINDEVEtats et RequêtesAndroidCode Utilisateur (MCU)

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.
Android 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étiqueAgrandissement 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étiqueSansAgrandissementRé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étiqueSansAgrandissementZoneImprimableRé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éelleImpression à 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.

Android 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
WINDEV

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
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 ...>).
:-(
B.
13 jan. 2023

Dernière modification : 05/07/2024

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