iDestination (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

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

Quand utiliser la fonction iDestination ?
Impression au format PDF
Impression en HTML
Impression en XLS
Impression en RTF
Configuration de l'imprimante pour l'impression en HTML, RTF et Texte
Impression au format PRN
Impression en XML
Caractéristiques d'impression
Impression sur un fax
Impression d'un fax en mode paysage
Utiliser un serveur de fax installé sur un poste différent du poste en cours
Fin d'impression

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

iDestination (Fonction)

En anglais : iDestination

Paramètre et renvoie la destination de l'impression.

Il est possible d'imprimer :

directement sur l'imprimante (syntaxe 1 et syntaxe 2).
Sur le serveur d'application (en déploiement), l'impression se fait uniquement sur les imprimantes connectées au serveur. Cette fonctionnalité est notamment utilisée pour les sites Intranet. Pour les sites Internet, il est conseillé de réaliser l'impression sous forme d'un fichier au format PDF générique (constante iPDFGénérique).
directement dans un fichier texte, HTM, RTF, PDF, PRN ou XML (syntaxe 3).
Pour obtenir une impression identique lors du développement et sur le site déployé, il est conseillé de réaliser des impressions génériques (par exemple avec les constantes iPDFGénérique, ...).
directement un duplicata (syntaxe 4).
directement sur un fax (syntaxe 5 et syntaxe 6, envoi d'un état vers un numéro de fax par exemple). Pour plus de détails sur la gestion des fax, consultez Envoyer des fax.

Exemple

// Impression au format HTML
iDestination(iHTML, "C:\Mes documents\MonEtat.HTM")
// "C:\Mes documents\MonEtat.HTM" correspond au nom et
// au chemin du fichier HTM qui sera créé avec l'état "ETAT_MonEtatRécap"
iImprimeEtat(ETAT_MonEtatRécap)

// Impression au format PDF
NomFichier est une chaîne = ComplèteRep(fRepDonnées()) + "f" + Facture + Client + ".PDF"
iDestination(iPDFGénérique, NomFichier)
iImprimeEtat(ETAT_Facture, Client, Facture)
// Teste si on est sur un site WEBDEV
SI EnModeWeb() = Vrai ALORS
// Impression effectuée depuis un site WEBDEV
// Envoi du fichier à l'internaute
FichierAffiche(NomFichier, "application/pdf")
Multitâche(0)
// Suppression du fichier sur le serveur
fSupprime(NomFichier)
FIN

// Imprimante PCL à utiliser
iDestination(iPCL, "\\MonRéseau\MonImprimante")
// Impression au format PCL : iDestination(iPCL, "\Mes documents\MonFichier.PCL")

// Génération d'un fichier PRN
iDestination(iFichierImprimante, "C:\Temp\Monimpression.prn")

// Génération d'un fichier PDF et ouverture du logiciel de messagerie par défaut
iDestination(iEmailPDF, "MaPieceJointe.PDF")

// Configuration du logiciel de mail (optionnel)
iParamètreExport(iExportEmailDestinataire, "Wam@CrazyMail.com; Celia.Wat@ZMail.fr")
iParamètreExport(iExportEmailExpéditeur, "Cemoy@Berrymail.com")
iParamètreExport(iExportEmailSujet, "Résultat des ventes de l'année")
iImprimeEtat(ETAT_MonEtat)

Syntaxe

Imprimer directement sur l'imprimante ou dans un mini-aperçu Masquer les détails

iDestination([<Destination> [, <Nom du document>]])

<Destination> : Constante optionnelle de type entier

Destination de l'impression.
iImprimante Impression directe sur l'imprimante.
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.
iMiniAperçu Impression dans un mini-aperçu. Ce mini-aperçu permet de visualiser les différentes pages à imprimer et de définir les options d'impression. Il est également possible de réaliser des exports.
Cette constante n'est pas disponible.

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

Si l'impression est directe (constante iImprimante), correspond au nom à donner à l'impression. Ce nom permettra d'identifier l'impression dans la liste des documents traités par l'imprimante.
Si l'impression est réalisée dans un mini-aperçu (constante iMiniAperçu), correspond au titre de la fenêtre du mini-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.

Imprimer directement sur une imprimante PCL Masquer les détails

iDestination(<iPCL> , <Imprimante à utiliser>)

<iPCL> : Constante

iPCL : Constante permettant d'imprimer directement sur une imprimante PCL.
Attention : il n'est pas possible d'imprimer en mode paysage sur une imprimante PCL.

<Imprimante à utiliser> : Chaîne de caractères

Chemin et nom de l'imprimante PCL utilisée. Cette imprimante doit être accessible.
Si cette imprimante est accessible via Bluetooth, ce paramètre doit correspondre à la chaîne "<Nom du port virtuel de sortie de Bluetooth>:".
Si plusieurs imprimantes utilisent la technologie Bluetooth, lors de l'impression, une fenêtre permet à l'utilisateur de sélectionner l'imprimante à utiliser.
Si cette imprimante est accessible par Wi-Fi ou par réseau, ce paramètre doit correspondre au nom et au chemin UNC de l'imprimante.

Imprimer dans un fichier (HTM, PCL, PDF, PRN, RTF, XLS, XML, ...) Masquer les détails

iDestination([<Type du fichier destination> [, <Nom du fichier à créer>]])

<Type du fichier destination> : Constante optionnelle de type entier

Permet de paramétrer le type de fichier à créer :
iEmailPDF Impression directe dans un fichier PDF et ouverture du logiciel de messagerie du poste en cours.
Ce fichier PDF est directement joint à un nouveau email créé en utilisant le client MAPI installé par un logiciel de messagerie du poste en cours. Le client MAPI doit être installé dans le même mode de compilation (32/64 bits) que l'application.
Le fichier a pour nom <Nom de l'état>.PDF (où <Nom de l'état> correspond au nom de l'état défini sous l'éditeur d'états). Ce fichier est créé dans le répertoire de l'application. Si le paramètre <Nom du fichier à créer> est précisé, le nom du fichier sera <Nom du fichier à créer>.PDF.
Remarque : Il est possible de paramétrer les éléments de l'email créé avec la fonction iParamètreExport.
Cette constante n'est pas disponible.
iFichier Impression directe dans un fichier texte. Le fichier a pour nom <Nom de l'état>.TXT (où <Nom de l'état> correspond au nom de l'état défini sous l'éditeur d'états). Ce fichier est créé dans le répertoire de l'application. Si le paramètre <Nom du fichier à créer> est précisé, le nom du fichier sera <Nom du fichier à créer>.TXT.
Attention : le paramétrage de l'imprimante est important. Consultez les remarques.
Si le répertoire du fichier n'est pas précisé, le fichier est généré dans le répertoire des données du site. Ce répertoire est paramétrable grâce à l'outil WDCOMPTE. Ce répertoire peut être connu grâce à la fonction fRepDonnées. Il est conseillé d'utiliser la fonction iDernierFichier pour ouvrir le dernier fichier généré.
Cette constante n'est pas disponible.
iFichierGénérique Impression directe dans un fichier texte. Le fichier a pour nom <Nom de l'état>.TXT (où <Nom de l'état> correspond au nom de l'état défini sous l'éditeur d'états). Ce fichier est créé dans le répertoire de l'application. Si le paramètre <Nom du fichier à créer> est précisé, le nom du fichier sera <Nom du fichier à créer>.TXT.
Ce mode d'impression n'utilise pas le driver d'imprimante courant ce qui garantit un résultat identique d'un poste à l'autre.
Si le répertoire du fichier n'est pas précisé, le fichier est généré dans le répertoire des données du site. Ce répertoire est paramétrable grâce à l'outil WDCOMPTE. Ce répertoire peut être connu grâce à la fonction fRepDonnées. Il est conseillé d'utiliser la fonction iDernierFichier pour ouvrir le dernier fichier généré.
Cette constante n'est pas disponible.
iFichierImprimante Impression directe dans un fichier PRN (fichier <Nom du fichier à créer>). Le paramètre <Nom du fichier à créer> doit contenir le nom complet du fichier PRN.
Attention : le paramétrage de l'imprimante est important. Consultez les remarques.
Cette constante n'est pas disponible.
iHTML Impression directe dans un fichier HTML avec utilisation de feuille de styles. Le fichier a pour nom <Nom de l'état>.HTM (où <Nom de l'état> correspond au nom de l'état défini sous l'éditeur d'états). Ce fichier est créé dans le répertoire de l'application.
Ce mode d'impression doit être utilisé pour gérer les superpositions dans les pages HTML.
Si le paramètre <Nom du fichier à créer> est précisé, le nom du fichier sera <Nom du fichier à créer>.HTM. Aucun aperçu ne sera affiché.
Attention : le paramétrage de l'imprimante est important. Consultez les remarques.
Si le répertoire du fichier n'est pas précisé, le fichier est généré dans le répertoire des données du site. Ce répertoire est paramétrable grâce à l'outil WDCOMPTE. Ce répertoire peut être connu grâce à la fonction fRepDonnées. Il est conseillé d'utiliser la fonction iDernierFichier pour ouvrir le dernier fichier généré.
Cette constante n'est pas disponible.
iHTMLGénérique Impression directe dans un fichier HTML avec utilisation d'une feuille de styles. Le fichier a pour nom <Nom de l'état>.HTM (où <Nom de l'état> correspond au nom de l'état défini sous l'éditeur d'états). Ce fichier est créé dans le répertoire de l'application.
Ce mode d'impression doit être utilisé pour gérer les superpositions dans les pages HTML.
Si le paramètre <Nom du fichier à créer> est précisé, le nom du fichier sera <Nom du fichier à créer>.HTM. Aucun aperçu ne sera affiché.
Ce mode d'impression n'utilise pas le driver d'imprimante courant ce qui garantit un résultat identique d'un poste à l'autre.
Si le répertoire du fichier n'est pas précisé, le fichier est généré dans le répertoire des données du site. Ce répertoire est paramétrable grâce à l'outil WDCOMPTE. Ce répertoire peut être connu grâce à la fonction fRepDonnées. Il est conseillé d'utiliser la fonction iDernierFichier pour ouvrir le dernier fichier généré.
Cette constante n'est pas disponible.
iHTMLGénériqueSansCSS Impression directe dans un fichier HTML sans utilisation d'une feuille de styles. Le fichier a pour nom <Nom de l'état>.HTM (où <Nom de l'état> correspond au nom de l'état défini sous l'éditeur d'états). Ce fichier est créé dans le répertoire de l'application.
Ce mode d'impression ne gère pas les superpositions dans les pages HTML.
Si le paramètre <Nom du fichier à créer> est précisé, le nom du fichier sera <Nom du fichier à créer>.HTM. Aucun aperçu ne sera affiché.
Ce mode d'impression n'utilise pas le driver d'imprimante courant ce qui garantit un résultat identique d'un poste à l'autre.
Si le répertoire du fichier n'est pas précisé, le fichier est généré dans le répertoire des données du site. Ce répertoire est paramétrable grâce à l'outil WDCOMPTE. Ce répertoire peut être connu grâce à la fonction fRepDonnées. Il est conseillé d'utiliser la fonction iDernierFichier pour ouvrir le dernier fichier généré.
Cette constante n'est pas disponible.
iHTMLSansCSS Impression directe dans un fichier HTML sans utilisation d'une feuille de styles. Le fichier a pour nom <Nom de l'état>.HTM (où <Nom de l'état> correspond au nom de l'état défini sous l'éditeur d'états). Ce fichier est créé dans le répertoire de l'application.
Ce mode d'impression ne gère pas les superpositions dans les pages HTML.
Si le paramètre <Nom du fichier à créer> est précisé, le nom du fichier sera <Nom du fichier à créer>.HTM. Aucun aperçu ne sera affiché.
Attention : le paramétrage de l'imprimante est important. Consultez les remarques.
Si le répertoire du fichier n'est pas précisé, le fichier est généré dans le répertoire des données du site. Ce répertoire est paramétrable grâce à l'outil WDCOMPTE. Ce répertoire peut être connu grâce à la fonction fRepDonnées. Il est conseillé d'utiliser la fonction iDernierFichier pour ouvrir le dernier fichier généré.
Cette constante n'est pas disponible.
iPCL Impression directe dans un fichier PCL (fichier <Nom de l'état>.PCL créé dans le répertoire de l'application).
Si le paramètre <Nom du fichier à créer> est précisé, le nom du fichier sera <Nom du fichier à créer>.PCL.
Si le répertoire du fichier n'est pas précisé, le fichier est généré dans le répertoire des données du site. Ce répertoire est paramétrable grâce à l'outil WDCOMPTE. Ce répertoire peut être connu grâce à la fonction fRepDonnées. Il est conseillé d'utiliser la fonction iDernierFichier pour ouvrir le dernier fichier généré.
Cette constante n'est pas disponible.
iPDF Impression directe dans un fichier PDF. Le fichier a pour nom <Nom de l'état>.PDF (où <Nom de l'état> correspond au nom de l'état défini sous l'éditeur d'états). Ce fichier est créé dans le répertoire de l'application.
Si le paramètre <Nom du fichier à créer> est précisé, le nom du fichier sera <Nom du fichier à créer>.PDF.
Si le répertoire du fichier n'est pas précisé, le fichier est généré dans le répertoire des données du site. Ce répertoire est paramétrable grâce à l'outil WDCOMPTE. Ce répertoire peut être connu grâce à la fonction fRepDonnées. Il est conseillé d'utiliser la fonction iDernierFichier pour ouvrir le dernier fichier généré.
Avertissement
A partir de la version 27, cette constante est conservée par compatibilité. Il est conseillé d'utiliser la constante iPDFGénérique qui permet une génération optimisée du fichier PDF.
iPDFGénérique Impression directe dans un fichier PDF. Le fichier a pour nom <Nom de l'état>.PDF (où <Nom de l'état> correspond au nom de l'état défini sous l'éditeur d'états). Ce fichier est créé dans le répertoire de l'application.
Si le paramètre <Nom du fichier à créer> est précisé, le nom du fichier sera <Nom du fichier à créer>.PDF.
Attention : Il n'est pas possible d'utiliser un format supérieur au format A4.
Ce mode d'impression n'utilise pas le driver d'imprimante courant ce qui garantit un résultat identique d'un poste à l'autre.
Si le répertoire du fichier n'est pas précisé, le fichier est généré dans le répertoire des données du site. Ce répertoire est paramétrable grâce à l'outil WDCOMPTE. Ce répertoire peut être connu grâce à la fonction fRepDonnées. Il est conseillé d'utiliser la fonction iDernierFichier pour ouvrir le dernier fichier généré.
iRTF Impression directe dans un fichier RTF. Le fichier a pour nom <Nom de l'état>.RTF (où <Nom de l'état> correspond au nom de l'état défini sous l'éditeur d'états). Ce fichier est créé dans le répertoire de l'application.
Si le paramètre <Nom du fichier à créer> est précisé, le nom du fichier sera <Nom du fichier à créer>.RTF. Aucun aperçu ne sera affiché.
Attention : le paramétrage de l'imprimante est important. Consultez les remarques.
Si le répertoire du fichier n'est pas précisé, le fichier est généré dans le répertoire des données du site. Ce répertoire est paramétrable grâce à l'outil WDCOMPTE. Ce répertoire peut être connu grâce à la fonction fRepDonnées. Il est conseillé d'utiliser la fonction iDernierFichier pour ouvrir le dernier fichier généré.
Cette constante n'est pas disponible.
iRTFGénérique Impression directe dans un fichier RTF. Le fichier a pour nom <Nom de l'état>.RTF (où <Nom de l'état> correspond au nom de l'état défini sous l'éditeur d'états). Ce fichier est créé dans le répertoire de l'application.
Si le paramètre <Nom du fichier à créer> est précisé, le nom du fichier sera <Nom du fichier à créer>.RTF. Aucun aperçu ne sera affiché.
Ce mode d'impression n'utilise pas le driver d'imprimante courant ce qui garantit un résultat identique d'un poste à l'autre.
Si le répertoire du fichier n'est pas précisé, le fichier est généré dans le répertoire des données du site. Ce répertoire est paramétrable grâce à l'outil WDCOMPTE. Ce répertoire peut être connu grâce à la fonction fRepDonnées. Il est conseillé d'utiliser la fonction iDernierFichier pour ouvrir le dernier fichier généré.
Cette constante n'est pas disponible.
iXLS Impression directe dans un fichier XLS. Le fichier a pour nom <Nom de l'état>.XLS (où <Nom de l'état> correspond au nom de l'état défini sous l'éditeur d'états). Ce fichier est créé dans le répertoire de l'application.
Si le paramètre <Nom du fichier à créer> est précisé, le nom du fichier sera <Nom du fichier à créer>.XLS. Aucun aperçu ne sera affiché.
Si le répertoire du fichier n'est pas précisé, le fichier est généré dans le répertoire des données du site. Ce répertoire est paramétrable grâce à l'outil WDCOMPTE. Ce répertoire peut être connu grâce à la fonction fRepDonnées. Il est conseillé d'utiliser la fonction iDernierFichier pour ouvrir le dernier fichier généré.
Cette constante n'est pas disponible.
iXLSGénérique Impression directe dans un fichier XLS. Le fichier a pour nom <Nom de l'état>.XLS (où <Nom de l'état> correspond au nom de l'état défini sous l'éditeur d'états). Ce fichier est créé dans le répertoire de l'application.
Si le paramètre <Nom du fichier à créer> est précisé, le nom du fichier sera <Nom du fichier à créer>.XLS. Aucun aperçu ne sera affiché.
Ce mode d'impression n'utilise pas le driver d'imprimante courant ce qui garanti un résultat identique d'un poste à l'autre.
Si le répertoire du fichier n'est pas précisé, le fichier est généré dans le répertoire des données du site. Ce répertoire est paramétrable grâce à l'outil WDCOMPTE. Ce répertoire peut être connu grâce à la fonction fRepDonnées. Il est conseillé d'utiliser la fonction iDernierFichier pour ouvrir le dernier fichier généré.
Cette constante n'est pas disponible.
iXML Impression directe dans un fichier XML. Le fichier a pour nom <Nom de l'état>.XML (où <Nom de l'état> correspond au nom de l'état défini sous l'éditeur d'états). Ce fichier est créé dans le répertoire de l'application.
Si le paramètre <Nom du fichier à créer> est précisé, le nom du fichier sera <Nom du fichier à créer>.XML. Aucun aperçu ne sera affiché.
Si le répertoire du fichier n'est pas précisé, le fichier est généré dans le répertoire des données du site. Ce répertoire est paramétrable grâce à l'outil WDCOMPTE. Ce répertoire peut être connu grâce à la fonction fRepDonnées. Il est conseillé d'utiliser la fonction iDernierFichier pour ouvrir le dernier fichier généré.
Cette constante n'est pas disponible.
iXMLGénérique Impression directe dans un fichier XML. Le fichier a pour nom <Nom de l'état>.XML (où <Nom de l'état> correspond au nom de l'état défini sous l'éditeur d'états). Ce fichier est créé dans le répertoire de l'application.
Si le paramètre <Nom du fichier à créer> est précisé, le nom du fichier sera <Nom du fichier à créer>.XML. Aucun aperçu ne sera affiché.
Ce mode d'impression n'utilise pas le driver d'imprimante courant ce qui garantit un résultat identique d'un poste à l'autre.
Si le répertoire du fichier n'est pas précisé, le fichier est généré dans le répertoire des données du site. Ce répertoire est paramétrable grâce à l'outil WDCOMPTE. Ce répertoire peut être connu grâce à la fonction fRepDonnées. Il est conseillé d'utiliser la fonction iDernierFichier pour ouvrir le dernier fichier généré.
Cette constante n'est pas disponible.

<Nom du fichier à créer> : Chaîne de caractères optionnelle

Nom du fichier généré. Si ce paramètre n'est pas précisé, le nom du fichier généré correspond au "Nom de l'état". Dans le cas d'une impression au format PRN (avec la constante iFichierImprimante), le nom complet du fichier à créer doit être spécifié.

Imprimer un duplicata Masquer les détails

iDestination(<Type destination> [, <Nom du fichier à créer> [, <Certificat> [, <Mot de passe>]]])

<Type destination> : Constante de type entier

Permet de paramétrer le type de fichier à créer :
iDuplicata Impression directe dans un fichier duplicata. Le fichier a pour nom <Nom de l'état>.DPL (où <Nom de l'état> correspond au nom de l'état défini sous l'éditeur d'états). Ce fichier est créé dans le répertoire de l'application.

Attention : Cette constante permet d'imprimer uniquement un duplicata et non de réaliser une impression.
Pour réaliser un duplicata d'une impression, il est conseillé d'utiliser la fonction iParamètreDuplicata puis la fonction iDestination pour imprimer sur l'imprimante.
Si le répertoire du fichier n'est pas précisé, le fichier est généré dans le répertoire des données du site. Ce répertoire est paramétrable grâce à l'outil WDCOMPTE. Ce répertoire peut être connu grâce à la fonction fRepDonnées. Il est conseillé d'utiliser la fonction iDernierFichier pour ouvrir le dernier fichier généré.

<Nom du fichier à créer> : Chaîne de caractères optionnelle

Nom du fichier duplicata à créer (sans l'extension). Le fichier créé sera <Nom du fichier à créer>.DPL.
Si ce paramètre correspond à chaîne vide (""), le nom du fichier généré correspond au "Nom de l'état".DPL.

<Certificat> : Variable de type Certificat

Nom de la variable de type Certificat contenant le certificat à utiliser pour signer le duplicata.

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

Mot de passe du duplicata généré.

Imprimer directement sur un Fax sans gestion d'un compte-rendu (Windows 2000 et XP) Masquer les détails

iDestination(<iFax> , <Numéro de Fax à composer>)

<iFax> : Constante

iFax : Constante permettant d'imprimer directement sur un fax.

<Numéro de Fax à composer> : Chaîne de caractères

Numéro de téléphone correspondant au fax où doit être envoyée l'impression.
Attention : Un modem doit être installé sur le poste en cours. Le numéro de fax doit correspondre aux spécifications indiquées lors de la configuration du modem.

Imprimer directement sur un Fax avec gestion d'un compte-rendu (Windows 2000 et XP) Masquer les détails

<Résultat> = iDestination(<iFax> , <Numéro de Fax à composer> , <Nom du fax> [, <Nom ou identifiant du serveur de fax>])

<Résultat> : Entier

Identifiant de la connexion au serveur de fax,
0 en cas d'erreur. Le message d'erreur correspondant peut être obtenu avec la fonction ErreurInfo.

<iFax> : Constante

iFax : Constante permettant d'imprimer directement sur un fax.

<Numéro de Fax à composer> : Chaîne de caractères

Numéro de téléphone correspondant au fax où doit être envoyée l'impression.
Attention : un modem doit être installé sur le poste en cours. Le numéro de fax doit correspondre aux spécifications indiquées lors de la configuration du modem.

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

Nom permettant d'identifier le fax envoyé. Il sera alors possible de connaître l'état du fax envoyé grâce à la fonction FaxEtat.

<Nom ou identifiant du serveur de fax> : Chaîne de caractères ou entier optionnelle

Nom de partage du poste serveur de fax.
Si ce paramètre n'est pas précisé ou correspond à une chaîne vide, le serveur de fax correspond au serveur de fax par défaut.
Attention : il est nécessaire de démarrer le serveur de fax et de le configurer en mode d'envoi. Pour plus de détails, consultez Envoyer des fax.
Identifiant du serveur de fax : Si la fonction FaxConnecte a été utilisée avant la fonction iAperçu, ce paramètre peut correspondre à l'identifiant de la connexion au serveur de fax renvoyé par la fonction FaxConnecte.

Remarques

Quand utiliser la fonction iDestination ?

La fonction iDestination doit être la première fonction d'impression appelée. Elle doit donc figurer avant les fonctions iImprime, iCréePolice, etc. Mais la fonction iDestination doit être appelée après les fonctions iConfigure ou iParamètre.

Remarque : La fonction iDestination peut être appelée avant l'exécution d'un état (avec iImprimeEtat) pour choisir la destination de l'exécution de l'état.

Impression au format PDF

Le fichier PDF généré peut être directement imprimé via la fonction iImprimePDF.

Impression en HTML

Si l'impression est réalisée dans une page HTML avec une feuille de styles (constante iHTMLCSS), la feuille de styles est intégrée au fichier HTML. L'impression est identique en HTML et sur une imprimante. Les superpositions sont gérées et la gestion de la taille des polices est précise.
Si l'impression est réalisée dans une page HTML sans feuille de styles (constante iHTML), les limitations suivantes peuvent être observées :
- gestion de la taille des polices non précise
- superposition non gérée. Il est par exemple impossible d'écrire sur une image.
Les polices orientées à 90° ne sont pas imprimées correctement dans le fichier HTML : le texte est affiché avec une police horizontale.
Les cadres arrondis ne sont pas imprimés. Ils sont remplacés par des cadres non arrondis.

Impression en XLS

Les champs Image, Code-barres et Graphe ne sont pas imprimés.

Impression en RTF

L'impression au format RTF gère uniquement le texte (avec son style) et les images. Il est impossible de gérer la superposition d'objets (lignes ou images). Il est impossible de mettre par exemple plusieurs lignes de texte à côté d'une image.
Les polices orientées à 90° ne sont pas imprimées correctement dans le fichier HTML : le texte est affiché avec une police horizontale.
Pour imprimer en RTF, le fichier "RICHED20.DLL" doit être présent sur le poste en cours. Le fichier "RICHED20.DLL" est généralement présent dans le répertoire système de Windows.
Les cadres ne sont pas imprimés.
Les tableaux sont gérés par le format RTF. La couleur de la police et la couleur de fond des cellules sont conservées.

Configuration de l'imprimante pour l'impression en HTML, RTF et Texte

Si l'impression est réalisée dans un fichier texte, seul le texte est récupéré : les traits, les images, ... sont ignorés.
L'impression en HTML, en RTF et en mode texte se base sur la configuration et la résolution de l'imprimante en cours. Ainsi si l'imprimante en cours est configurée avec des marges et en mode paysage, ces options seront utilisées pour l'impression en mode HTML, texte, ou RTF.
Plus l'imprimante est configurée avec une résolution fine, plus l'impression en RTF, texte ou HTML sera de bonne qualité.
Pour éviter certains problèmes de superposition lors d'une impression en mode HTML, il suffit parfois d'un simple réglage des paramètres de l'imprimante.

Impression au format PRN

Lors d'une impression au format PRN, le fichier PRN est spécifique à l'imprimante sélectionnée. Ce fichier est directement créé par le driver de l'imprimante, c'est un fichier binaire interprétable par l'imprimante.

Ce fichier peut être imprimé en différé sur l'imprimante spécifiée lors de l'impression ou sur toute autre imprimante du même type par la commande DOS "Print". La syntaxe de cette commande est :

Print /D:\\<Nom du poste>\<Nom de l'imprimante déclaré> <Nom du fichier prn>

Exemple :

Print /D:\\Poste_Doc\CanonLBP Sortie.prn

Remarque : Pour une imprimante réseau, il est nécessaire d'utiliser le nom du partage et non le nom de l'imprimante. Le nom du partage est connu dans l'onglet "Partage" de la description de l'imprimante.

Impression en XML

Lors d'une impression au format XML, seules les données sont imprimées. Les caractéristiques de mise en page (traits, ...) ne sont pas prises en compte.

Caractéristiques d'impression

Lors d'une impression au format PDF, il est possible de paramétrer les caractéristiques du fichier PDF créé grâce à la fonction iParamètrePDF.
Lors d'une impression au format XLS, il est possible de paramétrer les caractéristiques du fichier XLS créé grâce à la fonction iParamètreXLS.

Impression sur un fax

Deux syntaxes permettent d'envoyer une impression sur un fax :

Fax sans aucune gestion de compte-rendu. L'impression (réalisée par la suite avec la fonction iImprimeEtat par exemple) est directement envoyée au numéro de téléphone spécifié.
Fax avec gestion de compte-rendu. L'impression (réalisée par la suite avec la fonction iImprimeEtat par exemple) est envoyée au numéro de téléphone spécifié, par l'intermédiaire d'un serveur de fax. La fonction iAperçu renvoie l'identifiant de la connexion à ce serveur de fax. Cet identifiant, ainsi que le nom donné au fax, permettent de suivre l'envoi du fax grâce aux fonctions Fax. Pour plus de détails sur la gestion des fax, consultez Envoyer des fax.

Impression d'un fax en mode paysage

Pour paramétrer l'impression d'un fax en mode paysage (impression de plusieurs fax, dont un en mode paysage), il est nécessaire d'utiliser les fonctions d'impression dans l'ordre suivant :

Fonction iDestination avec la constante iFax.
Fonction iParamètre permettant de passer en mode paysage.

Si cet ordre n'est pas respecté, le paramétrage du mode paysage ne sera pas pris en compte par le driver de gestion des fax.

Exemple :

iDestination(iFax, "00046032032", "Fax")
iParamètre("ORIENTATION=PAYSAGE")
iImprime("Impression en paysage")
iFinImprime()

Utiliser un serveur de fax installé sur un poste différent du poste en cours

Il est possible d'utiliser un serveur de fax installé sur un poste différent du poste en cours. Dans ce cas, le poste sur lequel est installé le serveur de fax doit être un poste avec Windows Server 2003. Le serveur de fax doit être partagé. Il suffit alors d'utiliser le nom du poste serveur de fax dans la fonction iDestination.

Le poste à partir duquel les fax sont envoyés doit posséder un serveur de fax local.

Par exemple, si le serveur de fax est installé sur le poste "ServeurFax1", il suffit d'utiliser la syntaxe :

iDestination(iFax, "00046032032", "Fax", "\\ServeurFax1\Fax_Partage")

Fin d'impression

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

Les prochaines impressions seront effectuées sur l'imprimante, sauf si la fonction iDestination est à nouveau exécutée.

Classification Métier / UI : Code neutre

Composante : wd300prn.dll

Voir Aussi

Version minimum requise

Version 9

Documentation également disponible pour…

Commentaires

iVisualisateur

Changement de fonctionnement en WD26 :
La fenêtre d'aperçu ne s'ouvre plus à 100%.
Si on la maximise pour un document, le paramètre est gardé pour ce document mais pas pour un nouveau.

Laurent

09 mai 2022

Gestion en Service Windows

La constante "iPDFGénérique" n'imprime pas les codes barres en mode service windows.
Testé uniquement avec le code barre Code 128 natif sur les états Windev.

Baptiste - BLV TECH

05 nov. 2021

Limite sur Webservice

La constante "iFichierImprimante" ne fonctionne pas sur un environnement Webservice.

L'impression ce fait ( avec les fonctions Socketxx() ) mais le Webservice imprime avec un driver générique, pas celui de l'imprimante sélectionner.

Du coup, les fonctions spécifique du driver de votre imprimante ( Pell-Off par exemple ) ne sont pas pris en compte.

Baptiste - BLV TECH

02 nov. 2021

idestination et service Windows

Existe-il des restrictions concernant l'utilisation de la fonction iDestination dans un service Windows développé en Windev ?

Peut-on utiliser tous les types d'impression, etc ?

Merci d'avance pour vos précisons sur ce point car la gestion des impressions dans un service me pose des problèmes.

Damien 10

19 fév. 2020

Dernière modification : 21/06/2023

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