Edit

How to: Capture User Input from a PrintDialog at Run Time

  • Article

While you can set options related to printing at design time, you will sometimes want to change these options at run time, most likely because of choices made by the user. You can capture user input for printing a document using the PrintDialog and the PrintDocument components.

To change print options programmatically

  1. Add a PrintDialog and a PrintDocument component to your form.

  2. Set the Document property of the PrintDialog to the PrintDocument added to the form.

    PrintDialog1.Document = PrintDocument1  

    printDialog1.Document = PrintDocument1;  

    printDialog1->Document = PrintDocument1;

  3. Display the PrintDialog component by using the ShowDialog method.

    PrintDialog1.ShowDialog()  

    printDialog1.ShowDialog();  

    printDialog1->ShowDialog();

  4. The user's printing choices from the dialog will be copied to the PrinterSettings property of the PrintDocument component.

See also