Verificações de associação

As funções de consulta PCB apresentadas na caixa de diálogo Query Helper
Esta página de referência detalha as palavras-chave da linguagem de consulta da categoria Membership Checks disponíveis em documentos PCB e PCB Library no Altium Designer. Para ajuda sobre uma palavra‑chave de consulta específica, utilize as seguintes secções expansíveis ou realce (ou clique dentro de) qualquer palavra‑chave na Query Helper ou num painel Filter, depois prima F1 para aceder imediatamente à sua secção.
AsMils
Resumo
Para propriedades numéricas de objetos (por exemplo, altura, largura, raio, etc.), esta palavra‑chave é utilizada para converter o valor atual – medido nas unidades predefinidas da área de trabalho – em unidades imperiais - mil - onde 1 mil = 0,001 polegada, sendo depois testado em relação ao valor introduzido na expressão.
Sintaxe
AsMils(Keyword : Number) : Number
Exemplo de utilização
AsMils(ArcRadius) = 250
Devolve todos os objetos de arco que têm uma propriedade Radius que é 250mil.
AsMils(Height) Between 300 And 500
Devolve todos os objetos de componente que têm uma propriedade Height que é maior ou igual a 300mil, e menor ou igual a 500mil.
AsMils(PolygonGridSize) >= 10
Devolve todos os objetos de enchimento de polígono que têm uma propriedade Grid Size que é maior ou igual a 10mil.
AsMils(Width) < 50
Devolve todos os objetos de arco e pista que têm uma propriedade Width que é menor do que 50mil.
AsMils(TraceLength) = 10
Devolve todos os objetos de arco e pista que têm uma Length que é igual a 10mil.
Note - devido a um problema no software, para detetar corretamente o TraceLength utilizando a palavra‑chave AsMils, as unidades da placa têm de ser definidas para mils antes de executar a consulta.
AsMM
Resumo
Para propriedades numéricas de objetos (por exemplo, altura, largura, raio, etc.), esta palavra‑chave é utilizada para converter o valor atual – medido nas unidades predefinidas da área de trabalho – em unidades métricas - mm - onde 1 mm = 0,001 metro, sendo depois testado em relação ao valor introduzido na expressão.
Sintaxe
AsMM(Keyword : Number) : Number
Exemplo de utilização
AsMM(ArcRadius) = 6.35
Devolve todos os objetos de arco que têm uma propriedade Radius que é 6.35mm.
AsMM(Height) Between 7.62 And 12.7
Devolve todos os objetos de componente que têm uma propriedade Height que é maior ou igual a 7.62mm, e menor ou igual a 12.7mm.
AsMM(PolygonGridSize) >= 0.254
Devolve todos os objetos de enchimento de polígono que têm uma propriedade Grid Size que é maior ou igual a 0.254mm.
AsMM(Width) < 1.27
Devolve todos os objetos de arco e pista que têm uma propriedade Width que é menor do que 1.27mm.
AsMM(TraceLength) = 1
Devolve todos os objetos de arco e pista que têm uma Length que é igual a 1mm.
Note - devido a um problema no software, para detetar corretamente o TraceLength utilizando a palavra‑chave AsMM, as unidades da placa têm de ser definidas para mils antes de executar a consulta.
ComponentInLayerClass
Resumo
Devolve todos os objetos de componente cuja propriedade Layer corresponde a uma camada que é membro da Classe de Camada especificada.
Sintaxe
ComponentInLayerClass(ClassName : String) : Boolean/Boolean_String
À medida que define a expressão de consulta, é apresentada uma lista pop-up de todas as classes de camadas definidas pelo utilizador existentes, ordenadas por nome.
Exemplo de utilização
ComponentInLayerClass('TopSide')
ComponentInLayerClass('TopSide') = True
ComponentInLayerClass('TopSide') = 'True'
Devolve todos os objetos de componente cuja propriedade Layer corresponde a uma camada que é membro da Classe de Camada TopSide.
Not ComponentInLayerClass('BottomSide')
ComponentInLayerClass('BottomSide') = False
ComponentInLayerClass('BottomSide') = 'False'
Devolve todos os objetos except objetos de componente cuja propriedade Layer corresponde a uma camada que é membro da Classe de Camada BottomSide.
Nota
Os caracteres de aspas simples (') no início e no fim da cadeia ClassName são obrigatórios.
ExistsOnLayer
Resumo
Devolve todos os objetos que existem na camada especificada.
Sintaxe
ExistsOnLayer(Layer : String) : Boolean/Boolean_String
Layer é o nome da camada tal como aparece no separador Layers & Colors do painel View Configuration.
Exemplo de utilização
ExistsOnLayer('Top Layer')
ExistsOnLayer('Top Layer') = True
ExistsOnLayer('Top Layer') = 'True'
Devolve todos os objetos que existem na Top Layer.
Not ExistsOnLayer('Mechanical 3')
ExistsOnLayer('Mechanical 3') = False
ExistsOnLayer('Mechanical 3') = 'False'
Devolve todos os objetos except objetos que existem na camada Mechanical 3.
Nota
Os caracteres de aspas simples (') no início e no fim de Layer são obrigatórios.
HasFootprint
Resumo
Devolve todos os objetos de componente cuja propriedade Footprint cumpre a Consulta.
Sintaxe
HasFootprint(Footprint : String) : Boolean/Boolean_String
Exemplo de utilização
HasFootprint('SIP?0')
HasFootprint('SIP?0') = True
HasFootprint('SIP?0') = 'True'
Devolve todos os objetos de componente cuja propriedade Footprint começa com SIP e termina com 0, e inclui um outro caráter intermédio. Exemplos de footprints compatíveis incluem SIP10, SIP20 e SIPQ0.
HasFootprint('DIP*')
HasFootprint('DIP*') = True
HasFootprint('DIP*') = 'True'
Devolve todos os objetos de componente cuja propriedade Footprint começa com DIP. Exemplos de footprints compatíveis incluem DIP8, DIP14 e DIP24N.
Not HasFootprint('IDC16')
HasFootprint('IDC16') = False
HasFootprint('IDC16') = 'False'
Devolve todos os objetos except objetos de componente cuja propriedade Footprint é IDC16.
HasFootprint('*2*')
HasFootprint('*2*') = True
HasFootprint('*2*') = 'True'
Devolve todos os objetos de componente cuja propriedade Footprint inclui o caráter 2. Exemplos de footprints compatíveis incluem 2012, 2N5001, IDC20 e HDR1X2.
Notas
-
Os caracteres de aspas simples (') no início e no fim da cadeia
Footprintsão obrigatórios. - Para cada objeto de componente devolvido, os seus objetos filho associados também são devolvidos.
HasFootprintPad
Resumo
Devolve todos os objetos pad que são filhos de objetos de componente com o Footprint especificado, e em que a propriedade Name do pad cumpre a Consulta.
Sintaxe
HasFootprintPad(Footprint : String,Name : String) : Boolean/Boolean_String
Exemplo de utilização
Not HasFootprintPad('0805','1')
HasFootprintPad('0805','1') = False
HasFootprintPad('0805','1') = 'False'
Devolve todos os objetos except objetos pad cuja propriedade Name é 1, e são objetos filho de objetos de componente cuja propriedade Footprint é 0805.
HasFootprintPad('SIP?0','1')
HasFootprintPad('SIP?0','1') = True
HasFootprintPad('SIP?0','1') = 'True'
Devolve todos os objetos pad cuja propriedade Name é 1, e são objetos filho de objetos de componente cuja propriedade Footprint começa com SIP, termina com 0, e inclui um outro caráter intermédio. Exemplos de footprints compatíveis incluem SIP10, SIP20, SIPQ0.
HasFootprintPad('DB*','MNT')
HasFootprintPad('DB*','MNT') = True
HasFootprintPad('DB*','MNT') = 'True'
Devolve todos os objetos pad cuja propriedade Name é MNT e são objetos filho de objetos de componente cuja propriedade Footprint começa com DB. Exemplos de footprints compatíveis incluem DB9S, DB15HD, DB25P.
HasFootprintPad('','MN*')
HasFootprintPad('','MN*') = True
HasFootprintPad('','MN*') = 'True'
Devolve todos os objetos pad cuja propriedade Name começa com MN, e são objetos filho de any objeto de componente.
Notas
-
Os caracteres de aspas simples (') no início e no fim das cadeias
FootprinteNamesão obrigatórios. - Os objetos de componente pai não são devolvidos.
HasMaskExpansionOnLayer
Resumo
Devolve todos os objetos de arco, preenchimento, pad, região, pista e via que têm valores de Expansão da Máscara de Pasta (exceto via), ou de Expansão da Máscara de Soldadura, definidos para a camada especificada. Os valores podem ser definidos manualmente ou obtidos a partir da regra de projeto definida aplicável.
Sintaxe
HasMaskExpansionOnLayer(Layer : String) : Boolean/Boolean_String
Layer é o nome da camada, tal como aparece na secção Layers aplicável, no separador Layers & Colors do painel View Configuration.
Exemplo de utilização
HasMaskExpansionOnLayer('Top Layer')
HasMaskExpansionOnLayer('Top Layer') = True
HasMaskExpansionOnLayer('Top Layer') = 'True'
Devolve todos os objetos de arco, preenchimento, pad, região, pista e via que têm valores de Expansão da Máscara de Pasta (exceto via), ou de Expansão da Máscara de Soldadura, definidos para a Top Layer.
Not HasMaskExpansionOnLayer('Bottom Layer')
HasMaskExpansionOnLayer('Bottom Layer') = False
HasMaskExpansionOnLayer('Bottom Layer') = 'False'
Devolve todos os objetos except de arco, preenchimento, pad, região, pista e via que têm valores de Expansão da Máscara de Pasta (exceto via), ou de Expansão da Máscara de Soldadura, definidos para a Bottom Layer.
Nota
Os caracteres de aspas simples (') no início e no fim de Layer são obrigatórios.
HasPad
Resumo
Devolve todos os objetos pad cuja propriedade de nome completo cumpre a Consulta.
Sintaxe
HasPad(PadName : String) : Boolean/Boolean_String
A cadeia PadName especifica o nome completo com o qual um pad tem de corresponder. Isto consiste numa subcadeia inicial que especifica a propriedade Name do componente pai do pad (isto é, o Designador do componente), seguida de uma subcadeia que especifica a propriedade Name do próprio pad (isto é, o Designador do pad). O formato é, portanto, 'ParentComponentDesignator-PadDesignator'.
Exemplo de utilização
Not HasPad('C14-1')
HasPad('C14-1') = False
HasPad('C14-1') = 'False'
Devolve todos os objetos except o objeto pad cuja propriedade Name é 1, e é um objeto filho do objeto de componente cuja propriedade Name é C14.
HasPad('U5-11')
HasPad('U5-11') = True
HasPad('U5-11') = 'True'
Devolve o objeto pad cuja propriedade Name é 11, e é um objeto filho do objeto de componente cuja propriedade Name é U5.
HasPad('U*-11')
HasPad('U*-11') = True
HasPad('U*-11') = 'True'
Devolve todos os objetos pad cuja propriedade Name é 11, e são objetos filho de objetos de componente cuja propriedade Name começa com U.
HasPad('*-1*')
HasPad('*-1*') = True
HasPad('*-1*') = 'True'
Devolve todos os objetos pad cuja propriedade Name começa com 1, e são objetos filho de any objeto de componente.
Nota
Os caracteres de aspas simples (') no início e no fim da cadeia PadName são obrigatórios.
HasViaFeature
Resumo
Devolve todos os objetos via cuja propriedade de funcionalidade da via cumpre a Consulta.
Sintaxe
HasViaFeature(ViaFeature : String) : Boolean/Boolean_String
A cadeia ViaFeature especifica a característica de via que uma via tem de corresponder. Esta pode ser uma das seguintes:
-
Capping -
Covering -
Filling -
Plugging -
Tenting
Exemplo de utilização
Not HasViaFeature('Capping')
HasViaFeature('Capping') = False
HasViaFeature('Capping') = 'False'
Devolve todos os objetos except o objeto via cuja propriedade de característica de via é Capping.
HasViaFeature('Covering')
HasViaFeature('Covering') = True
HasViaFeature('Covering') = 'True'
Devolve o objeto via cuja propriedade de característica de via é Covering.
Nota
Os caracteres de aspas simples (') no início e no fim da cadeia ViaFeature são obrigatórios.
HasViaType
Resumo
Devolve todos os objetos via cuja propriedade de tipo de via cumpre a Query.
Sintaxe
HasViaType(ViaType : String) : Boolean/Boolean_String
A cadeia ViaType especifica a propriedade IPC 4761 Via Type que uma via tem de corresponder. Esta pode ser uma das seguintes:
-
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
Exemplo de utilização
Not HasViaFeature('Capping')
HasViaFeature('Capping') = False
HasViaFeature('Capping') = 'False'
Devolve todos os objetos except o objeto via cuja propriedade de característica de via é Capping.
HasViaFeature('Covering')
HasViaFeature('Covering') = True
HasViaFeature('Covering') = 'True'
Devolve o objeto via cuja propriedade de característica de via é Covering.
Nota
Os caracteres de aspas simples (') no início e no fim da cadeia ViaFeature são obrigatórios.
InChannelClass
Resumo
Devolve todos os objetos associados a objetos de componente que são membros da Classe de Canal de Design especificada.
Sintaxe
InChannelClass(ClassName1 : String,ClassName2 : String,...,ClassNamen : String) : Boolean/Boolean_String
À medida que define a expressão Query, é apresentada uma lista pop-up de todas as classes de canal de design definidas pelo utilizador existentes, ordenadas por nome.
Exemplo de utilização
InChannelClass('Red_LED')
InChannelClass('Red_LED') = True
InChannelClass('Red_LED') = 'True'
Devolve todos os objetos associados a objetos de componente que são membros da Classe de Canal de Design Red_LED.
InChannelClass('Output channel','Input channel')
InChannelClass('Output channel','Input channel') = True
InChannelClass('Output channel','Input channel') = 'True'
Devolve todos os objetos associados a objetos de componente que são membros da Classe de Canal de Design Output channel ou Input channel.
InChannelClass('Input*')
InChannelClass('Input*') = True
InChannelClass('Input*') = 'True'
Devolve todos os objetos associados a objetos de componente que são membros de qualquer Classe de Canal de Design cuja propriedade Name comece por Input.
Notas
-
Os caracteres de aspas simples (') no início e no fim de cada cadeia
ClassNamesão obrigatórios. - Os objetos de componente pai também são devolvidos.
InComponent
Resumo
Devolve todos os objetos de componente cuja propriedade Name cumpre a Query.
Sintaxe
InComponent(Name : String) : Boolean/Boolean_String
À medida que define a expressão Query, é apresentada uma lista pop-up de todos os componentes existentes, ordenados por nome.
Exemplo de utilização
InComponent('U1')
InComponent('U1') = True
InComponent('U1') = 'True'
Devolve todos os objetos de componente cuja propriedade Name é U1.
InComponent('U1', 'U2', 'J1')
InComponent('U1', 'U2', 'J1') = True
InComponent('U1', 'U2', 'J1') = 'True'
Devolve todos os objetos de componente cuja propriedade Name é U1, ou U2, ou J1.
Not InComponent('IDC16')
InComponent('IDC16') = False
InComponent('IDC16') = 'False'
Devolve todos os objetos except objetos de componente cuja propriedade Name é IDC16.
InComponent('U*')
InComponent('U*') = True
InComponent('U*') = 'True'
Devolve todos os objetos de componente cuja propriedade Name começa por U.
Notas
-
Os caracteres de aspas simples (') no início e no fim da cadeia
Namesão obrigatórios. - Para cada objeto de componente devolvido, os respetivos objetos filho associados também são devolvidos.
InComponentClass
Resumo
Devolve todos os objetos de componente que são membros da Classe de Componentes especificada.
Sintaxe
InComponentClass(ClassName : String) : Boolean/Boolean_String
À medida que define a expressão Query, é apresentada uma lista pop-up de todas as classes de componentes definidas pelo utilizador existentes, ordenadas por nome.
Exemplo de utilização
InComponentClass('TopSideSMD')
InComponentClass('TopSideSMD') = True
InComponentClass('TopSideSMD') = 'True'
Devolve todos os objetos de componente que são membros da Classe de Componentes TopSideSMD.
Not InComponentClass('BottomSideSMD')
InComponentClass('BottomSideSMD') = False
InComponentClass('BottomSideSMD') = 'False'
Devolve todos os objetos except objetos de componente que são membros da Classe de Componentes BottomSideSMD.
Nota
Os caracteres de aspas simples (') no início e no fim da cadeia ClassName são obrigatórios.
InDifferentialPair
Resumo
Devolve todos os objetos associados a objetos de par diferencial cuja propriedade Name cumpre a Query.
Sintaxe
InDifferentialPair(DifferentialPairName1 : String,DifferentialPair2 : String,...,DifferentialPairn : String) : Boolean/Boolean_String
À medida que define a expressão Query, é apresentada uma lista pop-up de todos os pares diferenciais existentes, ordenados por nome.
Exemplo de utilização
InDifferentialPair('Red_LED')
InDifferentialPair('Red_LED') = True
InDifferentialPair('Red_LED') = 'True'
Devolve todos os objetos associados ao objeto de par diferencial cuja propriedade Name é Red_LED.
InDifferentialPair('D0','D1')
InDifferentialPair('D0','D1') = True
InDifferentialPair('D0','D1') = 'True'
Devolve todos os objetos associados a objetos de par diferencial cuja propriedade Name é D0 ou D1.
InDifferentialPair('Input*')
InDifferentialPair('Input*') = True
InDifferentialPair('Input*') = 'True'
Devolve todos os objetos associados a objetos de par diferencial cuja propriedade Name começa por Input.
Notas
-
Os caracteres de aspas simples (') no início e no fim de cada cadeia
DifferentialPairNamesão obrigatórios. - Os objetos de par diferencial pai também são devolvidos.
InDifferentialPairClass
Resumo
Devolve todos os objetos de par diferencial que são membros da Classe de Pares Diferenciais especificada.
Sintaxe
InDifferentialPairClass(ClassName : String) : Boolean/Boolean_String
À medida que define a expressão Query, é apresentada uma lista pop-up de todos os pares diferenciais existentes, ordenados por nome.
Exemplo de utilização
InDifferentialPairClass('TopSide')
InDifferentialPairClass('TopSide') = True
InDifferentialPairClass('TopSide') = 'True'
Devolve todos os objetos de par diferencial que são membros da Classe de Pares Diferenciais TopSide.
Not InDifferentialPairClass('BottomSide')
InDifferentialPairClass('BottomSide') = False
InDifferentialPairClass('BottomSide') = 'False'
Devolve todos os objetos except objetos de par diferencial que são membros da Classe de Pares Diferenciais BottomSide.
Nota
Os caracteres de aspas simples (') no início e no fim da cadeia ClassName são obrigatórios.
InDrillLayerPair
Resumo
Devolve todos os objetos via cuja propriedade Drill Pair corresponde ao Par de Camadas de Furação especificado.
Sintaxe
InDrillLayerPair(LayerPair : String) : Boolean/Boolean_String
Exemplo de utilização
InDrillLayerPair('Top Layer - Bottom Layer')
InDrillLayerPair('Top Layer - Bottom Layer') = True
InDrillLayerPair('Top Layer - Bottom Layer') = 'True'
Devolve todos os objetos via cuja propriedade Drill Pair corresponde ao Par de Camadas de Furação 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'
Devolve todos os objetos except objetos via cuja propriedade Drill Pair corresponde ao Par de Camadas de Furação Top Layer - Signal Layer 1.
Notas
- A propriedade Drill Layer Pair só está definida para objetos via.
-
Os caracteres de aspas simples (') no início e no fim da cadeia
LayerPairsão obrigatórios. -
Para direcionar um tipo específico de via, inclua uma verificação adequada do tipo de objeto na query:
IsThruVia,IsBlindVia,IsBuriedVia,IsMicroVia, ouIsSkipVia.
Por exemplo, a query:
InDrillLayerPair('Top Layer - Signal Layer 1') AND IsMicroVia
Devolve todos os objetos via cuja propriedade Drill Pair corresponde ao Par de Camadas de FuraçãoTop Layer - Signal Layer 1E cujo tipo de via éµVia.
InFromTo
Resumo
Devolve todos os objetos associados a um objeto from-to cujas propriedades Net, From Pad e To Pad cumprem a Query.
Embora os objetos from-to sejam devolvidos no painel PCB List, para os ver na área de trabalho, terá de aplicar a query de filtro depois de colocar o painel PCB em modo From-To Editor.
Sintaxe
InFromTo('Net_Name (From_Pad : To_Pad)') : Boolean/Boolean_String
À medida que define a expressão query, é apresentada uma lista pop-up de todos os from-tos existentes, ordenados por nome.
Net_Name, From_Pad e To_Pad são todos cadeias; os únicos caracteres de aspas simples (') utilizados são os apresentados acima (imediatamente dentro do par mais externo de parênteses retos).
Cada uma das cadeias From_Pad e To_Pad especifica o nome completo ao qual um pad tem de corresponder. Este consiste numa subcadeia inicial que especifica a propriedade Name do componente pai do pad (ou seja, o Designator do componente), seguida de uma subcadeia que especifica a propriedade Name do próprio pad (ou seja, o Designator do pad). O formato é, portanto, 'ParentComponentDesignator-PadDesignator'.
Exemplo de utilização
InFromTo('VDD_XTAL (C13-2 : U1-8)')
InFromTo('VDD_XTAL (C13-2 : U1-8)') = True
InFromTo('VDD_XTAL (C13-2 : U1-8)') = 'True'
Devolve todos os objetos associados a um objeto from-to cuja propriedade Net é VDD_XTAL, a propriedade From Pad é C13-2 e a propriedade To Pad é U1-8. (Assim, o From Pad tem uma propriedade Name de 2, e o seu objeto de componente pai tem uma propriedade Name de C13. Do mesmo modo, o To Pad tem uma propriedade Name de 8 e o seu objeto de componente pai tem uma propriedade Name de U1).
Nota
Os objetos from-to pai também são devolvidos.
InFromToClass
Resumo
Devolve todos os objetos from-to que são membros da Classe From To especificada.
Sintaxe
InFromToClass(ClassName : String) : Boolean/Boolean_String
À medida que define a expressão Query, é apresentada uma lista pop-up de todas as classes from to definidas pelo utilizador existentes, por nome.
Exemplo de utilização
InFromToClass('Bus Terminators')
InFromToClass('Bus Terminators') = True
InFromToClass('Bus Terminators') = 'True'
Devolve todos os objetos from-to que são membros da Classe From To Bus Terminators.
Not InFromToClass('Bus Terminators')
InFromToClass('Bus Terminators') = False
InFromToClass('Bus Terminators') = 'False'
Devolve todos os objetos except objetos from-to que são membros da Classe From To Bus Terminators.
Nota
Os caracteres de aspas simples (') no início e no fim da cadeia ClassName são obrigatórios.
InLayerClass
Resumo
Devolve todos os objetos cuja propriedade Layer corresponde a uma camada que é membro da Classe de Camadas especificada.
Sintaxe
InLayerClass(ClassName : String) : Boolean/Boolean_String
À medida que define a expressão Query, é apresentada uma lista pop-up de todas as classes de camadas definidas pelo utilizador existentes, ordenadas por nome.
Exemplo de utilização
InLayerClass('TopSide')
InLayerClass('TopSide') = True
InLayerClass('TopSide') = 'True'
Devolve todos os objetos cuja propriedade Layer corresponde a uma camada que é membro da Classe de Camadas TopSide.
Not InLayerClass('BottomSide')
InLayerClass('BottomSide') = False
InLayerClass('BottomSide') = 'False'
Devolve todos os objetos except objetos cuja propriedade Layer corresponde a uma camada que é membro da Classe de Camadas BottomSide.
Nota
Os caracteres de aspas simples (') no início e no fim da cadeia ClassName são obrigatórios.
InLayerStackRegion
Resumo
Devolve todos os objetos cujo ponto de referência se encontra dentro da Board Region indicada.
Sintaxe
InLayerStackRegion(RegionName1 : String,RegionName2 : String,...,RegionNamen : String) : Boolean/Boolean_String
Exemplo de utilização
InLayerStackRegion('Region1')
InLayerStackRegion('Region1') = True
InLayerStackRegion('Region1') = 'True'
Devolve todos os objetos cujo ponto de referência se encontra dentro da Região da Placa cuja propriedade Name é Region1.
InLayerStackRegion('Region1','Region2')
InLayerStackRegion('Region1','Region2') = True
InLayerStackRegion('Region1','Region2') = 'True'
Devolve todos os objetos cujo ponto de referência se encontra dentro da Região da Placa cuja propriedade Name é Region1, ou da Região da Placa cuja propriedade Name é Region2.
Not InLayerStackRegion('Region2')
InLayerStackRegion('Region2') = False
InLayerStackRegion('Region2') = 'False'
Devolve todos os objetos except objetos cujo ponto de referência se encontra dentro da Região da Placa cuja propriedade Name é Region2.
Nota
Os caracteres de aspas simples (') no início e no fim da cadeia RegionName são obrigatórios.
InNamedPolygon
Resumo
Devolve todos os objetos primitivos que são filhos do vazado de polígono especificado.
Sintaxe
InNamedPolygon(PolygonName : String) : Boolean/Boolean_String
À medida que define a expressão Query, é apresentada uma lista pop-up de todos os vazados de polígono existentes, ordenados por nome.
Exemplo de utilização
InNamedPolygon('Power3V3')
InNamedPolygon('Power3V3') = True
InNamedPolygon('Power3V3') = 'True'
Devolve todos os objetos primitivos que são filhos do vazado de polígono cuja propriedade Name é Power3V3.
Not InNamedPolygon('Power3V3')
InNamedPolygon('Power3V3') = False
InNamedPolygon('Power3V3') = 'False'
Devolve todos os objetos except objetos primitivos que são filhos do vazado de polígono cuja propriedade Name é Power3V3.
Notas
-
Os caracteres de aspas simples (') no início e no fim da cadeia
PolygonNamesão obrigatórios. - O objeto pai do vazado de polígono também é devolvido.
InNamedUnion
Resumo
Devolve todos os objetos (pai e filhos) que fazem parte da união especificada.
Sintaxe
InNamedUnion(UnionName : String) : Boolean/Boolean_String
Os nomes das uniões são atribuídos automaticamente, mas podem ser alterados através do painel PCB no modo Unions . À medida que define a expressão Query, é apresentada uma lista pop-up de todas as uniões existentes, ordenadas por nome.
Exemplo de utilização
InNamedUnion('Unions')
InNamedUnion('Unions') = True
InNamedUnion('Unions') = 'True'
Devolve todos os objetos (pai e filhos) que fazem parte da união cujo nome é Unions.
Not InNamedUnion('Unions 1')
InNamedUnion('Unions 1') = False
InNamedUnion('Unions 1') = 'False'
Devolve todos os objetos except objetos (pai e filhos) que fazem parte da união cujo nome é Unions 1.
Nota
Os caracteres de aspas simples (') no início e no fim da cadeia UnionName são obrigatórios.
InNet
Resumo
Devolve todos os objetos associados a objetos Net cuja propriedade Name cumpre a Query.
Sintaxe
InNet(NetName1 : String,NetName2 : String,...,NetNamen : String) : Boolean/Boolean_String
À medida que define a expressão Query, é apresentada uma lista pop-up de todas as nets existentes, ordenadas por nome.
Exemplo de utilização
InNet('Red_LED')
InNet('Red_LED') = True
InNet('Red_LED') = 'True'
Devolve todos os objetos associados ao objeto Net cuja propriedade Name é Red_LED.
InNet('D0','D1')
InNet('D0','D1') = True
InNet('D0','D1') = 'True'
Devolve todos os objetos associados a objetos Net cuja propriedade Name é D0 ou D1.
InNet('V*')
InNet('V*') = True
InNet('V*') = 'True'
Devolve todos os objetos associados a objetos Net cuja propriedade Name começa por V.
Notas
-
Os caracteres de aspas simples (') no início e no fim de cada cadeia
NetNamesão obrigatórios. - Os objetos Net pai também são devolvidos.
InNetClass
Resumo
Devolve todas as nets (e os respetivos objetos associados) que são membros da Net Class especificada.
Sintaxe
InNetClass(ClassName : String) : Boolean/Boolean_String
À medida que define a expressão Query, é apresentada uma lista pop-up de todas as classes de nets definidas pelo utilizador, ordenadas por nome.
Exemplo de utilização
InNetClass('Data Bus Nets')
InNetClass('Data Bus Nets') = True
InNetClass('Data Bus Nets') = 'True'
Devolve todas as nets (e os respetivos objetos associados) que são membros da Net Class Data Bus Nets.
Not InNetClass('Address Bus Nets')
InNetClass('Address Bus Nets') = False
InNetClass('Address Bus Nets') = 'False'
Devolve todos os objetos except nets (e os respetivos objetos associados) que são membros da Net Class Address Bus Nets.
Nota
Os caracteres de aspas simples (') no início e no fim da cadeia ClassName são obrigatórios.
InPadClass
Resumo
Devolve todos os objetos pad que são membros da Pad Class especificada.
Sintaxe
InPadClass(ClassName : String) : Boolean/Boolean_String
À medida que define a expressão Query, é apresentada uma lista pop-up de todas as classes de pads definidas pelo utilizador, ordenadas por nome.
Exemplo de utilização
InPadClass('Top Side Probe Pads')
InPadClass('Top Side Probe Pads') = True
InPadClass('Top Side Probe Pads') = 'True'
Devolve todos os objetos pad que são membros da Pad Class Top Side Probe Pads.
Not InPadClass('Bottom Side Probe Pads')
InPadClass('Bottom Side Probe Pads') = False
InPadClass('Bottom Side Probe Pads') = 'False'
Devolve todos os objetos except objetos pad que são membros da Pad Class Bottom Side Probe Pads.
Nota
Os caracteres de aspas simples (') no início e no fim da cadeia ClassName são obrigatórios.
InPolygonClass
Resumo
Devolve todos os objetos de vazado de polígono que são membros da Polygon Class especificada.
Sintaxe
InPolygonClass(ClassName : String) : Boolean/Boolean_String
À medida que define a expressão Query, é apresentada uma lista pop-up de todas as classes de polígonos definidas pelo utilizador, ordenadas por nome.
Exemplo de utilização
InPolygonClass('Top Side Polys')
InPolygonClass('Top Side Polys') = True
InPolygonClass('Top Side Polys') = 'True'
Devolve todos os objetos de vazado de polígono que são membros da Polygon Class Top Side Polys.
Not InPolygonClass('Custom Polys')
InPolygonClass('Custom Polys') = False
InPolygonClass('Custom Polys') = 'False'
Devolve todos os objetos except objetos de vazado de polígono que são membros da Polygon Class Custom Polys.
Nota
Os caracteres de aspas simples (') no início e no fim da cadeia ClassName são obrigatórios.
InRegion
Resumo
Devolve todos os objetos que se encontram dentro da área especificada pela Query.
Sintaxe
InRegion(X1 : Number ,Y1 : Number ,X2 : Number ,Y2 : Number) : Boolean/Boolean_String
X1,Y1 e X2,Y2 especificam coordenadas no ficheiro PCB (Library). Os limites esquerdo e direito da região são especificados pelos parâmetros X1 e X2, enquanto os limites inferior e superior da região são especificados pelos parâmetros Y1 e Y2.
Todas as coordenadas são referidas à origem absoluta (e não à origem do utilizador ou ao ponto de inserção do componente) e, atualmente, utilizam sempre unidades em mils (1 mil = 0.001 polegada).
Exemplo de utilização
InRegion(12700,4700,13300,5000)
InRegion(12700,4700,13300,5000) = True
InRegion(12700,4700,13300,5000) = 'True'
Devolve os objetos que se encontram dentro da região retangular delimitada por X1 = 12700 e X2 = 13300, e por Y1 = 4700 e Y2 = 5000; essas coordenadas são referidas à origem absoluta.
Notas
- Os objetos pai de componente, coordenada, dimensão e Net não são devolvidos.
- Esta palavra-chave é um alias da palavra-chave InRegionAbsolute.
InRegionAbsolute
Resumo
Devolve todos os objetos que se encontram dentro da área especificada pela Query.
Sintaxe
InRegionAbsolute(X1 : Number ,Y1 : Number ,X2 : Number ,Y2 : Number) : Boolean/Boolean_String
X1,Y1 e X2,Y2 especificam coordenadas no ficheiro PCB (Library). Os limites esquerdo e direito da região são especificados pelos parâmetros X1 e X2, enquanto os limites inferior e superior da região são especificados pelos parâmetros Y1 e Y2.
Todas as coordenadas são referidas à origem absoluta (e não à origem do utilizador ou ao ponto de inserção do componente) e, atualmente, utilizam sempre unidades em mils (1 mil = 0.001 polegada).
Exemplo de utilização
InRegionAbsolute(12700,4700,13300,5000)
InRegionAbsolute(12700,4700,13300,5000) = True
InRegionAbsolute(12700,4700,13300,5000) = 'True'
Devolve os objetos que se encontram dentro da região retangular delimitada por X1 = 12700 e X2 = 13300, e por Y1 = 4700 e Y2 = 5000; essas coordenadas são referidas à origem absoluta.
Notas
- Os objetos pai de componente, coordenada, dimensão e Net não são devolvidos.
- Esta palavra-chave é um alias da palavra-chave InRegion.
InRegionRelative
Resumo
Devolve todos os objetos que se encontram dentro da área especificada pela Query.
Sintaxe
InRegionRelative(X1 : Number ,Y1 : Number ,X2 : Number ,Y2 : Number) : Boolean/Boolean_String
X1,Y1 e X2,Y2 especificam coordenadas no ficheiro PCB (Library). Os limites esquerdo e direito da região são especificados pelos parâmetros X1 e X2, enquanto os limites inferior e superior da região são especificados pelos parâmetros Y1 e Y2.
Todas as coordenadas são referidas à origem do utilizador (ficheiros PCB) ou ao ponto de inserção do componente (ficheiros PCB Library), em vez da origem absoluta, e, atualmente, utilizam sempre unidades em mils. (1 mil = 0.001 polegada).
Exemplo de utilização
InRegionRelative(-700,-400,1300,1600)
InRegionRelative(-700,-400,1300,1600) = True
InRegionRelative(-700,-400,1300,1600) = 'True'
Devolve os objetos que se encontram dentro da região retangular delimitada por X1 = -700 e X2 = 1300, e por Y1 = -400 e Y2 = 1600; essas coordenadas são referidas à origem do utilizador (ou ao ponto de inserção do componente).
Nota
Os objetos pai de componente, coordenada, dimensão e Net não são devolvidos.
InStructureClass
Resumo
Devolve todos os objetos pai e filho das Component Classes e Net Classes que são membros da Structure Class especificada.
Sintaxe
InStructureClass(ClassName1 : String,ClassName2 : String,...,ClassNamen : String) : Boolean/Boolean_String
À medida que define a expressão Query, é apresentada uma lista pop-up de todas as classes de estrutura definidas pelo utilizador, ordenadas por nome.
Exemplo de utilização
InStructureClass('Red_LED')
InStructureClass('Red_LED') = True
InStructureClass('Red_LED') = 'True'
Devolve todos os objetos pai e filho das Component Classes e Net Classes que são membros da Structure Class Red_LED.
InStructureClass('Output channel','Input channel')
InStructureClass('Output channel','Input channel') = True
InStructureClass('Output channel','Input channel') = 'True'
Devolve todos os objetos pai e filho das Component Classes e Net Classes que são membros da Structure Class Output channel ou Input channel.
InStructureClass('Input*')
InStructureClass('Input*') = True
InStructureClass('Input*') = 'True'
Devolve todos os objetos pai e filho das Classes de Componentes e Classes de Nets que são membros de qualquer Classe de Estrutura cuja Name propriedade comece por Input.
Nota
Os caracteres de aspas simples (') no início e no fim de cada cadeia ClassName são obrigatórios.
InUnion
Resumo
Devolve todos os objetos (pais e filhos) que fazem parte da união especificada.
Sintaxe
InUnion(Union : Number) : Boolean/Boolean_String
Os números de união são atribuídos automaticamente. À medida que define a expressão Query, é apresentada uma lista pop-up de todas as uniões existentes, ordenadas por número.
Exemplo de Utilização
InUnion(1)
InUnion(1) = True
InUnion(1) = 'True'
Devolve todos os objetos (pais e filhos) que fazem parte da união cujo número atribuído é 1.
Not InUnion(4)
InUnion(4) = False
InUnion(4) = 'False'
Devolve todos os except objetos (pais e filhos) que fazem parte da união cujo número atribuído é 4.
InxSignal
Resumo
Devolve todos os objetos que estão associados ao xSignal especificado.
Sintaxe
InxSignal(Name : String) : Boolean/Boolean_String
À medida que define a expressão Query, é apresentada uma lista pop-up de todos os xSignals existentes, ordenados por nome.
Exemplo de Utilização
InxSignal('DRAM_A0_PP1')
InxSignal('DRAM_A0_PP1') = True
InxSignal('DRAM_A0_PP1') = 'True'
Devolve todos os objetos que estão associados ao xSignal DRAM_A0_PP1.
Not InxSignal('DRAM_A0_PP1')
InxSignal('DRAM_A0_PP1') = False
InxSignal('DRAM_A0_PP1') = 'False'
Devolve todos os except objetos que estão associados ao xSignal DRAM_A0_PP1.
Nota
Os caracteres de aspas simples (') no início e no fim da cadeia Name são obrigatórios.
InxSignalClass
Resumo
Devolve todos os objetos xSignal que são membros da Classe xSignal especificada.
Sintaxe
InxSignalClass(ClassName : String) : Boolean/Boolean_String
À medida que define a expressão Query, é apresentada uma lista pop-up de todas as classes xSignal definidas pelo utilizador, ordenadas por nome.
Exemplo de Utilização
InxSignalClass('PCIE')
InxSignalClass('PCIE') = True
InxSignalClass('PCIE') = 'True'
Devolve todos os objetos xSignal que são membros da Classe xSignal PCIE.
Not InxSignalClass('PCIE')
InxSignalClass('PCIE') = False
InxSignalClass('PCIE') = 'False'
Devolve todos os except objetos xSignal que são membros da Classe xSignal PCIE.
Nota
Os caracteres de aspas simples (') no início e no fim da cadeia ClassName são obrigatórios.
IsNamedPolygon
Resumo
Devolve o preenchimento de polígono especificado.
Sintaxe
IsNamedPolygon(PolygonName : String) : Boolean/Boolean_String
À medida que define a expressão Query, é apresentada uma lista pop-up de todos os preenchimentos de polígono existentes, ordenados por nome.
Exemplo de Utilização
IsNamedPolygon('Power3V3')
IsNamedPolygon('Power3V3') = True
IsNamedPolygon('Power3V3') = 'True'
Devolve o objeto de preenchimento de polígono cuja Name propriedade é Power3V3.
Not IsNamedPolygon('Power3V3')
IsNamedPolygon('Power3V3') = False
IsNamedPolygon('Power3V3') = 'False'
Devolve todos os except o objeto de preenchimento de polígono cuja Name propriedade é Power3V3.
Notas
-
Os caracteres de aspas simples (') no início e no fim da cadeia
PolygonNamesão obrigatórios. -
Os objetos primitivos filhos do objeto de preenchimento de polígono devolvido não são devolvidos.
IsxSignal
Resumo
Devolve o objeto xSignal com o nome especificado.
Sintaxe
IsxSignal(Name : String) : Boolean/Boolean_String
À medida que define a expressão Query, é apresentada uma lista pop-up de todos os xSignals existentes, ordenados por nome.
Exemplo de Utilização
IsxSignal('DRAM_A0_PP1')
IsxSignal('DRAM_A0_PP1') = True
IsxSignal('DRAM_A0_PP1') = 'True'
Devolve o xSignal DRAM_A0_PP1.
Not IsxSignal('DRAM_A0_PP1')
IsxSignal('DRAM_A0_PP1') = False
IsxSignal('DRAM_A0_PP1') = 'False'
Devolve todos os objetos except o xSignal DRAM_A0_PP1.
Nota
Os caracteres de aspas simples (') no início e no fim da cadeia Name são obrigatórios.
OnGrid
Resumo
Devolve todos os objetos cujas propriedades X1 e Y1 cumprem a Query.
Sintaxe
OnGrid(X1 : Number,Y1 : Number) : Boolean/Boolean_String
Cada instância de Distance_String é uma cadeia numérica que especifica uma distância no ficheiro PCB (Library). Para ser devolvida, a propriedade X1 de um objeto tem de ser um múltiplo inteiro da primeira distância especificada, e a sua propriedade Y1 tem de ser um múltiplo inteiro da segunda distância especificada.
X1 e Y1 especificam coordenadas no ficheiro PCB (Library). Para ser devolvido, a propriedade X1 de um objeto tem de ser um múltiplo inteiro do primeiro valor especificado, e a sua propriedade Y1 tem de ser um múltiplo inteiro do segundo valor especificado.
Todas as coordenadas são referenciadas à origem absoluta (e não à origem do utilizador nem ao ponto de inserção do componente) e, atualmente, utilizam sempre unidades de mils (1 mil = 0,001 polegada).
Exemplo de Utilização
OnGrid(25,25)
OnGrid(25,25) = True
OnGrid(25,25) = 'True'
Devolve todos os objetos cuja propriedade X1 é um múltiplo inteiro de 25mil e cuja propriedade Y1 é um múltiplo inteiro de 25mil.
OnGrid(5,100)
OnGrid(5,100) = True
OnGrid(5,100) = 'True'
Devolve todos os objetos cuja propriedade X1 é um múltiplo inteiro de 5mil e cuja propriedade Y1 é um múltiplo inteiro de 100mil.
OnLayer
Resumo
Devolve todos os objetos cuja Layer propriedade cumpre a Query.
Sintaxe
OnLayer(Layer : String) : Boolean/Boolean_String
Layer é o nome da camada tal como aparece no separador Layers & Colors do painel View Configuration.
Exemplo de Utilização
OnLayer('Top Layer')
OnLayer('Top Layer') = True
OnLayer('Top Layer') = 'True'
Devolve todos os objetos cuja Layer propriedade é Top Layer.
Not OnLayer('Mechanical 3')
OnLayer('Mechanical 3') = False
OnLayer('Mechanical 3') = 'False'
Devolve todos os objetos except objetos cuja Layer propriedade é a camada Mechanical 3.
Notas
-
Os caracteres de aspas simples (') no início e no fim de
Layersão obrigatórios. -
Note que os objetos colocados na camada
Multi-Layerserão devolvidos pela palavra-chave de queryOnLayerapenas quando esta camada em particular for especificada, ou seja, ao utilizar a queryOnLayer('Multi-Layer'). Os objetos colocados na camadaMulti-Layernão serão devolvidos pela palavra-chave de queryOnLayerquando for especificada outra camada na qual existam as formas desses objetos. Utilize a queryExistsOnLayer(Layer : String)para selecionar objetos (incluindo objetos na camadaMulti-Layer) que tenham formas na camada especificada.
TouchesRoom
Resumo
Devolve objetos que residem total ou parcialmente na região ocupada por qualquer objeto room (regra de restrição de confinamento) cuja Name propriedade cumpre a Query.
Sintaxe
TouchesRoom(RoomName1 : String,RoomName2 : String,...,RoomNamen : String) : Boolean/Boolean_String
À medida que define a expressão Query, é apresentada uma lista pop-up de todos os rooms existentes, ordenados por nome.
Exemplo de Utilização
TouchesRoom('Power')
TouchesRoom('Power') = True
TouchesRoom('Power') = 'True'
Devolve objetos que residem total ou parcialmente na região ocupada por qualquer Room cuja Name propriedade é Power.
TouchesRoom('COUT1','COUT2')
TouchesRoom('COUT1','COUT2') = True
TouchesRoom('COUT1','COUT2') = 'True'
Devolve objetos que residem total ou parcialmente nas regiões ocupadas por quaisquer Rooms cuja Name propriedade seja COUT1 ou COUT2.
TouchesRoom('Monitor','Auxilary','Effects')
TouchesRoom('Monitor','Auxilary','Effects') = True
TouchesRoom('Monitor','Auxilary','Effects') = 'True'
Devolve objetos que residem total ou parcialmente nas regiões ocupadas por quaisquer Rooms cuja Name propriedade seja Monitor, ou Auxilary, ou Effects.
Notas
-
Os caracteres de aspas simples (') no início e no fim de cada cadeia
RoomNamesão obrigatórios. -
Os objetos Net, de coordenadas e de dimensões pai não são devolvidos.
WithinRoom
Resumo
Devolve objetos que residem totalmente na região ocupada por qualquer objeto room (regra de restrição de confinamento) cuja Name propriedade cumpre a Query.
Para que pads e vias sejam devolvidos, os seus pontos centrais têm de estar dentro do(s) room(s) especificado(s).
Sintaxe
WithinRoom(RoomName1 : String,RoomName2 : String,...,RoomNamen : String) : Boolean/Boolean_String
À medida que define a expressão Query, é apresentada uma lista pop-up de todos os rooms existentes, ordenados por nome.
Exemplo de Utilização
WithinRoom('Power')
WithinRoom('Power') = True
WithinRoom('Power') = 'True'
Devolve objetos que residem totalmente na região ocupada por qualquer room cuja Name propriedade é Power.
WithinRoom('COUT1','COUT2')
WithinRoom('COUT1','COUT2') = True
WithinRoom('COUT1','COUT2') = 'True'
Devolve objetos que residem totalmente nas regiões ocupadas por qualquer room cuja Name propriedade seja COUT1 ou COUT2.
WithinRoom('Monitor','Auxilary','Effects')
WithinRoom('Monitor','Auxilary','Effects') = True
WithinRoom('Monitor','Auxilary','Effects') = 'True'
Devolve objetos que residem totalmente nas regiões ocupadas por qualquer room cuja Name propriedade seja Monitor, ou Auxilary, ou Effects.
Notas
-
Os caracteres de aspas simples (') no início e no fim de cada cadeia
RoomNamesão obrigatórios. - Os objetos Net, de coordenadas e de dimensões pai não são devolvidos.