Caution: This version of this document is no longer maintained. For the latest documentation, see


Display a custom modal dialog for selecting print options


int PtPrintSelect( 
        PtWidget_t *parent, 
        const char *title,
        PtPrintSelectionInfo_t *info );




This function displays a modal dialog that lets you select print options and initiate printing. This function is similar to PtPrintSelection(), but PtPrintSelect() lets you customize the appearance and function of the dialog and the underlying PtPrintSel widget.

The dialog is parented off the parent widget, which may be NULL; if non-NULL, that parent widget is blocked and its cursor is changed to reflect this.

The title of the dialog is given by title; if this is NULL a default title of “Select Printer” is used.

The user may click one of these buttons:


An integer that indicates which button was pressed:

or Pt_PRINTSEL_ERROR, which indicates that an error was made in custom_args.

The do_preview member of the print context is also set to indicate whether Print or Preview was selected. This means that the context can be passed to the printing function, which will spawn the print-preview application if necessary.



Interrupt handler No
Signal handler No
Thread No

See also:

PpContinueJob(), PpCreatePC(), PpEndJob(), PpGetPC(), PpPrintNewPage(), PpReleasePC(), PpPrintWidget(), PpSetPC(), PpStartJob(), PpSuspendJob(), PtPrintSelection(), PtSetResources()

Printing chapter, and Setting resources in the Manipulating Resources in Application Code chapter of the Photon Programmer's Guide