Module print

A print dialog with a preview of the pages, and the system’s printers through CUPS. The app renders the document to PDF itself: the dialog asks it for a preview whenever the layout changes, and says where to print and how once the user accepts.

fn open( &mut self )
{
    self.print = Some( PrintDialog::new( &self.sender, Msg::Print, "Report" ).preview( true ) );
}

fn update( &mut self, msg: Msg )
{
    let Msg::Print( msg ) = msg;
    let Some( dialog ) = &mut self.print else { return };
    match dialog.update( msg )
    {
        Some( PrintEvent::Preview( options ) ) => { /* render, then send PrintDialogMsg::previewed( .. ) */ }
        Some( PrintEvent::Print( job ) )       => { self.print = None; /* render job.options, then ltk::print::send or save */ }
        Some( PrintEvent::Cancelled )          => self.print = None,
        None                                   => {}
    }
}

Modules

• blocking
  CUPS’s calls themselves, for a program without ltk’s loop; each blocks.
• gtk
  PrintOptions as the print portal carries them: GTK’s print settings and page setup.

Structs

• Job
• Paper
  A sheet size, in PDF points, with its PWG media name for the printer.
• PortalToken
  What the print portal’s dialog chose, which it prints with.
• Preview
  The pages chosen, rendered with the options the dialog asked for.
• PreviewPage
• PrintDialog
• PrintJob
  What to print, where and how, once the user accepted.
• PrintOptions
  What the user chose in a print dialog.
• Printer

Enums

• Destination
• JobState
• Margins
• Orientation
• PrintDialogMsg
• PrintEvent
  What the app has to do for the dialog.
• PrinterState
• Section
  A setting whose choices the dialog shows under it.
• Sides

Constants

• PAGES
  The field with the pages to print.
• PAPERS
• PREVIEW_WIDTH
  How wide, in pixels, the pages of a preview are best rendered.

Functions

• cancel_job
• format_pages
• jobs
  The user’s jobs not yet finished, on every printer or on one of them.
• list_printers
  The system’s printers, the default first; empty without CUPS’s server, an error without CUPS.
• parse_pages
  Pages such as 1-3, 5, 8-, inclusive and from 1; None when the text is not such a list.
• send
  Print pdf at destination with options; done once the printer’s queue, or the desktop, took it.
• set_default
  Make printer the user’s default.