PrintForm.Print - метод (Form, PrintForm.PrintOption)

Статья
11/05/2008

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

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

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

Синтаксис

'Декларация
Public Sub Print ( _
    printForm As Form, _
    printFormOption As PrintForm..::.PrintOption _
)
'Применение
Dim instance As PrintForm
Dim printForm As Form
Dim printFormOption As PrintForm..::.PrintOption

instance.Print(printForm, printFormOption)

public void Print(
    Form printForm,
    PrintForm..::.PrintOption printFormOption
)

public:
void Print(
    Form^ printForm, 
    PrintForm..::.PrintOption printFormOption
)

public function Print(
    printForm : Form, 
    printFormOption : PrintForm..::.PrintOption
)

Параметры

printForm
Тип: System.Windows.Forms.Form
Имя печатаемой формы Form.

printFormOption
Тип: Microsoft.VisualBasic.PowerPacks.Printing.PrintForm.PrintOption
Перечисление PrintForm.PrintOption, определяющее порядок печати формы.

Заметки

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

Если форма, заданная параметром printForm, не имеет фокуса, и параметр PrintOption задан либо как CompatibleModeClientAreaOnly, либо как CompatibleModeFullWindow, то возникает исключение. Если в качестве параметра PrintOption задано значение ClientAreaOnly, FullWindow или Scrollable, то может быть указано любая форма в приложении, даже если у нее нет фокуса.

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

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

По умолчанию на печать отправляется только клиентская область формы. Если требуется включить в печатаемое изображение полосы прокрутки, заголовок и границы, то в качестве параметра PrintOption следует задать значение CompatibleModeFullWindow или FullWindow.

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

Если требуется напечатать форму в ее изначальном размере, в качестве параметра PrintOption следует задать значение Scrollable.

Для печати метод Print использует одну из двух базовых реализаций. Используемая реализация определяется параметром PrintOption. Если данный параметр имеет значение CompatibleModeClientAreaOnly или CompatibleModeFullWindow, то используется реализация, обратно совместимая с методом PrintForm из Visual Basic 6.0. Если этот параметр имеет значение ClientAreaOnly, FullWindow или Scrollable, то используется другая реализация, не требующая, чтобы форма имела фокус.

Примечание.
В некоторых операционных системах текст и графика, созданные при помощи методов Graphics, могут отображаться некорректно. Кроме того, если задать в качестве параметра PrintOption значение ClientAreaOnly, FullWindow или Scrollable, то, возможно, потребуется вызвать метод Refresh формы сразу после вызова Print. Если этого не сделать, на форме могут появиться артефакты.

В некоторых операционных системах текст и графика, созданные при помощи методов Graphics, могут отображаться некорректно. Кроме того, если задать в качестве параметра PrintOption значение ClientAreaOnly, FullWindow или Scrollable, то, возможно, потребуется вызвать метод Refresh формы сразу после вызова Print. Если этого не сделать, на форме могут появиться артефакты.

Примеры

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

PrintForm1.PrintAction = Printing.PrintAction.PrintToPrinter
PrintForm1.Print(Me, ClientAreaOnly)
Me.Refresh

Разрешения

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