Export (0) Print
Expand All

PageSettings.Color Property

Gets or sets a value indicating whether the page should be printed in color.

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

public bool Color { get; set; }

Property Value

Type: System.Boolean
true if the page should be printed in color; otherwise, false. The default is determined by the printer.

ExceptionCondition
InvalidPrinterException

The printer named in the PrinterSettings.PrinterName property does not exist.

You can use the PrinterSettings.SupportsColor property to determine if the printer supports color printing. If the printer supports color, but you do not want to print in color, set the Color property to false. The default will be true.

The following code example prints a document with the first page in color, if the printer supports it. The example requires that a PrintDocument variable named printDoc has been created, and the PrintPage and QueryPageSettings events are handled.

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


private void MyButtonPrint_OnClick(object sender, System.EventArgs e)
{

    // Set the printer name and ensure it is valid. If not, provide a message to the user.
    printDoc.PrinterSettings.PrinterName = "\\mynetworkprinter";

    if (printDoc.PrinterSettings.IsValid) {

        // If the printer supports printing in color, then override the printer's default behavior. 
        if (printDoc.PrinterSettings.SupportsColor) {

            // Set the page default's to not print in color.
            printDoc.DefaultPageSettings.Color = false;
        }

        // Provide a friendly name, set the page number, and print the document.
        printDoc.DocumentName = "My Presentation";
        currentPageNumber = 1;
        printDoc.Print();
    }
    else {
        MessageBox.Show("Printer is not valid");
    }
}

private void MyPrintQueryPageSettingsEvent(object sender, QueryPageSettingsEventArgs e)
{
    // Determines if the printer supports printing in color. 
    if (printDoc.PrinterSettings.SupportsColor) {

        // If the printer supports color printing, use color. 
        if (currentPageNumber == 1 ) {

            e.PageSettings.Color = true;
        }

    }    
}

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft