Partager via

SetFilter, action de macro

S’applique à : Access 2013, Office 2013

Vous pouvez utiliser l’action AppliquerFiltre pour appliquer un filtre aux enregistrements de la feuille de données, de l’état, de la table ou du formulaire actif.

Setting

L’action AppliquerFiltre utilise les arguments suivants.

Argument de l’action Description
Nom du filtre Si spécifié, il s’agit du nom d’une requête ou d’un filtre enregistré en tant que requête. Cet argument ou l’argument Condition Where est obligatoire dans une base de données cliente. Dans une base de données web, cet argument n’est pas disponible.
Condition Where 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. Dans une base de données web, cet argument est obligatoire.
Nom du contrôle 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

Dans une base de données Web, l’argument Condition Where ne peut pas commencer par un signe égal (=).

Lorsque vous exécutez cette action, le filtre est appliqué à la table, au formulaire, à l'état ou à la feuille de données (par exemple les résultats de requête) qui est actif et qui a le focus.

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

Dans une base de données cliente, pour appliquer automatiquement un filtre lors de l’ouverture de l’objet, affectez la valeur True à la propriété FiltrerSurchargement.

Dans une base de données Web, pour appliquer automatiquement un filtre lors de l’ouverture de l’objet, ajoutez l’action AppliquerFiltre à une macro et ajoutez la macro à l’événement SurChargement de l’objet.

Exemple

L’exemple suivant montre comment utiliser l’action SetFilter pour filtrer le formulaire dans lequel la macro est définie.

Exemple de code fourni parMicrosoft Access 2010 Programmer’s Reference.

    OpenForm
        Form Name sfrmFoods
        View Form
        Filter Name
        Where Condition
        Data Mode
        Window Mode Normal
    
    SetFilter
        Filter Name
        Where Condition =[display_name] Like "*cheese*"
        Control Name
  • Last updated on