PrintDocument.QueryPageSettings Событие
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Происходит непосредственно перед каждым событием PrintPage.
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 Тип события
Примеры
В следующем примере кода документ выводится с первой цветной страницей, если принтер поддерживает его. В этом примере требуется, чтобы PrintDocument была создана переменная с именем printDoc и PrintPage были обработаны события и QueryPageSettings . Переменная currentPageNumber увеличивается после печати каждой страницы в событии PrintPage , которое не отображается.
В этом примере используйте 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
Комментарии
Каждую страницу документа можно распечатать с помощью разных параметров страницы. Параметры страницы задаются путем изменения отдельных QueryPageSettingsEventArgs.PageSettings свойств свойства или путем присвоения свойству значения PageSettings. Изменения, внесенные в , PageSettings затрагивают только текущую страницу, а не параметры страницы документа по умолчанию. Задание печати также можно отменить, задав свойству Cancel значение true для QueryPageSettingsEventArgs.
Чтобы связать событие с обработчиком событий, добавьте экземпляр делегата QueryPageSettingsEventHandler в событие . Обработчик событий вызывается при каждом возникновении события. Дополнительные сведения об обработке событий с помощью делегатов см. в разделе Обработка и вызов событий.
Если вы используете QueryPageSettings событие для изменения параметров принтера, производительность PrintPreviewDialog элемента управления не улучшится, даже если задан параметр конфигурации оптимизации. Дополнительные сведения см. в статье Общие сведения об элементе управления PrintPreviewDialog.
