PrintDocument::DefaultPageSettings Property

.NET Framework (current version)
 

Gets or sets page settings that are used as defaults for all pages to be printed.

Namespace:   System.Drawing.Printing
Assembly:  System.Drawing (in System.Drawing.dll)

C#
C++
F#
VB
Copy 
public:
[BrowsableAttribute(false)]
property PageSettings^ DefaultPageSettings {
	PageSettings^ get();
	void set(PageSettings^ value);
}

Property Value

Type: System.Drawing.Printing::PageSettings^

A PageSettings that specifies the default page settings for the document.

You can specify several default page settings through the DefaultPageSettings property. For example, the PageSettings::Color property specifies whether the page prints in color, the PageSettings::Landscape property specifies landscape or portrait orientation, and the PageSettings::Margins property specifies the margins of the page.

To specify settings on a page-by-page basis, handle the PrintPage or QueryPageSettings event and modify the PageSettings argument included in the PrintPageEventArgs or QueryPageSettingsEventArgs, respectively.

System_CAPS_noteNote

After printing has started, changes to page settings through the DefaultPageSettings property will not affect pages being printed.

The following code example sets a document's page orientation to landscape, and prints the document. The example makes three assumptions: that a variable named filePath has been set to the path of the file to print; that a method named pd_PrintPage, which handles the PrintPage event, has been defined; and that a variable named printer has been set to the printer's name.

Use the System.Drawing, System.Drawing.Printing, and System.IO namespaces for this example.

C#
C++
VB
Copy 
public:
   void Printing()
   {
      try
      {
         streamToPrint = gcnew StreamReader( filePath );
         try
         {
            printFont = gcnew System::Drawing::Font( "Arial",10 );
            PrintDocument^ pd = gcnew PrintDocument;
            pd->PrintPage += gcnew PrintPageEventHandler(
               this, &Form1::pd_PrintPage );
            pd->PrinterSettings->PrinterName = printer;
            // Set the page orientation to landscape.
            pd->DefaultPageSettings->Landscape = true;
            pd->Print();
         }
         finally
         {
            streamToPrint->Close();
         }
      }
      catch ( Exception^ ex ) 
      {
         MessageBox::Show( ex->Message );
      }
   }

.NET Framework
Available since 1.1
Return to top
Show: