PrintDocument.QueryPageSettings Zdarzenie
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
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).
