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

Статья
05/17/2015

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

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

Синтаксис

'Декларация
Public Sub Print ( _
    form As Form, _
    printOption As PrintForm.PrintOption _
)

public void Print(
    Form form,
    PrintForm.PrintOption printOption
)

public:
void Print(
    Form^ form, 
    PrintForm::PrintOption printOption
)

member Print : 
        form:Form * 
        printOption:PrintForm.PrintOption -> unit

public function Print(
    form : Form, 
    printOption : PrintForm.PrintOption
)

Параметры

form
Тип: Form

printOption
Тип: Microsoft.VisualBasic.PowerPacks.Printing.PrintForm.PrintOption

Заметки

Print Метод выводит все видимые объекты в форме. Сюда входят любые текста и графики, созданных с Graphics методы.

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

Примечание

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

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

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

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

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

Примечание

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

Примеры

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

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

Безопасность платформы .NET Framework

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