PrintDialog 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
從 Windows Form 應用程式列印時，可讓使用者選取印表機，並且選擇要列印的文件區段。
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 Forms 列印的詳細資訊，請參閱 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 Home Edition、Windows XP Professional、Windows Server 2003 或更新版本的系統是否應該以 Windows XP 樣式顯示對話方塊。 |
方法
事件
| Disposed |
當 Dispose() 方法的呼叫處置元件時，就會發生。 (繼承來源 Component) |
| HelpRequest |
發生於使用者按一下通用對話方塊上的 [說明] 按鈕時。 (繼承來源 CommonDialog) |
