AppliquerFiltre, action de macro

Important :  Cet article a été traduit automatiquement, voir l’avertissement. Vous pouvez consulter la version en anglais de cet article ici.

Vous pouvez utiliser l'action AppliquerFiltre pour appliquer un filtre, un requête ou une clause WHERE SQL pour un table, formulaire ou état pour restreindre ou trier les enregistrements dans la table, ou les enregistrements de la table ou requête sous-jacente du formulaire ou l'état. Pour les rapports, vous pouvez utiliser cette action uniquement dans une macro spécifié par la propriété du rapport OnOpen événement.

Remarque : Vous pouvez utiliser cette action pour appliquer une clause WHERE SQL seulement lorsque vous appliquez un filtre de 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 comporte les arguments suivants.

Argument de l’action

Description

Nom du filtre

Le nom d'un filtre ou une requête qui limite ou trie les enregistrements de la table, un formulaire ou un état. Vous pouvez entrer le nom d'une requête existante ou un filtre qui a été enregistré en tant que requête dans la zone Nom du filtre dans la section Arguments d'Action du volet Générateur de Macro.

Remarque : Lorsque vous utilisez cette action pour appliquer un filtre serveur, l'argument Nom du filtre doit être vide.

Condition Where

Une clause SQL WHERE valide (sans le mot où) ou un expression qui limite les enregistrements de la table, un formulaire ou un état.

Remarque : Dans une expression d'argument Condition Where , le côté gauche de l'expression contient généralement un nom de champ à partir de la table ou 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 dans un autre formulaire qui contient la valeur que vous voulez que les enregistrements dans le formulaire pour correspondre à la première. Le nom du contrôle doit être complet, par exemple :

Forms ! formulaire! nom contrôle

Noms de champs doivent être encadrés par des guillemets doubles et littéraux de chaîne doivent être encadrés par des 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 AppliquerFiltre de l'objet DoCmd dans un Visual Basic pour le module d'Applications (VBA). Vous pouvez entrer des instructions de clause SQL WHERE 32 768 caractères maximum 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 en mode Formulaire ou mode Feuille de données.

Le filtre et la condition WHERE que vous appliquez deviennent le paramètre de propriété filtre ou FiltreServeur du formulaire ou de l'état.

Pour les tables et formulaires, cette action équivaut à cliquer sur Appliquer le filtre/tri ou Appliquer un filtre serveur dans le menu enregistrements. La commande de menu applique le filtre créé récemment à la table ou le formulaire, alors que l'action AppliquerFiltre applique un filtre spécifié ou la requête.

Dans une base de données Access, si vous pointez sur filtre dans le menu enregistrements, puis cliquez sur Filtre/tri avancé après avoir exécuté l'action AppliquerFiltre , la fenêtre Filtre/tri avancé indique les critères de filtre que vous avez sélectionné avec cette action.

Pour supprimer un filtre et afficher tous les enregistrements d'une table ou un formulaire dans une base de données Access, vous pouvez utiliser l'action AfficherTousEnreg ou la commande Supprimer le filtre/tri 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 et puis cliquez sur Appliquer un filtre serveur dans le menu enregistrements de la barre d'outils ou définissez la propriété ServerFilterByForm sur False (0).

Lorsque vous enregistrez une table ou un formulaire, Access enregistre tous les filtres actuellement définis dans cet objet, mais ne sont pas appliquer le filtre automatiquement la prochaine fois que l'objet est ouvert (bien qu'il applique automatiquement tous les tris appliqués à l'objet avant de l'enregistrer). Si vous voulez appliquer un filtre automatiquement lors de la première ouverture d'un formulaire, spécifiez une macro contenant l'action AppliquerFiltre ou une procédure événementielle contenant la méthode AppliquerFiltre de l'objet DoCmd en tant que le paramètre de propriété d'événement OnOpen du formulaire. Vous pouvez également appliquer un filtre à l'aide de l'action OuvrirFormulaire ou OuvrirRapport ou leurs méthodes correspondantes. Pour appliquer un filtre automatiquement à l'ouverture d'une table, vous pouvez ouvrir la table à l'aide d'une macro contenant l'action OuvrirTable , suivie immédiatement par l'action AppliquerFiltre .

Exemple

Appliquer un filtre à l'aide d'une macro

La macro suivante contient un ensemble d'actions, chacun d'entre eux filtrant les enregistrements d'un formulaire de liste téléphonique des clients. Elle présente l'utilisation des actions AppliquerFiltre, AfficherTousEnreget AtteindreContrôle . Il affiche également l'utilisation de conditions pour déterminer quel bouton bascule dans un groupe d'options a été activée dans l'écran. Chaque ligne d'action est associé à un bouton bascule qui sélectionne le jeu d'enregistrements en commençant par les lettres A, B, C et ainsi de suite ou tous les enregistrements. Cette macro doit être attachée à l'événement Après MAJ du groupe d'options FiltreNomSociété.

Condition

Action

Arguments : paramètre

Commentaire

[CompanyNameFilters] = 1

AppliquerFiltre

Condition Where: [NomSociété] comme "[AÀÁÂÃÄ] *"

Filtre pour les noms d'entreprise qui commencent par A, À, Á, Â, Ã ou Ä.

[CompanyNameFilters] = 2

AppliquerFiltre

Condition Where: [NomSociété] comme « B * »

Filtrer les noms de société qui commencent par B.

[CompanyNameFilters] = 3

AppliquerFiltre

Condition Where: [NomSociété] comme "[CÇ] *"

Filtrer les noms d'entreprise qui commencent par C ou Ç.

... Lignes d'action pour D à Y ont le même format que de A à C...

[CompanyNameFilters] = 26

AppliquerFiltre

Condition Where: [NomSociété] comme "[ZÆØÅ] *"

Filtrer les noms d'entreprise qui commencent par Z, Æ, Ø ou Å.

[CompanyNameFilters] = 27

AfficherTousEnreg

Afficher tous les enregistrements.

[RecordsetClone]. [Compteur] > 0

AtteindreContrôle

Nom du contrôle : NomSociété

Si des enregistrements sont renvoyés pour la lettre sélectionnée, déplacez le focus sur le contrôle société.


Remarque : Avertissement traduction automatique : cet article a été traduit par un ordinateur, sans intervention humaine. Microsoft propose cette traduction automatique pour offrir aux personnes ne maîtrisant pas l’anglais l’accès au contenu relatif aux produits, services et technologies Microsoft. Comme cet article a été traduit automatiquement, il risque de contenir des erreurs de grammaire, de syntaxe ou de terminologie.

Développez vos compétences
Découvrez des formations
Accédez aux nouvelles fonctionnalités en avant-première
Rejoignez le programme Office Insider

Ces informations vous ont-elles été utiles ?

Nous vous remercions pour vos commentaires.

Merci pour vos commentaires. Il serait vraisemblablement utile pour vous de contacter l’un de nos agents du support Office.

×