Report.Open-Ereignis (Access)

Das Open-Ereignis tritt auf, bevor ein Bericht in der Vorschau angezeigt oder gedruckt wird.

Syntax

Ausdruck. Öffnen (Abbrechen)

Ausdruck Eine Variable, die ein Report-Objekt darstellt.

Parameter

Name	Erforderlich/Optional	Datentyp	Beschreibung
Abbrechen	Erforderlich	Integer	Die Einstellung bestimmt, ob das Öffnen des Formulars oder Berichts erfolgt. Wenn Sie das Cancel-Argument auf True (1) festlegen, wird das Öffnen des Formulars oder Berichts abgebrochen.

Rückgabewert

Nichts

Bemerkungen

Ein Makro oder eine Ereignisprozedur für das Open-Ereignis kann z. B. ein benutzerdefiniertes Dialogfeld öffnen, in das der Benutzer die Kriterien für die im Formular anzuzeigenden Datensätze oder den im Bericht enthaltenen Datumsbereich eingibt.

Beim Öffnen eines Berichts führt Microsoft Access das Makro oder die Ereignisprozedur für das Open-Ereignis aus, bevor die dem Bericht zugrunde liegende Abfrage ausgeführt wird. Dadurch kann der Benutzer Kriterien für den Bericht angeben, bevor er geöffnet wird. Beispielsweise wird in einem benutzerdefinierten Dialogfeld angezeigt, wenn das Open-Ereignis auftritt.

Wenn in Ihrer Anwendung mehrere Formular gleichzeitig geladen werden können, verwenden Sie die Ereignisse Activate und Deactivate anstelle des Open-Ereignisses, um benutzerdefinierte Symbolleisten anzuzeigen und auszublenden, wenn der Fokus auf ein anderes Formular verschoben wird.

Wenn das Close-Ereignis eintritt, können Sie ein anderes Fenster öffnen oder den Namen des Benutzers anfordern, um einen Protokolleintrag vorzunehmen.

Wenn Sie entscheiden möchten, ob Sie das Open - oder Load-Ereignis für Ihr Makro oder Ihre Ereignisprozedur verwenden möchten, besteht ein wesentlicher Unterschied darin, dass das Open-Ereignis abgebrochen werden kann, das Load-Ereignis jedoch nicht. Wenn Sie beispielsweise dynamisch eine Datensatzquelle für ein Formular in einer Ereignisprozedur für das Open-Ereignis des Formulars erstellen, können Sie das Öffnen des Formulars abbrechen, wenn keine Datensätze angezeigt werden. Im Gegensatz zum Unload-Ereignis kann das Close-Ereignis nicht abgebrochen werden.

Beispiel

Das folgende Beispiel zeigt, wie Sie eine Structured Query Language (SQL)-Anweisung verwenden, um die Datenquelle eines Berichts einzurichten, während er geöffnet wird.

Private Sub Report_Open(Cancel As Integer)

    On Error GoTo Error_Handler

    Me.Caption = "My Application"

    DoCmd.OpenForm FormName:="frmReportSelector_MemberList", _
    Windowmode:=acDialog

    'Cancel the report if "cancel" was selected on the dialog form.

    If Forms!frmReportSelector_MemberList!txtContinue = "no" Then
        Cancel = True
        GoTo Exit_Procedure
    End If
    Me.RecordSource = ReplaceWhereClause(Me.RecordSource, _
      Forms!frmReportSelector_MemberList!txtWhereClause)

Exit_Procedure:
    Exit Sub

Error_Handler:
    MsgBox Err.Number & ": " & Err.Description
    Resume Exit_Procedure
    Resume

End Sub

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.