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. Filtre intégré

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 sera l’une des suivantes, en fonction de la sélection choisie dans la fenêtre Choisir un générateur (accessible en choisissant le bouton Générer en regard de la zone Sur filtre dans le Fenêtre Propriétés du formulaire) :

• Si vous choisissez le Générateur d’expressions, la valeur sera =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é Filtre du formulaire Écriture commande au Form_Filter d’événement.

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.