Vous pouvez utiliser l’action AppliquerFiltre pour appliquer un filtre, un requête ou une clause SQL WHERE à un table, formulaire ou état pour restreindre ou trier les enregistrements dans la table, ou les enregistrements de la table ou de la requête sous-jacente du formulaire ou de l’état. Pour les rapports, vous pouvez utiliser cette action uniquement dans un macro spécifié par la propriété d’événement OnOpen de l’état.
Remarque : Vous pouvez utiliser cette action pour appliquer une clause SQL WHERE uniquement lors de l’application d’un filtre serveur. Un filtre serveur ne peut pas être appliqué à la source d’enregistrement d’une procédure stockée.
Remarque : L’action de macro AppliquerFiltre n’est pas disponible dans les applications web Access.
Paramètre
L’action AppliquerFiltre contient les arguments suivants.
|
Argument de l’action |
Description |
|
Nom du filtre |
Nom d’un filtre ou d’une requête qui restreint ou trie les enregistrements de la table, du formulaire ou de l’état. Vous pouvez entrer le nom d’une requête existante ou d’un filtre qui a été enregistré en tant que requête dans la zone Nom du filtre de la section Arguments de l’action du volet Générateur de macros. Remarque : Lorsque vous utilisez cette action pour appliquer un filtre de serveur, l’argument Nom du filtre doit être vide. |
|
Where Condition |
Clause SQL WHERE valide (sans le mot WHERE) ou expression qui limite les enregistrements de la table, du formulaire ou de l’état. Remarque : Dans une expression d’argument Condition Where , le côté gauche de l’expression contient généralement un nom de champ de la table ou de la requête sous-jacente pour le formulaire ou l’état. Le côté droit de l’expression contient généralement les critères que vous souhaitez appliquer à ce champ pour restreindre ou trier les enregistrements. Par exemple, les critères peuvent être le nom d’un contrôle sur un autre formulaire qui contient la valeur que vous souhaitez que les enregistrements du premier formulaire correspondent. Le nom du contrôle doit être complet, par exemple : Formulaires ! formname ! nom_contrôle Les noms de champs doivent être entourés de guillemets doubles et les littéraux de chaîne doivent être entourés de guillemets simples. La longueur maximale de l’argument Condition Where est de 255 caractères. Si vous devez entrer une clause SQL WHERE plus longue, utilisez la méthode ApplyFilter de l’objet DoCmd dans un module Visual Basic pour Applications (VBA). Vous pouvez entrer des instructions de clause SQL WHERE allant jusqu’à 32 768 caractères dans VBA. |
Remarque : Vous pouvez utiliser l’argument Nom du filtre si vous avez déjà défini un filtre qui fournit les données appropriées. Vous pouvez utiliser l’argument Condition Where pour entrer directement les critères de restriction. Si vous utilisez les deux arguments, Access applique la clause WHERE aux résultats du filtre. Vous devez utiliser un ou les deux arguments.
Remarques
Vous pouvez appliquer un filtre ou une requête à un formulaire dans mode Formulaire ou mode Feuille de données.
Le filtre et la condition WHERE que vous appliquez deviennent le paramètre de la propriété Filter ou ServerFilter du formulaire ou de l’état.
Pour les tableaux et les formulaires, cette action est similaire à un clic sur Appliquer le filtre/trier ou Appliquer le filtre serveur dans le menu Enregistrements . La commande de menu applique le filtre le plus récemment créé à la table ou au formulaire, tandis que l’action AppliquerFiltre applique un filtre ou une requête spécifié.
Dans une base de données Access, si vous pointez sur Filtrer dans le menu Enregistrements , puis cliquez sur Filtre/Tri avancé après avoir exécuté l’action AppliquerFiltre , le fenêtre Filtre/tri avancé affiche les critères de filtre que vous avez sélectionnés avec cette action.
Pour supprimer un filtre et afficher tous les enregistrements d’une table ou d’un formulaire dans une base de données Access, vous pouvez utiliser l’action AfficherToutesenregistrements ou la commande Supprimer le filtre/trier dans le menu Enregistrements . Pour supprimer un filtre dans un projet Access (.adp), vous pouvez revenir à la fenêtre filtrage par formulaire au niveau du serveur et supprimer tous les critères de filtre, puis cliquer sur Appliquer le filtre serveur dans le menu Enregistrements de la barre d’outils ou définir la propriété ServerFilterByForm sur False (0).
Lorsque vous enregistrez une table ou un formulaire, Access enregistre tout filtre actuellement défini dans cet objet, mais n’applique pas automatiquement le filtre à la prochaine ouverture de l’objet (bien qu’il applique automatiquement tout tri que vous avez appliqué à l’objet avant son enregistrement). Si vous souhaitez appliquer un filtre automatiquement lors de la première ouverture d’un formulaire, spécifiez une macro contenant l’action ApplyFilter ou une procédure événementielle contenant la méthode ApplyFilter de l’objet DoCmd comme paramètre de propriété d’événement OnOpen du formulaire. Vous pouvez également appliquer un filtre à l’aide de l’action OpenForm ou OpenReport , ou de leurs méthodes correspondantes. Pour appliquer automatiquement un filtre lors de l’ouverture d’une table, vous pouvez ouvrir la table à l’aide d’une macro contenant l’action OuvrirTable , suivie immédiatement de l’action AppliquerFiltre .
Exemple
Appliquer un filtre à l’aide d’une macro
La macro suivante contient un ensemble d’actions, chacune d’entre elles filtre les enregistrements d’un formulaire Liste de téléphones clients. Il montre l’utilisation des actions ApplyFilter, ShowAllRecords et GoToControl . Il montre également l’utilisation de conditions pour déterminer quel bouton bascule dans un groupe d’options a été sélectionné sur le formulaire. Chaque ligne d’action est associée à un bouton bascule qui sélectionne le jeu d’enregistrements commençant par A, B, C, etc., ou tous les enregistrements. Cette macro doit être attachée à l’événement AfterUpdate du groupe d’options CompanyNameFilter.
|
Condition |
Action |
Arguments : Paramètre |
Commentaire |
|
[CompanyNameFilters]=1 |
ApplyFilter |
Condition Where : [CompanyName] Like « [Aàáâãä]* » |
Filtrez les noms de société commençant par A, À, Á, Â, Ã ou Ä. |
|
[CompanyNameFilters]=2 |
ApplyFilter |
Condition Where : [CompanyName] Like « B* » |
Filtrez les noms de société commençant par B. |
|
[CompanyNameFilters]=3 |
ApplyFilter |
Condition Where : [CompanyName] Like « [CÇ]* » |
Filtrez les noms de société commençant par C ou Ç. |
|
... Les lignes d’action de D à Y ont le même format que A à C ... |
|||
|
[CompanyNameFilters]=26 |
ApplyFilter |
Condition Where : [CompanyName] Like « [Zæøå]* » |
Filtrez les noms de société commençant par Z, Æ, Ø ou Å. |
|
[CompanyNameFilters]=27 |
ShowAllRecords |
Afficher tous les enregistrements. |
|
|
[RecordsetClone]. [RecordCount]>0 |
GoToControl |
Nom du contrôle : CompanyName |
Si des enregistrements sont retournés pour la lettre sélectionnée, déplacez le focus sur le contrôle CompanyName. |
