Window.Close-Methode (Boolean)
Schließt das Fenster, das durch das Window-Objekt dargestellt wird, und erzwingt optional das Schließen eines ungespeicherten Formulars oder eines Formulars mit ungespeicherten Änderungen, ohne die Änderungen zu speichern.
Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)
Syntax
'Declaration
Public MustOverride Sub Close ( _
force As Boolean _
)
'Usage
Dim instance As Window
Dim force As Boolean
instance.Close(force)
public abstract void Close(
bool force
)
Parameter
- force
Typ: System.Boolean
Gibt an, ob geöffnete ungespeicherte Dokumente gespeichert werden. Der Standardwert lautet false.
Ausnahmen
Ausnahme | Bedingung |
---|---|
InvalidOperationException | Die Close-Methode wurde aus einem Ereignishandler für das Loading-Ereignis aufgerufen. |
ArgumentNullException | Der an diese Methode übergebene Parameter lautet ein Nullverweis (Nothing in Visual Basic). |
ArgumentException | Der an diese Methode übergebene Parameter ist nicht gültig. Der Parameter weist beispielsweise den falschen Typ oder das falsche Format auf. |
Hinweise
Die Close(force)-Methode schließt das zugeordnete Fenster und die darin enthaltenen Formulare. Wenn der force-Parameter auf true festgelegt ist, werden alle Formulare ohne Speichern geschlossen, und zwar auch dann, wenn sie nicht gespeichert wurden oder Änderungen enthalten, die nach dem letzten Speichern vorgenommen wurden. Ist der Parameter auf false festgelegt, werden die Benutzer aufgefordert, ihre Änderungen zu speichern.
Die Close-Methode kann nur für Bearbeitungsfenster verwendet werden. Wird sie für ein Entwurfsfenster verwendet, wird eine Ausnahme ausgelöst. Darüber hinaus kann die Close-Methode nur mit den Ereignishandlern SubmitEventHandler und ClickedEventHandler verwendet werden. Wird sie mit einem anderen Ereignishandler verwendet, wird eine Ausnahme ausgelöst.
Hinweis
Falls das Fenster, das geschlossen wird, das einzige in Microsoft InfoPath 2010 geöffnete Fenster ist, wird die InfoPath-Anwendung ebenfalls geschlossen.
Auf den Member kann nur über Formulare zugegriffen werden, die in derselben Domäne wie das zurzeit geöffnete Formular ausgeführt werden, oder über Formulare, denen domänenübergreifende Berechtigungen erteilt wurden.
Auf diesen Typ oder diesen Member kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die mit Microsoft InfoPath Filler geöffnet wurden.
Beispiele
Im folgenden Beispiel wird die Close-Methode der Window-Klasse verwendet, um das aktive Fenster zu schließen und um zu erzwingen, dass ein nicht gespeichertes Formular mit Änderungen ohne Speichern der Änderungen geschlossen wird.
this.Application.ActiveWindow.Close(true);
Me.Application.ActiveWindow.Close(true)