PrintForm 구성 요소(Visual Basic)
업데이트: 2007년 11월
Visual Basic 2008의 PrintForm 구성 요소를 사용하면 런타임에 Windows Form 이미지를 인쇄할 수 있습니다. 이 구성 요소의 동작은 이전 버전의 Visual Basic에서 사용되던 PrintForm 메서드의 동작을 대신합니다.
PrintForm 구성 요소 개요
Windows Forms을 사용하는 일반적인 시나리오는 문서 양식 또는 보고서와 유사하게 서식이 지정된 폼을 만든 후 해당 폼의 이미지를 인쇄하는 것입니다. PrintDocument 구성 요소를 사용하여 이 작업을 수행할 수도 있지만 그러려면 상당히 많은 코드를 작성해야 합니다. PrintForm 구성 요소를 사용하면 PrintDocument 구성 요소를 사용하지 않고도 폼의 이미지를 프린터, 인쇄 미리 보기 창 또는 파일로 인쇄할 수 있습니다.
PrintForm 구성 요소는 도구 상자의 Visual Basic PowerPacks 탭에 있습니다. 이 구성 요소는 폼에 끌어 오면 폼의 아래쪽 테두리 아래의 작은 영역을 지칭하는 구성 요소 트레이에 나타납니다. 구성 요소를 선택하면 이 구성 요소의 동작을 정의하는 속성을 속성 창에서 설정할 수 있습니다. 이 창에 표시되는 모든 속성은 코드에서 직접 설정할 수도 있습니다. 디자인 타임에 구성 요소를 추가할 필요 없이 코드를 작성할 때 PrintForm 구성 요소의 인스턴스를 만들 수도 있습니다.
폼을 인쇄하면 폼의 클라이언트 영역에 있는 모든 요소가 인쇄됩니다. 여기에는 모든 컨트롤 및 그래픽 메서드를 사용하여 폼에 그린 모든 텍스트나 그래픽이 포함됩니다. 그러나 폼의 제목 표시줄, 스크롤 막대 및 테두리는 기본적으로 인쇄되지 않습니다. 또한 기본적으로 PrintForm 구성 요소는 폼에 보이는 부분만 인쇄합니다. 예를 들어 런타임에 사용자가 폼의 크기를 조정한 경우 현재 화면에 보이는 컨트롤과 그래픽만 인쇄됩니다.
PrintForm 구성 요소가 사용하는 기본 프린터는 운영 체제의 제어판 설정에 따라 결정됩니다.
인쇄 작업이 초기화되면 표준 PrintDocument 인쇄 대화 상자가 표시됩니다. 이 대화 상자에서 인쇄 작업을 취소할 수 있습니다.
주요 메서드, 속성 및 이벤트
PrintForm 구성 요소의 주요 메서드는 폼 이미지를 프린터, 인쇄 미리 보기 창 또는 파일로 인쇄하는 Print 메서드입니다. Print 메서드는 다음과 같은 두 가지 버전으로 사용할 수 있습니다.
매개 변수를 사용하지 않는 기본 버전: Print()
인쇄 동작을 지정하는 매개 변수를 사용하는 오버로드된 버전: Print(printForm As Form, printFormOption As PrintOption)
오버로드된 메서드의 PrintOption 매개 변수는 폼을 인쇄하는 데 사용되는 기본 구현, 폼의 제목 표시줄, 스크롤 막대, 테두리 등을 인쇄할지 여부 및 폼의 스크롤 가능한 부분을 인쇄할지 여부를 결정합니다.
PrintAction 속성은 PrintForm 구성 요소의 주요 속성입니다. 이 속성은 출력을 프린터에 보낼지, 인쇄 미리 보기 창에 표시할지 또는 EPS(Encapsulated PostScript) 파일로 저장할지 결정합니다. PrintAction 속성을 PrintToFile로 설정하는 경우 PrintFileName 속성에 경로와 파일 이름을 지정합니다.
PrinterSettings 속성을 사용하면 사용할 프린터 및 인쇄할 매수 같은 설정을 지정할 수 있는 기본 PrinterSettings 개체에 액세스할 수 있을 뿐만 아니라 색상이나 양면 인쇄 같은 프린터의 기능을 쿼리할 수도 있습니다. 이 속성은 속성 창에 나타나지 않으므로 코드에서만 설정할 수 있습니다.
Form 속성은 PrintForm 구성 요소를 프로그래밍 방식으로 호출할 경우 인쇄할 폼을 지정하는 데 사용됩니다. 디자인 타임에 구성 요소를 폼에 추가한 경우에는 해당 폼이 기본적으로 인쇄됩니다.
PrintForm 구성 요소의 주요 이벤트는 다음과 같습니다.
BeginPrint 이벤트. Print 메서드가 호출된 후 문서의 첫 페이지가 인쇄되기 전에 발생합니다.
EndPrint 이벤트. 마지막 페이지가 인쇄된 후에 발생합니다.
QueryPageSettings 이벤트. 각 페이지가 인쇄되기 바로 전에 발생합니다.
설명
Graphics 메서드를 사용하여 그린 텍스트나 그래픽이 폼에 포함된 경우에는 기본 Print(Print()) 메서드를 사용하여 폼을 인쇄해야 합니다. 오버로드된 Print 메서드를 사용하면 일부 운영 체제에서 그래픽이 렌더링되지 않을 수 있습니다.
폼의 너비가 프린터에 있는 용지의 너비보다 크면 폼의 오른쪽이 잘릴 수 있습니다. 따라서 폼을 인쇄용으로 디자인할 때는 표준 용지 크기에 맞게 만들어야 합니다.
예제
다음 예제에서는 PrintForm 구성 요소의 일반적인 사용 방법을 보여 줍니다.
' Visual Basic.
Dim pf As New PrintForm
pf.Form = Me
pf.PrintAction = PrintToPrinter
pf.Print()
참고 항목
작업
방법: PrintForm 구성 요소를 사용하여 폼 인쇄(Visual Basic)
방법: 폼의 클라이언트 영역 인쇄(Visual Basic)
방법: 폼의 클라이언트 영역 및 비클라이언트 영역 인쇄(Visual Basic)