Share via

Méthode DoCmd.SetFilter (Access)

  • Article

Utilisez la méthode SetFilter pour appliquer un filtre aux enregistrements de la feuille de données active, un formulaire, un état ou un tableau.

Syntaxe

expression. SetFilter (FilterName, WhereCondition, ControlName)

expressionune variable représentant un objet DoCmd.

Paramètres

Nom Requis/Facultatif Type de données Description
FilterName Facultatif Variant S'il est fourni, le nom d'une requête ou d'un filtre enregistré en tant que requête. Cet argument ou l’argument WhereCondition est requis.
WhereCondition Facultatif Variant S'il est fourni, une clause WHERE SQL qui limite les enregistrements d'une feuille de données, d'un formulaire, d'un état ou d'une table.
Nom_contrôle Facultatif Variant Si spécifié, il s'agit du nom du contrôle qui correspond au sous-formulaire ou sous-état à filtrer. Si cet argument est vide, l’objet actif est filtré.

Remarques

Lorsque vous exécutez cette méthode, le filtre est appliqué à la table, au formulaire, à l’état ou à la feuille de données (par exemple, résultat de requête) actif et ayant le focus.

La propriété Filter de l’objet actif est utilisée pour enregistrer l’argument WhereCondition et l’appliquer ultérieurement. Les filtres sont enregistrés avec les objets dans lesquels ils sont créés. Ils sont automatiquement chargés lorsque l'objet est ouvert, mais ils ne sont pas automatiquement appliquées.

Pour appliquer automatiquement un filtre à l’ouverture de l’objet, définissez la propriété FilterOnLoad sur True.

Exemple

L’exemple de code suivant filtre l’objet actif afin qu’il n’affiche que les enregistrements commençant par « NWTB ».

DoCmd.SetFilter WhereCondition:="[Product Code] Like ""NWTB*"""

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.