Utilisation du langage de requête
Altium Essentials: PCB Global Editing and List Panel
This content is part of the official Altium Professional Training Program. For full courses, materials and certification, visit Altium Training.
En un coup d'œil
- Découvrez comment les requêtes ciblent des objets spécifiques et comment la portée des filtres détermine les documents et les objets dans lesquels la recherche est effectuée.
- Apprenez à créer et à vérifier des expressions de requête, puis à contrôler la sélection, le zoom et le masquage des résultats.
- Découvrez comment appliquer et supprimer des filtres, réutiliser les requêtes favorites et récentes, et utiliser des parenthèses pour rendre les expressions plus claires.
Qu'est-ce qu'une requête ?
Le plus grand défi lors du travail sur une conception électronique complexe est peut-être la gestion d'un grand nombre d'objets de conception. Des composants, étiquettes de nets et chaînes de texte sur les feuilles de schéma aux centaines de composants et de pistes qui constituent le routage du PCB, vous devez pouvoir accéder à ces objets, les examiner et les modifier. Comme dans la plupart des applications Windows, vous pouvez double-cliquer sur un objet pour modifier ses propriétés. Cela convient pour un seul objet, mais ce n'est pas une méthode adaptée si vous devez modifier plus de 300 chaînes de désignateurs de composants ou modifier tous les vias du PCB. Pour ce type de mise à jour, vous devez accéder à plusieurs objets simultanément.
Les éditeurs de schémas et de PCB d'Altium Designer s'appuient sur un puissant moteur de requêtes. En saisissant des requêtes dans ce moteur, vous pouvez filtrer les objets pour trouver et modifier précisément ceux dont vous avez besoin.
Le puissant système de filtrage et de modification des données d'Altium Designer vous permet de demander au logiciel de renvoyer un ensemble précis d'objets. Cette instruction est saisie sous la forme d'une requête. Une requête est une chaîne que vous saisissez à l'aide de mots-clés et d'une syntaxe spécifiques, et qui renvoie les objets ciblés. Libre à vous ensuite de choisir ce que vous en faites. Vous pouvez, par exemple, les mettre en surbrillance et estomper tous les autres objets, ou encore parcourir ou trier leurs propriétés et modifier certains attributs qu'ils ont en commun.
Vous pouvez appliquer une requête à plusieurs endroits, mais les principaux outils sont les panneaux Filter présentés dans les images ci-dessous. Appuyez sur F12 pour afficher/masquer le panneau Filter .
Les panneaux PCB Filter et SCH Filter avec des requêtes

Les panneaux PCBLIB Filter et SCHLIB Filter avec des requêtes
Les commandes du panneau permettent de définir les objets auxquels la requête sera appliquée et la façon de traiter les objets qui répondent à ses critères, ainsi que ceux qui n'y répondent pas.
Panneau SCH Filter

Localisez et mettez rapidement en surbrillance des objets à l'aide de requêtes logiques dans le panneau SCH Filter.
Résumé
Le panneau SCH Filter permet de construire des filtres en créant des requêtes logiques. Un filtre défini peut ensuite être appliqué au document schématique actif ou à tous les documents schématiques ouverts, ce qui vous permet de sélectionner et de modifier plusieurs objets avec davantage de précision et d'efficacité.
Accès au panneau
Vous pouvez accéder au panneau de différentes manières :
- Cliquez sur le bouton Panneaux en bas à droite de l'éditeur lorsque l'éditeur de schémas est actif, puis sélectionnez SCH Filter dans le menu contextuel.
- Cliquez sur View » Panels » SCH Filter.
- Appuyez sur le raccourci clavier F12.
Définition de la portée du filtre
La première zone du panneau contient des commandes permettant de définir la portée du filtre :
La zone Limit search to propose des commandes permettant d'affiner davantage la portée du filtre :
- All Objects - appliquer le filtre à tous les objets de conception.
- Selected Objects - appliquer le filtre uniquement aux objets de conception actuellement sélectionnés.
- Non Selected Objects - appliquer le filtre uniquement aux objets de conception qui ne sont pas actuellement sélectionnés.
Le champ déroulant Consider objects in vous permet de contrôler où le filtre est appliqué. Choisissez parmi les options suivantes :
- Current Document - appliquer le filtrage uniquement au document schématique actif (par défaut).
- Open Documents - appliquer le filtrage à tous les documents schématiques ouverts.
- Project Documents - appliquer le filtrage à tous les documents schématiques ouverts qui sont des documents sources du même projet parent.
Définition des requêtes de filtrage
La zone centrale du panneau vous permet de construire des filtres en saisissant des requêtes logiques. Vous pouvez saisir une requête directement dans le champ. Pendant la saisie, une liste de suggestions de mots-clés s'affiche pour vous aider.
L'assistant de requêtes est disponible pour vous aider à créer des requêtes. Cette fonction peut être très utile si vous avez des doutes sur la syntaxe d'une requête ou sur les mots-clés que vous pouvez utiliser. Pour utiliser l'assistant de requêtes, cliquez sur le bouton Helper pour ouvrir la boîte de dialogue Assistant de requêtes. Le moteur de requêtes sous-jacent analyse le document et répertorie tous les objets disponibles ainsi que les mots-clés génériques utilisables dans les requêtes.
Utilisez la partie supérieure de la boîte de dialogue pour composer une expression de requête à l'aide des SCH Functions et System Functions disponibles. La partie centrale de la boîte de dialogue propose différents opérateurs à utiliser pour construire une expression. Utilisez le bouton Check Syntax pour vérifier que la syntaxe d'une expression est correcte.
Une fois l'expression de la requête définie selon vos besoins, cliquez sur OK pour charger la requête dans la zone centrale du panneau SCH Filter, prête à être appliquée comme filtre.
Définition de la mise en surbrillance du filtre
Avant d'appliquer la requête, il est préférable de définir l'apparence visuelle souhaitée pour le résultat du filtrage dans l'espace de travail de conception. Les zones Objects passing/not passing the filter du panneau proposent différentes options qui constituent ensemble les commandes de mise en surbrillance pour le filtrage permanent.
Les options disponibles dans la zone Objects passing the filter vous permettent de contrôler l'affichage dans l'espace de travail de tous les objets qui entrent dans la portée du filtre et correspondent à son expression de requête :
- Select - lorsque cette option est activée (par défaut), les objets filtrés sont sélectionnés dans l'espace de travail.
- Zoom - lorsque cette option est activée (par défaut), la vue est zoomée et centrée (si possible) sur les objets filtrés dans la fenêtre de l'éditeur de conception.
Les options disponibles dans la zone Objects not passing the filter vous permettent de contrôler l'affichage dans l'espace de travail de tous les objets qui n'entrent pas dans la portée du filtre et/ou ne correspondent pas à son expression de requête :
- Deselect - lorsque cette option est activée (par défaut), tous les objets qui n'entrent pas dans la portée du filtre sont désélectionnés dans l'espace de travail.
- Mask out - lorsque cette option est activée (par défaut), les objets filtrés restent pleinement visibles dans la fenêtre de l'éditeur de conception, tandis que tous les autres objets sont estompés. Lorsque le masquage est appliqué, tous les objets qui n'entrent pas dans la portée du filtre ne peuvent plus être sélectionnés ni modifiés.
Vous pouvez activer n'importe quelle combinaison de ces options. Par exemple, vous pouvez faire en sorte que la vue soit zoomée et centrée sur tous les objets correspondant à votre requête et que ceux-ci soient sélectionnés dans la fenêtre de l'éditeur de conception, tout en appliquant un masquage pour réduire l'encombrement visuel dû aux autres objets de conception.
Application et suppression du filtre
Une fois votre requête définie et les options du panneau configurées selon vos besoins, vous pouvez appliquer le filtre en cliquant sur le bouton Apply ou en appuyant sur Enter.
Pour supprimer le filtre actuellement appliqué depuis le panneau, effacez l’expression de requête saisie dans le panneau, puis cliquez sur le bouton Apply ou appuyez sur Enter. Tous les objets de l’espace de travail de conception redeviendront entièrement visibles et pourront être sélectionnés et modifiés.
Menus contextuels
Un clic droit dans le panneau SCH Filter permet d’accéder à des options et commandes supplémentaires via un menu contextuel.
Ce menu propose les commandes suivantes :
- Add to Favorites - ajoute l’expression de requête actuellement affichée dans le panneau à la liste des requêtes favorites. La requête apparaît comme une nouvelle entrée dans l’onglet Favorites de la boîte de dialogue Gestionnaire d’expressions. Lorsqu’une requête est ajoutée à la liste des favoris, elle s’affiche en haut du menu contextuel. Les dix dernières requêtes ajoutées à cette liste sont affichées dans le menu (la plus récente en haut), ce qui vous permet d’accéder rapidement à vos expressions de requête favorites et de les réutiliser.
- Organize Favorites - utilisez cette commande pour accéder à l’onglet Favorites de la boîte de dialogue Gestionnaire d’expressions, dans lequel vous pouvez organiser (renommer, supprimer) les entrées de la liste des requêtes favorites selon vos besoins.
- Examples - cliquez pour accéder à un sous-menu d’exemples de filtres prédéfinis. Le choix d’un exemple de filtre charge l’expression de requête sous-jacente correspondante dans la zone centrale du panneau.
- History - cliquez pour accéder à un sous-menu contenant les neuf dernières expressions de requête utilisées, issues de l’historique des requêtes du panneau. Cliquez sur l’entrée More pour accéder à l’onglet History de la boîte de dialogue Gestionnaire d’expressions, dans lequel vous pouvez parcourir la liste complète des requêtes de l’historique et en appliquer une, ainsi qu’effacer l’historique si nécessaire.
- Show Scope Options - utilisez cette commande pour afficher ou masquer la zone de définition de la portée du filtre dans le panneau.
- Show Masking Options - utilisez cette commande pour afficher ou masquer la zone de mise en surbrillance du filtre dans le panneau.
Remarques
Généralités
- Appuyez sur la touche F12 pour afficher ou masquer le panneau dans l’espace de travail.
- Lorsque vous utilisez la boîte de dialogue Assistant de requête pour construire une requête, cliquez à l’intérieur d’un mot-clé saisi ou sur un mot-clé dans l’une des listes disponibles, puis appuyez sur F1 pour ouvrir l’aide relative à ce mot-clé. Vous pouvez également accéder à cette aide en cliquant à l’intérieur d’un mot-clé dans la zone centrale du panneau SCH Filter, puis en appuyant sur F1.
- Selon la forme et la taille du panneau, son contenu est disposé dynamiquement à l’horizontale ou à la verticale.
Lors de la construction d’expressions de requête
- Il est vivement conseillé d’utiliser des parenthèses dès qu’il existe le moindre risque que la requête ne soit pas interprétée correctement.
-
Les parenthèses ont la priorité la plus élevée dans l’ordre de priorité défini pour les différents opérateurs disponibles. Cet ordre détermine la façon dont le logiciel interprète les requêtes lorsque vous n’avez pas utilisé de parenthèses. L’ordre de priorité est le suivant :
Brackets
Not
^, *, /, Div, Mod, And
+, -, Or, Xor
=, <>, <, >, <=, >=
&&, ||
Cet ordre de priorité est similaire à celui utilisé dans les langages de type Pascal ; un usage généreux des parenthèses élimine les ambiguïtés et facilite la lecture des requêtes par d’autres personnes. - Les ambiguïtés sont résolues en procédant de gauche à droite.
- Les expressions entre parenthèses sont évaluées de l’intérieur vers l’extérieur et, à niveau égal, de gauche à droite.
- Les options d’affichage des objets qui satisfont au filtre appliqué et de ceux qui n’y satisfont pas étant distinctes, vous pouvez appliquer de nouvelles requêtes de filtrage pour affiner les résultats d’un filtrage précédent.
- Le filtrage appliqué à l’aide des requêtes du panneau SCH Filter est permanent. Lorsque les objets de conception ne satisfaisant pas au filtre sont masqués, le degré de masquage est contrôlé par le curseur situé en bas du panneau.
- Pour supprimer un filtre permanent, vous devez appliquer une requête vide depuis le panneau SCH Filter.
Panneau SCHLIB Filter
Repérez et mettez rapidement en surbrillance les objets d’une bibliothèque de schémas à l’aide de requêtes logiques dans le panneau SCHLIB Filter.
Résumé
Le panneau SCHLIB Filter vous permet de construire des filtres en créant des requêtes logiques. Un filtre défini peut ensuite être appliqué au composant actif de la bibliothèque de schémas ou à tous les composants de la bibliothèque de schémas active, ce qui vous permet de sélectionner et de modifier plusieurs objets avec davantage de précision et d’efficacité. Vous pouvez définir l’apparence des objets selon qu’ils correspondent ou non aux critères de recherche du filtre.
Accès au panneau
Vous pouvez accéder au panneau des façons suivantes :
- Cliquez sur le bouton Panneaux en bas à droite de l’espace de travail, puis sélectionnez SCHLIB Filter.
- Cliquez sur View » Panels » SCHLIB Filter dans les menus principaux.
- Utilisez le raccourci clavier F12.
Définition de la portée du filtre
La zone de gauche du panneau SCHLIB Filter contient les commandes permettant de définir (limiter) la portée du filtre.
Les options de portée sont les suivantes :
- All Objects - applique le filtre à tous les objets de conception.
- Selected Objects - applique le filtre uniquement aux objets de conception actuellement sélectionnés.
- Non Selected Objects - applique le filtre uniquement aux objets de conception qui ne sont pas actuellement sélectionnés.
- Whole Library - détermine si le filtrage s’applique uniquement au composant actif (option désactivée) ou à tous les composants du document de bibliothèque de schémas actif (option activée).
Définition des requêtes de filtrage
La zone centrale du panneau SCHLIB Filter vous permet de construire des filtres en saisissant des requêtes logiques.
Vous pouvez saisir une requête directement dans le champ. Pendant la saisie, une liste de suggestions de mots-clés s’affiche pour vous aider.
Assistant de requête
Outre la liste de suggestions, le panneau propose également l’assistant de requête Query Helper pour vous aider à créer des requêtes. Cet outil peut être très utile si vous avez des doutes sur la syntaxe d’une requête ou sur les mots-clés que vous pouvez utiliser. Pour utiliser Query Helper, cliquez sur le bouton Helper afin d’ouvrir la boîte de dialogue Query Helper. Le moteur de requête sous-jacent analyse le document et répertorie tous les objets disponibles, ainsi que les mots-clés génériques utilisables dans les requêtes.
Utilisez la partie supérieure de la boîte de dialogue pour composer une expression de requête à l’aide des SCH Functions et System Functions disponibles. La partie centrale de la boîte de dialogue propose différents opérateurs pour construire une expression. Utilisez le bouton Check Syntax pour vérifier que la syntaxe d’une expression est correcte.
Une fois l’expression de requête définie comme souhaité, cliquez sur OK pour charger la requête dans la partie centrale du panneau SCHLIB Filter. Appliquez le filtre à l’aide du bouton Apply.
Lorsque le filtre est appliqué à l’ensemble de la bibliothèque, les broches qui y répondent sont mises en surbrillance pour tous les autres composants.
Pour plus d’informations sur l’application des filtres, consultez la section Applying and Clearing a Filter ci-dessous.
Définition de la mise en surbrillance du filtre
Avant d’appliquer la requête dans le panneau SCHLIB Filter, il est préférable de définir l’aspect visuel des résultats du filtrage dans l’espace de travail de l’éditeur de conception. La partie droite du panneau propose différentes options qui constituent les commandes de mise en surbrillance du filtrage permanent.
Les options Objects passing the filter vous permettent de contrôler l’affichage, dans l’espace de travail, de tous les objets inclus dans le périmètre du filtre et correspondant à son expression de requête.
- Select - lorsque cette option est activée (par défaut), les objets filtrés sont sélectionnés dans l’espace de travail.
- Zoom - lorsque cette option est activée (par défaut), un zoom est effectué sur les objets filtrés, qui sont centrés (si possible) dans la fenêtre de l’éditeur de bibliothèque. Le comportement du zoom peut être défini à l’aide des options Zoom Library Components de la page Schéma - Zoom automatique de la bibliothèque de la boîte de dialogue Preferences.
À l’inverse, les options Objects not passing the filter vous permettent de contrôler l’affichage, dans l’espace de travail, de tous les objets qui do not sont inclus dans le périmètre du filtre et/ou correspondent à son expression de requête.
- Deselect - lorsque cette option est activée (par défaut), tous les objets situés hors du périmètre du filtre sont désélectionnés dans l’espace de travail.
- Mask out - lorsque cette option est activée (par défaut), tous les objets situés hors du périmètre du filtre sont masqués dans la fenêtre de l’éditeur de bibliothèque. Utilisez le curseur pour définir le niveau de masquage.
Application et suppression d’un filtre
Une fois la requête définie et les options du panneau configurées comme souhaité, vous pouvez appliquer le filtre en cliquant sur le bouton Apply du panneau ou en appuyant sur Enter.
Pour supprimer le filtre actuellement appliqué depuis le panneau, effacez l’expression de requête dans la partie centrale du panneau (en la sélectionnant, puis en la supprimant), puis cliquez sur le bouton Apply ou appuyez sur Enter. Tous les objets de l’espace de travail de conception redeviennent entièrement visibles et peuvent de nouveau être sélectionnés et modifiés.
Pour supprimer le filtrage dans l’espace de travail tout en conservant l’expression de requête dans la partie centrale du panneau, utilisez le bouton Clear Current Filter de la barre d’outils Sch Lib Standard (raccourci Shift+C).
Menu contextuel
Un clic droit dans le panneau SCHLIB Filter permet d’accéder à des options et commandes supplémentaires via un menu contextuel.
Ce menu propose les commandes suivantes :
- Add to Favorites - permet d’ajouter l’expression de requête actuellement affichée dans la partie centrale du panneau à la liste des requêtes favorites. La requête apparaît comme une nouvelle entrée dans l’onglet Favorites de la boîte de dialogue Gestionnaire d’expressions. Lorsqu’une requête est ajoutée à la liste des favoris, elle s’affiche en haut du menu contextuel. Les dix dernières requêtes ajoutées à cette liste sont affichées dans le menu (la plus récente en haut), ce qui vous permet d’accéder rapidement à vos expressions de requête favorites et de les réutiliser.
- Organize Favorites - permet d’accéder à l’onglet Favorites de la boîte de dialogue Gestionnaire d’expressions, dans lequel vous pouvez organiser (renommer, supprimer) les entrées de la liste des requêtes favorites.
- Examples - cliquez pour accéder à un sous-menu d’exemples de filtres prédéfinis. La sélection d’un exemple de filtre charge l’expression de requête sous-jacente associée dans la partie centrale du panneau.
- History - cliquez pour accéder à un sous-menu contenant les neuf dernières expressions de requête utilisées, issues de l’historique des requêtes du panneau. Cliquez sur l’entrée More pour accéder à l’onglet History de la boîte de dialogue Gestionnaire d’expressions, dans lequel vous pouvez parcourir la liste complète de l’historique des requêtes, appliquer une requête et effacer l’historique si nécessaire.
- Show Scope Options - permet d’afficher ou de masquer la zone de définition du périmètre du filtre dans le panneau.
- Show Masking Options - permet d’afficher ou de masquer la zone de mise en surbrillance du filtre dans le panneau.
Remarques
Généralités
- Appuyez sur la touche F12 pour afficher ou masquer le panneau dans l’espace de travail.
- Le filtrage appliqué à l’aide des requêtes du panneau SCHLIB Filter est permanent pour la session. Un filtre permanent doit être supprimé par l’action Clear correspondante (application d’une requête vide depuis le panneau SCHLIB Filter).
- Selon la forme et la taille du panneau SCHLIB Filter, son contenu est automatiquement disposé horizontalement ou verticalement.
Construction d’expressions de requête
- Il est vivement recommandé d’utiliser des parenthèses dès qu’il existe un risque que la requête soit mal interprétée.
-
Les parenthèses ont la priorité la plus élevée dans l’ordre de priorité défini pour les différents opérateurs disponibles. Cet ordre détermine la façon dont le logiciel interprète les requêtes lorsque l’utilisateur n’a pas ajouté de parenthèses. Il est le suivant :
Brackets
Not
^, *, /, Div, Mod, And
+, -, Or, Xor
=, <>, <, >, <=, >=
&&, ||
Cet ordre de priorité est similaire à celui utilisé dans les langages de type Pascal. Toutefois, un usage généreux des parenthèses élimine les ambiguïtés et facilite la lecture des requêtes par d’autres utilisateurs. - Les ambiguïtés sont résolues en procédant de gauche à droite.
- Les expressions entre parenthèses sont évaluées de l’intérieur vers l’extérieur et, à niveau égal, de gauche à droite.
Panneau Filtre PCB

Le panneau PCB Filter
Présentation
Le panneau PCB Filter fournit des commandes permettant de créer des filtres à l’aide de requêtes logiques. Un filtre défini peut ensuite être appliqué au PCB actif, ce qui vous permet de sélectionner et de modifier plusieurs objets avec une grande précision et efficacité.
Accès au panneau
Le panneau est accessible depuis l’éditeur de PCB de différentes manières :
- Cliquez sur le bouton Panels en bas à droite de l’espace de travail, puis sélectionnez PCB Filter.
- Cliquez sur View » Panels » PCB Filter dans les menus principaux.
- Utilisez le raccourci clavier F12 .
Sections du panneau
Le panneau PCB Filter se compose de trois zones. Les deux premières sont des listes de sélection qui définissent ensemble la portée du filtrage : Object et Layer.
La troisième zone, Filter, affiche la requête créée en fonction des objets et des couches actuellement sélectionnés.
Création d’expressions de filtrage simples
La zone principale du panneau fournit des commandes permettant de créer rapidement des expressions de filtrage simples ciblant n’importe quelle combinaison d’objets. Les types d’objets sont organisés dans une « matrice d’objets » et classés selon qu’il s’agit d’objets de net (Net), d’objets de composant (Comp) ou d’objets libres (Free). La liste d’objets de base suivante est reprise dans chacun de ces trois groupes :
- Piste
- Arc
- Via
- Pastille
- Remplissage
- Région
L’objet Text est disponible dans les groupes Comp et Free . Toutefois, comme ce type d’objet n’est pas associé à un net, il ne fait pas partie du groupe Net . En outre, le groupe Free comprend également : Component, Component Body, Room et Polygon.
Si ces paramètres sont définis sur « Component » et « Top Layer », par exemple, la vue de la carte met en surbrillance les composants de la couche supérieure. Les sélections dans les deux sections du panneau représentent l’effet cumulé de plusieurs étapes de filtrage, ce qui permet de mettre rapidement en surbrillance n’importe quel type d’objet de conception.
Pour utiliser un objet dans la création d’une expression de filtrage, c’est-à-dire pour filtrer selon cet objet, cochez la case correspondante dans la matrice d’objets. Les commandes disponibles dans le menu contextuel de cette zone vous permettent de cocher ou de décocher rapidement toutes les entrées de la matrice, ou d’inverser l’état de toutes ses cases à cocher.
Utilisez la zone Layer du panneau pour limiter le filtre à une ou plusieurs couches particulières, ou à une classe de couches spécifique. Les entrées répertoriées correspondent aux éléments suivants :
-
Les classes de couches définies pour la carte, dont les classes par défaut sont :
- <All Layers>
- <Component Layers>
- <Electrical Layers>
- <Signal Layers>
- Les couches définies dans l’empilage des couches (telles qu’elles apparaissent dans l’éditeur d’empilage des couches).
- Les couches supérieure et inférieure du masque de pâte à braser.
À mesure que vous effectuez vos sélections de filtrage, l’expression de requête résultante est créée dynamiquement et affichée dans la zone Filter du panneau. Une fois l’expression de requête définie selon vos besoins, vous devez l’appliquer dans une étape distincte. Pour cela, cliquez sur le bouton Apply to All en bas du panneau. Si vous souhaitez l’appliquer uniquement aux objets actuellement sélectionnés dans l’espace de travail, cliquez plutôt sur le bouton Apply to Selected.
Filtrage par objet
La sélection dans la liste Object du panneau filtre la vue de la carte pour afficher les objets de conception primitifs. Tous les objets sont mis en surbrillance, sauf si les paramètres des listes de filtrage Object et/ou Layer modifient ce comportement.

La carte affichée avec Component Body et Pad (In Any Component) sélectionnés sous Object. Layer est défini sur <All>.

La carte affichée avec Object défini sur Tracks (In Any Net) et Pads (In Any Net). Layer est défini sur <All>.
Filtrage par couche
La sélection dans la liste Layer du panneau filtre la vue de la carte pour afficher les objets de la couche physique de conception désignée (couches de signal, de masque et de sérigraphie). Tous les objets des couches correspondantes sont mis en surbrillance, sauf si les paramètres des listes de filtrage Layer et/ou Objects modifient ce comportement.

La carte affichée avec Object défini sur Components et Pads (In Any Component). Layers est défini sur Top Layer.

La carte affichée avec Object défini sur Pistes (dans n’importe quel Net). Layer est défini sur Bottom Layer.
Sélection des objets filtrés
L’action de filtrage combinée du panneau facilite à la fois la visualisation et la sélection des objets de conception de la carte qui vous intéressent.
Seuls les objets mis en surbrillance (filtrés) sont sélectionnables, ce qui facilite leur localisation, leur modification et la recherche d’informations les concernant.
Suppression du filtre
Supprimez le filtre actuellement appliqué en cliquant sur le bouton Clear.
Configuration du filtrage visuel
Le résultat visuel du filtrage appliqué au document dans l’espace de travail est déterminé par une série de commandes de mise en surbrillance. L’effet appliqué dans la vue de l’éditeur peut être défini sur Normal, Mask ou Dim ; en pratique, Mask offre l’effet de mise en surbrillance le plus marqué.
La liste déroulante Normal / Mask / Dim propose des options permettant de distinguer visuellement les objets filtrés des objets non filtrés dans l’espace de travail.

Sélectionnez le type de filtrage visuel à appliquer à l’aide de la liste déroulante du mode de masquage.
Effet de mise en surbrillance de chaque mode de masquage :
- Normal - les objets filtrés sont visibles dans l’espace de travail et l’apparence des objets non filtrés reste inchangée.
- Mask - les objets filtrés sont mis en surbrillance dans l’espace de travail et tous les autres objets deviennent monochromes.
- Dim - les objets filtrés sont mis en surbrillance dans l’espace de travail et tous les autres objets conservent leurs couleurs, mais sont estompés.
Définition des requêtes de filtrage
La zone centrale du panneau propose des commandes permettant de créer des filtres en saisissant des requêtes logiques.
Vous pouvez saisir une requête directement dans le champ. Pendant la saisie, une liste de mots-clés possibles s’affiche pour vous aider.
Deux fonctions facilitent la création de requêtes : l’assistant de requête et le générateur de requêtes. Ces fonctions peuvent être très utiles si vous avez des doutes sur la syntaxe d’une requête ou sur les mots-clés que vous pouvez utiliser.
Assistant de requête
Pour utiliser l’assistant de requête, cliquez sur le bouton Helper afin d’ouvrir la boîte de dialogue Assistant de requête. Le moteur de requêtes sous-jacent analyse le document et répertorie tous les objets disponibles ainsi que les mots-clés génériques utilisables dans les requêtes.
Utilisez la partie supérieure de la boîte de dialogue pour composer une expression de requête à l’aide des éléments PCB Functions, PCB Object Lists et System Functions disponibles. La zone centrale de la boîte de dialogue propose un ensemble d’opérateurs à utiliser pour construire une expression. Utilisez le bouton Check Syntax pour vérifier que la syntaxe de l’expression est correcte.
Une fois l’expression de requête définie selon vos besoins, cliquez sur OK pour charger la requête dans la zone centrale du panneau. Le filtre est alors prêt à être appliqué.
Générateur de requêtes
Pour utiliser le générateur de requêtes, cliquez sur le bouton Builder du panneau afin d’ouvrir la boîte de dialogue Création d’une requête à partir du circuit imprimé. Cette boîte de dialogue vous permet de créer une requête ciblant des objets spécifiques du document de conception en construisant une chaîne de conditions combinées par des opérateurs ET et/ou OU. La partie gauche de la boîte de dialogue sert à définir les conditions nécessaires pour cibler l’ensemble d’objets souhaité. Initialement, l’entrée de la colonne Condition Type/Operator est Add first condition. Un clic sur cette entrée affiche une liste déroulante des types de conditions.
Seuls les types de conditions pertinents pour la conception d’un circuit imprimé sont répertoriés.
Sélectionnez la condition souhaitée, puis cliquez dans la colonne Condition Value pour accéder à une liste déroulante des valeurs possibles pour ce type de condition. À mesure que vous définissez une condition dans la partie gauche de la boîte de dialogue, un aperçu de la requête en cours de construction s’affiche dans la partie droite.
Continuez à ajouter des conditions pour affiner l’ensemble des objets de conception ciblés selon vos besoins. Les conditions peuvent être combinées par des opérateurs ET ou OU. L’opérateur logique par défaut est ET ; il est automatiquement inséré lorsque vous ajoutez une condition.
Pour modifier l’opérateur logique entre les conditions, cliquez sur l’entrée ET ou OU dans la colonne Condition Type/Operator, puis sélectionnez l’opérateur souhaité. L’aperçu de la requête est mis à jour en conséquence.
Définition des priorités
Les boutons
et
situés en haut de la boîte de dialogue Création d’une requête à partir du circuit imprimé permettent d’ajouter ou de supprimer des parenthèses autour de la condition actuellement sélectionnée (en augmentant ou en diminuant le retrait). Vous pouvez ainsi définir la priorité de certaines conditions combinées par des opérateurs logiques ET ou OU.
Prenons par exemple la requête suivante :
InNet('5V') AND (OnLayer('TopLayer')
La première condition a été définie avec le type de condition Belongs to Net et la valeur 16M_IN. Une autre condition a ensuite été ajoutée avec le type de condition Exists on Layer et la valeur TopLayer.
À ce stade, la deuxième condition étant sélectionnée dans la boîte de dialogue, un clic a été effectué sur le bouton fléché vers la droite. Des parenthèses ont été automatiquement ajoutées autour de la deuxième condition et il est désormais possible d’ajouter une condition à l’intérieur de cette paire de parenthèses.
La troisième condition, de type Object Kind is et de valeur Piste, est ensuite ajoutée entre les parenthèses.
Utilisez la liste déroulante Show Level en haut à gauche de la boîte de dialogue pour contrôler l’affichage des niveaux dans votre chaîne structurée de conditions. Cela revient à développer ou à réduire l’affichage des parenthèses. L’ajout de parenthèses crée un nouveau niveau. Vous pouvez afficher les niveaux 1 à 5 ; pour les niveaux supplémentaires, utilisez l’option Show All Levels.
Vous pouvez également cliquer sur les symboles de développement ou de réduction (associés à une condition entre parenthèses) pour afficher les niveaux suivants ou masquer le niveau actuel (et tous les niveaux inférieurs), respectivement. Les boutons
et
en haut de la boîte de dialogue permettent également de développer ou de réduire la condition actuellement sélectionnée.
Utilisez les boutons
et
en haut de la boîte de dialogue pour déplacer une condition sélectionnée dans la chaîne de requête. Pour une condition comportant des sous-niveaux (c’est-à-dire une condition entre parenthèses), n’importe quelle condition de la structure de niveaux peut être déplacée. Lorsque les niveaux sont développés, une condition peut être déplacée vers le bas ou vers le haut à travers les niveaux. Lorsque les niveaux sont réduits, la condition est déplacée avec la structure de niveaux.
Pour supprimer une condition, sélectionnez-la, puis cliquez sur le bouton
en haut de la boîte de dialogue ou utilisez la touche Delete.
Une fois l’expression de requête définie selon vos besoins, cliquez sur OK pour charger la requête dans la zone centrale du panneau PCB Filter. Le filtre est alors prêt à être appliqué.
Création de règles de conception
Le panneau PCB Filter permet également de créer une règle de conception dont le périmètre d’application utilise l’expression de requête actuellement définie dans la zone centrale du panneau.
Pour ajouter une nouvelle règle de conception, cliquez sur le bouton Create Rule du panneau PCB Filter. La boîte de dialogue Choose Design Rule Type s’ouvre.
Cette boîte de dialogue répertorie toutes les catégories et tous les types de règles disponibles dans le document PCB. Choisissez le type de règle à créer, puis cliquez sur OK (ou double-cliquez directement sur l’entrée). La boîte de dialogue Éditeur de règles et de contraintes PCB s’ouvre.
Le nom de la règle nouvellement créée apparaît sélectionné dans l’arborescence de navigation à gauche. L’expression de requête de la règle se trouve dans le volet supérieur droit de la boîte de dialogue.
Une règle du type choisi est créée et sa fenêtre d’édition principale s’affiche, vous permettant de définir ses contraintes spécifiques. L’expression de requête du panneau PCB Filter est insérée dans la zone Full Query de la boîte de dialogue. Affinez les paramètres de configuration de la règle selon vos besoins, puis appliquez la nouvelle règle.
Application et suppression du filtre
Une fois la requête définie et les options du panneau configurées selon vos besoins, vous pouvez appliquer le filtre en cliquant sur l’un des boutons Apply du panneau ou sur Enter.
Pour supprimer le filtre actuellement appliqué depuis le panneau, effacez l’expression de requête dans la zone centrale du panneau (sélectionnez-la et supprimez-la), puis cliquez sur l’un des boutons Apply ou appuyez sur Enter. Tous les objets de l’espace de conception redeviendront entièrement visibles et pourront être sélectionnés et modifiés.
Menus contextuels
Un clic droit dans le panneau PCB Filter permet d’accéder à des options et commandes supplémentaires via des menus contextuels.
Un clic droit dans la zone Object ou Layer du panneau ouvre un menu contextuel proposant les options suivantes :
- Toggle Check - permet d’inverser l’état des options. Les options actuellement sélectionnées seront désélectionnées, et les options désélectionnées seront sélectionnées.
- Check All - permet de sélectionner toutes les options disponibles.
- Uncheck All - permet de désélectionner toutes les options disponibles.
Remarques
Généralités
- Appuyez sur la touche F12 pour afficher ou masquer le panneau dans l’espace de travail.
- Le générateur de requêtes (boîte de dialogue Building Query from Board) offre une méthode simple pour construire une requête à l’aide de types de conditions et de valeurs adaptés au contexte, qui vous permettent d’utiliser uniquement des « éléments de construction » pertinents. Pour construire des requêtes avancées, avec une spécification complète des mots-clés et de la syntaxe des opérateurs, utilisez la boîte de dialogue Query Helper.
- Les options d’affichage des objets répondant ou non aux critères du filtre appliqué étant distinctes, vous pouvez appliquer de nouvelles requêtes de filtrage en vous appuyant sur les résultats des filtrages précédents.
Lors de la construction d’expressions de requête
-
Il est vivement conseillé d’utiliser des parenthèses dès qu’il existe un risque que la requête soit mal interprétée.
-
Les parenthèses ont la priorité la plus élevée dans l’ordre de priorité défini pour les différents opérateurs disponibles. Cet ordre détermine la manière dont le logiciel interprète les requêtes lorsque l’utilisateur n’a pas ajouté de parenthèses. L’ordre de priorité est le suivant :
Brackets
Not
^, *, /, Div, Mod, And
+, -, Or, Xor
=, <>, <, >, <=, >=
&&, ||
Cet ordre de priorité est similaire à celui utilisé dans les langages de type Pascal. Toutefois, un usage généreux des parenthèses élimine toute ambiguïté et facilite la lecture des requêtes par d’autres utilisateurs. -
Les ambiguïtés sont résolues de gauche à droite.
-
Les parenthèses sont évaluées de l’intérieur vers l’extérieur et, à niveau égal, de gauche à droite.
Panneau PCBLIB Filter
Résumé
Le panneau PCBLIB Filter fournit des commandes permettant de construire des filtres en créant des requêtes logiques. Un filtre défini peut ensuite être appliqué à l’empreinte de composant PCB active ou à toutes les empreintes de composants de la bibliothèque PCB active, ce qui vous permet de sélectionner et de modifier plusieurs objets avec une grande précision et une grande efficacité.
Accès au panneau
Vous pouvez accéder au panneau depuis l’éditeur de bibliothèques PCB de différentes manières :
- Cliquez sur le bouton Panels en bas à droite de l’espace de travail, puis sélectionnez l’entrée PCBLIB Filter.
- Cliquez sur View » Panels » PCBLIB Filter dans les menus principaux.
- Utilisez le raccourci clavier F12.
Sections du panneau
Le panneau PCBLIB Filter se compose de trois zones. Les deux premières sont des listes de sélection qui définissent conjointement la portée du filtrage : Object et Layer. La troisième zone, Filter, affiche la requête créée en fonction des objets et des couches actuellement sélectionnés.
Construction d’expressions de filtrage simples
La zone principale du panneau fournit des commandes permettant de construire rapidement des expressions de filtrage simples ciblant n’importe quelle combinaison d’objets. Les types d’objets sont disposés dans une « matrice d’objets » et classés selon qu’il s’agit d’objets de net (Net), d’objets de composant (Comp) ou d’objets libres (Free). La liste d’objets de base suivante est reprise dans chacun de ces trois groupes :
- Piste
- Arc
- Via
- Pastille
- Remplissage
- Région
L’objet Text est disponible dans les groupes Comp et Free . Toutefois, comme ce type d’objet ne gère pas l’appartenance à un net, il ne figure pas dans le groupe Net . En outre, le groupe Free comprend également Component, ComponentBody, Room et Polygon.
Si ces paramètres sont définis sur « Components » et « Top Layer », par exemple, la vue de la carte mettra en évidence les composants de la couche supérieure. Les sélections effectuées dans les deux sections du panneau représentent l’effet cumulé de plusieurs étapes de filtrage, ce qui permet de mettre rapidement en évidence n’importe quel type d’objet de conception.
Pour utiliser un objet dans la construction d’une expression de filtrage, c’est-à-dire pour filtrer selon cet objet, cochez la case correspondante dans la matrice d’objets. Les commandes du menu contextuel de cette zone permettent de cocher ou de décocher rapidement toutes les entrées de la matrice, ou encore d’inverser l’état de toutes les cases à cocher.
Utilisez la zone Layer pour limiter le filtre à une ou plusieurs couches particulières, ou à une classe de couches spécifique. Les entrées répertoriées correspondent aux éléments suivants :
-
Les classes de couches définies pour la carte, dont les classes par défaut sont :
- <All Layers>
- <Component Layers>
- <Electrical Layers>
- <Signal Layers>
- Les couches définies dans l’empilage des couches (tel qu’il est présenté dans Layer Stack).
- Les couches supérieure et inférieure de masque de pâte à braser.
À mesure que vous choisissez vos critères de filtrage, l’expression de requête correspondante est construite dynamiquement et affichée dans la zone Filter du panneau. Une fois l’expression de requête de filtrage définie comme souhaité, vous devez l’appliquer séparément. Pour ce faire, cliquez sur le bouton Apply to All en bas du panneau. Si vous souhaitez l’appliquer uniquement aux objets actuellement sélectionnés dans l’espace de travail, utilisez plutôt le bouton Apply to Selected.
Application du filtrage
Les composants d’une bibliothèque PCB sont constitués de primitives (arcs, pastilles, pistes, etc.) disposées sur différentes couches de la carte. Ces objets sont soit « libres », soit « rattachés » à un objet de groupe. Notez que la sélection de Free dans la zone Object met uniquement en surbrillance les objets qui ne font pas partie d’un objet de groupe.
Filtrage par objet
La sélection dans la liste Object du panneau filtre la vue de la carte pour afficher les primitives de conception. Tous les objets sont mis en surbrillance, sauf si les paramètres de la liste de filtres Layer modifient ce comportement.

L’exemple de carte est présenté avec Track et Arc sélectionnés sous Object. Layer est réglé sur Top Overlay.
Filtrage par couche
La sélection dans la liste Layers du panneau filtre la vue de la carte pour afficher les objets situés sur la couche physique de conception désignée (couches de signal, de masque et de sérigraphie). Tous les objets des couches concernées sont mis en surbrillance, sauf si les paramètres de la liste de filtres Object modifient ce comportement.

L’exemple de carte est présenté avec Object réglé sur Pad. Layer réglé sur Top Layer.
Sélection des objets filtrés
L’action de filtrage globale proposée par le panneau PCBLIB Filter facilite à la fois la visualisation et la sélection des objets de conception de carte qui vous intéressent.
Seuls les objets mis en surbrillance (filtrés) peuvent être sélectionnés, ce qui permet de les localiser, de les modifier et d’obtenir des informations à leur sujet facilement.
Suppression du filtre
Supprimez le filtre actuellement appliqué à l’aide du bouton Clear du panneau.
Configuration du filtrage visuel
Le résultat visuel du filtrage appliqué au document dans l’espace de travail est déterminé par une série de commandes de mise en surbrillance. L’effet appliqué dans la vue de l’éditeur peut être défini sur Normal, Mask ou Dim ; en pratique, Mask produit l’effet de mise en surbrillance le plus marqué.
La liste déroulante Normal / Mask / Dim propose des options permettant de différencier visuellement les objets filtrés des objets non filtrés dans l’espace de travail.

Sélectionnez le type de filtrage visuel à appliquer à l’aide de la liste déroulante des modes de masquage.
Effet de mise en surbrillance visuelle pour chaque mode de masquage :
- Normal - les objets filtrés sont visibles dans l’espace de travail et l’apparence des objets non filtrés reste inchangée.
- Mask - les objets filtrés sont mis en surbrillance dans l’espace de travail, tous les autres objets étant affichés en monochrome.
- Dim - les objets filtrés sont mis en surbrillance dans l’espace de travail, tous les autres objets conservant leurs couleurs, mais étant estompés.
Définition des requêtes de filtrage
La zone centrale du panneau vous permet de créer des filtres en saisissant des requêtes logiques.
Vous pouvez saisir une requête directement dans le champ. Pendant la saisie, une liste de suggestions de mots-clés s’affiche pour vous aider.
Deux fonctionnalités sont disponibles pour vous aider à créer des requêtes : l’Assistant de requête et le Générateur de requête. Ces outils peuvent être très utiles si vous avez des doutes sur la syntaxe d’une requête ou sur les mots-clés que vous pouvez utiliser.
Assistant de requête
Pour utiliser l’Assistant de requête, cliquez sur le bouton Helper afin d’ouvrir la boîte de dialogue Assistant de requête. Le moteur de requête sous-jacent analyse le document et répertorie tous les objets disponibles, ainsi que les mots-clés génériques utilisables dans les requêtes.
Utilisez la partie supérieure de la boîte de dialogue pour composer une expression de requête à l’aide des éléments PCB Functions, PCB Object Lists et System Functions disponibles. La zone centrale de la boîte de dialogue propose différents opérateurs pour construire une expression. Utilisez le bouton Check Syntax pour vérifier que la syntaxe d’une expression est correcte.
Une fois l’expression de requête définie comme souhaité, cliquez sur OK pour charger la requête dans la zone centrale du panneau PCBLIB Filter, prête à être appliquée comme filtre.
Générateur de requête
Pour utiliser le Générateur de requête, cliquez sur le bouton Builder du panneau PCBLIB Filter afin d’ouvrir la boîte de dialogue Création d’une requête à partir de la carte.
Cette boîte de dialogue vous permet de créer une requête ciblant des objets spécifiques du document de conception, en construisant simplement une chaîne de conditions reliées par des opérateurs AND et/ou OR.
La partie gauche de la boîte de dialogue vous permet de spécifier les conditions nécessaires pour cibler l’ensemble d’objets souhaité. Initialement, l’entrée dans la colonne Condition Type/Operator est Add first condition. Cliquez une fois sur cette entrée pour ouvrir une liste déroulante des types de conditions.
Les types de conditions répertoriés sont uniquement ceux qui s’appliquent à une conception de carte.
Sélectionnez la condition, puis cliquez dans la colonne Condition Value pour accéder à une liste déroulante des valeurs possibles pour ce type de condition. À mesure que vous définissez une condition dans la partie gauche de la boîte de dialogue, un aperçu de la requête en cours de construction s’affiche à droite.
Continuez à ajouter des conditions pour affiner l’ensemble des objets de conception ciblés selon vos besoins. Les conditions peuvent être reliées par des opérateurs AND ou OR. L’opérateur logique par défaut est AND ; il est inséré automatiquement lorsque vous ajoutez une autre condition.
Pour modifier l’opérateur logique entre les conditions, cliquez sur l’entrée AND ou OR dans la colonne Condition Type/Operator, puis sélectionnez l’opérateur souhaité. L’aperçu de la requête est mis à jour en conséquence.
Définition de l’ordre de priorité
Les boutons
et
situés en haut de la boîte de dialogue Création d’une requête à partir de la carte permettent d’ajouter ou de supprimer des parenthèses autour de la condition actuellement sélectionnée (en augmentant ou en diminuant le retrait). Vous pouvez ainsi définir un ordre de priorité pour certaines conditions reliées par des opérateurs logiques AND ou OR.
La première condition a été définie avec le type de condition Exists on Layer et la valeur Top Layer. Une autre condition a ensuite été ajoutée avec le type de condition Object Kind is et la valeur Arc.
À ce stade, la deuxième condition étant sélectionnée dans la boîte de dialogue, le bouton flèche vers la droite a été cliqué. Des parenthèses ont été automatiquement ajoutées autour de la deuxième condition, et il est désormais possible d’ajouter une condition à l’intérieur de cette paire de parenthèses.
La troisième condition, de type In Any Polygon, est ensuite ajoutée entre les parenthèses.
Utilisez la liste déroulante Show All Levels en haut à gauche de la boîte de dialogue pour contrôler l’affichage des niveaux dans votre chaîne structurée de conditions. Cela permet essentiellement de développer ou de réduire l’affichage des parenthèses. L’ajout de parenthèses crée un nouveau niveau. Vous pouvez afficher les niveaux 1 à 5 ; pour les niveaux supplémentaires, utilisez l’option Show All Levels.
Vous pouvez également cliquer sur les symboles de développement ou de réduction associés à une condition entre parenthèses pour afficher les niveaux suivants ou masquer le niveau actuel (et tous les niveaux inférieurs), respectivement. Les boutons
et
en haut de la boîte de dialogue permettent également de développer ou de réduire la condition actuellement sélectionnée.
Utilisez les boutons
et
en haut de la boîte de dialogue pour déplacer une condition sélectionnée dans la chaîne de requête en cours de construction. Pour une condition comportant des sous-niveaux (c’est-à-dire une condition entre parenthèses), toute condition de la structure de niveaux peut être déplacée. Lorsque les niveaux sont développés, une condition peut être déplacée vers le bas ou vers le haut à travers les niveaux. Lorsque les niveaux sont réduits, une condition est déplacée par-dessus la structure de niveaux.
Pour supprimer une condition, sélectionnez-la, puis cliquez sur le bouton
en haut de la boîte de dialogue ou utilisez la touche Delete.
Une fois l’expression de requête définie comme souhaité, cliquez sur OK pour charger la requête dans la zone centrale du panneau PCBLIB Filter, prête pour l’application du filtre.
Création de règles de conception
Le panneau PCBLIB Filter permet également de créer une règle de conception. Son périmètre d’application utilisera l’expression de requête actuellement définie dans la zone centrale du panneau.
Pour ajouter une nouvelle règle de conception, cliquez sur le bouton Create Rule du panneau PCBLIB Filter. La boîte de dialogue Choose Design Rule Type s’ouvre.
Cette boîte de dialogue répertorie toutes les catégories et tous les types de règles disponibles dans le document PCB. Choisissez le type de règle à créer, puis cliquez sur OK (ou double-cliquez directement sur l’entrée). La boîte de dialogue Éditeur de règles et de contraintes PCB s’ouvre.
Le nom de la règle nouvellement créée apparaît sélectionné dans l’arborescence de navigation à gauche. L’expression de requête de la règle se trouve dans le volet supérieur droit de la boîte de dialogue.
Une règle du type choisi est créée et sa fenêtre principale d’édition s’affiche, prête à vous permettre de définir des contraintes spécifiques. L’expression de requête du panneau PCBLIB Filter est insérée dans la zone Requête complète de la boîte de dialogue. Ajustez les paramètres de configuration de la règle selon vos besoins, puis appliquez la nouvelle règle.
Application et suppression du filtre
Une fois la requête définie et les options du panneau configurées selon vos besoins, vous pouvez appliquer le filtre en cliquant sur le bouton Apply du panneau ou en appuyant sur Enter.
Pour supprimer le filtre actuellement appliqué depuis le panneau, effacez (sélectionnez et supprimez) l’expression de requête dans la zone centrale du panneau, puis cliquez sur le bouton Apply ou appuyez sur Enter. Tous les objets de l’espace de travail de conception redeviennent entièrement visibles et peuvent être sélectionnés et modifiés.
Menus contextuels
Faites un clic droit dans le panneau PCBLIB Filter pour accéder à des options et commandes supplémentaires via des menus contextuels.
Un clic droit dans la zone Object ou Layer du panneau ouvre un menu contextuel proposant les options suivantes :
- Toggle Check - permet d’inverser la sélection des options. Les options actuellement sélectionnées seront désélectionnées, et les options désélectionnées seront sélectionnées.
- Check All - permet de sélectionner toutes les options disponibles.
- Uncheck All - permet de désélectionner toutes les options disponibles.
Remarques
Généralités
- Appuyez sur la touche F12 pour afficher ou masquer le panneau dans l’espace de travail.
- Le générateur de requêtes (boîte de dialogue Création d’une requête à partir de la carte) offre une méthode simple pour construire une requête à l’aide de types et de valeurs de conditions adaptés au contexte, afin de n’utiliser que des « blocs de construction » pertinents. Pour une construction avancée des requêtes avec spécification complète des mots-clés et de la syntaxe des opérateurs, utilisez la boîte de dialogue Assistant de requête.
- Les options d’affichage des objets répondant au filtre appliqué étant distinctes de celles des objets n’y répondant pas, vous pouvez appliquer de nouvelles requêtes de filtrage aux résultats d’un filtrage précédent.
Lors de la construction d’expressions de requête
- Il est vivement conseillé d’utiliser des parenthèses dès qu’il existe un risque que la requête soit mal interprétée.
-
Les parenthèses ont la priorité la plus élevée dans l’ordre de priorité défini pour les différents opérateurs disponibles, qui détermine la manière dont le logiciel interprète les requêtes (lorsque l’utilisateur n’a pas fourni de parenthèses). Cet ordre de priorité est le suivant :
Brackets
Not
^, *, /, Div, Mod, And
+, -, Or, Xor
=, <>, <, >, <=, >=
&&, ||
Cet ordre de priorité est similaire à celui utilisé dans les langages de type Pascal. Toutefois, un usage généreux des parenthèses élimine les doutes et facilite la lecture des requêtes par d’autres personnes. - Les ambiguïtés sont résolues en procédant de gauche à droite.
- Les parenthèses sont évaluées de l’intérieur vers l’extérieur, et les expressions de même niveau sont traitées de gauche à droite.
Où se trouvent les résultats de la requête ?
Maintenant que vous avez rédigé une requête dans le panneau Filter , comment accéder aux objets renvoyés par celle-ci ? Il existe deux façons d’accéder aux objets et de les modifier dans l’environnement Altium Designer.
-
Graphiquement : après l’application d’un filtre, le comportement par défaut consiste à masquer (estomper et rendre non modifiables) tous les objets qui ne répondent pas à la requête, pour ne laisser que ceux qui y répondent. Ce mode est idéal pour localiser et examiner les objets dans l’espace de travail. Les objets masqués n’étant pas modifiables, les commandes telles que Ctrl+A (tout sélectionner) ne s’appliquent qu’aux objets renvoyés par la requête.
-
List panneau - le panneau List (Shift+F12) présente les données de votre conception sous une forme semblable à celle d’une feuille de calcul. Par défaut, il affiche tous les objets de conception, mais une fois un filtre appliqué, il affiche uniquement les objets renvoyés par la requête. Le panneau List offre les fonctions classiques de tri et de sélection d’une feuille de calcul, ce qui vous permet de modifier directement une ou plusieurs cellules.
Les panneaux PCB List et SCH List affichent les résultats des requêtes PCB/SCH de la section précédente.
Options de mise en évidence
Chaque fois qu’une requête est appliquée (ou que la fonction de filtrage des données est utilisée d’une autre manière), chaque objet du document cible est évalué dans le cadre de cette opération de filtrage. Toutefois, l’affichage ultérieur des objets inclus dans les résultats et de ceux qui n’y figurent pas dépend des options de mise en évidence sélectionnées dans le panneau Filter . Trois options de mise en évidence sont disponibles. Elles sont totalement indépendantes les unes des autres : vous pouvez donc en sélectionner une, deux ou les trois.
Zoom
Lorsque l’option Zoom est activée au moment de l’application de la requête, la vue du document cible est actualisée pour afficher la zone occupée par l’ensemble des objets figurant dans les résultats. L’affichage de chacun des autres objets dans la vue actualisée dépend de sa position par rapport à cette zone : ces objets peuvent donc être entièrement visibles, partiellement visibles ou totalement hors du champ d’affichage.
Cette option est souvent sélectionnée en association avec l’une ou les deux autres options. Si l’option Mask n’a pas été activée, les objets qui ne figurent pas dans les résultats restent affichés dans la vue graphique s’ils se trouvent dans les nouvelles limites de la vue. À première vue, sélectionner cette option seule peut sembler inutile, mais il peut arriver que vous souhaitiez actualiser la vue graphique pour qu’elle englobe certains objets, sans modifier l’état de sélection ou de masquage des objets du document.
Sélection
Lorsque l’option Select est activée, tous les objets figurant dans les résultats sont sélectionnés, tandis qu’aucun des autres objets ne l’est. Les objets sélectionnés sont affichés de manière à mieux se distinguer des objets non sélectionnés.
Si l’option Sélection est activée lors de l’application de la requête en cours, tous les objets appartenant à l’ensemble des résultats passent à l’état sélectionné, tandis que tous les autres objets (qui n’appartiennent pas à cet ensemble) passent à l’état non sélectionné. Cette option est généralement activée juste avant des opérations de modification globale, car seules les propriétés des objets alors sélectionnés sont mises à jour. L’option Sélection peut toutefois être utile dans d’autres situations, par exemple pour déplacer, copier ou supprimer certains objets.
Masquage
L’option de mise en évidence Mask détermine le nouvel état de masquage des objets dans le document cible. Lorsqu’elle est sélectionnée, tous les objets figurant dans les résultats sont masqués, tandis que tous les autres objets ne le sont pas. La principale caractéristique des objets masqués est qu’il est impossible de les modifier ou de modifier leurs propriétés. (Les objets masqués apparaissent grisés dans la vue en liste, mais ils n’y sont affichés que si l’option all objects est sélectionnée dans le panneau List .) La principale caractéristique des objets masqués est qu’il est impossible de modifier l’objet ou ses propriétés.
Le générateur de requêtes
L’éditeur PCB comprend une boîte de dialogue dédiée, Query Builder. Cette boîte de dialogue vous permet de créer des requêtes complexes en choisissant des conditions de test dans des listes déroulantes. L’un des avantages de Query Builder est de vous permettre de créer une requête ciblant différents types d’objets.
La boîte de dialogue « Building Query » (qui fait partie de la fonction « Query Builder ») aide les utilisateurs moins expérimentés à définir des requêtes : une requête est générée automatiquement à partir des conditions spécifiées par le concepteur.
La partie gauche de cette boîte de dialogue contient des commandes destinées à aider le concepteur à définir les propriétés que doit posséder chaque objet du document pour être renvoyé par la requête générée. À mesure que ces conditions sont définies ou modifiées, le contenu de la requête correspondante est actualisé et affiché dans la partie droite de la boîte de dialogue. Si vous fermez ensuite cette boîte de dialogue en cliquant sur le bouton OK (ou Apply), la requête associée est appliquée ou son contenu est recopié dans le panneau Filter, selon la manière dont la boîte de dialogue a été ouverte.
La boîte de dialogue Query Builder peut être ouverte depuis les emplacements suivants (comme illustré dans l’image ci-dessous) :
- Dans le panneau PCB Filter, cliquez sur le bouton Query Builder pour créer une requête et charger la chaîne correspondante dans le panneau.
- Dans la boîte de dialogue PCB Rules and Constraints Editor, cliquez sur le bouton Builder pour créer une requête définissant les objets auxquels cette règle s’applique.
L’image ci-dessous montre l’utilisation de la boîte de dialogue Query Builder pour créer une requête ciblant à la fois les pastilles et les vias du réseau 5V.

La boîte de dialogue Query Builder
Options et commandes de la boîte de dialogue du générateur de requêtes
-
Show All Levels - utilisez la liste déroulante pour contrôler l’affichage des niveaux dans la chaîne structurée de conditions. Cela permet essentiellement de développer ou de réduire l’affichage des parenthèses. L’ajout de parenthèses crée un nouveau niveau, et vous pouvez afficher les niveaux 1 à 5. Vous pouvez également cliquer sur les symboles de développement ou de réduction pour, respectivement, afficher les niveaux suivants ou masquer le niveau actuel (ainsi que tous les niveaux inférieurs).
-
- permet de supprimer les parenthèses entourant la condition actuellement sélectionnée (en diminuant le retrait). Cela vous permet de définir la priorité de certaines conditions combinées par un ET logique ou un OU logique.
-
- permet d’ajouter des parenthèses autour de la condition actuellement sélectionnée (en augmentant le retrait). Cela vous permet de définir la priorité de certaines conditions combinées par un ET logique ou un OU logique.
-
- permet de déplacer une condition sélectionnée vers le haut dans la chaîne de requête en cours de création. Pour une condition comportant des sous-niveaux (c’est-à-dire une condition entre parenthèses), toute condition de la structure de niveaux peut être déplacée. Lorsque les niveaux sont développés, une condition peut être déplacée vers le haut à travers les niveaux. Lorsque les niveaux sont réduits, une condition est déplacée au-delà de la structure de niveaux.
-
- permet de déplacer une condition sélectionnée vers le bas dans la chaîne de requête en cours de création. Pour une condition comportant des sous-niveaux (c’est-à-dire une condition entre parenthèses), toute condition de la structure de niveaux peut être déplacée. Lorsque les niveaux sont développés, une condition peut être déplacée vers le bas à travers les niveaux. Lorsque les niveaux sont réduits, une condition est déplacée au-delà de la structure de niveaux.
-
- utilisez les symboles de développement pour afficher les niveaux suivants.
-
- permet de réduire les symboles pour masquer le niveau actuel (et tous les niveaux inférieurs).
-
- permet de supprimer la condition sélectionnée.
- Condition Type/Operator - utilisez cette zone pour spécifier la ou les conditions requises pour cibler l’ensemble d’objets souhaité. Initialement, l’entrée de la colonne Condition Type/Operator sera Add first condition. Cliquez une fois sur cette entrée pour ouvrir une liste déroulante de types de conditions. Cette liste dépend de l’endroit depuis lequel la boîte de dialogue a été ouverte. Si vous créez une requête pour une règle de conception particulière dans la boîte de dialogue PCB Rules And Constraints Editor , la liste ne proposera que les types de conditions possibles pour ce type de règle.
- Condition Value - choisissez la première condition, puis cliquez dans la colonne Condition Value pour accéder à une liste déroulante des valeurs possibles pour ce type de condition. À mesure que vous définissez une condition, un aperçu de la requête en cours de création s’affiche dans la zone Query Preview.
L’Assistant de requête
L’étape suivante pour améliorer vos compétences en rédaction de requêtes consiste à utiliser la boîte de dialogue Query Helper . La boîte de dialogue Query Helpercomprend une zone Query dans laquelle vous pouvez saisir la requête souhaitée, tout en utilisant les boutons de syntaxe situés sous le champ Query (par exemple, And, Or, <, Not, Like, etc.), ainsi qu’une liste complète de tous les mots-clés de requête dans le champ Categories .
La boîte de dialogue « Assistant de requête » aide les concepteurs qui souhaitent définir leurs propres requêtes. Une brève description est fournie pour chaque mot-clé répertorié, mais vous pouvez accéder à l’aide en ligne en appuyant sur la touche F1 lorsqu’un mot-clé est sélectionné. Cela ouvre la boîte de dialogue de la bibliothèque de documentation d’Altium Designer, qui précise quels objets d’un document sont renvoyés par le mot-clé sélectionné, comment l’utiliser, et fournit un ou plusieurs exemples d’utilisation.
Vous pouvez accéder à cette boîte de dialogue des manières suivantes :
- Cliquez sur le bouton Helper dans le panneau Filter .
PCB Filter accès au panneau
SCH Filter accès au panneau
-
Dans la boîte de dialogue Recherche dans les bibliothèques de fichiers (accessible en cliquant sur
dans le coin supérieur droit du panneau Composants, puis en choisissant File-based Libraries Search dans le menu déroulant), cliquez sur le bouton Helper .
File-based Libraries Search accès à la boîte de dialogue
Utilisez la section Query située en haut de la boîte de dialogue pour composer une expression de requête à l’aide des fonctions disponibles. Dans la zone de texte, vous pouvez vérifier et/ou modifier davantage l’expression de recherche. Saisissez directement du texte dans cette zone pour modifier l’expression de recherche. Pour rechercher des mots-clés spécifiques à ajouter, commencez à saisir du texte. Pendant la saisie, la boîte de dialogue propose un menu déroulant de mots-clés disponibles correspondant au texte déjà saisi. Cliquez sur un mot-clé pour compléter automatiquement votre saisie. Si le mot-clé souhaité est sélectionné, appuyez sur Enter pour compléter également votre sélection automatiquement.
Parcourez la Categories des mots-clés disponibles pour trouver celui que vous souhaitez. Utilisez le champ Mask si vous ne connaissez pas le mot-clé exact. Par exemple, dans Query Helperde l’éditeur de schémas, saisir *har dans le champ Mask permet de trouver les mots-clés qui s’appliquent spécifiquement aux faisceaux, comme illustré dans l’image ci-dessous. Notez que le champ Mask effectue la recherche à la fois dans le champ Name du mot-clé et dans le champ Description ; il peut donc constituer le moyen le plus rapide de trouver des mots-clés possibles.
Double-cliquez sur un mot-clé dans la grille pour l’ajouter à la requête à la position actuelle du curseur.
La zone centrale de la boîte de dialogue comprend des boutons de syntaxe qui proposent différents opérateurs à utiliser lors de la création d’une expression. Pour plus d’informations sur la fonction de chaque bouton de syntaxe, consultez la section Opérateurs logiques des expressions de requête ci-dessous. Utilisez le bouton Check Syntax (en bas à gauche de la boîte de dialogue) pour vérifier qu’une expression est syntaxiquement correcte.
Historique des requêtes
Lorsque vous saisissez et appliquez une nouvelle requête depuis un panneau de filtrage (SCH Filter / SCHLIB Filter, PCB Filter / PCBLIB Filter), elle est ajoutée à l’historique des requêtes. Cliquez sur le bouton History du panneau pour accéder à cette liste. La boîte de dialogue Expression Manager s’ouvre avec l’onglet History actif.
L’onglet Historique de la boîte de dialogue Expression Manager présente la liste des expressions de requête utilisées précédemment. Un exemple d’historique des requêtes pour le schéma est présenté ici. Survolez l’image avec la souris pour afficher un exemple de liste similaire pour le PCB.
Pour utiliser une requête de l’historique, sélectionnez son entrée et cliquez sur le bouton Apply Expression ou double-cliquez directement sur l’entrée. La boîte de dialogue se ferme et l’expression de la requête est chargée dans la zone centrale du panneau de filtrage concerné.
Une requête de l’historique peut être ajoutée à la liste des requêtes favorites en sélectionnant son entrée, puis en cliquant sur le bouton Add To Favorites. Utilisez le bouton Clear History si vous souhaitez vider l’historique.
Jusqu’à neuf des expressions de requête les plus récemment utilisées dans la liste sont accessibles depuis le sous-menu History du menu contextuel du panneau de filtrage.
Requêtes favorites
Toute requête définie peut être ajoutée à une liste de requêtes favorites de deux manières :
- Cliquez sur le bouton Add To Favorites ou faites un clic droit dans la zone principale Query Expression et choisissez la commande Add to Favorites dans le menu contextuel pour ajouter l’expression de requête actuellement définie dans la zone centrale du panneau de filtrage actif.
- Sélectionnez une entrée de l’historique des requêtes dans l’onglet History de la boîte de dialogue Expression Manager, puis cliquez sur le bouton Add To Favorites.
Les expressions de requêtes favorites sont enregistrées et gérées dans l’onglet Favorites de la boîte de dialogue Expression Manager. Vous pouvez y accéder à l’aide du bouton Favorites d’un panneau de filtrage (SCH Filter / SCHLIB Filter, PCB Filter / PCBLIB Filter) ou en faisant un clic droit dans la zone principale Query Expression d’un panneau de filtrage, puis en choisissant la commande Organize Favorites dans le menu contextuel. Depuis l’espace de conception, vous pouvez accéder à cette boîte de dialogue à l’aide du raccourci clavier Y, puis en sélectionnant Organize Favorites dans le menu de filtrage contextuel.
Accédez à la liste de vos requêtes favorites depuis le panneau de filtrage de l’éditeur ou depuis l’espace de conception, à l’aide du menu de filtrage contextuel.
Lorsqu’une expression de requête est ajoutée à la liste Favorites , un nom unique lui est attribué. Par défaut, un nom générique est attribué — Favorite_n — où n est le prochain numéro disponible non utilisé. Le nom d’une entrée peut être modifié à tout moment à l’aide de l’une des méthodes suivantes :
- Sélectionnez l’entrée de la requête, puis cliquez sur le bouton Rename.
- Sélectionnez l’entrée de la requête, puis choisissez la commande Modifier dans le menu contextuel.
- Sélectionnez l’entrée de la requête, puis cliquez à nouveau dans le champ Name.
Dans chaque cas, saisissez le nouveau nom souhaité, puis cliquez en dehors du champ Name pour appliquer la modification.
Pour modifier une expression de requête favorite, sélectionnez son entrée dans la liste, puis cliquez sur le bouton Edit (ou faites un clic droit et choisissez Edit dans le menu contextuel). La boîte de dialogue Edit Favorite s’ouvre. Utilisez cette boîte de dialogue pour modifier le nom du favori, modifier l’expression elle-même et définir le traitement des objets de conception (aussi bien ceux qui répondent aux critères du filtre que ceux qui n’y répondent pas).
Modifiez une requête favorite existante à l’aide de la boîte de dialogue Edit Favorite, illustrée ici pour les schémas (à gauche) et les PCB (à droite).
Pour supprimer une requête de la liste Favorites , sélectionnez son entrée dans la liste, puis cliquez sur le bouton Remove ou choisissez la commande Remove dans le menu contextuel. Une boîte de dialogue vous demande de confirmer la suppression.
Utilisation des requêtes favorites
Vous pouvez utiliser vos requêtes favorites de trois manières :
-
Depuis l’onglet Favorites de la boîte de dialogue Expression Manager : sélectionnez l’entrée de la requête, puis cliquez sur le bouton Apply Expression, ou double-cliquez sur son entrée. La boîte de dialogue se ferme et l’expression de la requête est chargée dans la zone centrale du panneau de filtrage concerné.
-
Depuis le haut du menu contextuel du panneau de filtrage (jusqu’à dix des expressions de requête les plus récemment ajoutées à la liste Favorites sont disponibles).
-
Depuis le menu de filtrage contextuel de l’espace de conception (appuyez sur Y) : jusqu’à dix expressions de requêtes favorites sont répertoriées en haut du menu. L’expression de requête choisie est chargée dans la zone centrale du panneau de filtrage concerné.
Utilisation des exemples prédéfinis
Les éditeurs de schémas et de PCB sont tous deux fournis avec un ensemble d’exemples de requêtes prédéfinis. Ces exemples sont disponibles dans le menu de filtrage, accessible soit par un clic droit dans la zone d’expression du panneau de filtrage, soit à l’aide du raccourci clavier Y dans l’espace de conception. Survolez Examples pour afficher le sous-menu.
Lorsque vous sélectionnez une entrée du sous-menu, la requête correspondant à ce filtre est appliquée. Pour consulter la requête réelle correspondant à l’un des exemples, examinez la liste History après l’avoir appliquée. Vous pouvez également accéder à cette liste depuis le menu de filtrage contextuel.
Outils de création de requêtes
Le moyen le plus simple d’écrire une requête est peut-être de laisser Altium Designer le faire pour vous ! Pour cela, vous pouvez utiliser la boîte de dialogue Find Similar Objects ou la boîte de dialogue Query Builder .
Boîte de dialogue Rechercher des objets similaires
Lorsque vous utilisez la boîte de dialogue Rechercher des objets similaires, celle-ci génère une requête pour rechercher les objets souhaités. Si l’option Create Expression est activée, cette requête s’affiche dans le panneau Filter . Il s’agit d’une excellente méthode pour apprendre les différents mots-clés de requête.
La boîte de dialogue Find Similar Objects s’ouvre lorsque vous faites un clic droit sur un objet non masqué de votre document de conception, puis sélectionnez Find Similar Objects dans le menu contextuel.
Image de gauche : version PCB ; image de droite : version SCH
Cette boîte de dialogue vous permet de rechercher des objets similaires à celui sur lequel vous avez effectué un clic droit, puis de définir les attributs de l'objet qui doivent être identiques (ou différents) pour qu'une correspondance soit établie. Supposons que vous souhaitiez modifier toutes les pastilles GND de votre conception. Vous pouvez effectuer un clic droit sur l'une de ces pastilles, choisir Find Similar Objects, puis remplacer la valeur du champ Net , initialement définie sur Any (valeur par défaut), par Same. Toutes les pastilles GND seront sélectionnées lorsque vous cliquerez sur Apply dans la boîte de dialogue. Si l'option Create Expression est activée, la requête suivante s'affichera dans le panneau Filter : (ObjectKind = 'Pad') And (Net = 'GND').
Dans un schéma, par exemple, vous pouvez attribuer une même valeur à la propriété Color de tous les objets d'alimentation dont la propriété Text possède une valeur particulière (par exemple « GND ») dans un document. Dans un PCB, par exemple, vous pouvez attribuer une même valeur à la propriété Hole Size de tous les vias dont la propriété Via Diameter possède une valeur particulière dans un document.
Option d'effacement de la sélection existante
Activez l'option Clear Existing pour effacer toute sélection ou tout masque d'édition existant avant d'appliquer la recherche. Désactivez cette option si vous effectuez des recherches successives et souhaitez cumuler les résultats.
Barre d'outils de filtrage
La barre d'outils Filter Toolbar est disponible pour les documents PCB et permet de masquer tous les objets d'un document, à l'exception de ceux possédant une propriété donnée ou de ceux faisant partie d'un composant donné. Le champ situé à l'extrémité droite de la barre d'outils permet de définir le contenu d'une requête. Vous pouvez saisir la requête dans ce champ ou utiliser la liste déroulante pour sélectionner une requête récente (présente dans la liste History des requêtes). Il n'est pas possible de spécifier les options à utiliser lorsque les requêtes sont appliquées depuis Filter Toolbar et, dans tous les cas, toute requête précédente est effacée, puis les options de masquage et de zoom sont utilisées avec la requête actuelle. Pour utiliser les options de requête, utilisez le panneau Filter , la boîte de dialogue Query Builder, la boîte de dialogue Query Helper ou la boîte de dialogue Find Similar Objects .
Opérateurs des expressions de requête logiques
Vous trouverez ci-dessous un récapitulatif des opérateurs utilisables pour définir des expressions de requête logiques avec le langage de requête.
Opérateurs arithmétiques
| Opérateur | Description | Exemple |
|---|---|---|
| + | Opérateur d'addition | NetPinCount + NetViaCount |
| - | Opérateur de soustraction | ArcStopAngle - ArcStartAngle |
| * | Opérateur de multiplication | PadXSize_BottomLayer * PadYSize_BottomLayer |
| / | Opérateur de division | HoleDiameter / ViaDiameter |
| Div | Opérateur de division entière | Color Div 65536 Calcule le quotient de Color par 65536 en supprimant la partie décimale du résultat |
| Mod | Opérateur modulo | Color Mod 256 Calcule le reste de la division de Color par 256, sans déterminer la partie décimale du résultat |
Opérateurs logiques
| Opérateur | Description | Exemple |
|---|---|---|
| And | Opérateur logique ET | IsPad And OnMultiLayer Pour être renvoyé, un objet doit être une pastille et se trouver sur la couche Multi-Layer |
| && | Opérateur logique ET (priorité inférieure) |
IsPad && OnMultiLayer Pour être renvoyé, un objet doit être une pastille et se trouver sur la couche Multi-Layer |
| Or | Opérateur logique OU | IsPad Or IsVia Pour être renvoyé, un objet doit être une pastille ou un via |
| || | Opérateur logique OU (priorité inférieure) |
IsPad || IsVia Pour être renvoyé, un objet doit être une pastille ou un via |
| Xor | Opérateur logique OU EXCLUSIF | OnMultiLayer Xor (HoleDiameter <> 0) Pour être renvoyé, un objet doit soit se trouver sur la couche Multi-Layer et avoir une valeur de Hole Diameter égale à zéro, soit ne pas se trouver sur la couche Multi-Layer et avoir une valeur de Hole Diameter différente de zéro. |
| Not | Opérateur logique NON | Not OnMultiLayer Pour être renvoyé, un objet ne doit pas se trouver sur la couche Multi-Layer |
Opérateurs de comparaison
| Opérateur | Description | Exemple |
|---|---|---|
| < | Opérateur strictement inférieur à | HoleDiameter < 40 Pour être renvoyé, un objet doit avoir une valeur de Hole Diameter strictement inférieure à 40 |
| <= | Opérateur inférieur ou égal à | HoleDiameter <= 40 Pour être renvoyé, un objet doit avoir une valeur de Hole Diameter inférieure ou égale à 40 |
| >= | Opérateur supérieur ou égal à | HoleDiameter >= 40 Pour être renvoyé, un objet doit avoir une valeur de Hole Diameter supérieure ou égale à 40 |
| > | Opérateur strictement supérieur à | HoleDiameter > 40 Pour être renvoyé, un objet doit avoir une valeur de Hole Diameter strictement supérieure à 40 |
| <> | Opérateur différent de | HoleDiameter <> 40 Pour être renvoyé, un objet doit avoir une valeur de Hole Diameter différente de 40 |
| = | Opérateur égal à | HoleDiameter = 40 Pour être renvoyé, un objet doit avoir une valeur de Hole Diameter égale à 40 |
| Between...And... | Opérateur d'intervalle inclusif | HoleDiameter Between 30 And 50 Pour être renvoyé, un objet doit avoir une valeur de Hole Diameter supérieure ou égale à 30 et inférieure ou égale à 50. |
| Like | Opérateur Like | Name Like 'ADDR?*' Renvoie les objets dont la propriété Name possède une chaîne de texte commençant par ADDR et contenant au moins un caractère supplémentaire |
Caractères génériques
Les caractères génériques permettent de définir des chaînes qui ne sont pas entièrement spécifiées. Ils sont généralement utilisés avec d’autres caractères, ce qui permet de définir des chaînes partiellement spécifiées. Quelques mots-clés particuliers acceptent des paramètres de chaîne qui ne sont pas entièrement spécifiés, mais, dans la plupart des cas, les chaînes ne peuvent contenir des caractères génériques que lorsqu’elles sont comparées à l’aide de l’opérateur Like.
| Opérateur | Description | Exemple |
|---|---|---|
| ? | Peut être remplacé par un seul caractère de n’importe quel type | Footprint Like 'DIP1?' Renvoie les objets dont la propriété Footprint a pour valeur DIP10, DIP12, DIP14, etc. |
| * | Peut être remplacé par un nombre quelconque de caractères, chacun pouvant être de n’importe quel type | Footprint Like 'SIP*' Renvoie les objets dont la propriété Footprint a pour valeur SIP1, SIP12, SIP216, etc. (Les objets dont la propriété Footprint a pour valeur SIP sont également renvoyés, car « * » peut aussi être remplacé par no caractères.) |
Chaînes booléennes
| Opérateur | Description | Exemple |
|---|---|---|
| True | Confirme le sens d’un mot-clé | IsPad = True Pour être renvoyé, un objet doit être une pastille |
| False | Inverse le sens d’un mot-clé | IsVia = False Pour être renvoyé, un objet ne doit pas être un via |
Parenthèses et ordre de priorité
Il est utile d’examiner l’ordre de priorité des opérateurs utilisés dans les expressions logiques de requête. Sans cette connaissance, une expression risque en effet de ne pas cibler les objets souhaités.
Les parenthèses ont la priorité la plus élevée dans l’ordre de priorité défini pour les différents opérateurs, lequel détermine la manière dont le logiciel interprète les requêtes lorsque l’utilisateur n’a pas ajouté de parenthèses. Cet ordre, de la priorité la plus élevée à la plus faible, est le suivant :
- Parenthèses ()
- Not
- ^, *, /, Div, Mod, And
- +, -, Or, Xor
- =, <>, <, >, <=, >=
- &&, ||
Fonctions de requête système globales

Fonctions de requête système globales affichées dans la boîte de dialogue Query Helper
Cette section décrit les mots-clés du langage de requête disponibles dans les documents de schéma, de PCB et de bibliothèque d’Altium Designer. Pour obtenir de l’aide sur un mot-clé de requête particulier, utilisez les sections dépliables suivantes ou sélectionnez ce mot-clé (ou cliquez à l’intérieur), dans Query Helper, dans un panneau Filter ou dans le champ Query d’une règle de conception de PCB, puis appuyez sur F1 pour accéder directement à la section correspondante.
Fonctions arithmétiques
ABS
Résumé
Renvoie un nombre réel égal à la valeur absolue de la valeur numérique du paramètre. Si cette valeur numérique est positive, le nombre renvoyé a la même valeur ; sinon, le nombre renvoyé est égal à la valeur numérique du paramètre multipliée par -1.
Syntaxe
ABS(X : Number / Numeric_String) : Number
Exemples d’utilisation
ABS(2.3)
Renvoie 2,3.
ABS(-7.2)
Renvoie 7,2.
CEIL
Résumé
Renvoie un nombre entier dont la valeur dépend de la nature de la valeur numérique du paramètre. Si cette valeur numérique est un entier exact, le nombre renvoyé a exactement la même valeur ; sinon, le nombre renvoyé est le plus petit entier supérieur à la valeur numérique du paramètre.
Syntaxe
CEIL(X : Number / Numeric_String) : Number
Exemples d’utilisation
CEIL(5.0)
Renvoie 5.
CEIL(5.33)
Renvoie 6.
CEIL(-5.0)
Renvoie -5.
CEIL(-5.33)
Renvoie -5.
FLOOR
Résumé
Renvoie un nombre entier dont la valeur dépend de la nature de la valeur numérique du paramètre. Si cette valeur numérique est un entier exact, le nombre renvoyé a exactement la même valeur ; sinon, le nombre renvoyé est le plus grand entier inférieur à la valeur numérique du paramètre.
Syntaxe
FLOOR(X : Number / Numeric_String) : Number
Exemples d’utilisation
FLOOR(5.0)
Renvoie 5.
FLOOR(5.33)
Renvoie 5.
FLOOR(-5.0)
Renvoie -5.
FLOOR(-5.33)
Renvoie -6.
FRAC
Résumé
Renvoie un nombre réel dont la valeur dépend de la nature de la valeur numérique du paramètre :
- Si cette valeur numérique est positive sans être un entier exact, le nombre renvoyé est la différence entre la valeur numérique du paramètre et le plus grand entier inférieur à cette valeur.
- Si cette valeur numérique est négative sans être un entier exact, le nombre renvoyé est la différence entre la valeur numérique du paramètre et le plus petit entier supérieur à cette valeur.
- Si la valeur numérique du paramètre est un entier exact, le nombre renvoyé est 0.
Syntaxe
FRAC(X : Number / Numeric_String) : Number
Exemples d’utilisation
FRAC(5.0)
Renvoie 0.
FRAC(5.33)
Renvoie 0,33.
FRAC(-5.0)
Renvoie 0.
FRAC(-5.33)
Renvoie -0,33.
IIF
Résumé
Il s’agit d’une construction particulière contenant trois requêtes. La valeur de la première requête (entre la parenthèse ouvrante et la première virgule) est évaluée. Si elle vaut True, la deuxième requête (entre les virgules) est renvoyée ; sinon, la troisième requête (entre la deuxième virgule et la parenthèse fermante) est renvoyée.
Syntaxe
IIF(L : Boolean Query , A : Query , B : Query)
L, A et B sont des chaînes qui spécifient chacune une requête ; L doit être une requête booléenne (c’est-à-dire qui renvoie un résultat True ou False).
Exemples d’utilisation
IsArc And IIF(ArcStopAngle - ArcStartAngle >= 0 , ArcStopAngle - ArcStartAngle Between 30 And 60 , ArcStartAngle - ArcStopAngle Between 300 And 330)
Renvoie tous les arcs dont la longueur d’arc est supérieure ou égale à 30 degrés et inférieure ou égale à 60 degrés. (La propriété de longueur d’arc d’un arc est un angle déterminé en soustrayant sa propriété Start Angle de sa propriété Stop Angle. Une difficulté tient au fait que la propriété Stop Angle d’un arc peut être inférieure à sa propriété Start Angle, mais cette requête évalue correctement la longueur d’arc réelle pour tous les objets de type arc possibles.)
IsComponent And IIF(Layer = 'Top Layer' , Rotation <> 0 , Rotation <> 180)
Renvoie tous les composants situés sur la face supérieure du PCB dont la propriété Rotation n’est pas égale à 0 degré, ainsi que tous les composants situés sur la face inférieure du PCB dont la propriété Rotation n’est pas égale à 180 degrés. (Les objets composants ne peuvent se trouver que sur la couche de signal supérieure ou inférieure ; tout composant qui ne se trouve pas sur la couche de signal supérieure se trouve donc nécessairement sur la couche de signal inférieure.)
INT
Résumé
Renvoie un nombre entier dont la valeur dépend de la nature de la valeur numérique du paramètre :
- Si cette valeur numérique est positive, mais n’est pas un entier exact, le nombre renvoyé est le plus grand entier inférieur à la valeur numérique du paramètre.
- Si cette valeur numérique est négative, mais n’est pas un entier exact, le nombre renvoyé est le plus petit entier supérieur à la valeur numérique du paramètre.
- Si cette valeur numérique est un entier exact, le nombre renvoyé a exactement la même valeur.
Syntaxe
INT(X : Number / Numeric_String) : Number
Exemples d’utilisation
INT(5.0)
Renvoie 5.
INT(5.33)
Renvoie 5.
INT(-5.0)
Renvoie -5.
INT(-5.33)
Renvoie -5.
Conseils
Il s’agit d’un alias de la fonction arithmétique TRUNC.
MAX
Résumé
Renvoie un nombre (réel) dont la valeur est égale à la valeur maximale de tous les paramètres fournis. Chaque paramètre doit être un nombre ou une chaîne numérique, et le nombre de paramètres est illimité.
Syntaxe
MAX(N1 : Number / Numeric_String, [N2] : Number / Numeric_String, ...) : Number
Exemples d’utilisation
MAX(2)
Renvoie 2.
MAX(7,2,3)
Renvoie 7.
Conseils
Au moins un paramètre doit être fourni.
MIN
Résumé
Renvoie un nombre (réel) dont la valeur est égale à la valeur minimale de tous les paramètres fournis. Chaque paramètre doit être un nombre ou une chaîne numérique, et le nombre de paramètres est illimité.
Syntaxe
MIN(N1 : Number / Numeric_String, [N2] : Number / Numeric_String, ...) : Number
Exemples d’utilisation
MIN(2)
Renvoie 2.
MIN(7,2,3)
Renvoie 2.
Conseils
Au moins un paramètre doit être fourni.
POWER
Résumé
Renvoie un nombre (réel) dont la valeur est égale à la valeur numérique du premier paramètre élevée à la puissance correspondant à la valeur numérique du second paramètre.
Syntaxe
POWER(X : Number / Numeric_String , Y : Number / Numeric_String) : Number
Exemples d’utilisation
POWER(3,2)
Renvoie 9.
POWER(32,0.2)
Renvoie 2.
POWER(16,-0.5)
Renvoie 0,25.
ROUND
Résumé
Renvoie un nombre entier dont la valeur dépend de la nature de la valeur numérique du paramètre :
- Si cette valeur numérique est un entier exact, le nombre renvoyé a exactement la même valeur.
- Si cette valeur numérique n’est pas un entier exact, le nombre renvoyé est l’entier le plus proche de la valeur numérique du paramètre. Les nombres positifs situés exactement à mi-chemin entre deux entiers consécutifs sont arrondis upwards, tandis que les nombres négatifs situés exactement à mi-chemin entre deux entiers consécutifs sont arrondis downwards.
Syntaxe
ROUND(X : Number / Numeric_String) : Number
Exemples d’utilisation
ROUND(5.0)
Renvoie 5.
ROUND(5.33)
Renvoie 5.
ROUND(5.5)
Renvoie 6 (arrondi à l’entier supérieur).
ROUND(5.66)
Renvoie 6.
ROUND(-5.0)
Renvoie -5.
ROUND(-5.33)
Renvoie -5.
ROUND(-5.5)
Renvoie -6 (arrondi à l’entier inférieur).
ROUND(-5.66)
Renvoie -6.
SIGN
Résumé
Renvoie la valeur du signe du paramètre fourni. Autrement dit, renvoie un nombre entier dont la valeur dépend de la nature de la valeur numérique du paramètre :
- Si cette valeur numérique est positive, le nombre renvoyé est 1.
- Si cette valeur numérique est négative, le nombre renvoyé est -1.
- Si cette valeur numérique est exactement égale à zéro, le nombre renvoyé est 0.
Syntaxe
SIGN(X : Number / Numeric_String) : Number
Exemples d’utilisation
SIGN(5.33)
Renvoie 1.
SIGN(-5.33)
Renvoie -1.
SIGN(0)
Renvoie 0.
SQR
Résumé
Renvoie un nombre (réel) dont la valeur est égale au carré de la valeur numérique du paramètre.
Syntaxe
SQR(X : Number / Numeric_String) : Number
Exemples d’utilisation
SQR(2)
Renvoie 4.
SQR(14.1)
Renvoie 198,81.
SQR(-1.5)
Renvoie 2,25.
SQRT
Résumé
Renvoie un nombre (réel) dont la valeur est égale à la racine carrée (positive) de la valeur numérique du paramètre.
Syntaxe
SQRT(X : Number / Numeric_String) : Number
Exemples d’utilisation
SQRT(4)
Renvoie 2.
SQRT(10)
Renvoie 3,1623.
TRUNC
Résumé
Renvoie un nombre entier dont la valeur dépend de la nature de la valeur numérique du paramètre :
- Si cette valeur numérique est positive, mais n’est pas un entier exact, le nombre renvoyé est le plus grand entier inférieur à la valeur numérique du paramètre.
- Si cette valeur numérique est négative, mais n’est pas un entier exact, le nombre renvoyé est le plus petit entier supérieur à la valeur numérique du paramètre.
- Si cette valeur numérique est un entier exact, le nombre renvoyé a exactement la même valeur.
Syntaxe
TRUNC(X : Number / Numeric_String) : Number
Exemples d’utilisation
TRUNC(5.0)
Renvoie 5.
TRUNC(5.33)
Renvoie 5.
TRUNC(-5.0)
Renvoie -5.
TRUNC(-5.33)
Renvoie -5.
Conseils
Il s’agit d’un alias de la fonction arithmétique INT.
ZERO
Résumé
Renvoie un nombre entier dont la valeur est 0 ou 1, selon la valeur numérique du paramètre. Si cette valeur numérique est nulle, le nombre renvoyé est 0 ; sinon, le nombre renvoyé est 1.
Syntaxe
ZERO(X : Number / Numeric_String) : Number
Exemples d’utilisation
ZERO(5.33)
Renvoie 1.
ZERO(-5.33)
Renvoie 1.
ZERO(0)
Renvoie 0.
Fonctions trigonométriques
ACOS
Résumé
Renvoie un nombre (réel) dont la valeur est égale à l’arc cosinus du nombre spécifié par la valeur numérique du paramètre ; cet angle est exprimé en radians (et non en degrés).
Syntaxe
ACOS(X : Number / Numeric_String) : Number
Exemples d’utilisation
ACOS(0)
Renvoie 1,5708.
ACOS(0.5)
Renvoie 1,0472.
ACOS(1)
Renvoie 0.
ASIN
Résumé
Renvoie un nombre (réel) dont la valeur est égale à l’arc sinus du nombre spécifié par la valeur numérique du paramètre ; cet angle est exprimé en radians (et non en degrés).
Syntaxe
ASIN(X : Number / Numeric_String) : Number
Exemples d’utilisation
ASIN(0)
Renvoie 0.
ASIN(0.5)
Renvoie 0,5236.
ASIN(1)
Renvoie 1,5708.
ATAN
Résumé
Renvoie un nombre (réel) dont la valeur est égale à l’arc tangente du nombre spécifié par la valeur numérique du paramètre ; cet angle est exprimé en radians (et non en degrés).
Syntaxe
ATAN(X : Number / Numeric_String) : Number
Exemples d’utilisation
ATAN(0)
Renvoie 0.
ATAN(1)
Renvoie 0,7854.
ATAN(2.5)
Renvoie 1,1903.
COS
Résumé
Renvoie un nombre (réel) dont la valeur est égale au cosinus de l’angle spécifié par la valeur numérique du paramètre ; cet angle est exprimé en radians (et non en degrés).
Syntaxe
COS(X : Number / Numeric_String) : Number
Exemples d’utilisation
COS(0)
Renvoie 1.
COS(0.8)
Renvoie 0,6967.
COS(1.57)
Renvoie 0,0008.
COSH
Résumé
Renvoie un nombre (réel) dont la valeur est égale au cosinus hyperbolique de la valeur numérique du paramètre.
Syntaxe
COSH(X : Number / Numeric_String) : Number
Exemples d’utilisation
COSH(TextHeight / TextWidth) < 70.5
Renvoie les objets pour lesquels le cosinus hyperbolique du rapport entre leur distance TextHeight et leur distance TextWidth est inférieur à 70,5. (Cela revient à renvoyer les objets pour lesquels le rapport entre leur distance TextHeight et leur distance TextWidth est inférieur à 4,9487).
(TextHeight / TextWidth) >= COSH(2.3)
Renvoie les objets pour lesquels le rapport entre leur distance TextHeight et leur distance TextWidth est supérieur ou égal au cosinus hyperbolique de 2,3 (soit 5,0372).
COTAN
Résumé
Renvoie un nombre (réel) dont la valeur est égale à la cotangente de l’angle spécifié par la valeur numérique du paramètre ; cet angle est exprimé en radians (et non en degrés).
Syntaxe
COTAN(X : Number / Numeric_String) : Number
Exemples d’utilisation
COTAN(0.1)
Renvoie 9,9666.
COTAN(0.8)
Renvoie 0,9712.
COTAN(1.57)
Renvoie 0,0008.
SIN
Résumé
Renvoie un nombre (réel) dont la valeur est égale au sinus de l’angle spécifié par la valeur numérique du paramètre ; cet angle est exprimé en radians (et non en degrés).
Syntaxe
SIN(X : Number / Numeric_String) : Number
Exemples d’utilisation
SIN(0)
Renvoie 0.
SIN(0.8)
Renvoie 0,7174.
SIN(1.57)
Renvoie 1,0.
SINH
Résumé
Renvoie un nombre (réel) dont la valeur est égale au sinus hyperbolique de la valeur numérique du paramètre.
Syntaxe
SINH(X : Number / Numeric_String) : Number
Exemples d’utilisation
SINH(TextWidth / TextHeight) < 0.17
Renvoie les objets pour lesquels le sinus hyperbolique du rapport entre leur distance TextWidth et leur distance TextHeight est inférieur à 0,17. (Cela revient à renvoyer les objets pour lesquels le rapport entre leur distance TextWidth et leur distance TextHeight est inférieur à 0,1692).
(TextWidth / TextHeight) >= SINH(0.2)
Renvoie les objets pour lesquels le rapport entre leur distance TextWidth et leur distance TextHeight est supérieur ou égal au sinus hyperbolique de 0,2 (soit 0,2013).
TAN
Résumé
Renvoie un nombre (réel) dont la valeur est égale à la tangente de l’angle spécifié par la valeur numérique du paramètre ; cet angle est exprimé en radians (et non en degrés).
Syntaxe
TAN(X : Number / Numeric_String) : Number)
Exemples d’utilisation
TAN(0)
Renvoie 0.
TAN(0.8)
Renvoie 1,0296.
TAN(1.57)
Renvoie 1255,7656.
TANH
Résumé
Renvoie un nombre (réel) dont la valeur est égale à la tangente hyperbolique de la valeur numérique du paramètre.
Syntaxe
TANH(X : Number / Numeric_String) : Number
Exemples d’utilisation
TANH(TextWidth / TextHeight) < 0.17
Renvoie les objets pour lesquels la tangente hyperbolique du rapport entre leur distance TextWidth et leur distance TextHeight est inférieure à 0,17. (Cela revient à renvoyer les objets pour lesquels le rapport entre leur distance TextWidth et leur distance TextHeight est inférieur à 0,1717).
(TextWidth / TextHeight) >= TANH(0.2)
Renvoie les objets pour lesquels le rapport entre leur distance TextWidth et leur distance TextHeight est supérieur ou égal à la tangente hyperbolique de 0,2 (soit 0,1974).
Fonctions exponentielles et logarithmiques
EXP
Résumé
Renvoie un nombre (réel) dont la valeur est égale à e élevé à la puissance correspondant à la valeur numérique du paramètre. (Le nombre e est la base des logarithmes népériens et vaut environ 2.7183).
Syntaxe
EXP(X : Number / Numeric_String) : Number
Exemples d’utilisation
EXP(0)
Renvoie 1.
EXP(1)
Renvoie 2,7183.
LG
Résumé
Renvoie un nombre (réel) dont la valeur est égale au logarithme en base 10 de la valeur numérique du paramètre.
Syntaxe
LG(X : Number / Numeric_String) : Number
Exemples d’utilisation
LG(1)
Renvoie 0.
LG(10)
Renvoie 1.
LG(25)
Renvoie 1,3979.
LN
Résumé
Renvoie un nombre (réel) dont la valeur est égale au logarithme népérien (ou en base e) de la valeur numérique du paramètre. (Le nombre e vaut 2.7183).
Syntaxe
LN(X : Number / Numeric_String) : Number
Exemples d’utilisation
LN(1)
Renvoie 0.
LN(2)
Renvoie 0,6931.
LN(10)
Renvoie 2,3026.
LOG
Résumé
Renvoie un nombre (réel) dont la valeur est égale au logarithme en base 2 de la valeur numérique du paramètre.
Syntaxe
LOG(X : Number / Numeric_String) : Number
Exemples d’utilisation
LOG(1)
Renvoie 0.
LOG(2)
Renvoie 1.
LOG(8)
Renvoie 3.
LOG(10)
Renvoie 3,3219.
Fonctions d’agrégation
AVG
Résumé
Renvoie un nombre (réel) dont la valeur est égale à la moyenne de tous les paramètres fournis. Chaque paramètre doit être un nombre ou une chaîne numérique, et le nombre de paramètres est illimité.
Syntaxe
AVG(N1 : Number / Numeric_String, [N2] : Number / Numeric_String, ...) : Number
Exemples d’utilisation
AVG(2)
Renvoie 2.
AVG(7,2,3)
Renvoie 4.
Conseils
- Au moins un paramètre doit être fourni.
MAX
Résumé
Renvoie un nombre (réel) dont la valeur est égale à la valeur maximale de tous les paramètres fournis. Chaque paramètre doit être un nombre ou une chaîne numérique, et le nombre de paramètres est illimité.
Syntaxe
MAX(N1 : Number / Numeric_String, [N2] : Number / Numeric_String, ...) : Number
Exemples d’utilisation
MAX(2)
Renvoie 2.
MAX(7,2,3)
Renvoie 7.
Conseils
Au moins un paramètre doit être fourni.
MIN
Résumé
Renvoie un nombre (réel) dont la valeur est égale à la valeur minimale de tous les paramètres fournis. Chaque paramètre doit être un nombre ou une chaîne numérique, et le nombre de paramètres est illimité.
Syntaxe
MIN(N1 : Number / Numeric_String, [N2] : Number / Numeric_String, ...) : Number
Exemples d’utilisation
MIN(2)
Renvoie 2.
MIN(7,2,3)
Renvoie 2.
Conseils
Au moins un paramètre doit être fourni.
PROD
Résumé
Renvoie un nombre (réel) dont la valeur est égale au produit de tous les paramètres fournis. Chaque paramètre doit être un nombre ou une chaîne numérique, et le nombre de paramètres est illimité.
Syntaxe
PROD(N1 : Number / Numeric_String, [N2] : Number / Numeric_String, ...) : Number
Exemples d’utilisation
PROD(2)
Renvoie 2.
PROD(7,2,3)
Renvoie 42.
Conseils
Au moins un paramètre doit être fourni.
SUM
Résumé
Renvoie un nombre (réel) dont la valeur est égale à la somme de tous les paramètres fournis. Chaque paramètre doit être un nombre ou une chaîne numérique, et le nombre de paramètres est illimité.
Syntaxe
SUM(N1 : Number / Numeric_String, [N2] : Number / Numeric_String, ...) : Number
Exemples d’utilisation
SUM(2)
Renvoie 2.
SUM(7,2,3)
Renvoie 12.
Conseils
Au moins un paramètre doit être fourni.
Fonctions système
Copy
Résumé
Renvoie une sous-chaîne d’une chaîne. Il est possible de spécifier le nombre de caractères que contiendra la sous-chaîne renvoyée, ainsi que la position dans la chaîne du premier caractère de cette sous-chaîne.
Syntaxe
Copy(S : String , Index : Integer , Count : Integer) : String
S est une expression de type chaîne. Index et Count sont des expressions de type entier. Copy renvoie une sous-chaîne contenant Count caractères à partir de S[Index].
Si Index est supérieur à la longueur de S, Copy renvoie une chaîne vide.
Si Count spécifie un nombre de caractères supérieur au nombre disponible, seuls les caractères allant de S[Index] à la fin de S sont renvoyés.
Exemples d’utilisation
Copy('Cats and dogs',1,1)
Renvoie 'C'. (Renvoie 1 caractère à partir de la 1re position dans la chaîne).
Copy('Cats and dogs',2,1)
Renvoie 'a'. (Renvoie 1 caractère à partir de la 2e position dans la chaîne).
Copy('Cats and dogs',13,1)
Renvoie 's'. (Renvoie 1 caractère à partir de la 13e position dans la chaîne).
Copy('Cats and dogs',14,1)
Renvoie '' (une chaîne vide). (Renvoie 1 caractère à partir de la 14e position dans la chaîne ; toutefois, comme la chaîne ne contient que 13 caractères, une chaîne vide est renvoyée).
Copy('Cats and dogs',1,2)
Renvoie 'Ca'. (Renvoie 2 caractères à partir de la 1re position dans la chaîne).
Copy('Cats and dogs',2,2)
Renvoie 'at'. (Renvoie 2 caractères à partir de la 2e position dans la chaîne).
Copy('Cats and dogs',12,2)
Renvoie 'gs'. (Renvoie 2 caractères à partir de la 12e position dans la chaîne).
Copy('Cats and dogs',13,2)
Renvoie 's'. (Renvoie 2 caractères à partir de la 13e position dans la chaîne ; toutefois, comme la chaîne ne contient que 13 caractères, un seul caractère est renvoyé).
Copy('Cats and dogs',15,2)
Renvoie '' (une chaîne vide). (Renvoie 2 caractères à partir de la 15e position dans la chaîne ; toutefois, comme la chaîne ne contient que 13 caractères, une chaîne vide est renvoyée).
Copy('Cats and dogs',1,6)
Renvoie 'Cats a'. (Renvoie 6 caractères à partir de la 1re position dans la chaîne).
Copy('Cats and dogs',5,9)
Renvoie ' and dogs'. (Renvoie 9 caractères à partir de la 5e position dans la chaîne).
Copy('Cats and dogs',8,5)
Renvoie 'd dog'. (Renvoie 5 caractères à partir de la 8e position dans la chaîne).
Copy('Cats and dogs',8,6)
Renvoie 'd dogs'. (Renvoie 6 caractères à partir de la 8e position dans la chaîne).
Copy('Cats and dogs',8,7)
Renvoie 'd dogs'. (Renvoie 7 caractères à partir de la 8e position dans la chaîne ; toutefois, comme la chaîne ne contient que 13 caractères, seuls 6 caractères sont renvoyés).
Length
Résumé
Renvoie le nombre de caractères contenus dans une chaîne.
Syntaxe
Length(S : String) : Integer
S est la chaîne dont le nombre de caractères doit être renvoyé.
Exemples d’utilisation
Length(Name) Between 4 And 7
Renvoie les objets dont la propriété Name contient entre 4 et 7 caractères.
Length('Cat')
Renvoie 3.
Length('Darryll')
Renvoie 7.
Length('Cats and dogs')
Renvoie 13.
Length('')
Renvoie 0.
Pos
Résumé
Renvoie l’indice du premier caractère de la première occurrence d’une sous-chaîne spécifiée dans une chaîne donnée.
Syntaxe
Pos(Substr : String , S : String) : Integer
Pos recherche une sous-chaîne, Substr, dans une chaîne, S. Substr et S sont des expressions de type chaîne. La valeur entière renvoyée correspond à l’indice du premier caractère de Substr.
Exemples d’utilisation
Pos('T',Name) = 1
Renvoie tous les objets ayant une propriété Name dont la chaîne associée contient sa première occurrence de 'T' en première position ; 'T1' et 'Time Table' sont des exemples de telles chaînes. ('T' apparaît deux fois dans la chaîne 'Time Table', mais sa première occurrence se trouve en première position.)
Pos('A',Name) = 2
Renvoie tous les objets ayant une propriété Name dont la chaîne associée contient sa première occurrence de 'A' en deuxième position ; 'RA1' et 'CABLE CHART' sont des exemples de telles chaînes.
Pos('B',Name) = 0
Renvoie tous les objets possédant une propriété Name dont la chaîne associée ne contient « B » à aucune position ; « D1 » et « Time Table » sont des exemples de telles chaînes. (La chaîne « Time Table » contient « b » en huitième position, mais Pos est sensible à la casse.)
Pos('D',Name) > 0
Renvoie tous les objets possédant une propriété Name dont la chaîne associée contient « D » au moins une fois, à n'importe quelle position ; « Data Chart », « U1D » et « Install either D1 and D2 or D3 and D4, but never install all of these. » sont des exemples de telles chaînes.
Pos('Con',Name) = 1
Renvoie tous les objets possédant une propriété Name dont la chaîne associée contient une première occurrence de « Con » aux première, deuxième et troisième positions ; « Concatenate » est un exemple d'une telle chaîne. (La première occurrence de « Con » dans « Concatenate » correspond aux trois premiers caractères de cette chaîne ; le premier caractère de « Con » est « C », et il se trouve à la première position de « Concatenate ».)
Pos('ate',Name) = 5
Renvoie tous les objets possédant une propriété Name dont la chaîne associée contient une première occurrence de « ate » aux cinquième, sixième et septième positions ; « Concatenate » est un exemple d'une telle chaîne. (La première occurrence de « ate » dans « Concatenate » correspond aux caractères situés de la cinquième à la septième position ; le premier caractère de « ate » est « a », et il se trouve à la cinquième position de « Concatenate ».)
Pos('ate',Name) = 0
Renvoie tous les objets possédant une propriété Name dont la chaîne associée ne contient « ate » nulle part ; « C1 » et « TIME: » sont des exemples de telles chaînes.
Pred
Résumé
Renvoie un nombre (réel) dont la valeur est égale à la valeur numérique du paramètre moins 1.0.
Syntaxe
Pred(X : Number / Numeric_String) : Number
Exemple d'utilisation
Pred(4.1)
Renvoie 3.1.
Pred(41.313)
Renvoie 40.313.
Random
Résumé
Renvoie un nombre aléatoire compris entre 0 et X-1.
Syntaxe
Random(X) : Number
Exemple d'utilisation
Random(10)
Renvoie une valeur comprise entre 0 et 9.
Random(100)
Renvoie une valeur comprise entre 0 et 99.
Succ
Résumé
Renvoie un nombre (réel) dont la valeur est égale à la valeur numérique du paramètre plus 1.0.
Syntaxe
Succ(X : Number / Numeric_String) : Number
Exemple d'utilisation
Succ(2.1)
Renvoie 3.1.
Succ(41.313)
Renvoie 42.313.





















