PrintForm.Form-Eigenschaft

Artikel
10/24/2012

Ruft das Symbol ab bzw. legt das Format fest gedruckt werden soll.

Namespace: Microsoft.VisualBasic.PowerPacks.Printing
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntax

'Declaration
<BrowsableAttribute(False)> _
Public Property Form As Form

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

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

[<BrowsableAttribute(false)>]
member Form : Form with get, set

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

Eigenschaftswert

Typ: System.Windows.Forms.Form
Gibt ein Form-Objekt zurück.

Hinweise

Wenn die PrintForm Komponente in einem Formular gehostet wird, ist das übergeordnete Formular der Standardwert.Wenn eine Instanz einer PrintForm Komponente zur Laufzeit erstellt wird, muss die Form-Eigenschaft festgelegt werden.Wenn dies nicht der Fall ist, wird eine System.Argument.NullException Ausnahme ausgelöst.

Hinweis
Wenn Sie die grundlegende Print-Methode oder die überladene Print-Methode mit dem PrintOption-Parameter verwenden, der CompatibleModeClientAreaOnly oder CompatibleModeFullWindowfestgelegt wird, muss das Formular, das von der Form-Eigenschaft angegeben wird, die Form der obersten Ebene sein.Wenn dies nicht der Fall ist, wird eine Ausnahme ausgelöst.Um dies zu vermeiden, überprüfen Sie die TopLevel-Eigenschaft des Formulars bevor Sie Printaufrufen.

Wenn Sie die grundlegende Print-Methode oder die überladene Print-Methode mit dem PrintOption-Parameter verwenden, der CompatibleModeClientAreaOnly oder CompatibleModeFullWindowfestgelegt wird, muss das Formular, das von der Form-Eigenschaft angegeben wird, die Form der obersten Ebene sein.Wenn dies nicht der Fall ist, wird eine Ausnahme ausgelöst.Um dies zu vermeiden, überprüfen Sie die TopLevel-Eigenschaft des Formulars bevor Sie Printaufrufen.

Beispiele

Das folgende Beispiel veranschaulicht das Festlegen der Form-Eigenschaft.Dieses Beispiel setzt voraus, dass Sie eine PrintForm Komponente verfügen, die in einem Formular PrintForm1.

PrintForm1.Form = My.Forms.Form2

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.