Verificações de associação
Num relance
- Você aprenderá quais palavras-chave de consulta da categoria Membership Checks estão disponíveis no Altium Designer e para que cada uma é usada.
- Você verá a sintaxe correta e exemplos de consultas para selecionar objetos por unidades, camadas, footprints, pads, expansão de máscara e características de vias.
- Você conhecerá observações importantes de uso, incluindo a obrigatoriedade de aspas simples e comportamentos específicos do software que podem afetar os resultados das consultas.

As funções de consulta de PCB Membership Checks mostradas 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 de PCB e de biblioteca de PCB no Altium Designer. Para obter ajuda sobre uma palavra-chave de consulta específica, use as seções recolhíveis a seguir ou selecione (ou clique dentro de) uma palavra-chave no Query Helper ou em um painel Filter e pressione F1 para acessar sua seção imediatamente.
AsMils
Resumo
Para propriedades numéricas de objetos (por exemplo, altura, largura, raio etc.), esta palavra-chave é usada para converter o valor atual — medido nas unidades padrão da área de trabalho — em unidades imperiais — mil —, em que 1 mil = 0,001 polegada. O valor convertido é então comparado ao valor inserido na expressão.
Sintaxe
AsMils(Keyword : Number) : Number
Exemplo de uso
AsMils(ArcRadius) = 250
Retorna todos os objetos de arco cuja propriedade Radius é 250mil.
AsMils(Height) Between 300 And 500
Retorna todos os objetos de componente cuja propriedade Height é maior ou igual a 300mil e menor ou igual a 500mil.
AsMils(PolygonGridSize) >= 10
Retorna todos os objetos de preenchimento poligonal cuja propriedade Grid Size é maior ou igual a 10mil.
AsMils(Width) < 50
Retorna todos os objetos de arco e de trilha cuja propriedade Width é menor que 50mil.
AsMils(TraceLength) = 10
Retorna todos os objetos de arco e de trilha cujo Length é igual a 10mil.
Note - devido a um problema no software, para detectar corretamente o TraceLength usando a palavra-chave AsMils, as unidades da placa devem ser definidas como mils antes de executar a consulta.
AsMM
Resumo
Para propriedades numéricas de objetos (por exemplo, altura, largura, raio etc.), esta palavra-chave é usada para converter o valor atual — medido nas unidades padrão da área de trabalho — em unidades métricas — mm —, em que 1 mm = 0,001 metro. O valor convertido é então comparado ao valor inserido na expressão.
Sintaxe
AsMM(Keyword : Number) : Number
Exemplo de uso
AsMM(ArcRadius) = 6.35
Retorna todos os objetos de arco cuja propriedade Radius é 6.35mm.
AsMM(Height) Between 7.62 And 12.7
Retorna todos os objetos de componente cuja propriedade Height é maior ou igual a 7.62mm e menor ou igual a 12.7mm.
AsMM(PolygonGridSize) >= 0.254
Retorna todos os objetos de preenchimento poligonal cuja propriedade Grid Size é maior ou igual a 0.254mm.
AsMM(Width) < 1.27
Retorna todos os objetos de arco e de trilha cuja propriedade Width é menor que 1.27mm.
AsMM(TraceLength) = 1
Retorna todos os objetos de arco e de trilha cujo Length é igual a 1mm.
Note - devido a um problema no software, para detectar corretamente o TraceLength usando a palavra-chave AsMM, as unidades da placa devem ser definidas como mils antes de executar a consulta.
ComponentInLayerClass
Resumo
Retorna todos os objetos de componente cuja propriedade Layer corresponde a uma camada que pertence à classe de camadas especificada.
Sintaxe
ComponentInLayerClass(ClassName : String) : Boolean/Boolean_String
Ao definir a expressão de consulta, é exibida uma lista pop-up de todas as classes de camadas existentes definidas pelo usuário, ordenadas por nome.
Exemplo de uso
ComponentInLayerClass('TopSide')
ComponentInLayerClass('TopSide') = True
ComponentInLayerClass('TopSide') = 'True'
Retorna todos os objetos de componente cuja propriedade Layer corresponde a uma camada que pertence à classe de camadas TopSide.
Not ComponentInLayerClass('BottomSide')
ComponentInLayerClass('BottomSide') = False
ComponentInLayerClass('BottomSide') = 'False'
Retorna todos os objetos except objetos de componente cuja propriedade Layer corresponde a uma camada que pertence à classe de camadas BottomSide.
Nota
Os caracteres de aspas simples (') no início e no fim da string ClassName são obrigatórios.
ExistsOnLayer
Resumo
Retorna todos os objetos que existem na camada especificada.
Sintaxe
ExistsOnLayer(Layer : String) : Boolean/Boolean_String
Layer é o nome da camada conforme aparece na guia Layers & Colors do painel View Configuration.
Exemplo de uso
ExistsOnLayer('Top Layer')
ExistsOnLayer('Top Layer') = True
ExistsOnLayer('Top Layer') = 'True'
Retorna todos os objetos que existem na Top Layer.
Not ExistsOnLayer('Mechanical 3')
ExistsOnLayer('Mechanical 3') = False
ExistsOnLayer('Mechanical 3') = 'False'
Retorna 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
Retorna todos os objetos de componente cuja propriedade Footprint atende à consulta.
Sintaxe
HasFootprint(Footprint : String) : Boolean/Boolean_String
Exemplo de uso
HasFootprint('SIP?0')
HasFootprint('SIP?0') = True
HasFootprint('SIP?0') = 'True'
Retorna todos os objetos de componente cuja propriedade Footprint começa com SIP e termina com 0, e inclui um outro caractere intermediário. Exemplos de footprints que atendem a esses critérios incluem SIP10, SIP20 e SIPQ0.
HasFootprint('DIP*')
HasFootprint('DIP*') = True
HasFootprint('DIP*') = 'True'
Retorna todos os objetos de componente cuja propriedade Footprint começa com DIP. Exemplos de footprints que atendem a esse critério incluem DIP8, DIP14 e DIP24N.
Not HasFootprint('IDC16')
HasFootprint('IDC16') = False
HasFootprint('IDC16') = 'False'
Retorna todos os objetos except objetos de componente cuja propriedade Footprint é IDC16.
HasFootprint('*2*')
HasFootprint('*2*') = True
HasFootprint('*2*') = 'True'
Retorna todos os objetos de componente cuja propriedade Footprint inclui o caractere 2. Exemplos de footprints que atendem a esse critério incluem 2012, 2N5001, IDC20 e HDR1X2.
Notas
-
Os caracteres de aspas simples (') no início e no fim da string
Footprintsão obrigatórios. - Para cada objeto de componente retornado, seus objetos filhos associados também são retornados.
HasFootprintPad
Resumo
Retorna todos os objetos de pad que são filhos de objetos de componente com o footprint especificado e cuja propriedade Name do pad atende à consulta.
Sintaxe
HasFootprintPad(Footprint : String,Name : String) : Boolean/Boolean_String
Exemplo de uso
Not HasFootprintPad('0805','1')
HasFootprintPad('0805','1') = False
HasFootprintPad('0805','1') = 'False'
Retorna todos os objetos except objetos de pad cuja propriedade Name é 1 e que são objetos filhos de objetos de componente cuja propriedade Footprint é 0805.
HasFootprintPad('SIP?0','1')
HasFootprintPad('SIP?0','1') = True
HasFootprintPad('SIP?0','1') = 'True'
Retorna todos os objetos de pad cuja propriedade Name é 1 e que são objetos filhos de objetos de componente cuja propriedade Footprint começa com SIP, termina com 0 e inclui um outro caractere intermediário. Exemplos de footprints que atendem a esses critérios incluem SIP10, SIP20, SIPQ0.
HasFootprintPad('DB*','MNT')
HasFootprintPad('DB*','MNT') = True
HasFootprintPad('DB*','MNT') = 'True'
Retorna todos os objetos de pad cuja propriedade Name é MNT e que são objetos filhos de objetos de componente cuja propriedade Footprint começa com DB. Exemplos de footprints que atendem a esse critério incluem DB9S, DB15HD, DB25P.
HasFootprintPad('','MN*')
HasFootprintPad('','MN*') = True
HasFootprintPad('','MN*') = 'True'
Retorna todos os objetos de pad cuja propriedade Name começa com MN e que são objetos filhos do objeto de componente any .
Notas
-
Os caracteres de aspas simples (') no início e no fim das strings
FootprinteNamesão obrigatórios. - Os objetos de componente pais não são retornados.
HasMaskExpansionOnLayer
Resumo
Retorna todos os objetos de arco, preenchimento, pad, região, trilha e via que possuem valores de expansão da máscara de pasta (exceto vias) ou de expansão da máscara de solda definidos para a camada especificada. Os valores podem ser definidos manualmente ou obtidos da regra de projeto aplicável.
Sintaxe
HasMaskExpansionOnLayer(Layer : String) : Boolean/Boolean_String
Layer é o nome da camada, conforme aparece na seção Layers aplicável, na aba Layers & Colors do painel Configuração de visualização.
Exemplo de uso
HasMaskExpansionOnLayer('Top Layer')
HasMaskExpansionOnLayer('Top Layer') = True
HasMaskExpansionOnLayer('Top Layer') = 'True'
Retorna todos os objetos de arco, preenchimento, pad, região, trilha e via que possuem valores de expansão da máscara de pasta (exceto vias) ou de expansão da máscara de solda definidos para Top Layer.
Not HasMaskExpansionOnLayer('Bottom Layer')
HasMaskExpansionOnLayer('Bottom Layer') = False
HasMaskExpansionOnLayer('Bottom Layer') = 'False'
Retorna todos os objetos except objetos de arco, preenchimento, pad, região, trilha e via que possuem valores de expansão da máscara de pasta (exceto vias) ou de expansão da máscara de solda definidos para Bottom Layer.
Nota
Os caracteres de aspas simples (') no início e no final de Layer são obrigatórios.
HasPad
Resumo
Retorna todos os objetos de pad cuja propriedade de nome completo atende à consulta.
Sintaxe
HasPad(PadName : String) : Boolean/Boolean_String
A string PadName especifica o nome completo ao qual um pad deve corresponder. Ela consiste em uma substring inicial que especifica a propriedade Name do componente pai do pad (ou seja, o designador do componente), seguida de uma substring que especifica a propriedade Name do próprio pad (ou seja, o designador do pad). Portanto, o formato é 'ParentComponentDesignator-PadDesignator'.
Exemplo de uso
Not HasPad('C14-1')
HasPad('C14-1') = False
HasPad('C14-1') = 'False'
Retorna todos os objetos except o objeto de pad cuja propriedade Name é 1 e que é um objeto filho do objeto de componente cuja propriedade Name é C14.
HasPad('U5-11')
HasPad('U5-11') = True
HasPad('U5-11') = 'True'
Retorna o objeto de pad cuja propriedade Name é 11 e que é um objeto filho do objeto de componente cuja propriedade Name é U5.
HasPad('U*-11')
HasPad('U*-11') = True
HasPad('U*-11') = 'True'
Retorna todos os objetos de pad cuja propriedade Name é 11 e que são objetos filhos de objetos de componente cuja propriedade Name começa com U.
HasPad('*-1*')
HasPad('*-1*') = True
HasPad('*-1*') = 'True'
Retorna todos os objetos de pad cuja propriedade Name começa com 1 e que são objetos filhos de any objeto de componente.
Nota
Os caracteres de aspas simples (') no início e no final da string PadName são obrigatórios.
HasViaFeature
Resumo
Retorna todos os objetos de via cuja propriedade de característica da via atende à consulta.
Sintaxe
HasViaFeature(ViaFeature : String) : Boolean/Boolean_String
A string ViaFeature especifica a característica da via à qual uma via deve corresponder. Ela pode ser uma das seguintes:
-
Capping -
Covering -
Filling -
Plugging -
Tenting
Exemplo de uso
Not HasViaFeature('Capping')
HasViaFeature('Capping') = False
HasViaFeature('Capping') = 'False'
Retorna todos os objetos except o objeto de via cuja propriedade de característica da via é Capping.
HasViaFeature('Covering')
HasViaFeature('Covering') = True
HasViaFeature('Covering') = 'True'
Retorna o objeto de via cuja propriedade de característica da via é Covering.
Nota
Os caracteres de aspas simples (') no início e no final da string ViaFeature são obrigatórios.
HasViaType
Resumo
Retorna todos os objetos de via cuja propriedade de tipo de via atende à consulta.
Sintaxe
HasViaType(ViaType : String) : Boolean/Boolean_String
A string ViaType especifica a propriedade IPC 4761 Via Type à qual uma via deve corresponder. Ela 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 uso
Not HasViaFeature('Capping')
HasViaFeature('Capping') = False
HasViaFeature('Capping') = 'False'
Retorna todos os objetos except o objeto de via cuja propriedade de característica da via é Capping.
HasViaFeature('Covering')
HasViaFeature('Covering') = True
HasViaFeature('Covering') = 'True'
Retorna o objeto de via cuja propriedade de característica da via é Covering.
Nota
Os caracteres de aspas simples (') no início e no final da string ViaFeature são obrigatórios.
InChannelClass
Resumo
Retorna todos os objetos associados a objetos de componente que pertencem à classe de canais de projeto especificada.
Sintaxe
InChannelClass(ClassName1 : String,ClassName2 : String,...,ClassNamen : String) : Boolean/Boolean_String
À medida que você define a expressão de consulta, é exibida uma lista suspensa de todas as classes de canais de projeto existentes definidas pelo usuário, ordenadas por nome.
Exemplo de uso
InChannelClass('Red_LED')
InChannelClass('Red_LED') = True
InChannelClass('Red_LED') = 'True'
Retorna todos os objetos associados a objetos de componente que pertencem à classe de canais de projeto Red_LED.
InChannelClass('Output channel','Input channel')
InChannelClass('Output channel','Input channel') = True
InChannelClass('Output channel','Input channel') = 'True'
Retorna todos os objetos associados a objetos de componente que pertencem às classes de canais de projeto Output channel ou Input channel.
InChannelClass('Input*')
InChannelClass('Input*') = True
InChannelClass('Input*') = 'True'
Retorna todos os objetos associados a objetos de componente que pertencem a qualquer classe de canais de projeto cuja propriedade Name começa com Input.
Notas
-
Os caracteres de aspas simples (') no início e no final de cada string
ClassNamesão obrigatórios. - Os objetos de componente pai também são retornados.
InComponent
Resumo
Retorna todos os objetos de componente cuja propriedade Name atende à consulta.
Sintaxe
InComponent(Name : String) : Boolean/Boolean_String
À medida que você define a expressão de consulta, é exibida uma lista suspensa de todos os componentes existentes, ordenados por nome.
Exemplo de uso
InComponent('U1')
InComponent('U1') = True
InComponent('U1') = 'True'
Retorna todos os objetos de componente cuja propriedade Name é U1.
InComponent('U1', 'U2', 'J1')
InComponent('U1', 'U2', 'J1') = True
InComponent('U1', 'U2', 'J1') = 'True'
Retorna todos os objetos de componente cuja propriedade Name é U1, U2 ou J1.
Not InComponent('IDC16')
InComponent('IDC16') = False
InComponent('IDC16') = 'False'
Retorna todos os objetos except objetos de componente cuja propriedade Name é IDC16.
InComponent('U*')
InComponent('U*') = True
InComponent('U*') = 'True'
Retorna todos os objetos de componente cuja propriedade Name começa com U.
Notas
-
Os caracteres de aspas simples (') no início e no final da string
Namesão obrigatórios. - Para cada objeto de componente retornado, seus objetos filhos associados também são retornados.
InComponentClass
Resumo
Retorna todos os objetos de componente que pertencem à classe de componentes especificada.
Sintaxe
InComponentClass(ClassName : String) : Boolean/Boolean_String
À medida que você define a expressão de consulta, é exibida uma lista suspensa de todas as classes de componentes existentes definidas pelo usuário, ordenadas por nome.
Exemplo de uso
InComponentClass('TopSideSMD')
InComponentClass('TopSideSMD') = True
InComponentClass('TopSideSMD') = 'True'
Retorna todos os objetos de componente que pertencem à classe de componentes TopSideSMD.
Not InComponentClass('BottomSideSMD')
InComponentClass('BottomSideSMD') = False
InComponentClass('BottomSideSMD') = 'False'
Retorna todos os objetos except objetos de componente que pertencem à classe de componentes BottomSideSMD.
Nota
Os caracteres de aspas simples (') no início e no final da string ClassName são obrigatórios.
InDifferentialPair
Resumo
Retorna todos os objetos associados a objetos de par diferencial cuja propriedade Name atende à consulta.
Sintaxe
InDifferentialPair(DifferentialPairName1 : String,DifferentialPair2 : String,...,DifferentialPairn : String) : Boolean/Boolean_String
À medida que você define a expressão de consulta, é exibida uma lista suspensa de todos os pares diferenciais existentes, ordenados por nome.
Exemplo de uso
InDifferentialPair('Red_LED')
InDifferentialPair('Red_LED') = True
InDifferentialPair('Red_LED') = 'True'
Retorna 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'
Retorna todos os objetos associados a objetos de par diferencial cuja propriedade Name é D0 ou D1.
InDifferentialPair('Input*')
InDifferentialPair('Input*') = True
InDifferentialPair('Input*') = 'True'
Retorna todos os objetos associados a objetos de par diferencial cuja propriedade Name começa com Input.
Notas
- Os caracteres de aspas simples (') no início e no final de cada string
DifferentialPairNamesão obrigatórios. - Os objetos de par diferencial pai também são retornados.
InDifferentialPairClass
Resumo
Retorna todos os objetos de par diferencial que pertencem à classe de pares diferenciais especificada.
Sintaxe
InDifferentialPairClass(ClassName : String) : Boolean/Boolean_String
À medida que você define a expressão de consulta, é apresentada uma lista pop-up de todos os pares diferenciais existentes, ordenados por nome.
Exemplos de uso
InDifferentialPairClass('TopSide')
InDifferentialPairClass('TopSide') = True
InDifferentialPairClass('TopSide') = 'True'
Retorna todos os objetos de par diferencial que pertencem à classe de pares diferenciais TopSide.
Not InDifferentialPairClass('BottomSide')
InDifferentialPairClass('BottomSide') = False
InDifferentialPairClass('BottomSide') = 'False'
Retorna todos os objetos except objetos de par diferencial que pertencem à classe de pares diferenciais BottomSide.
Nota
Os caracteres de aspas simples (') no início e no final da string ClassName são obrigatórios.
InDrillLayerPair
Resumo
Retorna todos os objetos de via cuja propriedade Drill Pair corresponde ao par de camadas de furação especificado.
Sintaxe
InDrillLayerPair(LayerPair : String) : Boolean/Boolean_String
Exemplos de uso
InDrillLayerPair('Top Layer - Bottom Layer')
InDrillLayerPair('Top Layer - Bottom Layer') = True
InDrillLayerPair('Top Layer - Bottom Layer') = 'True'
Retorna todos os objetos de 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'
Retorna todos os objetos except objetos de via cuja propriedade Drill Pair corresponde ao par de camadas de furação Top Layer - Signal Layer 1.
Notas
- A propriedade Drill Layer Pair é definida apenas para objetos de via.
-
Os caracteres de aspas simples (') no início e no final da string
LayerPairsão obrigatórios. -
Para selecionar um tipo específico de via, inclua uma verificação adequada do tipo de objeto na consulta:
IsThruVia,IsBlindVia,IsBuriedVia,IsMicroViaouIsSkipVia.
Por exemplo, a consulta:
InDrillLayerPair('Top Layer - Signal Layer 1') AND IsMicroVia
Retorna todos os objetos de via cuja propriedade Drill Pair corresponde ao par de camadas de furaçãoTop Layer - Signal Layer 1E cujo tipo de via éµVia.
InFromTo
Resumo
Retorna todos os objetos associados a um objeto de origem-destino cujas propriedades Net, From Pad e To Pad atendem à consulta.
Embora os objetos de origem-destino sejam retornados no painel PCB List, para visualizá-los na área de trabalho, será necessário aplicar a consulta de filtro após colocar o painel PCB no modo From-To Editor.
Sintaxe
InFromTo('Net_Name (From_Pad : To_Pad)') : Boolean/Boolean_String
À medida que você define a expressão de consulta, é apresentada uma lista pop-up de todos os objetos de origem-destino existentes, ordenados por nome.
Net_Name, From_Pad e To_Pad são strings; os únicos caracteres de aspas simples (') usados são os mostrados acima (imediatamente dentro do par de parênteses mais externo).
Cada uma das strings From_Pad e To_Pad especifica o nome completo ao qual um pad deve corresponder. Esse nome consiste em uma substring inicial que especifica a propriedade Name do componente pai do pad (ou seja, o designador do componente), seguida de uma substring que especifica a propriedade Name do próprio pad (ou seja, o designador do pad). Portanto, o formato é 'ParentComponentDesignator-PadDesignator'.
Exemplos de uso
InFromTo('VDD_XTAL (C13-2 : U1-8)')
InFromTo('VDD_XTAL (C13-2 : U1-8)') = True
InFromTo('VDD_XTAL (C13-2 : U1-8)') = 'True'
Retorna todos os objetos associados a um objeto de origem-destino cuja propriedade Net é VDD_XTAL, cuja propriedade From Pad é C13-2 e cuja propriedade To Pad é U1-8. (Assim, o pad de origem tem a propriedade Name com o valor 2, e seu objeto de componente pai tem a propriedade Name com o valor C13. Da mesma forma, o pad de destino tem a propriedade Name com o valor 8 e seu objeto de componente pai tem a propriedade Name com o valor U1).
Nota
Os objetos de origem-destino pai também são retornados.
InFromToClass
Resumo
Retorna todos os objetos de origem-destino que pertencem à classe de origem-destino especificada.
Sintaxe
InFromToClass(ClassName : String) : Boolean/Boolean_String
À medida que você define a expressão de consulta, é apresentada uma lista pop-up de todas as classes de origem-destino existentes definidas pelo usuário, por nome.
Exemplos de uso
InFromToClass('Bus Terminators')
InFromToClass('Bus Terminators') = True
InFromToClass('Bus Terminators') = 'True'
Retorna todos os objetos de origem-destino que pertencem à classe de origem-destino Bus Terminators.
Not InFromToClass('Bus Terminators')
InFromToClass('Bus Terminators') = False
InFromToClass('Bus Terminators') = 'False'
Retorna todos os objetos except objetos de origem-destino que pertencem à classe de origem-destino Bus Terminators.
Nota
Os caracteres de aspas simples (') no início e no final da string ClassName são obrigatórios.
InLayerClass
Resumo
Retorna todos os objetos cuja propriedade Layer corresponde a uma camada que pertence à classe de camadas especificada.
Sintaxe
InLayerClass(ClassName : String) : Boolean/Boolean_String
À medida que você define a expressão de consulta, é apresentada uma lista pop-up de todas as classes de camadas existentes definidas pelo usuário, ordenadas por nome.
Exemplos de uso
InLayerClass('TopSide')
InLayerClass('TopSide') = True
InLayerClass('TopSide') = 'True'
Retorna todos os objetos cuja propriedade Layer corresponde a uma camada que pertence à classe de camadas TopSide.
Not InLayerClass('BottomSide')
InLayerClass('BottomSide') = False
InLayerClass('BottomSide') = 'False'
Retorna todos os objetos except objetos cuja propriedade Layer corresponde a uma camada que pertence à classe de camadas BottomSide.
Nota
Os caracteres de aspas simples (') no início e no final da string ClassName são obrigatórios.
InLayerStackRegion
Resumo
Retorna todos os objetos cujo ponto de referência está dentro de Board Region com o nome especificado.
Sintaxe
InLayerStackRegion(RegionName1 : String,RegionName2 : String,...,RegionNamen : String) : Boolean/Boolean_String
Exemplos de uso
InLayerStackRegion('Region1')
InLayerStackRegion('Region1') = True
InLayerStackRegion('Region1') = 'True'
Retorna todos os objetos cujo ponto de referência está dentro da região da placa cuja propriedade Name é Region1.
InLayerStackRegion('Region1','Region2')
InLayerStackRegion('Region1','Region2') = True
InLayerStackRegion('Region1','Region2') = 'True'
Retorna todos os objetos cujo ponto de referência está 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'
Retorna todos os objetos except objetos cujo ponto de referência está dentro da região da placa cuja propriedade Name é Region2.
Nota
Os caracteres de aspas simples (') no início e no final da string RegionName são obrigatórios.
InNamedPolygon
Resumo
Retorna todos os objetos primitivos que são filhos do preenchimento poligonal especificado.
Sintaxe
InNamedPolygon(PolygonName : String) : Boolean/Boolean_String
À medida que você define a expressão de consulta, é apresentada uma lista pop-up de todos os preenchimentos poligonais existentes, ordenados por nome.
Exemplos de uso
InNamedPolygon('Power3V3')
InNamedPolygon('Power3V3') = True
InNamedPolygon('Power3V3') = 'True'
Retorna todos os objetos primitivos que são filhos do preenchimento poligonal cuja propriedade Name é Power3V3.
Not InNamedPolygon('Power3V3')
InNamedPolygon('Power3V3') = False
InNamedPolygon('Power3V3') = 'False'
Retorna todos os objetos except objetos primitivos que são filhos do preenchimento poligonal cuja propriedade Name é Power3V3.
Notas
-
Os caracteres de aspas simples (') no início e no final da string
PolygonNamesão obrigatórios. - O objeto de preenchimento poligonal pai também é retornado.
InNamedUnion
Resumo
Retorna 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 por meio do painel PCB no modo Unions . Ao definir a expressão de consulta, é apresentada uma lista pop-up de todas as uniões existentes, ordenadas por nome.
Exemplos de uso
InNamedUnion('Unions')
InNamedUnion('Unions') = True
InNamedUnion('Unions') = 'True'
Retorna todos os objetos (pais e filhos) que fazem parte da união cujo nome é Unions.
Not InNamedUnion('Unions 1')
InNamedUnion('Unions 1') = False
InNamedUnion('Unions 1') = 'False'
Retorna todos os objetos except objetos (pais 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 string UnionName são obrigatórios.
InNet
Resumo
Retorna todos os objetos associados a objetos de net cuja propriedade Name atende à consulta.
Sintaxe
InNet(NetName1 : String,NetName2 : String,...,NetNamen : String) : Boolean/Boolean_String
Ao definir a expressão de consulta, é apresentada uma lista pop-up de todas as nets existentes, ordenadas por nome.
Exemplos de uso
InNet('Red_LED')
InNet('Red_LED') = True
InNet('Red_LED') = 'True'
Retorna todos os objetos associados ao objeto de net cuja propriedade Name é Red_LED.
InNet('D0','D1')
InNet('D0','D1') = True
InNet('D0','D1') = 'True'
Retorna todos os objetos associados a objetos de net cuja propriedade Name é D0 ou D1.
InNet('V*')
InNet('V*') = True
InNet('V*') = 'True'
Retorna todos os objetos associados a objetos de net cuja propriedade Name começa com V.
Notas
-
Os caracteres de aspas simples (') no início e no fim de cada string
NetNamesão obrigatórios. - Os objetos de net pais também são retornados.
InNetClass
Resumo
Retorna todas as nets (e seus objetos associados) que pertencem à classe de nets especificada.
Sintaxe
InNetClass(ClassName : String) : Boolean/Boolean_String
Ao definir a expressão de consulta, é apresentada uma lista pop-up de todas as classes de nets existentes definidas pelo usuário, ordenadas por nome.
Exemplos de uso
InNetClass('Data Bus Nets')
InNetClass('Data Bus Nets') = True
InNetClass('Data Bus Nets') = 'True'
Retorna todas as nets (e seus objetos associados) que pertencem à classe de nets Data Bus Nets.
Not InNetClass('Address Bus Nets')
InNetClass('Address Bus Nets') = False
InNetClass('Address Bus Nets') = 'False'
Retorna todos os objetos except nets (e seus objetos associados) que pertencem à classe de nets Address Bus Nets.
Nota
Os caracteres de aspas simples (') no início e no fim da string ClassName são obrigatórios.
InPadClass
Resumo
Retorna todos os objetos de pad que pertencem à classe de pads especificada.
Sintaxe
InPadClass(ClassName : String) : Boolean/Boolean_String
Ao definir a expressão de consulta, é apresentada uma lista pop-up de todas as classes de pads existentes definidas pelo usuário, ordenadas por nome.
Exemplos de uso
InPadClass('Top Side Probe Pads')
InPadClass('Top Side Probe Pads') = True
InPadClass('Top Side Probe Pads') = 'True'
Retorna todos os objetos de pad que pertencem à classe de pads Top Side Probe Pads.
Not InPadClass('Bottom Side Probe Pads')
InPadClass('Bottom Side Probe Pads') = False
InPadClass('Bottom Side Probe Pads') = 'False'
Retorna todos os objetos except objetos de pad que pertencem à classe de pads Bottom Side Probe Pads.
Nota
Os caracteres de aspas simples (') no início e no fim da string ClassName são obrigatórios.
InPolygonClass
Resumo
Retorna todos os objetos de preenchimento poligonal que pertencem à classe de polígonos especificada.
Sintaxe
InPolygonClass(ClassName : String) : Boolean/Boolean_String
Ao definir a expressão de consulta, é apresentada uma lista pop-up de todas as classes de polígonos existentes definidas pelo usuário, ordenadas por nome.
Exemplos de uso
InPolygonClass('Top Side Polys')
InPolygonClass('Top Side Polys') = True
InPolygonClass('Top Side Polys') = 'True'
Retorna todos os objetos de preenchimento poligonal que pertencem à classe de polígonos Top Side Polys.
Not InPolygonClass('Custom Polys')
InPolygonClass('Custom Polys') = False
InPolygonClass('Custom Polys') = 'False'
Retorna todos os objetos except objetos de preenchimento poligonal que pertencem à classe de polígonos Custom Polys.
Nota
Os caracteres de aspas simples (') no início e no fim da string ClassName são obrigatórios.
InRegion
Resumo
Retorna todos os objetos que se encontram dentro da área especificada pela consulta.
Sintaxe
InRegion(X1 : Number ,Y1 : Number ,X2 : Number ,Y2 : Number) : Boolean/Boolean_String
X1,Y1 e X2,Y2 especificam coordenadas no arquivo de PCB (biblioteca de PCB). 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 referenciadas à origem absoluta (e não à origem do usuário ou ao ponto de inserção do componente) e, atualmente, sempre utilizam unidades em mils (1 mil = 0,001 polegada).
Exemplos de uso
InRegion(12700,4700,13300,5000)
InRegion(12700,4700,13300,5000) = True
InRegion(12700,4700,13300,5000) = 'True'
Retorna 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 referenciadas à origem absoluta.
Notas
- Os objetos pais de componente, coordenada, cota e net não são retornados.
- Esta palavra-chave é um alias da palavra-chave InRegionAbsolute.
InRegionAbsolute
Resumo
Retorna todos os objetos que se encontram dentro da área especificada pela consulta.
Sintaxe
InRegionAbsolute(X1 : Number ,Y1 : Number ,X2 : Number ,Y2 : Number) : Boolean/Boolean_String
X1,Y1 e X2,Y2 especificam coordenadas no arquivo de PCB (biblioteca de PCB). 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 referenciadas à origem absoluta (e não à origem do usuário ou ao ponto de inserção do componente) e, atualmente, sempre utilizam unidades em mils (1 mil = 0,001 polegada).
Exemplos de uso
InRegionAbsolute(12700,4700,13300,5000)
InRegionAbsolute(12700,4700,13300,5000) = True
InRegionAbsolute(12700,4700,13300,5000) = 'True'
Retorna 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 referenciadas à origem absoluta.
Notas
- Os objetos pais de componente, coordenada, cota e net não são retornados.
- Esta palavra-chave é um alias da palavra-chave InRegion.
InRegionRelative
Resumo
Retorna todos os objetos que se encontram dentro da área especificada pela consulta.
Sintaxe
InRegionRelative(X1 : Number ,Y1 : Number ,X2 : Number ,Y2 : Number) : Boolean/Boolean_String
X1,Y1 e X2,Y2 especificam coordenadas no arquivo de PCB (biblioteca de PCB). 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 referenciadas à origem do usuário (arquivos de PCB) ou ao ponto de inserção do componente (arquivos de biblioteca de PCB), em vez da origem absoluta, e, atualmente, sempre utilizam unidades em mils (1 mil = 0,001 polegada).
Exemplos de uso
InRegionRelative(-700,-400,1300,1600)
InRegionRelative(-700,-400,1300,1600) = True
InRegionRelative(-700,-400,1300,1600) = 'True'
Retorna 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 referenciadas à origem do usuário (ou ao ponto de inserção do componente).
Nota
Os objetos pais de componente, coordenada, cota e net não são retornados.
InStructureClass
Resumo
Retorna todos os objetos pais e filhos das classes de componentes e classes de redes que são membros da classe de estrutura especificada.
Sintaxe
InStructureClass(ClassName1 : String,ClassName2 : String,...,ClassNamen : String) : Boolean/Boolean_String
À medida que você define a expressão de consulta, é apresentada uma lista pop-up de todas as classes de estrutura existentes definidas pelo usuário, ordenadas por nome.
Exemplos de uso
InStructureClass('Red_LED')
InStructureClass('Red_LED') = True
InStructureClass('Red_LED') = 'True'
Retorna todos os objetos pais e filhos das classes de componentes e classes de redes que são membros da classe de estrutura Red_LED.
InStructureClass('Output channel','Input channel')
InStructureClass('Output channel','Input channel') = True
InStructureClass('Output channel','Input channel') = 'True'
Retorna todos os objetos pais e filhos das classes de componentes e classes de redes que são membros das classes de estrutura Output channel ou Input channel.
InStructureClass('Input*')
InStructureClass('Input*') = True
InStructureClass('Input*') = 'True'
Retorna todos os objetos pais e filhos das classes de componentes e classes de redes que são membros de qualquer classe de estrutura cuja propriedade Name comece com Input.
Nota
Os caracteres de aspas simples (') no início e no final de cada string ClassName são obrigatórios.
InUnion
Resumo
Retorna todos os objetos (pais e filhos) que fazem parte da união especificada.
Sintaxe
InUnion(Union : Number) : Boolean/Boolean_String
Os números das uniões são atribuídos automaticamente. À medida que você define a expressão de consulta, é apresentada uma lista pop-up de todas as uniões existentes, ordenadas por número.
Exemplos de uso
InUnion(1)
InUnion(1) = True
InUnion(1) = 'True'
Retorna 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'
Retorna todos os objetos except objetos (pais e filhos) que fazem parte da união cujo número atribuído é 4.
InxSignal
Resumo
Retorna todos os objetos associados ao xSignal especificado.
Sintaxe
InxSignal(Name : String) : Boolean/Boolean_String
À medida que você define a expressão de consulta, é apresentada uma lista pop-up de todos os xSignals existentes, ordenados por nome.
Exemplos de uso
InxSignal('DRAM_A0_PP1')
InxSignal('DRAM_A0_PP1') = True
InxSignal('DRAM_A0_PP1') = 'True'
Retorna todos os objetos associados ao xSignal DRAM_A0_PP1.
Not InxSignal('DRAM_A0_PP1')
InxSignal('DRAM_A0_PP1') = False
InxSignal('DRAM_A0_PP1') = 'False'
Retorna todos os objetos except objetos associados ao xSignal DRAM_A0_PP1.
Nota
Os caracteres de aspas simples (') no início e no final da string Name são obrigatórios.
InxSignalClass
Resumo
Retorna todos os objetos xSignal que são membros da classe de xSignals especificada.
Sintaxe
InxSignalClass(ClassName : String) : Boolean/Boolean_String
À medida que você define a expressão de consulta, é apresentada uma lista pop-up de todas as classes de xSignals existentes definidas pelo usuário, ordenadas por nome.
Exemplos de uso
InxSignalClass('PCIE')
InxSignalClass('PCIE') = True
InxSignalClass('PCIE') = 'True'
Retorna todos os objetos xSignal que são membros da classe de xSignals PCIE.
Not InxSignalClass('PCIE')
InxSignalClass('PCIE') = False
InxSignalClass('PCIE') = 'False'
Retorna todos os objetos except objetos xSignal que são membros da classe de xSignals PCIE.
Nota
Os caracteres de aspas simples (') no início e no final da string ClassName são obrigatórios.
IsNamedPolygon
Resumo
Retorna o preenchimento poligonal especificado.
Sintaxe
IsNamedPolygon(PolygonName : String) : Boolean/Boolean_String
À medida que você define a expressão de consulta, é apresentada uma lista pop-up de todos os preenchimentos poligonais existentes, ordenados por nome.
Exemplos de uso
IsNamedPolygon('Power3V3')
IsNamedPolygon('Power3V3') = True
IsNamedPolygon('Power3V3') = 'True'
Retorna o objeto de preenchimento poligonal cuja propriedade Name é Power3V3.
Not IsNamedPolygon('Power3V3')
IsNamedPolygon('Power3V3') = False
IsNamedPolygon('Power3V3') = 'False'
Retorna todos os objetos except o objeto de preenchimento poligonal cuja propriedade Name é Power3V3.
Notas
-
Os caracteres de aspas simples (') no início e no final da string
PolygonNamesão obrigatórios. -
Os objetos primitivos filhos do objeto de preenchimento poligonal retornado não são retornados.
IsxSignal
Resumo
Retorna o objeto xSignal com o nome especificado.
Sintaxe
IsxSignal(Name : String) : Boolean/Boolean_String
À medida que você define a expressão de consulta, é apresentada uma lista pop-up de todos os xSignals existentes, ordenados por nome.
Exemplos de uso
IsxSignal('DRAM_A0_PP1')
IsxSignal('DRAM_A0_PP1') = True
IsxSignal('DRAM_A0_PP1') = 'True'
Retorna o xSignal DRAM_A0_PP1.
Not IsxSignal('DRAM_A0_PP1')
IsxSignal('DRAM_A0_PP1') = False
IsxSignal('DRAM_A0_PP1') = 'False'
Retorna todos os objetos except o xSignal DRAM_A0_PP1.
Nota
Os caracteres de aspas simples (') no início e no final da string Name são obrigatórios.
OnGrid
Resumo
Retorna todos os objetos cujas propriedades X1 e Y1 atendem à consulta.
Sintaxe
OnGrid(X1 : Number,Y1 : Number) : Boolean/Boolean_String
Cada instância de Distance_String é uma string numérica que especifica uma distância no arquivo de PCB (biblioteca). Para ser retornado, a propriedade X1 de um objeto deve ser um múltiplo inteiro da primeira distância especificada, e sua propriedade Y1 deve ser um múltiplo inteiro da segunda distância especificada.
X1 e Y1 especificam coordenadas no arquivo de PCB (biblioteca). Para ser retornado, a propriedade X1 de um objeto deve ser um múltiplo inteiro do primeiro valor especificado, e sua propriedade Y1 deve ser um múltiplo inteiro do segundo valor especificado.
Todas as coordenadas são referenciadas à origem absoluta (e não à origem do usuário ou ao ponto de inserção do componente) e, atualmente, sempre usam unidades de mils (1 mil = 0,001 polegada).
Exemplos de uso
OnGrid(25,25)
OnGrid(25,25) = True
OnGrid(25,25) = 'True'
Retorna 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'
Retorna todos os objetos cuja propriedade X1 é um múltiplo inteiro de 5mil e cuja propriedade Y1 é um múltiplo inteiro de 100mil.
OnLayer
Resumo
Retorna todos os objetos cuja propriedade Layer atende à consulta.
Sintaxe
OnLayer(Layer : String) : Boolean/Boolean_String
Layer é o nome da camada conforme aparece na guia Layers & Colors do painel Configuração de visualização.
Exemplos de uso
OnLayer('Top Layer')
OnLayer('Top Layer') = True
OnLayer('Top Layer') = 'True'
Retorna todos os objetos cuja propriedade Layer é Top Layer.
Not OnLayer('Mechanical 3')
OnLayer('Mechanical 3') = False
OnLayer('Mechanical 3') = 'False'
Retorna todos os objetos except objetos cuja propriedade Layer é a camada Mechanical 3.
Notas
-
Os caracteres de aspas simples (') no início e no final de
Layersão obrigatórios. -
Observe que os objetos posicionados na camada
Multi-Layerserão retornados pela palavra-chave de consultaOnLayersomente ao especificar essa camada em particular, ou seja, ao usar a consultaOnLayer('Multi-Layer'). Os objetos posicionados na camadaMulti-Layernão serão retornados pela palavra-chave de consultaOnLayerao especificar outra camada na qual existam as formas desses objetos. Use a consultaExistsOnLayer(Layer : String)para selecionar objetos (incluindo objetos na camadaMulti-Layer) que tenham formas na camada especificada.
TouchesRoom
Resumo
Retorna objetos que estão total ou parcialmente dentro da região ocupada por qualquer objeto room (regra de restrição de confinamento) cuja propriedade Name atende à consulta.
Sintaxe
TouchesRoom(RoomName1 : String,RoomName2 : String,...,RoomNamen : String) : Boolean/Boolean_String
Ao definir a expressão de consulta, é apresentada uma lista suspensa de todas as rooms existentes, ordenadas por nome.
Exemplos de uso
TouchesRoom('Power')
TouchesRoom('Power') = True
TouchesRoom('Power') = 'True'
Retorna objetos que estão total ou parcialmente dentro da região ocupada por qualquer room cuja propriedade Name é Power.
TouchesRoom('COUT1','COUT2')
TouchesRoom('COUT1','COUT2') = True
TouchesRoom('COUT1','COUT2') = 'True'
Retorna objetos que estão total ou parcialmente dentro das regiões ocupadas por quaisquer rooms cuja propriedade Name é COUT1 ou COUT2.
TouchesRoom('Monitor','Auxilary','Effects')
TouchesRoom('Monitor','Auxilary','Effects') = True
TouchesRoom('Monitor','Auxilary','Effects') = 'True'
Retorna objetos que estão total ou parcialmente dentro das regiões ocupadas por quaisquer rooms cuja propriedade Name é Monitor, Auxilary ou Effects.
Notas
-
Os caracteres de aspas simples (') no início e no final de cada string
RoomNamesão obrigatórios. -
Objetos pai de coordenadas, dimensões e redes não são retornados.
WithinRoom
Resumo
Retorna objetos que estão totalmente dentro da região ocupada por qualquer objeto room (regra de restrição de confinamento) cuja propriedade Name atende à consulta.
Para que pads e vias sejam retornados, seus pontos centrais devem estar dentro das rooms especificadas.
Sintaxe
WithinRoom(RoomName1 : String,RoomName2 : String,...,RoomNamen : String) : Boolean/Boolean_String
Ao definir a expressão de consulta, é apresentada uma lista suspensa de todas as rooms existentes, ordenadas por nome.
Exemplos de uso
WithinRoom('Power')
WithinRoom('Power') = True
WithinRoom('Power') = 'True'
Retorna objetos que estão totalmente dentro da região ocupada por qualquer room cuja propriedade Name é Power.
WithinRoom('COUT1','COUT2')
WithinRoom('COUT1','COUT2') = True
WithinRoom('COUT1','COUT2') = 'True'
Retorna objetos que estão totalmente dentro das regiões ocupadas por qualquer room cuja propriedade Name é COUT1 ou COUT2.
WithinRoom('Monitor','Auxilary','Effects')
WithinRoom('Monitor','Auxilary','Effects') = True
WithinRoom('Monitor','Auxilary','Effects') = 'True'
Retorna objetos que estão totalmente dentro das regiões ocupadas por qualquer room cuja propriedade Name é Monitor, Auxilary ou Effects.
Notas
-
Os caracteres de aspas simples (') no início e no final de cada string
RoomNamesão obrigatórios. - Objetos pai de coordenadas, dimensões e redes não são retornados.