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.BooleanGibt 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 ist ein Nullverweis (Nothing in Visual Basic). |
| ArgumentException | Der an diese Methode übergebene Parameter ist nicht gültig. Er 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 geöffnete Fenster ist, wird die InfoPath-Anwendung ebenfalls geschlossen.
Auf dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die in der gleichen Domäne wie das derzeit geöffnete Formular ausgeführt werden oder denen domänenübergreifende Berechtigungen zugewiesen wurden.
Auf diesen Typ oder dieses Mitglied kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die in 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)