---
name: "Prima::PrintDialog"
section: "3"
platform: "linux"
package: "libprima-perl"
version: "1.28-1.3+b3"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/Prima::PrintDialog"
---

# Prima::PrintDialog(3)

standard printer setup dialog

## NAME

Prima::PrintDialog - standard printer setup dialog

## DESCRIPTION

Provides a standard dialog that allows the user to select a printer and its options. The toolkit does not provide the in-depth management of the printer options; this can only be accessed by executing a printer-specific setup window, called by `"Prima::Printer::setup_dialog"`. The class invokes this method when the user presses 'Properties' button. Otherwise, the class provides only selection of a printer from the printer list.

When the dialog finished successfully, the selected printer is set as the current by writing to `"Prima::Printer::printer"` property. This technique allows direct use of the user-selected printer and its properties without prior knowledge of the selection process.

## SYNOPSIS

```
        use Prima::PrintDialog;
        $dlg = Prima::PrintSetupDialog-> create;
        if ( $dlg-> execute) {
                my $p = $::application-> get_printer;
                if ( $p-> begin_doc ) {
                        $p-> text_out( 'Hello world', 10, 10);
                        $p-> end_doc;
                }
        }
        $dlg-> destroy;
```

## AUTHOR

Dmitry Karasik, \<dmitry@karasik.eu.org\>.

## SEE ALSO

Prima, Prima::Window, Prima::Printer.