Chapter 11 CDE Printing Widgets and APIs

Table of Contents

CDE users typically print files through a series of dialogs, the first one being initiated by selecting (for example) the pulldown menu for printing a file. This chapter documents a set of dialogs provided by CDEnext for use primarily by applications that perform X printing:

The initial print dialog is provided as the DtPrintSetupBox() widget. This consists of the set of generic print options, a possible application-specific set of print options, and a set of command buttons at the bottom to start or cancel the print operation, bring up the Print Dialog Manager (PDM), or bring up a help dialog.
The DtPrinterSelectionDialog() is for selecting X Printers and is accessible through the DtPrintSetupBox() widget.
A dialog for obtaining additional printer information, the DtPrinterInfoDialog(), is accessible through either the DtPrintSetupBox() or the DtPrinterSelectionDialog().

There is also a file selection dialog (accessible through DtPrintSetupBox()) that enables users to select files to be printed. All of these sub-dialogs are considered part of the DtPrintSetupBox() widget, and as such, there is no external API for them.

Although DtPrintSetupBox() is designed primarily for X printing, it is also designed for use as a general application print dialog for use in any CDEnext application that provides printing. DtPrintSetupBox() is also designed to allow simple integration with the Print Dialog Manager, which provides additional printer and spooler specific X printing setup dialogs.

The remaining sections of this chapter document the DtPrint convenience functions, the DtPrint Dialog Manager, and how to integrate help with the printing widgets.

Chapter 11 CDE Printing Widgets and APIs

Technical documentation

» Table of Contents

» Glossary

» Index