Vérifications d’appartenance
En un coup d'œil
- Découvrez les mots-clés de requête de la catégorie Membership Checks disponibles dans Altium Designer et leur utilité.
- Consultez la syntaxe correcte et des exemples de requêtes pour sélectionner des objets selon les unités, les couches, les empreintes, les pastilles, l’expansion du masque et les caractéristiques des vias.
- Prenez connaissance des remarques d’utilisation importantes, notamment sur les apostrophes obligatoires et les comportements propres au logiciel susceptibles d’influencer les résultats des requêtes.

Les fonctions de requête PCB Membership Checks affichées dans la boîte de dialogue Query Helper
Cette page de référence détaille les mots-clés du langage de requête de la catégorie Membership Checks disponibles dans les documents PCB et de bibliothèque PCB dans Altium Designer. Pour obtenir de l’aide sur un mot-clé de requête spécifique, utilisez les sections dépliables suivantes ou sélectionnez un mot-clé (ou cliquez à l’intérieur) dans le Query Helper ou dans un panneau Filter, puis appuyez sur F1 pour accéder immédiatement à sa section.
AsMils
Résumé
Pour les propriétés numériques des objets (par exemple, la hauteur, la largeur, le rayon, etc.), ce mot-clé permet de convertir la valeur actuelle, mesurée dans les unités par défaut de l’espace de travail, en unités impériales — le mil, où 1 mil = 0,001 pouce. La valeur obtenue est ensuite comparée à la valeur saisie dans l’expression.
Syntaxe
AsMils(Keyword : Number) : Number
Exemples d’utilisation
AsMils(ArcRadius) = 250
Renvoie tous les objets de type arc dont la propriété Radius est égale à 250mil.
AsMils(Height) Between 300 And 500
Renvoie tous les objets de type composant dont la propriété Height est supérieure ou égale à 300mil et inférieure ou égale à 500mil.
AsMils(PolygonGridSize) >= 10
Renvoie tous les objets de type remplissage polygonal dont la propriété Grid Size est supérieure ou égale à 10mil.
AsMils(Width) < 50
Renvoie tous les objets de type arc et piste dont la propriété Width est inférieure à 50mil.
AsMils(TraceLength) = 10
Renvoie tous les objets de type arc et piste dont la propriété Length est égale à 10mil.
Note - en raison d’un problème logiciel, pour détecter correctement TraceLength à l’aide du mot-clé AsMils, les unités de la carte doivent être définies en mils avant d’exécuter la requête.
AsMM
Résumé
Pour les propriétés numériques des objets (par exemple, la hauteur, la largeur, le rayon, etc.), ce mot-clé permet de convertir la valeur actuelle, mesurée dans les unités par défaut de l’espace de travail, en unités métriques — le mm, où 1 mm = 0,001 mètre. La valeur obtenue est ensuite comparée à la valeur saisie dans l’expression.
Syntaxe
AsMM(Keyword : Number) : Number
Exemples d’utilisation
AsMM(ArcRadius) = 6.35
Renvoie tous les objets de type arc dont la propriété Radius est égale à 6.35mm.
AsMM(Height) Between 7.62 And 12.7
Renvoie tous les objets de type composant dont la propriété Height est supérieure ou égale à 7.62mm et inférieure ou égale à 12.7mm.
AsMM(PolygonGridSize) >= 0.254
Renvoie tous les objets de type remplissage polygonal dont la propriété Grid Size est supérieure ou égale à 0.254mm.
AsMM(Width) < 1.27
Renvoie tous les objets de type arc et piste dont la propriété Width est inférieure à 1.27mm.
AsMM(TraceLength) = 1
Renvoie tous les objets de type arc et piste dont la propriété Length est égale à 1mm.
Note - en raison d’un problème logiciel, pour détecter correctement TraceLength à l’aide du mot-clé AsMM, les unités de la carte doivent être définies en mils avant d’exécuter la requête.
ComponentInLayerClass
Résumé
Renvoie tous les objets de type composant dont la propriété Layer correspond à une couche appartenant à la classe de couches spécifiée.
Syntaxe
ComponentInLayerClass(ClassName : String) : Boolean/Boolean_String
Lors de la définition de l’expression de requête, une liste contextuelle de toutes les classes de couches définies par l’utilisateur existantes s’affiche, triées par nom.
Exemples d’utilisation
ComponentInLayerClass('TopSide')
ComponentInLayerClass('TopSide') = True
ComponentInLayerClass('TopSide') = 'True'
Renvoie tous les objets de type composant dont la propriété Layer correspond à une couche appartenant à la classe de couches TopSide.
Not ComponentInLayerClass('BottomSide')
ComponentInLayerClass('BottomSide') = False
ComponentInLayerClass('BottomSide') = 'False'
Renvoie tous les objets except objets de type composant dont la propriété Layer correspond à une couche appartenant à la classe de couches BottomSide.
Remarque
Les apostrophes (') au début et à la fin de la chaîne ClassName sont obligatoires.
ExistsOnLayer
Résumé
Renvoie tous les objets présents sur la couche spécifiée.
Syntaxe
ExistsOnLayer(Layer : String) : Boolean/Boolean_String
Layer est le nom de la couche tel qu’il apparaît dans l’onglet Layers & Colors du panneau View Configuration.
Exemples d’utilisation
ExistsOnLayer('Top Layer')
ExistsOnLayer('Top Layer') = True
ExistsOnLayer('Top Layer') = 'True'
Renvoie tous les objets présents sur Top Layer.
Not ExistsOnLayer('Mechanical 3')
ExistsOnLayer('Mechanical 3') = False
ExistsOnLayer('Mechanical 3') = 'False'
Renvoie tous les objets except objets présents sur la couche Mechanical 3.
Remarque
Les apostrophes (') au début et à la fin de Layer sont obligatoires.
HasFootprint
Résumé
Renvoie tous les objets de type composant dont la propriété Footprint satisfait à la requête.
Syntaxe
HasFootprint(Footprint : String) : Boolean/Boolean_String
Exemples d’utilisation
HasFootprint('SIP?0')
HasFootprint('SIP?0') = True
HasFootprint('SIP?0') = 'True'
Renvoie tous les objets de type composant dont la propriété Footprint commence par SIP et se termine par 0, avec un seul caractère intermédiaire supplémentaire. Voici quelques exemples d’empreintes correspondantes : SIP10, SIP20 et SIPQ0.
HasFootprint('DIP*')
HasFootprint('DIP*') = True
HasFootprint('DIP*') = 'True'
Renvoie tous les objets de type composant dont la propriété Footprint commence par DIP. Voici quelques exemples d’empreintes correspondantes : DIP8, DIP14 et DIP24N.
Not HasFootprint('IDC16')
HasFootprint('IDC16') = False
HasFootprint('IDC16') = 'False'
Renvoie tous les objets except objets de type composant dont la propriété Footprint est égale à IDC16.
HasFootprint('*2*')
HasFootprint('*2*') = True
HasFootprint('*2*') = 'True'
Renvoie tous les objets de type composant dont la propriété Footprint contient le caractère 2. Voici quelques exemples d’empreintes correspondantes : 2012, 2N5001, IDC20 et HDR1X2.
Remarques
-
Les apostrophes (') au début et à la fin de la chaîne
Footprintsont obligatoires. - Pour chaque objet de type composant renvoyé, les objets enfants associés sont également renvoyés.
HasFootprintPad
Résumé
Renvoie tous les objets de type pastille qui sont des enfants d’objets de type composant possédant l’empreinte spécifiée, et dont la propriété Name satisfait à la requête.
Syntaxe
HasFootprintPad(Footprint : String,Name : String) : Boolean/Boolean_String
Exemples d’utilisation
Not HasFootprintPad('0805','1')
HasFootprintPad('0805','1') = False
HasFootprintPad('0805','1') = 'False'
Renvoie tous les objets except objets de type pastille dont la propriété Name est égale à 1, et qui sont des objets enfants d’objets de type composant dont la propriété Footprint est égale à 0805.
HasFootprintPad('SIP?0','1')
HasFootprintPad('SIP?0','1') = True
HasFootprintPad('SIP?0','1') = 'True'
Renvoie tous les objets de type pastille dont la propriété Name est égale à 1, et qui sont des objets enfants d’objets de type composant dont la propriété Footprint commence par SIP, se termine par 0 et contient un seul caractère intermédiaire supplémentaire. Voici quelques exemples d’empreintes correspondantes : SIP10, SIP20, SIPQ0.
HasFootprintPad('DB*','MNT')
HasFootprintPad('DB*','MNT') = True
HasFootprintPad('DB*','MNT') = 'True'
Renvoie tous les objets de type pastille dont la propriété Name est égale à MNT et qui sont des objets enfants d’objets de type composant dont la propriété Footprint commence par DB. Voici quelques exemples d’empreintes correspondantes : DB9S, DB15HD, DB25P.
HasFootprintPad('','MN*')
HasFootprintPad('','MN*') = True
HasFootprintPad('','MN*') = 'True'
Renvoie tous les objets de type pastille dont la propriété Name commence par MN, et qui sont des objets enfants de l’objet de type composant any .
Remarques
-
Les apostrophes (') au début et à la fin des chaînes
FootprintetNamesont obligatoires. - Les objets de type composant parents ne sont pas renvoyés.
HasMaskExpansionOnLayer
Résumé
Renvoie tous les objets arc, remplissage, pastille, région, piste et via pour lesquels des valeurs d'expansion du masque de pâte à braser (sauf pour les vias) ou du masque de soudure sont définies pour la couche spécifiée. Les valeurs peuvent être définies manuellement ou provenir de la règle de conception applicable.
Syntaxe
HasMaskExpansionOnLayer(Layer : String) : Boolean/Boolean_String
Layer est le nom de la couche, tel qu'il apparaît dans la section Layers applicable, dans l'onglet Layers & Colors du panneau Configuration de la vue.
Exemples d'utilisation
HasMaskExpansionOnLayer('Top Layer')
HasMaskExpansionOnLayer('Top Layer') = True
HasMaskExpansionOnLayer('Top Layer') = 'True'
Renvoie tous les objets arc, remplissage, pastille, région, piste et via pour lesquels des valeurs d'expansion du masque de pâte à braser (sauf pour les vias) ou du masque de soudure sont définies pour Top Layer.
Not HasMaskExpansionOnLayer('Bottom Layer')
HasMaskExpansionOnLayer('Bottom Layer') = False
HasMaskExpansionOnLayer('Bottom Layer') = 'False'
Renvoie tous les objets except objets arc, remplissage, pastille, région, piste et via pour lesquels des valeurs d'expansion du masque de pâte à braser (sauf pour les vias) ou du masque de soudure sont définies pour Bottom Layer.
Remarque
Les apostrophes (') au début et à la fin de Layer sont obligatoires.
HasPad
Résumé
Renvoie tous les objets pastille dont la propriété de nom complet correspond à la requête.
Syntaxe
HasPad(PadName : String) : Boolean/Boolean_String
La chaîne PadName spécifie le nom complet auquel une pastille doit correspondre. Celui-ci se compose d'une première sous-chaîne qui spécifie la propriété Name du composant parent de la pastille (c'est-à-dire le repère du composant), suivie d'une sous-chaîne qui spécifie la propriété Name de la pastille elle-même (c'est-à-dire le repère de la pastille). Le format est donc 'ParentComponentDesignator-PadDesignator'.
Exemples d'utilisation
Not HasPad('C14-1')
HasPad('C14-1') = False
HasPad('C14-1') = 'False'
Renvoie tous les objets except l'objet pastille dont la propriété Name est 1 et qui est un objet enfant de l'objet composant dont la propriété Name est C14.
HasPad('U5-11')
HasPad('U5-11') = True
HasPad('U5-11') = 'True'
Renvoie l'objet pastille dont la propriété Name est 11 et qui est un objet enfant de l'objet composant dont la propriété Name est U5.
HasPad('U*-11')
HasPad('U*-11') = True
HasPad('U*-11') = 'True'
Renvoie tous les objets pastille dont la propriété Name est 11 et qui sont des objets enfants d'objets composant dont la propriété Name commence par U.
HasPad('*-1*')
HasPad('*-1*') = True
HasPad('*-1*') = 'True'
Renvoie tous les objets pastille dont la propriété Name commence par 1 et qui sont des objets enfants de any objet composant.
Remarque
Les apostrophes (') au début et à la fin de la chaîne PadName sont obligatoires.
HasViaFeature
Résumé
Renvoie tous les objets via dont la propriété de caractéristique de via correspond à la requête.
Syntaxe
HasViaFeature(ViaFeature : String) : Boolean/Boolean_String
La chaîne ViaFeature spécifie la caractéristique de via à laquelle un via doit correspondre. Il peut s'agir de l'une des valeurs suivantes :
-
Capping -
Covering -
Filling -
Plugging -
Tenting
Exemples d'utilisation
Not HasViaFeature('Capping')
HasViaFeature('Capping') = False
HasViaFeature('Capping') = 'False'
Renvoie tous les objets except l'objet via dont la propriété de caractéristique de via est Capping.
HasViaFeature('Covering')
HasViaFeature('Covering') = True
HasViaFeature('Covering') = 'True'
Renvoie l'objet via dont la propriété de caractéristique de via est Covering.
Remarque
Les apostrophes (') au début et à la fin de la chaîne ViaFeature sont obligatoires.
HasViaType
Résumé
Renvoie tous les objets via dont la propriété de type de via correspond à la requête.
Syntaxe
HasViaType(ViaType : String) : Boolean/Boolean_String
La chaîne ViaType spécifie la propriété IPC 4761 Via Type à laquelle un via doit correspondre. Il peut s'agir de l'une des valeurs suivantes :
-
None -
Type 1a -
Type 1b -
Type 2a -
Type 2b -
Type 3a -
Type 3b -
Type 4a -
Type 4b -
Type 5 -
Type 6a -
Type 6b -
Type 7
Exemples d'utilisation
Not HasViaFeature('Capping')
HasViaFeature('Capping') = False
HasViaFeature('Capping') = 'False'
Renvoie tous les objets except l'objet via dont la propriété de caractéristique de via est Capping.
HasViaFeature('Covering')
HasViaFeature('Covering') = True
HasViaFeature('Covering') = 'True'
Renvoie l'objet via dont la propriété de caractéristique de via est Covering.
Remarque
Les apostrophes (') au début et à la fin de la chaîne ViaFeature sont obligatoires.
InChannelClass
Résumé
Renvoie tous les objets associés à des objets composant appartenant à la classe de canaux de conception spécifiée.
Syntaxe
InChannelClass(ClassName1 : String,ClassName2 : String,...,ClassNamen : String) : Boolean/Boolean_String
Lorsque vous définissez l'expression de requête, une liste déroulante de toutes les classes de canaux de conception existantes définies par l'utilisateur, triées par nom, s'affiche.
Exemples d'utilisation
InChannelClass('Red_LED')
InChannelClass('Red_LED') = True
InChannelClass('Red_LED') = 'True'
Renvoie tous les objets associés à des objets composant appartenant à la classe de canaux de conception Red_LED.
InChannelClass('Output channel','Input channel')
InChannelClass('Output channel','Input channel') = True
InChannelClass('Output channel','Input channel') = 'True'
Renvoie tous les objets associés à des objets composant appartenant à l'une des classes de canaux de conception Output channel ou Input channel.
InChannelClass('Input*')
InChannelClass('Input*') = True
InChannelClass('Input*') = 'True'
Renvoie tous les objets associés à des objets composant appartenant à une classe de canaux de conception dont la propriété Name commence par Input.
Remarques
-
Les apostrophes (') au début et à la fin de chaque chaîne
ClassNamesont obligatoires. - Les objets composant parents sont également renvoyés.
InComponent
Résumé
Renvoie tous les objets composant dont la propriété Name correspond à la requête.
Syntaxe
InComponent(Name : String) : Boolean/Boolean_String
Lorsque vous définissez l'expression de requête, une liste déroulante de tous les composants existants, triés par nom, s'affiche.
Exemples d'utilisation
InComponent('U1')
InComponent('U1') = True
InComponent('U1') = 'True'
Renvoie tous les objets composant dont la propriété Name est U1.
InComponent('U1', 'U2', 'J1')
InComponent('U1', 'U2', 'J1') = True
InComponent('U1', 'U2', 'J1') = 'True'
Renvoie tous les objets composant dont la propriété Name est U1, U2 ou J1.
Not InComponent('IDC16')
InComponent('IDC16') = False
InComponent('IDC16') = 'False'
Renvoie tous les objets except objets composant dont la propriété Name est IDC16.
InComponent('U*')
InComponent('U*') = True
InComponent('U*') = 'True'
Renvoie tous les objets composant dont la propriété Name commence par U.
Remarques
-
Les apostrophes (') au début et à la fin de la chaîne
Namesont obligatoires. - Pour chaque objet composant renvoyé, les objets enfants associés sont également renvoyés.
InComponentClass
Résumé
Renvoie tous les objets composant appartenant à la classe de composants spécifiée.
Syntaxe
InComponentClass(ClassName : String) : Boolean/Boolean_String
Lorsque vous définissez l'expression de requête, une liste déroulante de toutes les classes de composants existantes définies par l'utilisateur, triées par nom, s'affiche.
Exemples d'utilisation
InComponentClass('TopSideSMD')
InComponentClass('TopSideSMD') = True
InComponentClass('TopSideSMD') = 'True'
Renvoie tous les objets composant appartenant à la classe de composants TopSideSMD.
Not InComponentClass('BottomSideSMD')
InComponentClass('BottomSideSMD') = False
InComponentClass('BottomSideSMD') = 'False'
Renvoie tous les objets except objets composant appartenant à la classe de composants BottomSideSMD.
Remarque
Les apostrophes (') au début et à la fin de la chaîne ClassName sont obligatoires.
InDifferentialPair
Résumé
Renvoie tous les objets associés à des objets paire différentielle dont la propriété Name correspond à la requête.
Syntaxe
InDifferentialPair(DifferentialPairName1 : String,DifferentialPair2 : String,...,DifferentialPairn : String) : Boolean/Boolean_String
Lorsque vous définissez l'expression de requête, une liste déroulante de toutes les paires différentielles existantes, triées par nom, s'affiche.
Exemples d'utilisation
InDifferentialPair('Red_LED')
InDifferentialPair('Red_LED') = True
InDifferentialPair('Red_LED') = 'True'
Renvoie tous les objets associés à l'objet paire différentielle dont la propriété Name est Red_LED.
InDifferentialPair('D0','D1')
InDifferentialPair('D0','D1') = True
InDifferentialPair('D0','D1') = 'True'
Renvoie tous les objets associés à des objets paire différentielle dont la propriété Name est D0 ou D1.
InDifferentialPair('Input*')
InDifferentialPair('Input*') = True
InDifferentialPair('Input*') = 'True'
Renvoie tous les objets associés à des objets paire différentielle dont la propriété Name commence par Input.
Remarques
- Les apostrophes (') au début et à la fin de chaque chaîne
DifferentialPairNamesont obligatoires. - Les objets paires différentielles parents sont également renvoyés.
InDifferentialPairClass
Résumé
Renvoie tous les objets paires différentielles appartenant à la classe de paires différentielles spécifiée.
Syntaxe
InDifferentialPairClass(ClassName : String) : Boolean/Boolean_String
Lors de la définition de l'expression de requête, une liste contextuelle de toutes les paires différentielles existantes, triées par nom, s'affiche.
Exemples d'utilisation
InDifferentialPairClass('TopSide')
InDifferentialPairClass('TopSide') = True
InDifferentialPairClass('TopSide') = 'True'
Renvoie tous les objets paires différentielles appartenant à la classe de paires différentielles TopSide.
Not InDifferentialPairClass('BottomSide')
InDifferentialPairClass('BottomSide') = False
InDifferentialPairClass('BottomSide') = 'False'
Renvoie tous les objets except objets paires différentielles appartenant à la classe de paires différentielles BottomSide.
Remarque
Les apostrophes (') au début et à la fin de la chaîne ClassName sont obligatoires.
InDrillLayerPair
Résumé
Renvoie tous les objets vias dont la propriété Drill Pair correspond à la paire de couches de perçage spécifiée.
Syntaxe
InDrillLayerPair(LayerPair : String) : Boolean/Boolean_String
Exemples d'utilisation
InDrillLayerPair('Top Layer - Bottom Layer')
InDrillLayerPair('Top Layer - Bottom Layer') = True
InDrillLayerPair('Top Layer - Bottom Layer') = 'True'
Renvoie tous les objets vias dont la propriété Drill Pair correspond à la paire de couches de perçage Top Layer - Bottom Layer.
Not InDrillLayerPair('Top Layer - Signal Layer 1')
InDrillLayerPair('Top Layer - Signal Layer 1') = False
InDrillLayerPair('Top Layer - Signal Layer 1') = 'False'
Renvoie tous les objets except objets vias dont la propriété Drill Pair correspond à la paire de couches de perçage Top Layer - Signal Layer 1.
Remarques
- La propriété Drill Layer Pair est uniquement définie pour les objets vias.
-
Les apostrophes (') au début et à la fin de la chaîne
LayerPairsont obligatoires. -
Pour cibler un type de via spécifique, incluez une vérification appropriée du type d'objet dans la requête :
IsThruVia,IsBlindVia,IsBuriedVia,IsMicroViaouIsSkipVia.
Par exemple, la requête :
InDrillLayerPair('Top Layer - Signal Layer 1') AND IsMicroVia
Renvoie tous les objets vias dont la propriété Drill Pair correspond à la paire de couches de perçageTop Layer - Signal Layer 1ET dont le type de via estµVia.
InFromTo
Résumé
Renvoie tous les objets associés à un objet de liaison point à point dont les propriétés Net, From Pad et To Pad satisfont à la requête.
Bien que les objets de liaison point à point soient renvoyés dans le panneau PCB List, pour les voir dans l'espace de travail, vous devez appliquer la requête de filtrage après avoir placé le panneau PCB en mode From-To Editor.
Syntaxe
InFromTo('Net_Name (From_Pad : To_Pad)') : Boolean/Boolean_String
Lors de la définition de l'expression de requête, une liste contextuelle de toutes les liaisons point à point existantes, triées par nom, s'affiche.
Net_Name, From_Pad et To_Pad sont toutes des chaînes ; les seules apostrophes (') utilisées sont celles représentées ci-dessus (immédiatement à l'intérieur de la paire de parenthèses la plus externe).
Chacune des chaînes From_Pad et To_Pad spécifie le nom complet auquel une pastille doit correspondre. Celui-ci se compose d'une sous-chaîne initiale qui spécifie la propriété Name du composant parent de la pastille (c'est-à-dire le repère du composant), suivie d'une sous-chaîne qui spécifie la propriété Name de la pastille elle-même (c'est-à-dire le repère de la pastille). Le format est donc 'ParentComponentDesignator-PadDesignator'.
Exemples d'utilisation
InFromTo('VDD_XTAL (C13-2 : U1-8)')
InFromTo('VDD_XTAL (C13-2 : U1-8)') = True
InFromTo('VDD_XTAL (C13-2 : U1-8)') = 'True'
Renvoie tous les objets associés à un objet de liaison point à point dont la propriété Net est VDD_XTAL, la propriété From Pad est C13-2 et la propriété To Pad est U1-8. (Ainsi, la pastille de départ possède une propriété Name définie sur 2, et son objet composant parent possède une propriété Name définie sur C13. De même, la pastille d'arrivée possède une propriété Name définie sur 8 et son objet composant parent possède une propriété Name définie sur U1).
Remarque
Les objets de liaison point à point parents sont également renvoyés.
InFromToClass
Résumé
Renvoie tous les objets de liaison point à point appartenant à la classe de liaisons point à point spécifiée.
Syntaxe
InFromToClass(ClassName : String) : Boolean/Boolean_String
Lors de la définition de l'expression de requête, une liste contextuelle de toutes les classes de liaisons point à point définies par l'utilisateur existantes, classées par nom, s'affiche.
Exemples d'utilisation
InFromToClass('Bus Terminators')
InFromToClass('Bus Terminators') = True
InFromToClass('Bus Terminators') = 'True'
Renvoie tous les objets de liaison point à point appartenant à la classe de liaisons point à point Bus Terminators.
Not InFromToClass('Bus Terminators')
InFromToClass('Bus Terminators') = False
InFromToClass('Bus Terminators') = 'False'
Renvoie tous les objets except objets de liaison point à point appartenant à la classe de liaisons point à point Bus Terminators.
Remarque
Les apostrophes (') au début et à la fin de la chaîne ClassName sont obligatoires.
InLayerClass
Résumé
Renvoie tous les objets dont la propriété Layer correspond à une couche appartenant à la classe de couches spécifiée.
Syntaxe
InLayerClass(ClassName : String) : Boolean/Boolean_String
Lors de la définition de l'expression de requête, une liste contextuelle de toutes les classes de couches définies par l'utilisateur existantes, triées par nom, s'affiche.
Exemples d'utilisation
InLayerClass('TopSide')
InLayerClass('TopSide') = True
InLayerClass('TopSide') = 'True'
Renvoie tous les objets dont la propriété Layer correspond à une couche appartenant à la classe de couches TopSide.
Not InLayerClass('BottomSide')
InLayerClass('BottomSide') = False
InLayerClass('BottomSide') = 'False'
Renvoie tous les objets except objets dont la propriété Layer correspond à une couche appartenant à la classe de couches BottomSide.
Remarque
Les apostrophes (') au début et à la fin de la chaîne ClassName sont obligatoires.
InLayerStackRegion
Résumé
Renvoie tous les objets dont le point de référence se trouve dans la région Board Region nommée.
Syntaxe
InLayerStackRegion(RegionName1 : String,RegionName2 : String,...,RegionNamen : String) : Boolean/Boolean_String
Exemples d'utilisation
InLayerStackRegion('Region1')
InLayerStackRegion('Region1') = True
InLayerStackRegion('Region1') = 'True'
Renvoie tous les objets dont le point de référence se trouve dans la région de carte dont la propriété Name est Region1.
InLayerStackRegion('Region1','Region2')
InLayerStackRegion('Region1','Region2') = True
InLayerStackRegion('Region1','Region2') = 'True'
Renvoie tous les objets dont le point de référence se trouve dans la région de carte dont la propriété Name est Region1, ou dans la région de carte dont la propriété Name est Region2.
Not InLayerStackRegion('Region2')
InLayerStackRegion('Region2') = False
InLayerStackRegion('Region2') = 'False'
Renvoie tous les objets except objets dont le point de référence se trouve dans la région de carte dont la propriété Name est Region2.
Remarque
Les apostrophes (') au début et à la fin de la chaîne RegionName sont obligatoires.
InNamedPolygon
Résumé
Renvoie tous les objets primitifs enfants du remplissage polygonal spécifié.
Syntaxe
InNamedPolygon(PolygonName : String) : Boolean/Boolean_String
Lors de la définition de l'expression de requête, une liste contextuelle de tous les remplissages polygonaux existants, triés par nom, s'affiche.
Exemples d'utilisation
InNamedPolygon('Power3V3')
InNamedPolygon('Power3V3') = True
InNamedPolygon('Power3V3') = 'True'
Renvoie tous les objets primitifs enfants du remplissage polygonal dont la propriété Name est Power3V3.
Not InNamedPolygon('Power3V3')
InNamedPolygon('Power3V3') = False
InNamedPolygon('Power3V3') = 'False'
Renvoie tous les objets except objets primitifs enfants du remplissage polygonal dont la propriété Name est Power3V3.
Remarques
-
Les apostrophes (') au début et à la fin de la chaîne
PolygonNamesont obligatoires. - L'objet de remplissage polygonal parent est également renvoyé.
InNamedUnion
Résumé
Renvoie tous les objets (parents et enfants) faisant partie de l'union spécifiée.
Syntaxe
InNamedUnion(UnionName : String) : Boolean/Boolean_String
Les noms des unions sont attribués automatiquement, mais peuvent être modifiés à l’aide du panneau PCB en mode Unions . Lorsque vous définissez l’expression de requête, une liste contextuelle de toutes les unions existantes, triées par nom, s’affiche.
Exemples d’utilisation
InNamedUnion('Unions')
InNamedUnion('Unions') = True
InNamedUnion('Unions') = 'True'
Renvoie tous les objets (parents et enfants) appartenant à l’union dont le nom est Unions.
Not InNamedUnion('Unions 1')
InNamedUnion('Unions 1') = False
InNamedUnion('Unions 1') = 'False'
Renvoie tous les objets except objets (parents et enfants) appartenant à l’union dont le nom est Unions 1.
Remarque
Les apostrophes (') au début et à la fin de la chaîne UnionName sont obligatoires.
InNet
Résumé
Renvoie tous les objets associés aux objets de type net dont la propriété Name répond à la requête.
Syntaxe
InNet(NetName1 : String,NetName2 : String,...,NetNamen : String) : Boolean/Boolean_String
Lorsque vous définissez l’expression de requête, une liste contextuelle de tous les nets existants, triés par nom, s’affiche.
Exemples d’utilisation
InNet('Red_LED')
InNet('Red_LED') = True
InNet('Red_LED') = 'True'
Renvoie tous les objets associés à l’objet de type net dont la propriété Name a pour valeur Red_LED.
InNet('D0','D1')
InNet('D0','D1') = True
InNet('D0','D1') = 'True'
Renvoie tous les objets associés aux objets de type net dont la propriété Name a pour valeur D0 ou D1.
InNet('V*')
InNet('V*') = True
InNet('V*') = 'True'
Renvoie tous les objets associés aux objets de type net dont la propriété Name commence par V.
Remarques
-
Les apostrophes (') au début et à la fin de chaque chaîne
NetNamesont obligatoires. - Les objets nets parents sont également renvoyés.
InNetClass
Résumé
Renvoie tous les nets (et leurs objets associés) appartenant à la classe de nets spécifiée.
Syntaxe
InNetClass(ClassName : String) : Boolean/Boolean_String
Lorsque vous définissez l’expression de requête, une liste contextuelle de toutes les classes de nets définies par l’utilisateur, triées par nom, s’affiche.
Exemples d’utilisation
InNetClass('Data Bus Nets')
InNetClass('Data Bus Nets') = True
InNetClass('Data Bus Nets') = 'True'
Renvoie tous les nets (et leurs objets associés) appartenant à la classe de nets Data Bus Nets.
Not InNetClass('Address Bus Nets')
InNetClass('Address Bus Nets') = False
InNetClass('Address Bus Nets') = 'False'
Renvoie tous les objets except nets (et leurs objets associés) appartenant à la classe de nets Address Bus Nets.
Remarque
Les apostrophes (') au début et à la fin de la chaîne ClassName sont obligatoires.
InPadClass
Résumé
Renvoie tous les objets de type pastille appartenant à la classe de pastilles spécifiée.
Syntaxe
InPadClass(ClassName : String) : Boolean/Boolean_String
Lorsque vous définissez l’expression de requête, une liste contextuelle de toutes les classes de pastilles définies par l’utilisateur, triées par nom, s’affiche.
Exemples d’utilisation
InPadClass('Top Side Probe Pads')
InPadClass('Top Side Probe Pads') = True
InPadClass('Top Side Probe Pads') = 'True'
Renvoie tous les objets de type pastille appartenant à la classe de pastilles Top Side Probe Pads.
Not InPadClass('Bottom Side Probe Pads')
InPadClass('Bottom Side Probe Pads') = False
InPadClass('Bottom Side Probe Pads') = 'False'
Renvoie tous les objets except objets de type pastille appartenant à la classe de pastilles Bottom Side Probe Pads.
Remarque
Les apostrophes (') au début et à la fin de la chaîne ClassName sont obligatoires.
InPolygonClass
Résumé
Renvoie tous les objets de type polygone de cuivre appartenant à la classe de polygones spécifiée.
Syntaxe
InPolygonClass(ClassName : String) : Boolean/Boolean_String
Lorsque vous définissez l’expression de requête, une liste contextuelle de toutes les classes de polygones définies par l’utilisateur, triées par nom, s’affiche.
Exemples d’utilisation
InPolygonClass('Top Side Polys')
InPolygonClass('Top Side Polys') = True
InPolygonClass('Top Side Polys') = 'True'
Renvoie tous les objets de type polygone de cuivre appartenant à la classe de polygones Top Side Polys.
Not InPolygonClass('Custom Polys')
InPolygonClass('Custom Polys') = False
InPolygonClass('Custom Polys') = 'False'
Renvoie tous les objets except objets de type polygone de cuivre appartenant à la classe de polygones Custom Polys.
Remarque
Les apostrophes (') au début et à la fin de la chaîne ClassName sont obligatoires.
InRegion
Résumé
Renvoie tous les objets situés dans la zone spécifiée par la requête.
Syntaxe
InRegion(X1 : Number ,Y1 : Number ,X2 : Number ,Y2 : Number) : Boolean/Boolean_String
X1,Y1 et X2,Y2 spécifient les coordonnées dans le fichier PCB (ou de bibliothèque PCB). Les limites gauche et droite de la région sont spécifiées par les paramètres X1 et X2, tandis que les limites inférieure et supérieure sont spécifiées par les paramètres Y1 et Y2.
Toutes les coordonnées sont référencées par rapport à l’origine absolue (et non à l’origine utilisateur ou au point d’insertion du composant) et sont actuellement toujours exprimées en mils (1 mil = 0,001 pouce).
Exemple d’utilisation
InRegion(12700,4700,13300,5000)
InRegion(12700,4700,13300,5000) = True
InRegion(12700,4700,13300,5000) = 'True'
Renvoie les objets situés dans la région rectangulaire délimitée par X1 = 12700 et X2 = 13300, ainsi que par Y1 = 4700 et Y2 = 5000 ; ces coordonnées sont référencées par rapport à l’origine absolue.
Remarques
- Les objets parents de type composant, coordonnée, cote et net ne sont pas renvoyés.
- Ce mot-clé est un alias du mot-clé InRegionAbsolute.
InRegionAbsolute
Résumé
Renvoie tous les objets situés dans la zone spécifiée par la requête.
Syntaxe
InRegionAbsolute(X1 : Number ,Y1 : Number ,X2 : Number ,Y2 : Number) : Boolean/Boolean_String
X1,Y1 et X2,Y2 spécifient les coordonnées dans le fichier PCB (ou de bibliothèque PCB). Les limites gauche et droite de la région sont spécifiées par les paramètres X1 et X2, tandis que les limites inférieure et supérieure sont spécifiées par les paramètres Y1 et Y2.
Toutes les coordonnées sont référencées par rapport à l’origine absolue (et non à l’origine utilisateur ou au point d’insertion du composant) et sont actuellement toujours exprimées en mils (1 mil = 0,001 pouce).
Exemple d’utilisation
InRegionAbsolute(12700,4700,13300,5000)
InRegionAbsolute(12700,4700,13300,5000) = True
InRegionAbsolute(12700,4700,13300,5000) = 'True'
Renvoie les objets situés dans la région rectangulaire délimitée par X1 = 12700 et X2 = 13300, ainsi que par Y1 = 4700 et Y2 = 5000 ; ces coordonnées sont référencées par rapport à l’origine absolue.
Remarques
- Les objets parents de type composant, coordonnée, cote et net ne sont pas renvoyés.
- Ce mot-clé est un alias du mot-clé InRegion.
InRegionRelative
Résumé
Renvoie tous les objets situés dans la zone spécifiée par la requête.
Syntaxe
InRegionRelative(X1 : Number ,Y1 : Number ,X2 : Number ,Y2 : Number) : Boolean/Boolean_String
X1,Y1 et X2,Y2 spécifient les coordonnées dans le fichier PCB (ou de bibliothèque PCB). Les limites gauche et droite de la région sont spécifiées par les paramètres X1 et X2, tandis que les limites inférieure et supérieure sont spécifiées par les paramètres Y1 et Y2.
Toutes les coordonnées sont référencées par rapport à l’origine utilisateur (fichiers PCB) ou au point d’insertion du composant (fichiers de bibliothèque PCB), plutôt qu’à l’origine absolue, et sont actuellement toujours exprimées en mils (1 mil = 0,001 pouce).
Exemple d’utilisation
InRegionRelative(-700,-400,1300,1600)
InRegionRelative(-700,-400,1300,1600) = True
InRegionRelative(-700,-400,1300,1600) = 'True'
Renvoie les objets situés dans la région rectangulaire délimitée par X1 = -700 et X2 = 1300, ainsi que par Y1 = -400 et Y2 = 1600 ; ces coordonnées sont référencées par rapport à l’origine utilisateur (ou au point d’insertion du composant).
Remarque
Les objets parents de type composant, coordonnée, cote et net ne sont pas renvoyés.
InStructureClass
Résumé
Renvoie tous les objets parents et enfants des classes de composants et des classes de nets qui sont membres de la classe de structure spécifiée.
Syntaxe
InStructureClass(ClassName1 : String,ClassName2 : String,...,ClassNamen : String) : Boolean/Boolean_String
Lorsque vous définissez l'expression de requête, une liste contextuelle de toutes les classes de structure définies par l'utilisateur existantes, triées par nom, s'affiche.
Exemples d'utilisation
InStructureClass('Red_LED')
InStructureClass('Red_LED') = True
InStructureClass('Red_LED') = 'True'
Renvoie tous les objets parents et enfants des classes de composants et des classes de nets qui sont membres de la classe de structure Red_LED.
InStructureClass('Output channel','Input channel')
InStructureClass('Output channel','Input channel') = True
InStructureClass('Output channel','Input channel') = 'True'
Renvoie tous les objets parents et enfants des classes de composants et des classes de nets qui sont membres de l'une des classes de structure Output channel ou Input channel.
InStructureClass('Input*')
InStructureClass('Input*') = True
InStructureClass('Input*') = 'True'
Renvoie tous les objets parents et enfants des classes de composants et des classes de nets qui sont membres de toute classe de structure dont la propriété Name commence par Input.
Remarque
Les apostrophes (') au début et à la fin de chaque chaîne ClassName sont obligatoires.
InUnion
Résumé
Renvoie tous les objets (parents et enfants) qui font partie de l'union spécifiée.
Syntaxe
InUnion(Union : Number) : Boolean/Boolean_String
Les numéros d'union sont attribués automatiquement. Lorsque vous définissez l'expression de requête, une liste contextuelle de toutes les unions existantes, triées par numéro, s'affiche.
Exemples d'utilisation
InUnion(1)
InUnion(1) = True
InUnion(1) = 'True'
Renvoie tous les objets (parents et enfants) qui font partie de l'union dont le numéro attribué est 1.
Not InUnion(4)
InUnion(4) = False
InUnion(4) = 'False'
Renvoie tous les objets except objets (parents et enfants) qui font partie de l'union dont le numéro attribué est 4.
InxSignal
Résumé
Renvoie tous les objets associés au xSignal spécifié.
Syntaxe
InxSignal(Name : String) : Boolean/Boolean_String
Lorsque vous définissez l'expression de requête, une liste contextuelle de tous les xSignals existants, triés par nom, s'affiche.
Exemples d'utilisation
InxSignal('DRAM_A0_PP1')
InxSignal('DRAM_A0_PP1') = True
InxSignal('DRAM_A0_PP1') = 'True'
Renvoie tous les objets associés au xSignal DRAM_A0_PP1.
Not InxSignal('DRAM_A0_PP1')
InxSignal('DRAM_A0_PP1') = False
InxSignal('DRAM_A0_PP1') = 'False'
Renvoie tous les objets except objets associés au xSignal DRAM_A0_PP1.
Remarque
Les apostrophes (') au début et à la fin de la chaîne Name sont obligatoires.
InxSignalClass
Résumé
Renvoie tous les objets xSignal qui sont membres de la classe de xSignals spécifiée.
Syntaxe
InxSignalClass(ClassName : String) : Boolean/Boolean_String
Lorsque vous définissez l'expression de requête, une liste contextuelle de toutes les classes de xSignals définies par l'utilisateur existantes, triées par nom, s'affiche.
Exemples d'utilisation
InxSignalClass('PCIE')
InxSignalClass('PCIE') = True
InxSignalClass('PCIE') = 'True'
Renvoie tous les objets xSignal qui sont membres de la classe de xSignals PCIE.
Not InxSignalClass('PCIE')
InxSignalClass('PCIE') = False
InxSignalClass('PCIE') = 'False'
Renvoie tous les objets except objets xSignal qui sont membres de la classe de xSignals PCIE.
Remarque
Les apostrophes (') au début et à la fin de la chaîne ClassName sont obligatoires.
IsNamedPolygon
Résumé
Renvoie le remplissage polygonal spécifié.
Syntaxe
IsNamedPolygon(PolygonName : String) : Boolean/Boolean_String
Lorsque vous définissez l'expression de requête, une liste contextuelle de tous les remplissages polygonaux existants, triés par nom, s'affiche.
Exemples d'utilisation
IsNamedPolygon('Power3V3')
IsNamedPolygon('Power3V3') = True
IsNamedPolygon('Power3V3') = 'True'
Renvoie l'objet de remplissage polygonal dont la propriété Name est Power3V3.
Not IsNamedPolygon('Power3V3')
IsNamedPolygon('Power3V3') = False
IsNamedPolygon('Power3V3') = 'False'
Renvoie tous les objets except l'objet de remplissage polygonal dont la propriété Name est Power3V3.
Remarques
-
Les apostrophes (') au début et à la fin de la chaîne
PolygonNamesont obligatoires. -
Les objets primitifs enfants de l'objet de remplissage polygonal renvoyé ne sont pas renvoyés.
IsxSignal
Résumé
Renvoie l'objet xSignal portant le nom spécifié.
Syntaxe
IsxSignal(Name : String) : Boolean/Boolean_String
Lorsque vous définissez l'expression de requête, une liste contextuelle de tous les xSignals existants, triés par nom, s'affiche.
Exemples d'utilisation
IsxSignal('DRAM_A0_PP1')
IsxSignal('DRAM_A0_PP1') = True
IsxSignal('DRAM_A0_PP1') = 'True'
Renvoie le xSignal DRAM_A0_PP1.
Not IsxSignal('DRAM_A0_PP1')
IsxSignal('DRAM_A0_PP1') = False
IsxSignal('DRAM_A0_PP1') = 'False'
Renvoie tous les objets except le xSignal DRAM_A0_PP1.
Remarque
Les apostrophes (') au début et à la fin de la chaîne Name sont obligatoires.
OnGrid
Résumé
Renvoie tous les objets dont les propriétés X1 et Y1 satisfont à la requête.
Syntaxe
OnGrid(X1 : Number,Y1 : Number) : Boolean/Boolean_String
Chaque instance de Distance_String est une chaîne numérique qui spécifie une distance dans le fichier PCB (ou de bibliothèque PCB). Pour qu'un objet soit renvoyé, sa propriété X1 doit être un multiple entier de la première distance spécifiée, et sa propriété Y1 doit être un multiple entier de la seconde distance spécifiée.
X1 et Y1 spécifient les coordonnées dans le fichier PCB (ou de bibliothèque PCB). Pour qu'un objet soit renvoyé, sa propriété X1 doit être un multiple entier de la première valeur spécifiée, et sa propriété Y1 doit être un multiple entier de la seconde valeur spécifiée.
Toutes les coordonnées sont référencées à l'origine absolue (et non à l'origine utilisateur ou au point d'insertion du composant) et, à l'heure actuelle, elles sont toujours exprimées en mils (1 mil = 0,001 pouce).
Exemples d'utilisation
OnGrid(25,25)
OnGrid(25,25) = True
OnGrid(25,25) = 'True'
Renvoie tous les objets dont la propriété X1 est un multiple entier de 25mil et dont la propriété Y1 est un multiple entier de 25mil.
OnGrid(5,100)
OnGrid(5,100) = True
OnGrid(5,100) = 'True'
Renvoie tous les objets dont la propriété X1 est un multiple entier de 5mil et dont la propriété Y1 est un multiple entier de 100mil.
OnLayer
Résumé
Renvoie tous les objets dont la propriété Layer satisfait à la requête.
Syntaxe
OnLayer(Layer : String) : Boolean/Boolean_String
Layer est le nom de la couche tel qu'il apparaît dans l'onglet Layers & Colors du panneau Configuration de la vue.
Exemples d'utilisation
OnLayer('Top Layer')
OnLayer('Top Layer') = True
OnLayer('Top Layer') = 'True'
Renvoie tous les objets dont la propriété Layer est Top Layer.
Not OnLayer('Mechanical 3')
OnLayer('Mechanical 3') = False
OnLayer('Mechanical 3') = 'False'
Renvoie tous les objets except objets dont la propriété Layer correspond à la couche Mechanical 3.
Remarques
-
Les apostrophes (') au début et à la fin de
Layersont obligatoires. -
Notez que les objets placés sur la couche
Multi-Layerne seront renvoyés par le mot-clé de requêteOnLayerque si cette couche précise est spécifiée, c'est-à-dire lors de l'utilisation de la requêteOnLayer('Multi-Layer'). Les objets placés sur la coucheMulti-Layerne seront pas renvoyés par le mot-clé de requêteOnLayersi une autre couche sur laquelle les formes de ces objets existent est spécifiée. Utilisez la requêteExistsOnLayer(Layer : String)pour cibler les objets (y compris ceux de la coucheMulti-Layer) qui possèdent des formes sur la couche spécifiée.
TouchesRoom
Résumé
Renvoie les objets qui se trouvent entièrement ou partiellement dans la région occupée par un objet room (règle de contrainte de confinement) dont la propriété Name correspond à la requête.
Syntaxe
TouchesRoom(RoomName1 : String,RoomName2 : String,...,RoomNamen : String) : Boolean/Boolean_String
Lors de la définition de l’expression de requête, une liste contextuelle de toutes les rooms existantes, triées par nom, s’affiche.
Exemples d’utilisation
TouchesRoom('Power')
TouchesRoom('Power') = True
TouchesRoom('Power') = 'True'
Renvoie les objets qui se trouvent entièrement ou partiellement dans la région occupée par une room dont la propriété Name a pour valeur Power.
TouchesRoom('COUT1','COUT2')
TouchesRoom('COUT1','COUT2') = True
TouchesRoom('COUT1','COUT2') = 'True'
Renvoie les objets qui se trouvent entièrement ou partiellement dans les régions occupées par des rooms dont la propriété Name a pour valeur COUT1 ou COUT2.
TouchesRoom('Monitor','Auxilary','Effects')
TouchesRoom('Monitor','Auxilary','Effects') = True
TouchesRoom('Monitor','Auxilary','Effects') = 'True'
Renvoie les objets qui se trouvent entièrement ou partiellement dans les régions occupées par des rooms dont la propriété Name a pour valeur Monitor, Auxilary ou Effects.
Remarques
-
Les apostrophes (') au début et à la fin de chaque chaîne
RoomNamesont obligatoires. -
Les objets parents de type coordonnée, cote et net ne sont pas renvoyés.
WithinRoom
Résumé
Renvoie les objets qui se trouvent entièrement dans la région occupée par un objet room (règle de contrainte de confinement) dont la propriété Name correspond à la requête.
Pour que les pastilles et les vias soient renvoyés, leurs centres doivent se trouver dans la ou les rooms spécifiées.
Syntaxe
WithinRoom(RoomName1 : String,RoomName2 : String,...,RoomNamen : String) : Boolean/Boolean_String
Lors de la définition de l’expression de requête, une liste contextuelle de toutes les rooms existantes, triées par nom, s’affiche.
Exemples d’utilisation
WithinRoom('Power')
WithinRoom('Power') = True
WithinRoom('Power') = 'True'
Renvoie les objets qui se trouvent entièrement dans la région occupée par une room dont la propriété Name a pour valeur Power.
WithinRoom('COUT1','COUT2')
WithinRoom('COUT1','COUT2') = True
WithinRoom('COUT1','COUT2') = 'True'
Renvoie les objets qui se trouvent entièrement dans les régions occupées par des rooms dont la propriété Name a pour valeur COUT1 ou COUT2.
WithinRoom('Monitor','Auxilary','Effects')
WithinRoom('Monitor','Auxilary','Effects') = True
WithinRoom('Monitor','Auxilary','Effects') = 'True'
Renvoie les objets qui se trouvent entièrement dans les régions occupées par des rooms dont la propriété Name a pour valeur Monitor, Auxilary ou Effects.
Remarques
-
Les apostrophes (') au début et à la fin de chaque chaîne
RoomNamesont obligatoires. - Les objets parents de type coordonnée, cote et net ne sont pas renvoyés.