PrintDocument.QueryPageSettings Zdarzenie

Definicja

Przestrzeń nazw:

System.Drawing.Printing

Zestaw:

System.Drawing.Common.dll

Pakiet:

System.Drawing.Common v8.0.0

Źródło:

PrintDocument.cs

Występuje bezpośrednio przed każdym PrintPage zdarzeniem.

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 go obsługuje. Przykład wymaga PrintDocument utworzenia zmiennej o nazwie printDoc , a PrintPage zdarzenia i QueryPageSettings są obsługiwane. Zmienna currentPageNumber jest zwiększana po wydrukowaniu PrintPage każdej strony w zdarzeniu, które nie jest wyświetlane.

W tym przykładzie System.Drawing użyj przestrzeni nazw i System.Drawing.Printing .

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

Można wydrukować każdą stronę dokumentu przy użyciu różnych ustawień strony. Ustawienia strony można ustawić, modyfikując poszczególne właściwości QueryPageSettingsEventArgs.PageSettings właściwości lub ustawiając właściwość na PageSettingswartość . Zmiany wprowadzone PageSettings tylko na bieżącej stronie, a nie domyślne ustawienia strony dokumentu. Zadanie drukowania można również anulować, ustawiając Cancel właściwość na true wartość .QueryPageSettingsEventArgs

Aby skojarzyć zdarzenie z programem obsługi zdarzeń, dodaj wystąpienie QueryPageSettingsEventHandler delegata do zdarzenia. Procedura obsługi zdarzeń jest wywoływana za każdym razem, gdy wystąpi zdarzenie. Aby uzyskać więcej informacji na temat obsługi zdarzeń za pomocą delegatów, zobacz Obsługa i podnoszenie zdarzeń.

Jeśli używasz zdarzenia QueryPageSettings do modyfikowania ustawień drukarki, wydajność PrintPreviewDialog kontrolki nie poprawi się nawet w przypadku ustawienia przełącznika konfiguracji optymalizacji. Aby uzyskać więcej informacji, zobacz PrintPreviewDialog control overview (Omówienie kontrolki PrintPreviewDialog).

Zobacz też

• QueryPageSettingsEventHandler
• PrintPageEventArgs
• BeginPrint
• EndPrint
• PrintPage