PrintDocument.QueryPageSettings Evento

Definizione

Si verifica immediatamente prima di ogni evento PrintPage.Occurs immediately before each PrintPage event.

public:
 event System::Drawing::Printing::QueryPageSettingsEventHandler ^ QueryPageSettings;
public event System.Drawing.Printing.QueryPageSettingsEventHandler QueryPageSettings;
member this.QueryPageSettings : System.Drawing.Printing.QueryPageSettingsEventHandler 
Public Custom Event QueryPageSettings As QueryPageSettingsEventHandler 

Esempi

Nell'esempio di codice seguente viene stampato un documento con la prima pagina di colore, se supportata dalla stampante.The following code example prints a document with the first page in color, if the printer supports it. Per l'esempio è necessario PrintDocument che sia printDoc PrintPage stata creata una variabile denominata e che QueryPageSettings siano gestiti gli eventi e.The example requires that a PrintDocument variable named printDoc has been created, and the PrintPage and QueryPageSettings events are handled. La currentPageNumber variabile viene incrementata dopo la PrintPage stampa di ogni pagina nell'evento, che non viene visualizzata.The currentPageNumber variable is incremented after every page is printed in the PrintPage event, which is not shown.

Usare gli System.Drawing spazi System.Drawing.Printing dei nomi e per questo esempio.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

Commenti

È possibile stampare ogni pagina di un documento usando impostazioni di pagina diverse.It is possible to print each page of a document using different page settings. È possibile impostare le impostazioni di pagina modificando singole QueryPageSettingsEventArgs.PageSettings proprietà della proprietà o impostando la proprietà PageSettingssu un oggetto.You set page settings by modifying individual properties of the QueryPageSettingsEventArgs.PageSettings property or by setting the property to a PageSettings. Le modifiche apportate a PageSettings influiscono solo sulla pagina corrente, non sulle impostazioni di pagina predefinite del documento.Changes made to the PageSettings affect only the current page, not the document's default page settings. È inoltre possibile annullare il processo di stampa impostando Cancel la proprietà true su per QueryPageSettingsEventArgs.The print job can also be canceled by setting the Cancel property to true for the QueryPageSettingsEventArgs.

Per associare l'evento al gestore eventi, aggiungere un'istanza del QueryPageSettingsEventHandler delegato all'evento.To associate the event with your event handler, add an instance of the QueryPageSettingsEventHandler delegate to the event. Il gestore eventi viene chiamato ogni volta che si verifica l'evento.The event handler is called whenever the event occurs. Per ulteriori informazioni sulla gestione degli eventi con i delegati, vedere gestione e generazione di eventi.For more information about handling events with delegates, see Handling and Raising Events.

Se si utilizza l' QueryPageSettings evento per modificare le impostazioni della stampante, le prestazioni PrintPreviewDialog del controllo non miglioreranno anche se è impostata un'opzione di configurazione dell'ottimizzazione.If you use the QueryPageSettings event to modify printer settings, the performance of the PrintPreviewDialog control will not improve even if an optimization configuration switch is set. Per ulteriori informazioni, vedere Cenni preliminari sul controllo PrintPreviewDialog.For more information, see PrintPreviewDialog control overview.

Si applica a

Vedi anche