QueryPageSettingsEventArgs Класс

Определение

Пространство имен:

System.Drawing.Printing

Сборка:

System.Drawing.Common.dll

Пакет:

System.Drawing.Common v8.0.0

Исходный код:

QueryPageSettingsEventArgs.cs

Предоставляет данные о событии QueryPageSettings.

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

Наследование

Object

EventArgs

CancelEventArgs

PrintEventArgs

QueryPageSettingsEventArgs

Примеры

В следующем примере кода документ выводится с первой цветной страницей, если принтер поддерживает его. В примере предполагается, что PrintDocument была создана переменная с именем printDoc и PrintPage обрабатываются события и QueryPageSettings .

В этом примере используйте System.Drawing пространства имен и 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

Комментарии

Каждую страницу документа можно распечатать с помощью разных параметров страницы. Параметры страницы задаются путем изменения отдельных PageSettings свойств свойства или путем присвоения свойству значения PageSettings. Задание печати также можно отменить, задав свойству Cancel значение true.

Конструкторы

QueryPageSettingsEventArgs(PageSettings)

Инициализирует новый экземпляр класса QueryPageSettingsEventArgs.

Свойства

Cancel	Возвращает или задает значение, показывающее, следует ли отменить событие. (Унаследовано от CancelEventArgs)
PageSettings	Получает или задает параметры выводимой на печать страницы.
PrintAction	Возвращает значение PrintToFile во всех случаях. (Унаследовано от PrintEventArgs)

Методы

Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

См. также раздел

• PrintDocument
• OnQueryPageSettings(QueryPageSettingsEventArgs)
• QueryPageSettings
• QueryPageSettingsEventHandler