다음을 통해 공유


방법: Windows Forms 애플리케이션에서 인쇄 미리 보기 표시

PrintPreviewDialog 컨트롤을 사용하여 문서를 인쇄하기 전에 사용자가 문서를 표시할 수 있습니다.

이를 위해서는 PrintDocument 클래스의 인스턴스(인쇄할 문서)를 지정해야 합니다. PrintDocument 구성 요소에서 인쇄 미리 보기를 사용하는 방법에 대한 자세한 내용은 방법: Windows Forms에서 인쇄 미리 보기를 사용하여 인쇄를 참조하세요.

참고

런타임에 PrintPreviewDialog 컨트롤을 사용하려면 로컬에 또는 네트워크를 통해 컴퓨터에 프린터가 설치되어 있어야 합니다. 이는 PrintPreviewDialog 구성 요소가 인쇄할 때 문서의 모양을 결정하는 방식입니다.

PrintPreviewDialog 컨트롤은 PrinterSettings 클래스를 사용합니다. 또한 PrintPreviewDialog 컨트롤은 PrintPreviewDialog 구성 요소와 마찬가지로 PageSettings 클래스를 사용합니다. PrintPreviewDialog 컨트롤의 Document 속성에 지정된 인쇄 문서는 PrinterSettings 클래스 및 PageSettings 클래스의 인스턴스를 참조하며 미리 보기 창에서 문서를 렌더링하는 데 사용됩니다.

PrintPreviewDialog 컨트롤을 사용하여 페이지를 보려면

  • ShowDialog 메서드를 사용하여 대화 상자를 표시하고, 사용할 PrintDocument 를 지정합니다.

    다음 코드 예에는 Button 컨트롤의 Click 이벤트 처리기가 PrintPreviewDialog 컨트롤의 인스턴스를 엽니다. 인쇄 문서가 Document 속성에 지정됩니다. 아래 예에서는 인쇄 문서가 지정되지 않았습니다.

    이 예에서는 폼에 Button 컨트롤, PrintDocument 구성 요소(myDocument) 및 PrintPreviewDialog 컨트롤이 있다고 가정합니다.

    Private Sub Button1_Click(ByVal sender As System.Object, _  
       ByVal e As System.EventArgs) Handles Button1.Click  
       ' The print document 'myDocument' used below  
       ' is merely for an example.  
       ' You will have to specify your own print document.  
       PrintPreviewDialog1.Document = myDocument  
       PrintPreviewDialog1.ShowDialog()  
    End Sub  
    
    private void button1_Click(object sender, System.EventArgs e)  
    {  
       // The print document 'myDocument' used below  
       // is merely for an example.  
       // You will have to specify your own print document.  
       printPreviewDialog1.Document = myDocument;  
       printPreviewDialog1.ShowDialog();  
    }  
    
    private:  
       void button1_Click(System::Object ^ sender,  
          System::EventArgs ^ e)  
       {  
          // The print document 'myDocument' used below  
          // is merely for an example.  
          // You will have to specify your own print document.  
          printPreviewDialog1->Document = myDocument;  
          printPreviewDialog1->ShowDialog();  
       }  
    

    (Visual C#, Visual C++) 양식 생성자에 다음 코드를 추가하여 이벤트 처리기를 등록합니다.

    this.button1.Click += new System.EventHandler(this.button1_Click);  
    
    this->button1->Click += gcnew  
       System::EventHandler(this, &Form1::button1_Click);  
    

참고 항목