PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE


  • Quand utiliser la fonction iDestination ?
  • Android : Impression au format PDF
  • Impression au format PDF
  • Fin d'impression
  • Impression via Bluetooth
  • Fonctionnement différent en mode GO et en utilisation réelle
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget iOSApple WatchCatalystUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Paramètre et renvoie la destination de l'impression.
Il est possible d'imprimer :
  • directement sur l'imprimante (syntaxe 1 et syntaxe 2).
    Windows Mobile Dans cette version, l'impression se fait uniquement sur une imprimante PCL.
  • directement dans un fichier texte, HTM, RTF, PDF, PRN ou XML (syntaxe 3).
    Windows Mobile Dans cette version, l'impression se fait uniquement dans un fichier PCL.

    AndroidiPhone/iPadUniversal Windows 10 App Dans cette version, l'impression se fait uniquement dans un fichier PDF.
  • Versions 15 et supérieures
    directement un duplicata (syntaxe 4).
    Nouveauté 15
    directement un duplicata (syntaxe 4).
    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.
    Windows Mobile Dans cette version, cette fonctionnalité n'est pas disponible.
Versions 18 et supérieures
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 18
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Versions 19 et supérieures
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Android Cette fonction est désormais disponible pour les applications Android.
Nouveauté 19
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Android Cette fonction est désormais disponible pour les applications Android.
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Android Cette fonction est désormais disponible pour les applications Android.
AndroidWidget AndroidiPhone/iPadUniversal Windows 10 App Seules les impressions au format PDF sont disponibles.
Versions 21 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Exemple
Windows Mobile
// Imprimante PCL à utiliser
iDestination(iPCL, "\\MonRéseau\MonImprimante")
// Impression au format PCL : iDestination(iPCL, "\Mes documents\MonFichier.PCL")
Syntaxe
WINDEV Mobile

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 (avec guillemets)
Chemin et nom de l'imprimante PCL utilisée. Cette imprimante doit être accessible.
Si cette imprimante est associée au port infrarouge du Pocket PC, ce paramètre doit correspondre :
  • à la chaîne "IRDA:" : si une seule imprimante est active sur le port infrarouge au moment de l'impression.
  • à la chaîne "IRDA:<Imprimante à utiliser>" : si plusieurs imprimantes sont actives sur le port infrarouge au moment de l'impression.
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. Pour plus de détails sur l'impression par Bluetooth, consultez les remarques.
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 :
Versions 23 et supérieures
iEmailPDF
Nouveauté 23
iEmailPDF
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.
AndroidWidget AndroidiPhone/iPadUniversal Windows 10 AppWindows Mobile Cette constante n'est pas disponible.
iFichierImpression 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.
AndroidWidget AndroidiPhone/iPadUniversal Windows 10 AppWindows Mobile Cette constante n'est pas disponible.
iFichierGénériqueImpression 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.
AndroidWidget AndroidiPhone/iPadUniversal Windows 10 AppWindows Mobile Cette constante n'est pas disponible.
iFichierImprimanteImpression 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.
AndroidWidget AndroidiPhone/iPadUniversal Windows 10 AppWindows Mobile Cette constante n'est pas disponible.
iHTMLImpression 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.
AndroidWidget AndroidiPhone/iPadUniversal Windows 10 AppWindows Mobile Cette constante n'est pas disponible.
iHTMLGénériqueImpression 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.
AndroidWidget AndroidiPhone/iPadUniversal Windows 10 AppWindows Mobile Cette constante n'est pas disponible.
iHTMLSansCSSImpression 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.
AndroidWidget AndroidiPhone/iPadUniversal Windows 10 AppWindows Mobile Cette constante n'est pas disponible.
iHTMLGénériqueSansCSSImpression 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.
AndroidWidget AndroidiPhone/iPadUniversal Windows 10 AppWindows Mobile Cette constante n'est pas disponible.
iPCLImpression 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.
AndroidWidget AndroidiPhone/iPadUniversal Windows 10 AppWindows Mobile Cette constante n'est pas disponible.
iPDFImpression 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.
AndroidWidget AndroidWindows Mobile Cette constante n'est pas disponible.
iPDFGénériqueImpression 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.
Android Les impressions PDF supportent uniquement les polices standards Adobe (non Unicode) : Courier, Helvetica, Times, Symbol et ZapFDingbats.
Windows Mobile Cette constante n'est pas disponible.
iRTFImpression 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.
AndroidWidget AndroidiPhone/iPadUniversal Windows 10 AppWindows Mobile Cette constante n'est pas disponible.
iRTFGénériqueImpression 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.
AndroidWidget AndroidiPhone/iPadUniversal Windows 10 AppWindows Mobile Cette constante n'est pas disponible.
iXLSImpression 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é.
AndroidWidget AndroidiPhone/iPadUniversal Windows 10 AppWindows Mobile Cette constante n'est pas disponible.
iXLSGénériqueImpression 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.
AndroidWidget AndroidiPhone/iPadUniversal Windows 10 AppWindows Mobile Cette constante n'est pas disponible.
iXMLImpression 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é.
AndroidWidget AndroidiPhone/iPadUniversal Windows 10 AppWindows Mobile Cette constante n'est pas disponible.
iXMLGénériqueImpression 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.
AndroidWidget AndroidiPhone/iPadUniversal Windows 10 AppWindows Mobile 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é.
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.
AndroidWidget Android

Android : Impression au format PDF

Par défaut, si la fonction iDestination n'est pas appelée avant de lancer une impression PDF, un fichier "document.pdf" sera généré dans le répertoire des fichiers de l'application.
S'il est nécessaire d'ouvrir le document PDF généré par les fonctions d'impression avec une application externe (en utilisant la fonction LanceAppliAssociée par exemple), le document doit se trouver sur la mémoire externe de l'appareil (sdcard par exemple) pour qu'il soit accessible par les autres applications.
Exemple :
iDestination(iPDFGénérique, ComplèteRep(SysRepCarteStockage()) + "document.pdf")
Attention : Sous Android, les impressions PDF supportent uniquement les polices standards Adobe (non Unicode) : Courier, Helvetica, Times, Symbol et ZapFDingbats.
AndroidWidget AndroidiPhone/iPad

Impression au format PDF

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

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

Impression via Bluetooth

Pour imprimer via Bluetooth, il est nécessaire de :
  • utiliser une imprimante de type PCL.
  • utiliser une imprimante qui accepte la couche série de Bluetooth.
  • connaître le nom du port virtuel de sortie de Bluetooth. Ce nom peut être connu dans les paramètres Bluetooth du Pocket PC / PC ou dans la documentation du Pocket PC / PC.
    Généralement, ce nom correspond à "COM8:".
Pour plus de détails, consultez Imprimer via Bluetooth.
Windows Mobile

Fonctionnement différent en mode GO et en utilisation réelle

En mode GO (simulation sur le poste de développement), une erreur WLangage est générée lors de l'appel de la fonction iDestination.
L'ensemble des différences entre le mode GO (simulateur) et l'utilisation réelle est détaillé dans Différences en mode GO et en utilisation réelle.
Classification Métier / UI : Code neutre
Composante : wd260prn.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
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