QueryPageSettingsEventArgs Class
Provides data for the QueryPageSettings event.
System.EventArgs
System.ComponentModel.CancelEventArgs
System.Drawing.Printing.PrintEventArgs
System.Drawing.Printing.QueryPageSettingsEventArgs
Namespace: System.Drawing.Printing
Assembly: System.Drawing (in System.Drawing.dll)
The QueryPageSettingsEventArgs type exposes the following members.
| Name | Description | |
|---|---|---|
![]() | QueryPageSettingsEventArgs | Initializes a new instance of the QueryPageSettingsEventArgs class. |
| Name | Description | |
|---|---|---|
![]() | Cancel | Gets or sets a value indicating whether the event should be canceled. (Inherited from CancelEventArgs.) |
![]() | PageSettings | Gets or sets the page settings for the page to be printed. |
![]() | PrintAction | Returns PrintToFile in all cases. (Inherited from PrintEventArgs.) |
| Name | Description | |
|---|---|---|
![]() | Equals(Object) | Determines whether the specified object is equal to the current object. (Inherited from Object.) |
![]() | Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) |
![]() | GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
![]() | GetType | Gets the Type of the current instance. (Inherited from Object.) |
![]() | MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
![]() | ToString | Returns a string that represents the current object. (Inherited from Object.) |
It is possible to print each page of a document using different page settings. You set page settings by modifying individual properties of the PageSettings property or by setting the property to a PageSettings. The print job can also be canceled by setting the Cancel property to true.
The following code example prints a document with the first page in color, if the printer supports it. The example assumes 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; } } }
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.


