Share via


Propriété Form.OnFilter (Access)

Définit ou renvoie la valeur de la zone Sur filtre dans la fenêtre Propriétés d'un formulaire. String en lecture/écriture.

Syntaxe

expression. OnFilter

expressionVariable qui représente un objetForm.

Remarques

Cette propriété est utile pour modifier par programme l’action que Microsoft Access effectue lorsqu’un événement est déclenché. Par exemple, entre les appels d'un événement, vous pouvez modifier les paramètres d'une expression ou passer d'une procédure événementielle à une expression ou une macro, selon les circonstances du déclenchement de l'événement.

L'événement Filter se produit lorsqu'un formulaire est ouvert et que ses enregistrements sont affichés.

La valeur OnFilter est l’une des suivantes, en fonction de la sélection choisie dans la fenêtre Choisir générateur (accessible en sélectionnant le bouton Générer en regard de la zone Sur filtre dans la Fenêtre Propriétés du formulaire) :

  • Si vous choisissez Générateur d’expressions, la valeur est =expression, où expression est l’expression de la fenêtre Générateur d’expressions.

  • Si vous choisissez Générateur de macros, la valeur est le nom de la macro.

  • Si vous choisissez Générateur de code, la valeur sera [Procédure événementielle].

Si la zone Sur filtre est vide, la valeur de la propriété sera une chaîne vide.

Exemple

L’exemple suivant associe la propriété Filter du formulaire Order Entry à l’événement Form_Filter.

Forms("Order Entry").OnFilter = "[Event Procedure]"

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.