Controlli del tipo di oggetto

Updated: October 08, 2026

A colpo d'occhio

Questo articolo è una guida di riferimento alle parole chiave di query della categoria Object Type Checks disponibili nei documenti PCB e nelle librerie PCB di Altium Designer. Spiega cosa restituisce ciascuna parola chiave, ne mostra la sintassi corretta e include semplici esempi d'uso per identificare rapidamente oggetti come archi, via, pad, quote, punti di retroforatura, corpi 3D ed elementi relativi alle maschere quando si lavora nel Query Helper o nel pannello Filter. Se cerchi un modo rapido per capire quale controllo del tipo di oggetto utilizzare e quale risultato aspettarti, questa pagina offre un riferimento chiaro e pratico per aiutarti a lavorare con maggiore sicurezza. Continua a leggere per trovare la query esatta di cui hai bisogno.

- Un riferimento rapido alle parole chiave di query Object Type Checks, con indicazioni su cosa restituisce ciascuna e sulla relativa sintassi.
- Espressioni di esempio che mostrano come utilizzare ciascuna funzione con condizioni true, false o not.
- Indicazioni per identificare categorie specifiche di oggetti PCB, come fori, maschere, quote, tipi di modelli 3D, via e punti di retroforatura.

Approfondisci con l'IA:

Le funzioni di query PCB Object Type Checks sono mostrate nella finestra di dialogo Query Helper

IsComponentVia
IsComponentVia = True
Restituisce tutti gli oggetti via che sono figli di oggetti componente.

Not IsComponentVia
IsComponentVia = False
Restituisce tutti gli oggetti except oggetti via che sono figli di oggetti componente.

IsConnection

Riepilogo

Restituisce tutte le linee di connessione.

Si noti che le connessioni restituite sono visualizzate nell'area di progettazione, ma nessun oggetto di questo tipo è presente nel pannello PCB List.

Sintassi

IsConnection : Boolean/Boolean_String

Esempio d'uso

IsConnection IsConnection = True IsConnection = 'True'
Restituisce tutte le linee di connessione.

Not IsConnection IsConnection = False IsConnection = 'False'
Restituisce tutti gli oggetti AND linee di connessione. Vengono visualizzati anche i dettagli delle "connessioni", poiché si tratta di oggetti figli (non elencati) degli oggetti net restituiti da questa query.

Not IsConnection And Not IsNet
(IsConnection = False) And (IsNet = False)
Restituisce tutti gli oggetti except gli oggetti net; i dettagli delle "connessioni" non vengono visualizzati perché si tratta di oggetti figli (non elencati) degli oggetti net e questa query non restituisce alcun oggetto net.

IsCoordinate

Riepilogo

Restituisce gli oggetti coordinata.

Sintassi

IsCoordinate : Boolean

Esempio d'uso

IsCoordinate
IsCoordinate = True
Restituisce tutti gli oggetti coordinata.

Not IsCoordinate
IsCoordinate = False
Restituisce tutti gli oggetti except oggetti coordinata.

IsCopperRegion

Riepilogo

Restituisce gli oggetti regione piena, ossia le regioni la cui proprietà Kind non è impostata su Polygon cutout o Board cutout (valori che le renderebbero rispettivamente regioni Polygon Cutout o Board Cutout).

Vengono restituiti anche i riempimenti poligonali con Fill Mode impostato su Solid (Copper Regions).

Sintassi

IsCopperRegion : Boolean

Esempio d'uso

IsCopperRegion
IsCopperRegion = True
Restituisce tutti gli oggetti regione piena.

Not IsCopperRegion
IsCopperRegion = False
Restituisce tutti gli oggetti except oggetti regione piena.

IsCutoutRegion

Riepilogo

Riepilogo

Riepilogo

Restituisce tutti gli oggetti la cui proprietà Object Kind corrisponde al tipo di oggetto specificato.

Sintassi

IsObjectKind(ObjectType : String) : Boolean/Boolean_String

ObjectType specifica il tipo di oggetto e deve essere una delle seguenti stringhe:

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 – le seguenti stringhe vengono utilizzate per selezionare i vari tipi di regola. Il tipo di regola, così come appare nella finestra di dialogo PCB Rules and Constraints Editor, è indicato tra parentesi dopo la stringa:
- 'Acute Angle Rule'(Angolo acuto)
- 'Bare-board Fabrication Test Point Style Rule'(Stile dei punti di test di fabbricazione)
- 'Bare-board Fabrication Test Point Usage Rule'(Utilizzo dei punti di test di fabbricazione)
- 'Board Outline Clearance'(Distanza dal contorno della scheda)
- 'Broken Nets Rule'(Net non sbrogliata)
- 'Clearance Rule'(Distanza di isolamento)
- 'Component Clearance Rule'(Distanza tra i componenti)
- 'Component Rotations Rule'(Orientamenti dei componenti)
- 'Confinement Constraint Rule'(Definizione della room)
- 'Daisy Chain Stub Length Rule'(Lunghezza dello stub della catena daisy chain)
- 'Differential Pairs Rule'(Instradamento delle coppie differenziali)
- 'Fanout Control Rule'(Controllo del fanout)
- 'Flight Time Falling Edge Rule'(Tempo di propagazione - Fronte di discesa)
- 'Flight Time Rising Edge Rule'(Tempo di propagazione - Fronte di salita)
- 'Hole To Hole Clearance Rule'(Distanza tra i fori)
- 'In-circuit Assembly Test Point Style Rule'(Stile dei punti di test di assemblaggio)
- 'In-circuit Assembly Test Point Usage Rule'(Utilizzo dei punti di test di assemblaggio)
- 'Layer Pair Rule'(Coppie di layer)
- 'Matched Lengths Rule'(Lunghezze abbinate)
- 'Max Min Height Rule'(Altezza)
- 'Max Min Hole Size Rule'(Dimensione del foro)
- 'Max Min Impedance Rule'(Impedenza)
- 'Max Min Length Rule'(Lunghezza)
- 'Max Min Width Rule'(Larghezza)
- 'Max Slope Falling Edge Rule'(Pendenza - Fronte di discesa)
- 'Max Slope Rising Edge Rule'(Pendenza - Fronte di salita)
- 'Max Via Stub Length (BackDrilling rule)' (Lunghezza massima dello stub del via (back drilling))
- 'Maximum Via Count Rule'(Numero massimo di via)
- 'Minimum Annular Ring Rule'(Anello anulare minimo)
- 'Minimum Solder Mask Sliver Rule'(Larghezza minima del setto di solder mask)
- 'Modified Polygon'(Poligono modificato)
- 'Net Antennae Rule'(Antenne delle net)
- 'Nets To Ignore Rule'(Net da ignorare)
- 'Overshoot Falling Edge Rule'(Sovraelongazione - Fronte di discesa)
- 'Overshoot Rising Edge Rule'(Sovraelongazione - Fronte di salita)
- 'Parallel Segment Rule'(Segmento parallelo)
- 'Paste Mask Expansion Rule'(Espansione della maschera per pasta saldante)
- 'Permitted Layers Rule'(Layer consentiti)
- 'Polygon Connect Style Rule'(Stile di connessione dei poligoni)
- 'Power Plane Clearance Rule'(Distanza dal piano di alimentazione)
- 'Power Plane Connect Style Rule'(Stile di connessione al piano di alimentazione)
- 'Routing Corner Style Rule'(Angoli di instradamento)
- 'Routing Layers Rule'(Layer di instradamento)
- 'Routing Priority Rule'(Priorità di instradamento)
- 'Routing Topology Rule'(Topologia di instradamento)
- 'Routing Via Style Rule'(Stile dei via di instradamento)
- 'Short Circuit Rule'(Cortocircuito)
- 'Signal Base Value Rule'(Valore di base del segnale)
- 'Signal Stimulus Rule'(Stimolo del segnale)
- 'Signal Top Value Rule'(Valore superiore del segnale)
- 'Silk To Silk Clearance Rule'(Distanza tra elementi serigrafici)
- 'Silk To Solder Mask Clearance Rule'(Distanza tra serigrafia e solder mask)
- 'SMD Entry'(Ingresso SMD)
- 'SMD Neck Down Rule'(Restringimento SMD)
- 'SMD To Corner Rule'(Distanza tra SMD e angolo)
- 'SMD To Plane Rule'(Distanza tra SMD e piano)
- 'Solder Mask Expansion Rule'(Espansione della solder mask)
- 'Supply Nets Rule'(Net di alimentazione)
- 'Unconnected Pin Rule'(Pin non connesso)
- 'Undershoot Falling Edge Rule'(Sottoelongazione - Fronte di discesa)
- 'Undershoot Rising Edge Rule'(Sottoelongazione - Fronte di salita)
- 'Vias Under SMD Rule'(Via sotto gli SMD)
Others – 'Board Region', 'Class', 'Differential Pair', 'Net', 'Violation'.

Esempio di utilizzo

IsObjectKind('Via') IsObjectKind('Via') = True IsObjectKind('Via') = 'True'
Restituisce tutti gli oggetti via.

Not IsObjectKind('Track') IsObjectKind('Track') = False IsObjectKind('Track') = 'False'
Restituisce tutti gli oggetti except oggetti pista.

Note

I caratteri di apice singolo (') all'inizio e alla fine della stringa ObjectType sono obbligatori.

IsPoly
IsPoly = True
Restituisce tutti gli oggetti riempimento poligonale.

Not IsPoly
IsPoly = False
Restituisce tutti gli oggetti except oggetti riempimento poligonale.

Note

Questa funzione è un alias della funzione IsPolygon.
Quando si definisce una regola Electrical Clearance per i riempimenti poligonali, è necessario utilizzare il controllo dell'attributo InPolygon (o InPoly) anziché il controllo del tipo di oggetto IsPolygon (o IsPoly). Questo perché le regole di clearance agiscono sulle primitive (regioni, piste e archi) che compongono il riempimento poligonale o che sono in al suo interno, anziché sul riempimento poligonale come oggetto completo. Una regola di clearance valida per i riempimenti poligonali si applicherebbe tra gli oggetti InPolygon e All altri oggetti.

IsPolygon

Riepilogo

Restituisce gli oggetti riempimento poligonale.

Sintassi

IsPolygon : Boolean

Esempio di utilizzo

IsPolygon
IsPolygon = True
Restituisce tutti gli oggetti riempimento poligonale.

Not IsPolygon
IsPolygon = False
Restituisce tutti gli oggetti except oggetti riempimento poligonale.

Note

Questa funzione è un alias della funzione IsPoly.
Quando si definisce una regola Electrical Clearance per i riempimenti poligonali, è necessario utilizzare il controllo dell'attributo InPolygon (o InPoly) anziché il controllo del tipo di oggetto IsPolygon (o IsPoly). Questo perché le regole di clearance agiscono sulle primitive (regioni, piste e archi) che compongono il riempimento poligonale o che sono in al suo interno, anziché sul riempimento poligonale come oggetto completo. Una regola di clearance valida per i riempimenti poligonali si applicherebbe tra gli oggetti InPolygon e All altri oggetti.

IsRegion

Riepilogo

Restituisce tutti gli oggetti regione, ovvero le regioni solide, le regioni di ritaglio dei poligoni e le regioni di ritaglio della scheda.

Vengono restituiti anche i riempimenti poligonali con Fill Mode impostato su Solid (Copper Regions).

Sintassi

IsRegion : Boolean

Esempio di utilizzo

IsRegion
IsRegion = True
Restituisce tutti gli oggetti regione.

Not IsRegion
IsRegion = False
Restituisce tutti gli oggetti except oggetti regione.

IsRoom

Riepilogo

Restituisce gli oggetti regola di definizione delle room (regola del vincolo di confinamento).

Sintassi

IsRoom : Boolean/Boolean_String

Esempio di utilizzo

IsRoom
IsRoom= True
IsRoom= 'True'
Restituisce tutti gli oggetti regola di definizione delle room.

Not IsRoom
IsRoom= False IsRoom= 'False'
Restituisce tutti gli oggetti except oggetti regola di definizione delle room.

IsRule_ConfinementConstraint
IsRule_ConfinementConstraint= True
IsRule_ConfinementConstraint= 'True'
Restituisce tutti gli oggetti della regola di definizione delle room.

Not IsRule_ConfinementConstraint
IsRule_ConfinementConstraint= False Is Rule_ConfinementConstraint= 'False'
Restituisce tutti gli oggetti except oggetti della regola di definizione delle room.

IsViolation
IsViolation = True
Restituisce tutti gli oggetti violazione.

Not IsViolation
IsViolation = False
Restituisce tutti gli oggetti except oggetti violazione.

Versione stampabile

Localizzato tramite A

Se trovi un problema, seleziona il testo/l’immagine e premi Ctrl + Enter per inviarci il tuo feedback.

Disponibilità delle funzionalità

Le funzionalità a tua disposizione dipendono dalla soluzione Altium di cui disponi: Altium Develop, Altium Agile Teams, Altium Agile Enterprise oppure Altium Designer (con abbonamento attivo).

Se non vedi una funzionalità documentata nel software che stai effettivamente utilizzando, contatta il reparto vendite di Altium per saperne di più.

Documentazione legacy

La documentazione di Altium Designer non è più suddivisa per versione. Se è necessario accedere alla documentazione delle versioni precedenti di Altium Designer, visitare la sezione Documentazione legacy della pagina Altri programmi di installazione.