PrintForm.Form - свойство

Статья
11/05/2008

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

Возвращает или задает печатаемую форму.

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

Синтаксис

'Декларация
<BrowsableAttribute(False)> _
Public Property Form As Form
'Применение
Dim instance As PrintForm
Dim value As Form

value = instance.Form

instance.Form = value

[BrowsableAttribute(false)]
public Form Form { get; set; }

[BrowsableAttribute(false)]
public:
property Form^ Form {
    Form^ get ();
    void set (Form^ value);
}

public function get Form () : Form
public function set Form (value : Form)

Значение свойства

Тип: System.Windows.Forms.Form
Возвращает объект Form.

Заметки

Если компонент PrintForm размещен на форме, по умолчанию возвращается его родительская форма. Если экземпляр компонента PrintForm создается во время выполнения, необходимо задать свойство Form. Если этого не сделать, будет создано исключение System.Argument.NullException.

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

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

Примеры

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

PrintForm1.Form = My.Forms.Form2

Разрешения

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