PrintDocument.QueryPageSettings Zdarzenie

Definicja

Występuje bezpośrednio przed każdym PrintPage zdarzeniem.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 

Typ zdarzenia

QueryPageSettingsEventHandler

Przykłady

Poniższy przykład kodu drukuje dokument z pierwszą stroną w kolorze, jeśli drukarka je obsługuje.The following code example prints a document with the first page in color, if the printer supports it. Przykład wymaga, aby PrintDocument zmienna o nazwie printDoc została utworzona, a PrintPage QueryPageSettings zdarzenia i są obsługiwane.The example requires that a PrintDocument variable named printDoc has been created, and the PrintPage and QueryPageSettings events are handled. currentPageNumberZmienna jest zwiększana po wydrukowaniu każdej strony w PrintPage zdarzeniu, która nie jest wyświetlana.The currentPageNumber variable is incremented after every page is printed in the PrintPage event, which is not shown.

Użyj System.Drawing System.Drawing.Printing przestrzeni nazw i dla tego przykładu.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

Uwagi

Istnieje możliwość drukowania każdej strony dokumentu przy użyciu różnych ustawień strony.It is possible to print each page of a document using different page settings. Ustawienia strony są ustawiane przez modyfikację poszczególnych właściwości QueryPageSettingsEventArgs.PageSettings właściwości lub przez ustawienie właściwości na PageSettings .You set page settings by modifying individual properties of the QueryPageSettingsEventArgs.PageSettings property or by setting the property to a PageSettings. Zmiany wprowadzone w PageSettings stronie dotyczy tylko bieżącej strony, a nie domyślne ustawienia strony dokumentu.Changes made to the PageSettings affect only the current page, not the document's default page settings. Zadanie drukowania można także anulować przez ustawienie Cancel właściwości na true wartość QueryPageSettingsEventArgs .The print job can also be canceled by setting the Cancel property to true for the QueryPageSettingsEventArgs.

Aby skojarzyć zdarzenie z programem obsługi zdarzeń, Dodaj wystąpienie QueryPageSettingsEventHandler delegata do zdarzenia.To associate the event with your event handler, add an instance of the QueryPageSettingsEventHandler delegate to the event. Procedura obsługi zdarzeń jest wywoływana za każdym razem, gdy wystąpi zdarzenie.The event handler is called whenever the event occurs. Aby uzyskać więcej informacji na temat obsługi zdarzeń z delegatami, zobacz Obsługa iwywoływanie zdarzeń.For more information about handling events with delegates, see Handling and Raising Events.

W przypadku użycia QueryPageSettings zdarzenia w celu zmodyfikowania ustawień drukarki wydajność PrintPreviewDialog kontrolki nie zostanie zwiększona nawet po ustawieniu przełącznika konfiguracji optymalizacji.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. Aby uzyskać więcej informacji, zobacz PrintPreviewDialog Control — Omówienie.For more information, see PrintPreviewDialog control overview.

Dotyczy

Zobacz też