Événement Report.Open (Access)

L’événement Open se produit avant l’aperçu ou l’impression d’un rapport.

Syntaxe

expression. Ouvrir (Annuler)

Expression Variable qui représente un objet Report .

Parameters

Nom	Requis/Facultatif	Type de données	Description
Cancel	Obligatoire	Entier	La valeur de cet argument détermine si l'ouverture du formulaire ou de l'état a lieu. Définir l’argument Annuler sur True (1) annule l’ouverture du formulaire ou de l’état.

Valeur renvoyée

Aucune

Remarques

Par exemple, une macro ou une procédure événementielle Open peut ouvrir une boîte de dialogue personnalisée dans laquelle l’utilisateur entre les critères pour filtrer le jeu d’enregistrements à afficher dans un formulaire ou la plage de dates à prendre en compte pour un état.

Lorsque vous ouvrez un état en fonction d'une requête sous-jacente, Microsoft Access exécute la macro ou la procédure événementielle Open avant d'exécuter la requête sous-jacente relative à l'état. Cela permet à l’utilisateur de spécifier des critères pour le rapport avant son ouverture ; par exemple, dans une boîte de dialogue personnalisée, vous affichez lorsque l’événement Open se produit.

Si votre application peut avoir plusieurs formulaires chargés à la fois, utilisez les événements Activate et Deactivate au lieu de l’événement Open pour afficher et masquer les barres d’outils personnalisées lorsque le focus se déplace vers un autre formulaire.

Lorsque l’événement Close se produit, vous pouvez ouvrir une autre fenêtre ou demander au nom de l’utilisateur de créer une entrée de journal indiquant qui a utilisé le formulaire ou l’état.

Si vous essayez de décider d’utiliser l’événement Open ou Load pour votre macro ou procédure événementielle, une différence significative est que l’événement Open peut être annulé, mais pas l’événement Load . Par exemple, si vous créez dynamiquement une source d’enregistrement pour un formulaire dans une procédure événementielle pour l’événement Open du formulaire, vous pouvez annuler l’ouverture du formulaire s’il n’y a pas d’enregistrements à afficher. De la même façon, il est possible d’annuler l’événement Unload mais pas l’événement Close.

Exemple

L'exemple suivant montre comment utiliser une instruction de langage SQL (Structured Query) pour établir la source de données d'un état lors de son ouverture.

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

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.