Print manager

Gestionnaire d'impression avec XulRunner

Même si le gestionnaire n'est pas encore entièrement configuré pour fonctionner avec XulRunner, il est cependant disponible avec le Toolkit. En attendant, il permet quand même d'avoir rapidement accès au mêmes fonctionnalités que la gestion de l'impression sous Firefox, à condition de procéder à quelques légères modifications.

Modifier « PrintUtils.js »

L'impression est gérée via l'objet JS « PrintUtils » qui se trouve dans « global/content/printUtils.js » dans le chrome du Toolkit. Il est nécessaire de récupérer ce fichier et de le placer dans le chrome de son application après avoir effectué les modification suivantes :

 enterPrintPreview: function ()
 {
    ...

    // show the toolbar after we go into print preview mode so
    // that we can initialize the toolbar with total num pages
    printPreviewTB = document.createElementNS(XUL_NS, "toolbar");
    printPreviewTB.setAttribute("printpreview", true);
    printPreviewTB.setAttribute("id", "print-preview-toolbar");

    // Ajouter la ligne suivante (l.197):
    getBrowser().parentNode.insertBefore(printPreviewTB, getBrowser());

    ...
  }

Aperçu avant impression

L'aperçu avant impression est activé sur l'élément <iframe> ou <browser> qui contient le document à imprimer. Dans Firefox, une toolbar spéciale est insérée au-dessus de cet élément et permet d'avoir accès aux éléments de configuration de l'impression. Sous XulRunner, il suffit donc de créer une fenêtre spéciale qui contiendra le document à imprimer:

 <window
  xmlns="[[http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul]]"
  id="printPreview"
  title="Aperçu avant Impression"
  onload="onLoad();"
  ...
  >

   <script type="application/x-javascript" src="[[chrome://monappli/content/printUtils.js"/]]>
   <script type="application/x-javascript" src="[[chrome://monappli/content/printPreview.js"/]]>

   <browser id="content" src="[[about:blank]]" flex="1"/>

 </window>

« printPreview.js »

  var gBrowser;

  function getBrowser()
  {
    if (!gBrowser)
         gBrowser = document.getElementById("content");

    return gBrowser;
  }

  function onEnterPrintPreview()
  {
    // On peut modifier la fenêtre xul ici.
  }

  function onExitPrintPreview()
  {
    // On ferme la fenêtre ici si elle ne sert que pour la prévisualisation.
    window.close();
  }

  function onLoadContent()
  {
    // On lance la mode "preview"  dès le chargement du contenu
    PrintUtils.printPreview(onEnterPrintPreview, onExitPrintPreview);
  }

  function onUnloadContent()
  {
    //
  }

  function onLoad()
  {
    var args    = window.arguments;

    getBrowser().addEventListener("unload", onUnloadContent, true);
    getBrowser().addEventListener("load"  , onLoadContent, true);

    getBrowser().setAttribute("src","file://"+args[0]);
  }

La fenêtre sera alors ouverte par:

 openDialog(command, "PrintPreview", "chrome,resizable,dialog=no,dependent,centerscreen", url_du_document);

Attention, cela ne fonctionnera pas si la fenêtre est modale !

La barre d'outils

La barre d'outils est un composant xbl qui se trouve dans « global/content/printPreviewBindings.xml ». On peut tout à fait récupérer ce composant et le modifier à notre guise en n'oubliant pas de modifier le binding CSS et le cas échéant apporter les modifications appropriés à « PrintUtils.js ».

	<script type="application/x-javascript" src="[[chrome://global/content/printUtils.js"/]]>

   <script type="application/x-javascript" src="[[chrome://monappli/content/printUtils.js"/]]>

    var doc = browser;
    var req = doc.contentWindow.QueryInterface(Components.interfaces.nsIInterfaceRequestor);
    var wbprint = req.getInterface(Components.interfaces.nsIWebBrowserPrint);
    var settings = PrintUtils.getPrintSettings();
    wbprint.print(settings, null);

    pref("print.printer_PostScript/default.print_command", "kprinter ${MOZ_PRINTER_NAME:+'-P'}${MOZ_PRINTER_NAME}");