如何：建立標準的 Windows Form 列印工作

發行項
09/27/2024

Windows Forms 中列印的基礎是 PrintDocument 元件 — 更具體來說，是 PrintPage 事件。藉由撰寫程式碼來處理 PrintPage 事件，您可以指定要列印的內容，以及如何列印這些內容。

建立列印作業

將 PrintDocument 元件新增至表單。
撰寫程式碼來處理 PrintPage 事件。

您必須撰寫自己的列印邏輯程式碼。此外，您必須指定要列印的材料。

在下列程式碼範例中，PrintPage 事件處理常式中會建立紅色矩形圖形的範例圖形，做為要列印的材料。
```
Private Sub PrintDocument1_PrintPage(ByVal sender As Object, ByVal e As System.Drawing.Printing.PrintPageEventArgs) Handles PrintDocument1.PrintPage  
   e.Graphics.FillRectangle(Brushes.Red, New Rectangle(500, 500, 500, 500))  
End Sub  
```
```
private void printDocument1_PrintPage(object sender,
System.Drawing.Printing.PrintPageEventArgs e)  
{  
   e.Graphics.FillRectangle(Brushes.Red,
     new Rectangle(500, 500, 500, 500));  
}  
```
```
private:  
   void printDocument1_PrintPage(System::Object ^ sender,  
      System::Drawing::Printing::PrintPageEventArgs ^ e)  
   {  
      e->Graphics->FillRectangle(Brushes::Red,  
         Rectangle(500, 500, 500, 500));  
   }  
```
(Visual C# 和 Visual C++) 將下列程式碼放在表單的建構函式中，以註冊事件處理常式。
```
this.printDocument1.PrintPage += new  
   System.Drawing.Printing.PrintPageEventHandler  
   (this.printDocument1_PrintPage);  
```
```
printDocument1->PrintPage += gcnew  
   System::Drawing::Printing::PrintPageEventHandler  
   (this, &Form1::printDocument1_PrintPage);  
```
您可能也想要撰寫 BeginPrint 和 EndPrint 事件的程式碼，其中或許包含一個整數，代表要列印的總頁數，每列印一頁時，會將其減一。

注意

您可以將 PrintDialog 元件新增至表單，為您的使用者提供全新且有效率的使用者介面 (UI)。設定 PrintDialog 元件的 Document 屬性，可讓您設定與表單上所使用的列印文件相關的屬性。如需 PrintDialog 元件的詳細資訊，請參閱 PrintDialog 元件。

如需 Windows Forms 列印作業的詳細資訊，包括如何以程式設計方式建立列印作業，請參閱 PrintPageEventArgs。

共用方式為

如何：建立標準的 Windows Form 列印工作

建立列印作業

另請參閱

其他資源