Verificações de Tipo de Objeto

Updated: October 08, 2026

Num relance

Este artigo é um guia de referência da categoria Object Type Checks (Verificações de tipo de objeto) de palavras-chave de consulta disponíveis em documentos de PCB e de biblioteca de PCB no Altium Designer. Ele explica o que cada palavra-chave retorna, apresenta a sintaxe correta e inclui exemplos simples de uso para que você possa identificar rapidamente objetos como arcos, vias, pads, cotas, locais de back drill, corpos 3D e itens relacionados a máscaras ao trabalhar no Query Helper ou no painel Filter. Se você precisa entender rapidamente qual verificação de tipo de objeto usar e qual resultado esperar, esta página oferece uma referência clara e prática para ajudar você a trabalhar com mais confiança. Continue lendo e encontre a consulta exata de que precisa.

- Uma referência rápida das palavras-chave de consulta da categoria Object Type Checks, incluindo o que cada uma retorna e como deve ser escrita.
- Exemplos de expressões que mostram como usar cada função com condições true, false ou not.
- Ajuda para identificar categorias específicas de objetos de PCB, como furos, máscaras, cotas, tipos de modelos 3D, vias e locais de back drill.

Aprofunde-se com a IA:

As funções de consulta de PCB Object Type Checks são exibidas na caixa de diálogo Query Helper

IsComponentVia
IsComponentVia = True
Retorna todos os objetos de via que são filhos de objetos de componente.

Not IsComponentVia
IsComponentVia = False
Retorna todos os objetos except objetos de via que são filhos de objetos de componente.

IsConnection

Resumo

Retorna todas as linhas de conexão.

Observe que as conexões retornadas são exibidas no espaço de projeto, mas nenhum objeto desse tipo é apresentado no painel PCB List.

Sintaxe

IsConnection : Boolean/Boolean_String

Exemplo de uso

IsConnection IsConnection = True IsConnection = 'True'
Retorna todas as linhas de conexão.

Not IsConnection IsConnection = False IsConnection = 'False'
Retorna todos os objetos AND linhas de conexão. Os detalhes de "conexão" também são exibidos porque são objetos filhos (não listados) dos objetos de rede retornados por esta consulta.

Not IsConnection And Not IsNet
(IsConnection = False) And (IsNet = False)
Retorna todos os objetos except objetos de rede; os detalhes de "conexão" não são exibidos porque são objetos filhos (não listados) de objetos de rede, e nenhum objeto de rede é retornado por esta consulta.

IsCoordinate

Resumo

Retorna objetos de coordenada.

Sintaxe

IsCoordinate : Boolean

Exemplo de uso

IsCoordinate
IsCoordinate = True
Retorna todos os objetos de coordenada.

Not IsCoordinate
IsCoordinate = False
Retorna todos os objetos except objetos de coordenada.

IsCopperRegion

Resumo

Retorna objetos de região sólida, ou seja, regiões cuja propriedade Kind não está definida como Polygon cutout ou Board cutout (o que as tornaria regiões Polygon Cutout ou Board Cutout, respectivamente).

Os preenchimentos de polígono que tiverem Fill Mode definido como Solid (Copper Regions) também serão retornados.

Sintaxe

IsCopperRegion : Boolean

Exemplo de uso

IsCopperRegion
IsCopperRegion = True
Retorna todos os objetos de região sólida.

Not IsCopperRegion
IsCopperRegion = False
Retorna todos os objetos except objetos de região sólida.

IsCutoutRegion

Resumo

Resumo

Resumo

Retorna todos os objetos cuja propriedade Object Kind corresponde ao tipo de objeto especificado.

Sintaxe

IsObjectKind(ObjectType : String) : Boolean/Boolean_String

ObjectType especifica o tipo de objeto e deve ser uma das seguintes strings:

Design Objects – '3D Body', 'Arc', 'Angular Dimension', 'Baseline Dimension', 'Center Dimension', 'Component', 'Coordinate', 'Datum Dimension', 'Design View', 'Drill Table' , 'Embedded Board', 'Fill', 'Layer Stack Table', 'Leader Dimension', 'Linear Diameter Dimension', 'Linear Dimension', 'OLE Object', 'Original Dimension', 'Pad', 'Poly', 'Radial Diameter Dimension', 'Radial Dimension', 'Region', 'Split Plane', 'Text', 'Track', 'Via'.
Design Rules – as seguintes strings são usadas para selecionar os diversos tipos de regra. O tipo de regra, conforme aparece na caixa de diálogo PCB Rules and Constraints Editor, é mostrado entre parênteses após a string:
- 'Acute Angle Rule'(Ângulo agudo)
- 'Bare-board Fabrication Test Point Style Rule'(Estilo de ponto de teste de fabricação)
- 'Bare-board Fabrication Test Point Usage Rule'(Uso de ponto de teste de fabricação)
- 'Board Outline Clearance'(Folga do contorno da placa)
- 'Broken Nets Rule'(Net não roteada)
- 'Clearance Rule'(Folga)
- 'Component Clearance Rule'(Folga entre componentes)
- 'Component Rotations Rule'(Orientações dos componentes)
- 'Confinement Constraint Rule'(Definição de Room)
- 'Daisy Chain Stub Length Rule'(Comprimento da derivação em cadeia)
- 'Differential Pairs Rule'(Roteamento de pares diferenciais)
- 'Fanout Control Rule'(Controle de fanout)
- 'Flight Time Falling Edge Rule'(Tempo de propagação - Borda de descida)
- 'Flight Time Rising Edge Rule'(Tempo de propagação - Borda de subida)
- 'Hole To Hole Clearance Rule'(Folga entre furos)
- 'In-circuit Assembly Test Point Style Rule'(Estilo de ponto de teste de montagem)
- 'In-circuit Assembly Test Point Usage Rule'(Uso de ponto de teste de montagem)
- 'Layer Pair Rule'(Pares de camadas)
- 'Matched Lengths Rule'(Comprimentos casados)
- 'Max Min Height Rule'(Altura)
- 'Max Min Hole Size Rule'(Tamanho do furo)
- 'Max Min Impedance Rule'(Impedância)
- 'Max Min Length Rule'(Comprimento)
- 'Max Min Width Rule'(Largura)
- 'Max Slope Falling Edge Rule'(Inclinação - Borda de descida)
- 'Max Slope Rising Edge Rule'(Inclinação - Borda de subida)
- 'Max Via Stub Length (BackDrilling rule)' (Comprimento máximo do stub de via (Back drilling))
- 'Maximum Via Count Rule'(Número máximo de vias)
- 'Minimum Annular Ring Rule'(Anel anular mínimo)
- 'Minimum Solder Mask Sliver Rule'(Largura mínima da faixa de máscara de solda)
- 'Modified Polygon'(Polígono modificado)
- 'Net Antennae Rule'(Antenas de net)
- 'Nets To Ignore Rule'(Nets a ignorar)
- 'Overshoot Falling Edge Rule'(Sobressinal - Borda de descida)
- 'Overshoot Rising Edge Rule'(Sobressinal - Borda de subida)
- 'Parallel Segment Rule'(Segmento paralelo)
- 'Paste Mask Expansion Rule'(Expansão da máscara de pasta)
- 'Permitted Layers Rule'(Camadas permitidas)
- 'Polygon Connect Style Rule'(Estilo de conexão do polígono)
- 'Power Plane Clearance Rule'(Folga do plano de alimentação)
- 'Power Plane Connect Style Rule'(Estilo de conexão do plano de alimentação)
- 'Routing Corner Style Rule'(Cantos de roteamento)
- 'Routing Layers Rule'(Camadas de roteamento)
- 'Routing Priority Rule'(Prioridade de roteamento)
- 'Routing Topology Rule'(Topologia de roteamento)
- 'Routing Via Style Rule'(Estilo de via de roteamento)
- 'Short Circuit Rule'(Curto-circuito)
- 'Signal Base Value Rule'(Valor de base do sinal)
- 'Signal Stimulus Rule'(Estímulo do sinal)
- 'Signal Top Value Rule'(Valor de topo do sinal)
- 'Silk To Silk Clearance Rule'(Folga entre serigrafias)
- 'Silk To Solder Mask Clearance Rule'(Folga entre serigrafia e máscara de solda)
- 'SMD Entry'(Entrada em SMD)
- 'SMD Neck Down Rule'(Estreitamento em SMD)
- 'SMD To Corner Rule'(Distância de SMD ao canto)
- 'SMD To Plane Rule'(Distância de SMD ao plano)
- 'Solder Mask Expansion Rule'(Expansão da máscara de solda)
- 'Supply Nets Rule'(Nets de alimentação)
- 'Unconnected Pin Rule'(Pino não conectado)
- 'Undershoot Falling Edge Rule'(Subsinal - Borda de descida)
- 'Undershoot Rising Edge Rule'(Subsinal - Borda de subida)
- 'Vias Under SMD Rule'(Vias sob SMD)
Others – 'Board Region', 'Class', 'Differential Pair', 'Net', 'Violation'.

Exemplo de uso

IsObjectKind('Via') IsObjectKind('Via') = True IsObjectKind('Via') = 'True'
Retorna todos os objetos de via.

Not IsObjectKind('Track') IsObjectKind('Track') = False IsObjectKind('Track') = 'False'
Retorna todos os objetos except objetos de trilha.

Notas

Os caracteres de aspas simples (') no início e no final da string ObjectType são obrigatórios.

IsPoly
IsPoly = True
Retorna todos os objetos de preenchimento poligonal.

Not IsPoly
IsPoly = False
Retorna todos os objetos except objetos de preenchimento poligonal.

Notas

Esta função é um alias da função IsPolygon.
Ao definir uma regra de Electrical Clearance para preenchimentos poligonais, você deve usar a verificação de atributo InPolygon (ou InPoly) em vez da verificação de tipo de objeto IsPolygon (ou IsPoly). Isso ocorre porque as regras de afastamento atuam sobre as primitivas (regiões, trilhas e arcos) que compõem ou são in o preenchimento poligonal, e não sobre o preenchimento poligonal como um objeto inteiro. Uma regra de afastamento válida para preenchimentos poligonais seria entre objetos InPolygon e All outros objetos.

IsPolygon

Resumo

Retorna objetos de preenchimento poligonal.

Sintaxe

IsPolygon : Boolean

Exemplo de uso

IsPolygon
IsPolygon = True
Retorna todos os objetos de preenchimento poligonal.

Not IsPolygon
IsPolygon = False
Retorna todos os objetos except objetos de preenchimento poligonal.

Notas

Esta função é um alias da função IsPoly.
Ao definir uma regra de Electrical Clearance para preenchimentos poligonais, você deve usar a verificação de atributo InPolygon (ou InPoly) em vez da verificação de tipo de objeto IsPolygon (ou IsPoly). Isso ocorre porque as regras de afastamento atuam sobre as primitivas (regiões, trilhas e arcos) que compõem ou são in o preenchimento poligonal, e não sobre o preenchimento poligonal como um objeto inteiro. Uma regra de afastamento válida para preenchimentos poligonais seria entre objetos InPolygon e All outros objetos.

IsRegion

Resumo

Retorna todos os objetos de região, ou seja, regiões sólidas, regiões de recorte de polígono e regiões de recorte de placa.

Os preenchimentos poligonais cuja propriedade Fill Mode está definida como Solid (Copper Regions) também serão retornados.

Sintaxe

IsRegion : Boolean

Exemplo de uso

IsRegion
IsRegion = True
Retorna todos os objetos de região.

Not IsRegion
IsRegion = False
Retorna todos os objetos except objetos de região.

IsRoom

Resumo

Retorna objetos de regra de definição de sala (regra de restrição de confinamento).

Sintaxe

IsRoom : Boolean/Boolean_String

Exemplo de uso

IsRoom
IsRoom= True
IsRoom= 'True'
Retorna todos os objetos de regra de definição de sala.

Not IsRoom
IsRoom= False IsRoom= 'False'
Retorna todos os objetos except objetos de regra de definição de sala.

IsRule_ConfinementConstraint
IsRule_ConfinementConstraint= True
IsRule_ConfinementConstraint= 'True'
Retorna todos os objetos da regra de definição de Room.

Not IsRule_ConfinementConstraint
IsRule_ConfinementConstraint= False Is Rule_ConfinementConstraint= 'False'
Retorna todos os objetos except objetos da regra de definição de Room.

IsViolation
IsViolation = True
Retorna todos os objetos de violação.

Not IsViolation
IsViolation = False
Retorna todos os objetos except objetos de violação.

Versão para impressão

Localizado por IA

Caso encontre um problema, selecione o texto/imagem e primaCtrl + Enterpara nos enviar o seu feedback.

Disponibilidade de Recursos

Os recursos disponíveis para você dependem de qual solução Altium você possui – Altium Develop, Altium Agile Teams, Altium Agile Enterprise ou Altium Designer (com assinatura ativa).

Se você não vir um recurso documentado no software que está usando no momento, entre em contato com a equipe de vendas da Altium para saber mais.

Documentação Legada

A documentação do Altium Designer já não é versionada. Se precisar de aceder à documentação de versões anteriores do Altium Designer, visite a secção Documentação Legada da página de Outros Instaladores.