Paramètres
En un coup d'œil
- Découvrez quels mots-clés de requête liés aux paramètres s’appliquent aux composants, aux empreintes ou aux objets PCB en général, et comment utiliser chacun d’eux dans un filtre ou une requête.
- Consultez des exemples de requêtes pour rechercher des objets par nom de paramètre, trouver des correspondances exactes ou partielles de valeurs et exclure les objets qui ne remplissent pas une condition.
- Comprenez comment convertir les valeurs de paramètres sous forme de chaînes de caractères en valeurs numériques pour effectuer des comparaisons sur des plages de valeurs à l’aide de mots-clés tels que 'StrToNumber' et 'StrToNumberDef'.

Les fonctions de requête PCB Parameters 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 Parameters disponibles dans les documents PCB et les bibliothèques PCB. 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 panneau Query Helper ou dans un panneau Filter, puis appuyez sur F1 pour accéder immédiatement à sa section.
CompParameterValue
Résumé
Renvoie la valeur sous forme de chaîne d’un paramètre de composant PCB, qui peut être testée pour renvoyer les composants PCB répondant aux critères de la requête.
Syntaxe
CompParameterValue(ParameterName : String) : String
Exemple d’utilisation
CompParameterValue('Mounting Technology') Like 'SM*'
Renvoie tous les composants qui possèdent le paramètre Mounting Technology dont la valeur est une chaîne commençant par SM, comme SMT, SMD, etc. Les objets enfants associés à un objet composant répondant aux critères, tels que les pistes, arcs, pastilles, textes, etc., sont également renvoyés.
CompParameterValue('Mounting Technology') Like '*SM*'
Renvoie tous les composants et leurs objets enfants associés dont le paramètre Mounting Technology a pour valeur une chaîne contenant *SM*.
StrToNumber(CompParameterValue('VoltageRating'),V) > 50
Renvoie tous les composants et leurs objets enfants associés dont la valeur du paramètre VoltageRating est supérieure à 50 volts. La valeur sous forme de chaîne renvoyée par CompParameterValue est convertie en nombre pour la comparaison par la fonction StrToNumber, qui prend en compte les unités.
FootprintParameterValue
Résumé
Renvoie la valeur sous forme de chaîne d’un paramètre d’empreinte PCB, qui peut être testée pour renvoyer les composants PCB répondant aux critères de la requête.
Syntaxe
FootprintParameterValue(ParameterName : String) : String
Exemple d’utilisation
FootprintParameterValue('Mounting Type') Like 'SMD'
Renvoie tous les composants et leurs objets enfants associés dont le paramètre d’empreinte Mounting Type a pour valeur une chaîne contenant SMD.
HasCompParameter
Résumé
Renvoie les composants PCB possédant un paramètre portant le nom spécifié.
Syntaxe
HasCompParameter(ParameterName : String) : Boolean
Exemple d’utilisation
HasCompParameter('Mounting Technology')
HasCompParameter('Mounting Technology') = True
Renvoie tous les objets parents de type composant possédant un paramètre nommé Mounting Technology. Les objets enfants associés à un objet composant répondant aux critères, tels que les pistes, arcs, pastilles, textes, etc., sont également renvoyés.
Not HasCompParameter('Mounting Technology')
HasCompParameter('Mounting Technology') = False
Renvoie tous les composants et leurs objets enfants associés, except pour les objets parents de type composant possédant le paramètre Mounting Technology.
HasCompParameterValue
Résumé
Renvoie les composants PCB possédant un paramètre portant le nom spécifié et dont la valeur répond aux critères de la requête.
Syntaxe
HasCompParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Exemple d’utilisation
HasCompParameterValue('Mounting Technology','SMT')
HasCompParameterValue('Mounting Technology','SMT') = True
Renvoie tous les objets parents de type composant possédant un paramètre nommé Mounting Technology dont la valeur correspond à SMT. Les objets enfants associés à un objet composant répondant aux critères, tels que les pistes, arcs, pastilles, textes, etc., sont également renvoyés.
Not HasCompParameterValue('Design Item Status','RoHS-Compliant')
HasCompParameterValue('Design Item Status','RoHS-Compliant') = False
Renvoie tous les composants et leurs objets enfants associés qui ne possèdent pas de paramètre Design Item Status ayant pour valeur RoHS-Compliant.
HasFootprintParameter
Résumé
Renvoie les composants PCB possédant un paramètre d’empreinte portant le nom spécifié.
Syntaxe
HasFootprintParameter(ParameterName : String) : Boolean
Exemple d’utilisation
HasFootprintParameter('IPC Density')
HasFootprintParameter('IPC Density') = True
Renvoie tous les objets parents de type composant possédant un paramètre d’empreinte nommé IPC Density. Les objets enfants associés à un objet composant répondant aux critères, tels que les pistes, arcs, pastilles, textes, etc., sont également renvoyés.
Not HasFootprintParameter('IPC Density')
HasFootprintParameter('IPC Density') = False
Renvoie tous les composants et leurs objets enfants associés, except pour les objets parents de type composant possédant le paramètre d’empreinte IPC Density.
HasFootprintParameterValue
Résumé
Renvoie les composants PCB possédant un paramètre d’empreinte portant le nom spécifié et dont la valeur répond aux critères de la requête.
Syntaxe
HasFootprintParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Exemple d’utilisation
HasFootprintParameterValue('Mounting Method','Press Fit')
HasFootprintParameterValue('Mounting Method','Press Fit') = True
Renvoie tous les objets parents de type composant possédant un paramètre d’empreinte nommé Mounting Method dont la valeur correspond à Press Fit. . Les objets enfants associés à un objet composant répondant aux critères, tels que les pistes, arcs, pastilles, textes, etc., sont également renvoyés.
Not HasFootprintParameterValue('Mounting Method','Press Fit')
HasFootprintParameterValue('Mounting Method','Press Fit') = False
Renvoie tous les composants et leurs objets enfants associés qui ne possèdent pas de paramètre d’empreinte Mounting Method ayant pour valeur Press Fit.
HasParameter
Résumé
Renvoie les objets PCB possédant un paramètre portant le nom spécifié.
Syntaxe
HasParameter(ParameterName : String) : Boolean
Exemple d’utilisation
HasParameter('Mounting Technology')
HasParameter('Mounting Technology') = True
Renvoie tous les objets possédant un paramètre nommé Mounting Technology.
Not HasParameter('Mounting Technology')
HasParameter('Mounting Technology') = False
Renvoie tous les objets except ceux qui possèdent le paramètre Mounting Technology.
HasParameterValue
Résumé
Renvoie les objets PCB possédant un paramètre portant le nom spécifié et dont la valeur répond aux critères de la requête.
Syntaxe
HasParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Exemple d’utilisation
HasParameterValue('Mounting Technology','SMT')
HasParameterValue('Mounting Technology','SMT') = True
Renvoie tous les objets possédant un paramètre nommé Mounting Technology dont la valeur correspond à SMT.
Not HasParameterValue('Design Item Status','RoHS-Compliant')
HasParameterValue('Design Item Status','RoHS-Compliant') = False
Renvoie tous les objets qui ne possèdent pas de paramètre Design Item Status ayant pour valeur RoHS-Compliant.
ParameterValue
Résumé
Renvoie la valeur sous forme de chaîne d’un paramètre d’objet PCB, qui peut être testée pour renvoyer les objets PCB répondant aux critères de la requête.
Syntaxe
ParameterValue(ParameterName : String) : String
Exemple d’utilisation
ParameterValue('Mounting Technology') Like 'SM*'
Renvoie tous les objets possédant le paramètre Mounting Technology dont la valeur est une chaîne commençant par SM, comme SMT, SMD, etc.
ParameterValue('Mounting Technology') Like '*SM*'
Renvoie tous les objets possédant le paramètre Mounting Technology dont la valeur est une chaîne contenant SM.
StrToNumber(ParameterValue('VoltageRating'),V) > 50
Renvoie tous les objets dont la valeur du paramètre VoltageRating est supérieure à 50 volts. La valeur sous forme de chaîne renvoyée par ParameterValue est convertie en nombre pour la comparaison par la fonction StrToNumber, qui prend en compte les unités.
StrToNumber
Résumé
Convertit la chaîne de valeur du paramètre désigné en nombre en utilisant le type d’unité spécifié.
Syntaxe
StrToNumber(Value : String , Unit : String) : Number
Exemple d’utilisation
StrToNumber(ParameterValue('VoltageRating'),V) > 50
Convertit la chaîne de valeur renvoyée par le paramètre VoltageRating en nombre, en utilisant le volt (V) comme unité, puis renvoie tous les objets dont la valeur est supérieure à 50 V.
StrToNumber(ParameterValue('Resistance'),Ohms) Between 1000 And 10000
Convertit la chaîne de valeur renvoyée par le paramètre Resistance en nombre, en utilisant l’ohm comme unité, puis renvoie tous les objets dont la valeur est comprise entre 1 kΩ et 10 kΩ.
StrToNumber(ParameterValue('CapacitanceValue'),F) < 2e-9
Convertit la chaîne de valeur renvoyée par le paramètre CapacitanceValue en nombre, en utilisant le farad (F), unité de capacité, puis renvoie tous les objets dont la valeur est inférieure à 2 nF (2e-9 en notation scientifique).
Remarques
Une erreur de script est générée si la chaîne de valeur ne peut pas être convertie en nombre. Pour gérer ce cas, utilisez la fonction StrToNumber, qui renvoie un nombre par défaut spécifié si la conversion échoue.
La fonction de conversion de chaîne en nombre tenant compte des unités accepte un large éventail de définitions de types d’unités, notamment :
- V – Tension
- A – Courant
- Ohm – Résistance
- Z – Impédance
- F – Capacité
- H – Inductance
- G – Conductance
- W – Puissance
- Hz – Fréquence
- Q – Charge
- C – Température
- dB – Décibels
- % – Pourcentage
- m – Longueur
- Kg – Masse
- s – Temps
Le convertisseur accepte les facteurs multiplicateurs standard (micro, kilo, méga, etc.) et, par conséquent, les chaînes de paramètres contenant des abréviations de préfixes telles que mV, uA, kHz,, etc.
Plusieurs formats de valeurs sont également pris en charge. Par exemple, une même valeur de résistance peut être représentée comme suit :
- 2k2
- 2.2k
- 2200
- 2,200
StrToNumberDef
Résumé
Convertit la chaîne de valeur du paramètre spécifié en un nombre, ou en un nombre par défaut, en utilisant le type d’unité indiqué.
Syntaxe
StrToNumber(Value : String , Unit : String , Default : Number) : Number
Exemples d’utilisation
StrToNumberDef(ParameterValue('VoltageRating'),V,10) > 50
Convertit la chaîne de valeur renvoyée par le paramètre VoltageRating en un nombre, en utilisant la tension (V) comme unité, puis renvoie tous les objets dont la valeur est supérieure à 50 V. Si la chaîne du paramètre ou l’unité n’est pas reconnue (et ne peut donc pas être convertie), une valeur par défaut de 10 est renvoyée.
StrToNumberDef(ParameterValue('VoltageRating'),'V',6) Between 10 And 50
Convertit la chaîne de valeur renvoyée par le paramètre VoltageRating en un nombre, en utilisant la tension (V) comme unité, puis renvoie tous les objets dont la valeur nominale est comprise entre 10 V et 50 V. Si la valeur ne peut pas être lue, une tension de 6 V (la valeur par défaut définie) est utilisée.
Remarques
La fonction de conversion de chaîne en nombre tenant compte des unités accepte un large éventail de définitions de types d’unités, notamment :
- V – Tension
- A – Courant
- Ohm – Résistance
- Z – Impédance
- F – Capacité
- H – Inductance
- G – Conductance
- W – Puissance
- Hz – Fréquence
- Q – Charge
- C – Température
- dB – Décibels
- % – Pourcentage
- m – Longueur
- Kg – Masse
- s – Temps
Le convertisseur accepte les facteurs multiplicateurs standard (micro, kilo, méga, etc.) et, par conséquent, les chaînes de paramètres contenant des abréviations de préfixes telles que mV, uA, kHz,, etc.
Plusieurs formats de valeurs sont également pris en charge. Par exemple, une même valeur de résistance peut être représentée comme suit :
- 2k2
- 2.2k
- 2200
- 2,200