PrintForm.Print - метод

Статья
11/05/2008

Обновлен: Ноябрь 2007

Осуществляет передачу изображения формы Windows Forms в соответствии со значением свойства PrintAction.

Пространство имен: Microsoft.VisualBasic.PowerPacks.Printing
Сборка: Microsoft.VisualBasic.PowerPacks.Vs (в Microsoft.VisualBasic.PowerPacks.Vs.dll)

Синтаксис

'Декларация
Public Sub Print
'Применение
Dim instance As PrintForm

instance.Print()

public void Print()

public:
void Print()

public function Print()

Заметки

Метод Print отправляет на печать все видимые объекты, расположенные на форме. К ним относится текст и графика, отображаемые при помощи методов Graphics.

По умолчанию на печать отправляется только клиентская область формы. Если пользователь изменил размер формы во время выполнения, на печать отправляется только видимая в данный момент часть формы. Если форма была перемещена таким образом, что на экране видна только ее часть, она будет напечатана так, как если бы форма была видна целиком. Для изменения поведения по умолчанию используется перегруженный объект Print.

Метод Print обратно совместим с методом PrintForm из Visual Basic 6.0.

Примечание.
С помощью этого метода можно напечатать только ту форму, которая в настоящий момент имеет фокус. Если перед вызовом данного метода указать в свойстве Form другую форму, то отрисованное изображение формы может отличаться от ожидаемого. Во избежание этого перед вызовом Print рекомендуется вызвать метод Focus формы.

С помощью этого метода можно напечатать только ту форму, которая в настоящий момент имеет фокус. Если перед вызовом данного метода указать в свойстве Form другую форму, то отрисованное изображение формы может отличаться от ожидаемого. Во избежание этого перед вызовом Print рекомендуется вызвать метод Focus формы.

Примеры

В следующем примере показана печать текущей формы на принтере по умолчанию, при этом печатается только видимая часть клиентской области. В данном примере в форме требуется наличие компонента PrintForm с именем PrintForm1.

PrintForm1.PrintAction = Printing.PrintAction.PrintToPrinter
PrintForm1.Print()

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.