QueryPageSettingsEventArgs Clase

Definición

Proporciona datos para el evento QueryPageSettings.Provides data for the QueryPageSettings event.

public ref class QueryPageSettingsEventArgs : System::Drawing::Printing::PrintEventArgs
public class QueryPageSettingsEventArgs : System.Drawing.Printing.PrintEventArgs
type QueryPageSettingsEventArgs = class
    inherit PrintEventArgs
Public Class QueryPageSettingsEventArgs
Inherits PrintEventArgs
Herencia
QueryPageSettingsEventArgs

Ejemplos

En el ejemplo de código siguiente se imprime un documento con la primera página en color, si la impresora lo admite.The following code example prints a document with the first page in color, if the printer supports it. En el ejemplo se da PrintDocument por supuesto printDoc que se ha creado una variable PrintPage denominada QueryPageSettings y se controlan los eventos y.The example assumes that a PrintDocument variable named printDoc has been created, and the PrintPage and QueryPageSettings events are handled.

Use los System.Drawing espacios System.Drawing.Printing de nombres y para este ejemplo.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" );
      }
   }

   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;
         }
      }
   }

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;
        }

    }    
}

Private Sub MyButtonPrint_OnClick(ByVal sender As Object, ByVal e As System.EventArgs)

    ' 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 Then

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

            ' Set the page default's to not print in color.
            printDoc.DefaultPageSettings.Color = False
        End If

        ' 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")
    End If
End Sub

Private Sub MyPrintQueryPageSettingsEvent(ByVal sender As Object, ByVal e As QueryPageSettingsEventArgs)

    ' Determines if the printer supports printing in color.
    If printDoc.PrinterSettings.SupportsColor Then

        ' If the printer supports color printing, use color.
        If currentPageNumber = 1 Then

            e.PageSettings.Color = True
        End If

    End If
End Sub

Comentarios

Es posible imprimir cada página de un documento con una configuración de página diferente.It is possible to print each page of a document using different page settings. Establezca la configuración de la página modificando las propiedades individuales PageSettings de la propiedad o estableciendo la propiedad PageSettingsen.You set page settings by modifying individual properties of the PageSettings property or by setting the property to a PageSettings. También se puede cancelar el trabajo de impresión estableciendo la Cancel propiedad en. trueThe print job can also be canceled by setting the Cancel property to true.

Constructores

QueryPageSettingsEventArgs(PageSettings)

Inicializa una nueva instancia de la clase QueryPageSettingsEventArgs.Initializes a new instance of the QueryPageSettingsEventArgs class.

Propiedades

Cancel

Obtiene o establece un valor que indica si se debe cancelar el evento.Gets or sets a value indicating whether the event should be canceled.

(Heredado de CancelEventArgs)
PageSettings

Obtiene o establece la configuración de la página que se va a imprimir.Gets or sets the page settings for the page to be printed.

PrintAction

Devuelve PrintToFile en todos los casos.Returns PrintToFile in all cases.

(Heredado de PrintEventArgs)

Métodos

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Se aplica a

Consulte también: