PrintForm.Form-Eigenschaft

Artikel
08/23/2008

Aktualisiert: November 2007

Ruft das zu druckende Formular ab bzw. legt dieses fest.

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

Syntax

<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)

Eigenschaftenwert

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 der 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 einem PrintOption-Parameter von CompatibleModeClientAreaOnly oder CompatibleModeFullWindow verwenden, muss es sich bei dem durch die Form-Eigenschaft festgelegten Formular um das Formular der obersten Ebene handeln. 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 Print aufrufen.

Wenn Sie die grundlegende Print-Methode oder die überladene Print-Methode mit einem PrintOption-Parameter von CompatibleModeClientAreaOnly oder CompatibleModeFullWindow verwenden, muss es sich bei dem durch die Form-Eigenschaft festgelegten Formular um das Formular der obersten Ebene handeln. 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 Print aufrufen.

Beispiele

Im folgenden Beispiel wird das Festlegen der Form-Eigenschaft veranschaulicht. Für dieses Beispiel ist es erforderlich, dass auf einem Formular eine PrintForm-Komponente mit der Bezeichnung PrintForm1 vorhanden ist.

PrintForm1.Form = My.Forms.Form2

Berechtigungen

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.