PrintDialog 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
允许用户从 Windows 窗体应用程序中选择一台打印机，并选择文档中要打印的部分。
public ref class PrintDialog sealed : System::Windows::Forms::CommonDialogpublic sealed class PrintDialog : System.Windows.Forms.CommonDialogtype PrintDialog = class
inherit CommonDialogPublic NotInheritable Class PrintDialog
Inherits CommonDialog- 继承
示例
下面的代码示例演示如何使用 PrintDialog 控件设置 AllowSomePages、 ShowHelp和 Document 属性。 若要运行此示例，请将以下代码粘贴到包含 PrintDialog 名为 的 PrintDialog1 控件和名为 的按钮的 Button1窗体中。 此示例要求按钮的事件 Click 和 PrintPage 的事件 docToPrint 已连接到此示例中定义的事件处理方法。
// Declare the PrintDocument object.
System::Drawing::Printing::PrintDocument^ docToPrint;
// This method will set properties on the PrintDialog object and
// then display the dialog.
void Button1_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
// Allow the user to choose the page range he or she would
// like to print.
PrintDialog1->AllowSomePages = true;
// Show the help button.
PrintDialog1->ShowHelp = true;
// Set the Document property to the PrintDocument for
// which the PrintPage Event has been handled. To display the
// dialog, either this property or the PrinterSettings property
// must be set
PrintDialog1->Document = docToPrint;
if ( docToPrint == nullptr )
System::Windows::Forms::MessageBox::Show( "null" );
;
;
if ( PrintDialog1 == nullptr )
System::Windows::Forms::MessageBox::Show( "pnull" );
;
;
System::Windows::Forms::DialogResult result = PrintDialog1->ShowDialog();
System::Windows::Forms::MessageBox::Show( result.ToString() );
;
;
// If the result is OK then print the document.
if ( result == ::DialogResult::OK )
{
docToPrint->Print();
}
}
// The PrintDialog will print the document
// by handling the document's PrintPage event.
void document_PrintPage( Object^ /*sender*/, System::Drawing::Printing::PrintPageEventArgs^ e )
{
// Insert code to render the page here.
// This code will be called when the control is drawn.
// The following code will render a simple
// message on the printed document.
String^ text = "In document_PrintPage method.";
System::Drawing::Font^ printFont = gcnew System::Drawing::Font( "Arial",35,System::Drawing::FontStyle::Regular );
// Draw the content.
e->Graphics->DrawString( text, printFont, System::Drawing::Brushes::Black, 10, 10 );
}
// Declare the PrintDocument object.
private System.Drawing.Printing.PrintDocument docToPrint =
new System.Drawing.Printing.PrintDocument();
// This method will set properties on the PrintDialog object and
// then display the dialog.
private void Button1_Click(System.Object sender,
System.EventArgs e)
{
// Allow the user to choose the page range he or she would
// like to print.
PrintDialog1.AllowSomePages = true;
// Show the help button.
PrintDialog1.ShowHelp = true;
// Set the Document property to the PrintDocument for
// which the PrintPage Event has been handled. To display the
// dialog, either this property or the PrinterSettings property
// must be set
PrintDialog1.Document = docToPrint;
DialogResult result = PrintDialog1.ShowDialog();
// If the result is OK then print the document.
if (result==DialogResult.OK)
{
docToPrint.Print();
}
}
// The PrintDialog will print the document
// by handling the document's PrintPage event.
private void document_PrintPage(object sender,
System.Drawing.Printing.PrintPageEventArgs e)
{
// Insert code to render the page here.
// This code will be called when the control is drawn.
// The following code will render a simple
// message on the printed document.
string text = "In document_PrintPage method.";
System.Drawing.Font printFont = new System.Drawing.Font
("Arial", 35, System.Drawing.FontStyle.Regular);
// Draw the content.
e.Graphics.DrawString(text, printFont,
System.Drawing.Brushes.Black, 10, 10);
}
' Declare the PrintDocument object.
Private WithEvents docToPrint As New Printing.PrintDocument
' This method will set properties on the PrintDialog object and
' then display the dialog.
Private Sub Button1_Click(ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles Button1.Click
' Allow the user to choose the page range he or she would
' like to print.
PrintDialog1.AllowSomePages = True
' Show the help button.
PrintDialog1.ShowHelp = True
' Set the Document property to the PrintDocument for
' which the PrintPage Event has been handled. To display the
' dialog, either this property or the PrinterSettings property
' must be set
PrintDialog1.Document = docToPrint
Dim result As DialogResult = PrintDialog1.ShowDialog()
' If the result is OK then print the document.
If (result = DialogResult.OK) Then
docToPrint.Print()
End If
End Sub
' The PrintDialog will print the document
' by handling the document's PrintPage event.
Private Sub document_PrintPage(ByVal sender As Object, _
ByVal e As System.Drawing.Printing.PrintPageEventArgs) _
Handles docToPrint.PrintPage
' Insert code to render the page here.
' This code will be called when the control is drawn.
' The following code will render a simple
' message on the printed document.
Dim text As String = "In document_PrintPage method."
Dim printFont As New System.Drawing.Font _
("Arial", 35, System.Drawing.FontStyle.Regular)
' Draw the content.
e.Graphics.DrawString(text, printFont, _
System.Drawing.Brushes.Black, 10, 10)
End Sub
注解
创建 实例 PrintDialog时，读/写属性设置为初始值。 有关这些值的列表，请参阅 PrintDialog 构造函数。 若要获取用户通过 修改的打印机设置， PrintDialog请使用 PrinterSettings 属性。
有关使用 Windows 窗体 打印的详细信息，请参阅System.Drawing.Printing命名空间概述。 如果要从Windows Presentation Foundation应用程序打印，请参阅 System.Printing 命名空间。
构造函数
| PrintDialog() |
初始化 PrintDialog 类的新实例。 |
属性
| AllowCurrentPage |
获取或设置一个值，该值指示是否显示“当前页”选项按钮。 |
| AllowPrintToFile |
获取或设置一个值，该值指示是否启用“打印到文件”复选框。 |
| AllowSelection |
获取或设置一个值，该值指示是否启用“选择”选项按钮。 |
| AllowSomePages |
获取或设置一个值，该值指示是否启用“页”选项按钮。 |
| CanRaiseEvents |
获取一个指示组件是否可以引发事件的值。 (继承自 Component) |
| Container |
获取包含 IContainer 的 Component。 (继承自 Component) |
| DesignMode |
获取一个值，用以指示 Component 当前是否处于设计模式。 (继承自 Component) |
| Document |
获取或设置一个值，指示用于获取 PrintDocument 的 PrinterSettings。 |
| Events |
获取附加到此 Component 的事件处理程序的列表。 (继承自 Component) |
| PrinterSettings |
获取或设置对话框修改的打印机设置。 |
| PrintToFile |
获取或设置一个值，该值指示是否选中“打印到文件”复选框。 |
| ShowHelp |
获取或设置一个值，该值指示是否显示“帮助”按钮。 |
| ShowNetwork |
获取或设置一个值，该值指示是否显示“网络”按钮。 |
| Site | (继承自 Component) |
| Tag |
获取或设置一个对象，该对象包含控件的数据。 (继承自 CommonDialog) |
| UseEXDialog |
获取或设置一个值，该值指示对于运行 Windows XP 家庭版、Windows XP Professional、Windows Server 2003 或更高版本的系统，该对话框是否应以 Windows XP 样式显示。 |
方法
事件
| Disposed |
在通过调用 Dispose() 方法释放组件时发生。 (继承自 Component) |
| HelpRequest |
当用户单击通用对话框中的“帮助”按钮时发生。 (继承自 CommonDialog) |
