Parâmetros

As funções de pesquisa de PCB apresentadas na caixa de diálogo ParametersEsta página de referência detalha as palavras-chave da linguagem de pesquisa da categoria Query Helper disponíveis em documentos PCB e de biblioteca PCB. Para obter ajuda sobre uma palavra‑chave de pesquisa específica, utilize as seguintes secções expansíveis ou realce (ou clique dentro de) qualquer palavra‑chave na Parameters ou num painel Query Helper e, em seguida, prima Filter para aceder imediatamente à respetiva secção.
CompParameterValue
Resumo
Devolve o valor em cadeia de um parâmetro de componente PCB, que pode ser testado para devolver componentes PCB que cumpram a pesquisa.
Sintaxe
CompParameterValue(ParameterName : String) : String
Exemplo de utilização
CompParameterValue('Mounting Technology') Like 'SM*'
Devolve todos os componentes que incluem o parâmetro Mounting Technology com um valor em cadeia iniciado por SM, tal como SMT, SMD, etc. Também são devolvidos os objetos filho associados de um objeto de componente em conformidade, como pistas, arcos, pads, texto, etc.
CompParameterValue('Mounting Technology') Like '*SM*'
Devolve todos os componentes e os respetivos objetos filho associados em que o parâmetro Mounting Technology tem um valor em cadeia que inclui *SM*.
StrToNumber(CompParameterValue('VoltageRating'),V) > 50
Devolve todos os componentes e os respetivos objetos filho associados em que o valor do parâmetro VoltageRating é superior a 50 volts. O valor em cadeia devolvido por CompParameterValue é convertido num número para a comparação pela função StrToNumber, que reconhece unidades.
FootprintParameterValue
Resumo
Devolve o valor em cadeia de um parâmetro de Footprint PCB, que pode ser testado para devolver componentes PCB que cumpram a pesquisa.
Sintaxe
FootprintParameterValue(ParameterName : String) : String
Exemplo de utilização
FootprintParameterValue('Mounting Type') Like 'SMD'
Devolve todos os componentes e os respetivos objetos filho associados em que o parâmetro de Footprint Mounting Type tem um valor em cadeia que inclui SMD.
HasCompParameter
Resumo
Devolve componentes PCB que incluem o nome de parâmetro especificado.
Sintaxe
HasCompParameter(ParameterName : String) : Boolean
Exemplo de utilização
HasCompParameter('Mounting Technology')
HasCompParameter('Mounting Technology') = True
Devolve todos os objetos‑pai de componente que têm o nome de parâmetro Mounting Technology. Também são devolvidos os objetos filho associados de um objeto de componente em conformidade, como pistas, arcos, pads, texto, etc.
Not HasCompParameter('Mounting Technology')
HasCompParameter('Mounting Technology') = False
Devolve todos os componentes e os respetivos objetos filho associados, except para os objetos‑pai de componente que tenham o parâmetro Mounting Technology.
HasCompParameterValue
Resumo
Devolve componentes PCB que incluem o nome de parâmetro especificado com um valor que cumpra a pesquisa.
Sintaxe
HasCompParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Exemplo de utilização
HasCompParameterValue('Mounting Technology','SMT')
HasCompParameterValue('Mounting Technology','SMT') = True
Devolve todos os objetos‑pai de componente que têm o nome de parâmetro Mounting Technology com uma propriedade de valor correspondente de SMT. Também são devolvidos os objetos filho associados de um objeto de componente em conformidade, como pistas, arcos, pads, texto, etc.
Not HasCompParameterValue('Design Item Status','RoHS-Compliant')
HasCompParameterValue('Design Item Status','RoHS-Compliant') = False
Devolve todos os componentes e os respetivos objetos filho associados que não têm um parâmetro Design Item Status com um valor de RoHS-Compliant.
HasFootprintParameter
Resumo
Devolve componentes PCB que incluem o nome do parâmetro de Footprint especificado.
Sintaxe
HasFootprintParameter(ParameterName : String) : Boolean
Exemplo de utilização
HasFootprintParameter('IPC Density')
HasFootprintParameter('IPC Density') = True
Devolve todos os objetos‑pai de componente que têm o nome do parâmetro de Footprint IPC Density . Também são devolvidos os objetos filho associados de um objeto de componente em conformidade, como pistas, arcos, pads, texto, etc.
Not HasFootprintParameter('IPC Density')
HasFootprintParameter('IPC Density') = False
Devolve todos os componentes e os respetivos objetos filho associados, except para os objetos‑pai de componente que tenham o parâmetro de Footprint IPC Density .
HasFootprintParameterValue
Resumo
Devolve componentes PCB que incluem o nome do parâmetro de Footprint especificado com um valor que cumpra a pesquisa.
Sintaxe
HasFootprintParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Exemplo de utilização
HasFootprintParameterValue('Mounting Method','Press Fit')
HasFootprintParameterValue('Mounting Method','Press Fit') = True
Devolve todos os objetos‑pai de componente que têm o nome do parâmetro de Footprint Mounting Method com uma propriedade de valor correspondente de Press Fit. Também são devolvidos os objetos filho associados de um objeto de componente em conformidade, como pistas, arcos, pads, texto, etc.
Not HasFootprintParameterValue('Mounting Method','Press Fit')
HasFootprintParameterValue('Mounting Method','Press Fit') = False
Devolve todos os componentes e os respetivos objetos filho associados que não têm um parâmetro de Footprint Mounting Method com um valor de Press Fit.
HasParameter
Resumo
Devolve objetos PCB que incluem o nome de parâmetro especificado.
Sintaxe
HasParameter(ParameterName : String) : Boolean
Exemplo de utilização
HasParameter('Mounting Technology')
HasParameter('Mounting Technology') = True
Devolve todos os objetos que têm o nome de parâmetro Mounting Technology.
Not HasParameter('Mounting Technology')
HasParameter('Mounting Technology') = False
Devolve todos os objetos except exceto os que têm o parâmetro Mounting Technology.
HasParameterValue
Resumo
Devolve objetos PCB que incluem o nome de parâmetro especificado com um valor que cumpra a pesquisa.
Sintaxe
HasParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Exemplo de utilização
HasParameterValue('Mounting Technology','SMT')
HasParameterValue('Mounting Technology','SMT') = True
Devolve todos os objetos que têm o nome de parâmetro Mounting Technology e uma propriedade de valor correspondente de SMT.
Not HasParameterValue('Design Item Status','RoHS-Compliant')
HasParameterValue('Design Item Status','RoHS-Compliant') = False
Devolve todos os objetos que não têm um parâmetro Design Item Status com um valor de RoHS-Compliant.
ParameterValue
Resumo
Devolve o valor em cadeia de um parâmetro de objeto PCB, que pode ser testado para devolver objetos PCB que cumpram a pesquisa.
Sintaxe
ParameterValue(ParameterName : String) : String
Exemplo de utilização
ParameterValue('Mounting Technology') Like 'SM*'
Devolve todos os objetos com o parâmetro Mounting Technology cujo valor em cadeia começa por SM, tal como SMT, SMD, etc.
ParameterValue('Mounting Technology') Like '*SM*'
Devolve todos os objetos com o parâmetro Mounting Technology cujo valor em cadeia inclui SM.
StrToNumber(ParameterValue('VoltageRating'),V) > 50
Devolve todos os objetos que têm um valor de parâmetro VoltageRating superior a 50 volts. O valor em cadeia devolvido por ParameterValue é convertido num número para a comparação pela função StrToNumber, que reconhece unidades.
StrToNumber
Resumo
Converte a cadeia de valor do parâmetro indicado num número usando o tipo de unidade especificado.
Sintaxe
StrToNumber(Value : String , Unit : String) : Number
Exemplo de utilização
StrToNumber(ParameterValue('VoltageRating'),V) > 50
Converte o valor em cadeia devolvido pelo parâmetro VoltageRating num número, usando volts (V) como unidade, e depois devolve todos os objetos com um valor superior a 50V.
StrToNumber(ParameterValue('Resistance'),Ohms) Between 1000 And 10000
Converte o valor em cadeia devolvido pelo parâmetro Resistance num número, usando ohms como unidade, e depois devolve todos os objetos com um valor entre 1kΩ e 10kΩ.
StrToNumber(ParameterValue('CapacitanceValue'),F) < 2e-9
Converte o valor em cadeia devolvido pelo parâmetro CapacitanceValue num número, usando Capacitância (F) como unidade, e depois devolve todos os objetos com um valor inferior a 2nF (2e-9 em notação científica).
Notas
Será gerado um erro de scripting se a cadeia de valor não puder ser convertida num número. Para contemplar esta situação, utilize a função StrToNumber, que devolve um número predefinido se a conversão falhar.
A função de conversão de cadeia em número com reconhecimento de unidades aceita uma vasta gama de definições de tipo de unidade, incluindo:
- V – Tensão
- A – Corrente
- Ohm – Resistência
- Z – Impedância
- F – Capacitância
- H – Indutância
- G – Condutância
- W – Potência
- Hz – Frequência
- Q – Carga
- C – Temperatura
- dB – Decibéis
- % – Percentagem
- m – Comprimento
- Kg – Massa
- s – Tempo
O conversor aceita fatores de escala de valor padrão (micro, quilo, mega, etc.,) e, por conseguinte, cadeias de parâmetros que contenham abreviaturas de prefixo como mV, uA, kHz, etc.
Também são suportadas várias formas de representação de valores. Por exemplo, o mesmo valor de resistência pode ser representado como:
- 2k2
- 2.2k
- 2200
- 2,200
StrToNumberDef
Resumo
Converte a cadeia de valor do parâmetro indicado num número, ou num número predefinido, usando o tipo de unidade especificado.
Sintaxe
StrToNumber(Value : String , Unit : String , Default : Number) : Number
Exemplo de utilização
StrToNumberDef(ParameterValue('VoltageRating'),V,10) > 50
Converte o valor em cadeia devolvido pelo parâmetro VoltageRating num número, usando tensão (V) como unidade, e depois devolve todos os objetos com um valor superior a 50V. Se a cadeia do parâmetro ou a unidade não forem reconhecidas (não puderem ser convertidas), é devolvido um valor predefinido de 10.
StrToNumberDef(ParameterValue('VoltageRating'),'V',6) Between 10 And 50
Converte o valor em cadeia devolvido pelo parâmetro VoltageRating num número, usando tensão (V) como unidade, e depois devolve todos os objetos com um valor nominal entre 10V e 50V. Se o valor não puder ser lido, é assumida uma tensão de 6V (o valor predefinido definido).
Notas
A função de conversão de cadeia em número com reconhecimento de unidades aceita uma vasta gama de definições de tipo de unidade, incluindo:
- V – Tensão
- A – Corrente
- Ohm – Resistência
- Z – Impedância
- F – Capacitância
- H – Indutância
- G – Condutância
- W – Potência
- Hz – Frequência
- Q – Carga
- C – Temperatura
- dB – Decibéis
- % – Percentagem
- m – Comprimento
- Kg – Massa
- s – Tempo
O conversor aceita fatores de escala de valor padrão (micro, quilo, mega, etc.,) e, por conseguinte, cadeias de parâmetros que contenham abreviaturas de prefixo como mV, uA, kHz, etc.
Também são suportadas várias formas de representação de valores. Por exemplo, o mesmo valor de resistência pode ser representado como:
- 2k2
- 2.2k
- 2200
- 2,200