Comprobaciones de pertenencia
De un vistazo
- Aprenderás qué palabras clave de consulta de comprobación de pertenencia están disponibles en Altium Designer y para qué se utiliza cada una.
- Verás la sintaxis correcta y ejemplos de consultas para seleccionar objetos según sus unidades, capas, huellas, pads, expansión de máscara y características de las vías.
- Conocerás indicaciones de uso importantes, como el uso obligatorio de comillas simples y los comportamientos específicos del software que pueden afectar a los resultados de las consultas.

Las funciones de consulta de PCB Membership Checks que se muestran en el cuadro de diálogo Query Helper
Esta página de referencia detalla las palabras clave del lenguaje de consulta de la categoría Membership Checks disponibles en los documentos de PCB y de biblioteca de PCB en Altium Designer. Para obtener ayuda sobre una palabra clave de consulta específica, utilice las siguientes secciones desplegables o resalte cualquier palabra clave (o haga clic dentro de ella) en el Query Helper o en un panel Filter y, a continuación, pulse F1 para acceder inmediatamente a su sección.
AsMils
Resumen
Para las propiedades numéricas de los objetos (p. ej., altura, anchura, radio, etc.), esta palabra clave se utiliza para convertir el valor actual —medido en las unidades predeterminadas del espacio de trabajo— a unidades imperiales — mil, donde 1 mil = 0,001 pulgadas— y, a continuación, compararlo con el valor introducido en la expresión.
Sintaxis
AsMils(Keyword : Number) : Number
Ejemplos de uso
AsMils(ArcRadius) = 250
Devuelve todos los objetos de arco cuya propiedad Radius es 250mil.
AsMils(Height) Between 300 And 500
Devuelve todos los objetos de componente cuya propiedad Height es mayor o igual que 300mil y menor o igual que 500mil.
AsMils(PolygonGridSize) >= 10
Devuelve todos los objetos de vertido de polígono cuya propiedad Grid Size es mayor o igual que 10mil.
AsMils(Width) < 50
Devuelve todos los objetos de arco y de pista cuya propiedad Width es menor que 50mil.
AsMils(TraceLength) = 10
Devuelve todos los objetos de arco y de pista cuyo Length es igual a 10mil.
Note - debido a un problema del software, para detectar correctamente el TraceLength mediante la palabra clave AsMils, las unidades de la placa deben establecerse en mils antes de ejecutar la consulta.
AsMM
Resumen
Para las propiedades numéricas de los objetos (p. ej., altura, anchura, radio, etc.), esta palabra clave se utiliza para convertir el valor actual —medido en las unidades predeterminadas del espacio de trabajo— a unidades métricas — mm, donde 1 mm = 0,001 metros— y, a continuación, compararlo con el valor introducido en la expresión.
Sintaxis
AsMM(Keyword : Number) : Number
Ejemplos de uso
AsMM(ArcRadius) = 6.35
Devuelve todos los objetos de arco cuya propiedad Radius es 6.35mm.
AsMM(Height) Between 7.62 And 12.7
Devuelve todos los objetos de componente cuya propiedad Height es mayor o igual que 7.62mm y menor o igual que 12.7mm.
AsMM(PolygonGridSize) >= 0.254
Devuelve todos los objetos de vertido de polígono cuya propiedad Grid Size es mayor o igual que 0.254mm.
AsMM(Width) < 1.27
Devuelve todos los objetos de arco y de pista cuya propiedad Width es menor que 1.27mm.
AsMM(TraceLength) = 1
Devuelve todos los objetos de arco y de pista cuyo Length es igual a 1mm.
Note - debido a un problema del software, para detectar correctamente el TraceLength mediante la palabra clave AsMM, las unidades de la placa deben establecerse en mils antes de ejecutar la consulta.
ComponentInLayerClass
Resumen
Devuelve todos los objetos de componente cuya propiedad Layer coincide con una capa que pertenece a la clase de capas especificada.
Sintaxis
ComponentInLayerClass(ClassName : String) : Boolean/Boolean_String
Al definir la expresión de consulta, se muestra una lista emergente de todas las clases de capas existentes definidas por el usuario, ordenadas por nombre.
Ejemplos de uso
ComponentInLayerClass('TopSide')
ComponentInLayerClass('TopSide') = True
ComponentInLayerClass('TopSide') = 'True'
Devuelve todos los objetos de componente cuya propiedad Layer coincide con una capa que pertenece a la clase de capas TopSide.
Not ComponentInLayerClass('BottomSide')
ComponentInLayerClass('BottomSide') = False
ComponentInLayerClass('BottomSide') = 'False'
Devuelve todos los objetos except objetos de componente cuya propiedad Layer coincide con una capa que pertenece a la clase de capas BottomSide.
Nota
Los caracteres de comilla simple (') al principio y al final de la cadena ClassName son obligatorios.
ExistsOnLayer
Resumen
Devuelve todos los objetos que existen en la capa especificada.
Sintaxis
ExistsOnLayer(Layer : String) : Boolean/Boolean_String
Layer es el nombre de la capa tal como aparece en la pestaña Layers & Colors del panel Configuración de vista.
Ejemplos de uso
ExistsOnLayer('Top Layer')
ExistsOnLayer('Top Layer') = True
ExistsOnLayer('Top Layer') = 'True'
Devuelve todos los objetos que existen en la Top Layer.
Not ExistsOnLayer('Mechanical 3')
ExistsOnLayer('Mechanical 3') = False
ExistsOnLayer('Mechanical 3') = 'False'
Devuelve todos los objetos except objetos que existen en la capa Mechanical 3.
Nota
Los caracteres de comilla simple (') al principio y al final de Layer son obligatorios.
HasFootprint
Resumen
Devuelve todos los objetos de componente cuya propiedad Footprint cumple la consulta.
Sintaxis
HasFootprint(Footprint : String) : Boolean/Boolean_String
Ejemplos de uso
HasFootprint('SIP?0')
HasFootprint('SIP?0') = True
HasFootprint('SIP?0') = 'True'
Devuelve todos los objetos de componente cuya propiedad Footprint comienza por SIP y termina en 0, e incluye otro carácter intermedio. Algunos ejemplos de huellas que cumplen estos criterios son SIP10, SIP20 y SIPQ0.
HasFootprint('DIP*')
HasFootprint('DIP*') = True
HasFootprint('DIP*') = 'True'
Devuelve todos los objetos de componente cuya propiedad Footprint comienza por DIP. Algunos ejemplos de huellas que cumplen este criterio son DIP8, DIP14 y DIP24N.
Not HasFootprint('IDC16')
HasFootprint('IDC16') = False
HasFootprint('IDC16') = 'False'
Devuelve todos los objetos except objetos de componente cuya propiedad Footprint es IDC16.
HasFootprint('*2*')
HasFootprint('*2*') = True
HasFootprint('*2*') = 'True'
Devuelve todos los objetos de componente cuya propiedad Footprint incluye el carácter 2. Algunos ejemplos de huellas que cumplen este criterio son 2012, 2N5001, IDC20 y HDR1X2.
Notas
-
Los caracteres de comilla simple (') al principio y al final de la cadena
Footprintson obligatorios. - Por cada objeto de componente devuelto, también se devuelven sus objetos secundarios asociados.
HasFootprintPad
Resumen
Devuelve todos los objetos de pad que son objetos secundarios de objetos de componente con la huella especificada y cuya propiedad Name del pad cumple la consulta.
Sintaxis
HasFootprintPad(Footprint : String,Name : String) : Boolean/Boolean_String
Ejemplos de uso
Not HasFootprintPad('0805','1')
HasFootprintPad('0805','1') = False
HasFootprintPad('0805','1') = 'False'
Devuelve todos los objetos except objetos de pad cuya propiedad Name es 1 y que son objetos secundarios de objetos de componente cuya propiedad Footprint es 0805.
HasFootprintPad('SIP?0','1')
HasFootprintPad('SIP?0','1') = True
HasFootprintPad('SIP?0','1') = 'True'
Devuelve todos los objetos de pad cuya propiedad Name es 1 y que son objetos secundarios de objetos de componente cuya propiedad Footprint comienza por SIP, termina en 0 e incluye otro carácter intermedio. Algunos ejemplos de huellas que cumplen estos criterios son SIP10, SIP20 y SIPQ0.
HasFootprintPad('DB*','MNT')
HasFootprintPad('DB*','MNT') = True
HasFootprintPad('DB*','MNT') = 'True'
Devuelve todos los objetos de pad cuya propiedad Name es MNT y que son objetos secundarios de objetos de componente cuya propiedad Footprint comienza por DB. Algunos ejemplos de huellas que cumplen este criterio son DB9S, DB15HD y DB25P.
HasFootprintPad('','MN*')
HasFootprintPad('','MN*') = True
HasFootprintPad('','MN*') = 'True'
Devuelve todos los objetos de pad cuya propiedad Name comienza por MN y que son objetos secundarios de any objeto de componente.
Notas
-
Los caracteres de comilla simple (') al principio y al final de las cadenas
FootprintyNameson obligatorios. - No se devuelven los objetos de componente principales.
HasMaskExpansionOnLayer
Resumen
Devuelve todos los objetos de arco, relleno, pad, región, pista y vía que tienen valores de expansión de la máscara de pasta (excepto las vías) o de expansión de la máscara de soldadura definidos para la capa especificada. Los valores pueden definirse manualmente o tomarse de la regla de diseño aplicable.
Sintaxis
HasMaskExpansionOnLayer(Layer : String) : Boolean/Boolean_String
Layer es el nombre de la capa, tal como aparece en la sección Layers correspondiente, en la pestaña Layers & Colors del panel Configuración de vista.
Ejemplo de uso
HasMaskExpansionOnLayer('Top Layer')
HasMaskExpansionOnLayer('Top Layer') = True
HasMaskExpansionOnLayer('Top Layer') = 'True'
Devuelve todos los objetos de arco, relleno, pad, región, pista y vía que tienen valores de expansión de la máscara de pasta (excepto las vías) o de expansión de la máscara de soldadura definidos para Top Layer.
Not HasMaskExpansionOnLayer('Bottom Layer')
HasMaskExpansionOnLayer('Bottom Layer') = False
HasMaskExpansionOnLayer('Bottom Layer') = 'False'
Devuelve todos los objetos except objetos de arco, relleno, pad, región, pista y vía que tienen valores de expansión de la máscara de pasta (excepto las vías) o de expansión de la máscara de soldadura definidos para Bottom Layer.
Nota
Los caracteres de comilla simple (') al principio y al final de Layer son obligatorios.
HasPad
Resumen
Devuelve todos los objetos de pad cuya propiedad de nombre completo cumple la consulta.
Sintaxis
HasPad(PadName : String) : Boolean/Boolean_String
La cadena PadName especifica el nombre completo con el que debe coincidir un pad. Consta de una subcadena inicial que especifica la propiedad Name del componente padre del pad (es decir, el designador del componente), seguida de una subcadena que especifica la propiedad Name del propio pad (es decir, el designador del pad). Por lo tanto, el formato es 'ParentComponentDesignator-PadDesignator'.
Ejemplo de uso
Not HasPad('C14-1')
HasPad('C14-1') = False
HasPad('C14-1') = 'False'
Devuelve todos los objetos except el objeto de pad cuya propiedad Name es 1 y que es un objeto hijo del objeto de componente cuya propiedad Name es C14.
HasPad('U5-11')
HasPad('U5-11') = True
HasPad('U5-11') = 'True'
Devuelve el objeto de pad cuya propiedad Name es 11 y que es un objeto hijo del objeto de componente cuya propiedad Name es U5.
HasPad('U*-11')
HasPad('U*-11') = True
HasPad('U*-11') = 'True'
Devuelve todos los objetos de pad cuya propiedad Name es 11 y que son objetos hijos de objetos de componente cuya propiedad Name comienza por U.
HasPad('*-1*')
HasPad('*-1*') = True
HasPad('*-1*') = 'True'
Devuelve todos los objetos de pad cuya propiedad Name comienza por 1 y que son objetos hijos de any objeto de componente.
Nota
Los caracteres de comilla simple (') al principio y al final de la cadena PadName son obligatorios.
HasViaFeature
Resumen
Devuelve todos los objetos de vía cuya propiedad de característica de vía cumple la consulta.
Sintaxis
HasViaFeature(ViaFeature : String) : Boolean/Boolean_String
La cadena ViaFeature especifica la característica de vía con la que debe coincidir una vía. Puede ser una de las siguientes:
-
Capping -
Covering -
Filling -
Plugging -
Tenting
Ejemplo de uso
Not HasViaFeature('Capping')
HasViaFeature('Capping') = False
HasViaFeature('Capping') = 'False'
Devuelve todos los objetos except el objeto de vía cuya propiedad de característica de vía es Capping.
HasViaFeature('Covering')
HasViaFeature('Covering') = True
HasViaFeature('Covering') = 'True'
Devuelve el objeto de vía cuya propiedad de característica de vía es Covering.
Nota
Los caracteres de comilla simple (') al principio y al final de la cadena ViaFeature son obligatorios.
HasViaType
Resumen
Devuelve todos los objetos de vía cuya propiedad de tipo de vía cumple la consulta.
Sintaxis
HasViaType(ViaType : String) : Boolean/Boolean_String
La cadena ViaType especifica la propiedad IPC 4761 Via Type con la que debe coincidir una vía. Puede ser una de las siguientes:
-
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
Ejemplo de uso
Not HasViaFeature('Capping')
HasViaFeature('Capping') = False
HasViaFeature('Capping') = 'False'
Devuelve todos los objetos except el objeto de vía cuya propiedad de característica de vía es Capping.
HasViaFeature('Covering')
HasViaFeature('Covering') = True
HasViaFeature('Covering') = 'True'
Devuelve el objeto de vía cuya propiedad de característica de vía es Covering.
Nota
Los caracteres de comilla simple (') al principio y al final de la cadena ViaFeature son obligatorios.
InChannelClass
Resumen
Devuelve todos los objetos asociados a objetos de componente que pertenecen a la clase de canales de diseño especificada.
Sintaxis
InChannelClass(ClassName1 : String,ClassName2 : String,...,ClassNamen : String) : Boolean/Boolean_String
Al definir la expresión de consulta, se muestra una lista emergente de todas las clases de canales de diseño existentes definidas por el usuario, ordenadas por nombre.
Ejemplo de uso
InChannelClass('Red_LED')
InChannelClass('Red_LED') = True
InChannelClass('Red_LED') = 'True'
Devuelve todos los objetos asociados a objetos de componente que pertenecen a la clase de canales de diseño Red_LED.
InChannelClass('Output channel','Input channel')
InChannelClass('Output channel','Input channel') = True
InChannelClass('Output channel','Input channel') = 'True'
Devuelve todos los objetos asociados a objetos de componente que pertenecen a las clases de canales de diseño Output channel o Input channel.
InChannelClass('Input*')
InChannelClass('Input*') = True
InChannelClass('Input*') = 'True'
Devuelve todos los objetos asociados a objetos de componente que pertenecen a cualquier clase de canales de diseño cuya propiedad Name comienza por Input.
Notas
-
Los caracteres de comilla simple (') al principio y al final de cada cadena
ClassNameson obligatorios. - También se devuelven los objetos de componente padre.
InComponent
Resumen
Devuelve todos los objetos de componente cuya propiedad Name cumple la consulta.
Sintaxis
InComponent(Name : String) : Boolean/Boolean_String
Al definir la expresión de consulta, se muestra una lista emergente de todos los componentes existentes, ordenados por nombre.
Ejemplo de uso
InComponent('U1')
InComponent('U1') = True
InComponent('U1') = 'True'
Devuelve todos los objetos de componente cuya propiedad Name es U1.
InComponent('U1', 'U2', 'J1')
InComponent('U1', 'U2', 'J1') = True
InComponent('U1', 'U2', 'J1') = 'True'
Devuelve todos los objetos de componente cuya propiedad Name es U1, U2 o J1.
Not InComponent('IDC16')
InComponent('IDC16') = False
InComponent('IDC16') = 'False'
Devuelve todos los objetos except objetos de componente cuya propiedad Name es IDC16.
InComponent('U*')
InComponent('U*') = True
InComponent('U*') = 'True'
Devuelve todos los objetos de componente cuya propiedad Name comienza por U.
Notas
-
Los caracteres de comilla simple (') al principio y al final de la cadena
Nameson obligatorios. - Por cada objeto de componente devuelto, también se devuelven sus objetos hijos asociados.
InComponentClass
Resumen
Devuelve todos los objetos de componente que pertenecen a la clase de componentes especificada.
Sintaxis
InComponentClass(ClassName : String) : Boolean/Boolean_String
Al definir la expresión de consulta, se muestra una lista emergente de todas las clases de componentes existentes definidas por el usuario, ordenadas por nombre.
Ejemplo de uso
InComponentClass('TopSideSMD')
InComponentClass('TopSideSMD') = True
InComponentClass('TopSideSMD') = 'True'
Devuelve todos los objetos de componente que pertenecen a la clase de componentes TopSideSMD.
Not InComponentClass('BottomSideSMD')
InComponentClass('BottomSideSMD') = False
InComponentClass('BottomSideSMD') = 'False'
Devuelve todos los objetos except objetos de componente que pertenecen a la clase de componentes BottomSideSMD.
Nota
Los caracteres de comilla simple (') al principio y al final de la cadena ClassName son obligatorios.
InDifferentialPair
Resumen
Devuelve todos los objetos asociados a objetos de par diferencial cuya propiedad Name cumple la consulta.
Sintaxis
InDifferentialPair(DifferentialPairName1 : String,DifferentialPair2 : String,...,DifferentialPairn : String) : Boolean/Boolean_String
Al definir la expresión de consulta, se muestra una lista emergente de todos los pares diferenciales existentes, ordenados por nombre.
Ejemplo de uso
InDifferentialPair('Red_LED')
InDifferentialPair('Red_LED') = True
InDifferentialPair('Red_LED') = 'True'
Devuelve todos los objetos asociados al objeto de par diferencial cuya propiedad Name es Red_LED.
InDifferentialPair('D0','D1')
InDifferentialPair('D0','D1') = True
InDifferentialPair('D0','D1') = 'True'
Devuelve todos los objetos asociados a objetos de par diferencial cuya propiedad Name es D0 o D1.
InDifferentialPair('Input*')
InDifferentialPair('Input*') = True
InDifferentialPair('Input*') = 'True'
Devuelve todos los objetos asociados a objetos de par diferencial cuya propiedad Name comienza por Input.
Notas
- Los caracteres de comilla simple (') al principio y al final de cada cadena
DifferentialPairNameson obligatorios. - También se devuelven los objetos de par diferencial padre.
InDifferentialPairClass
Resumen
Devuelve todos los objetos de par diferencial que pertenecen a la clase de pares diferenciales especificada.
Sintaxis
InDifferentialPairClass(ClassName : String) : Boolean/Boolean_String
A medida que define la expresión de consulta, se muestra una lista emergente de todos los pares diferenciales existentes ordenados por nombre.
Ejemplo de uso
InDifferentialPairClass('TopSide')
InDifferentialPairClass('TopSide') = True
InDifferentialPairClass('TopSide') = 'True'
Devuelve todos los objetos de par diferencial que pertenecen a la clase de pares diferenciales TopSide.
Not InDifferentialPairClass('BottomSide')
InDifferentialPairClass('BottomSide') = False
InDifferentialPairClass('BottomSide') = 'False'
Devuelve todos los objetos except objetos de par diferencial que pertenecen a la clase de pares diferenciales BottomSide.
Nota
Los caracteres de comilla simple (') al principio y al final de la cadena ClassName son obligatorios.
InDrillLayerPair
Resumen
Devuelve todos los objetos de vía cuya propiedad Drill Pair coincide con el par de capas de taladrado especificado.
Sintaxis
InDrillLayerPair(LayerPair : String) : Boolean/Boolean_String
Ejemplo de uso
InDrillLayerPair('Top Layer - Bottom Layer')
InDrillLayerPair('Top Layer - Bottom Layer') = True
InDrillLayerPair('Top Layer - Bottom Layer') = 'True'
Devuelve todos los objetos de vía cuya propiedad Drill Pair coincide con el par de capas de taladrado 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'
Devuelve todos los objetos except objetos de vía cuya propiedad Drill Pair coincide con el par de capas de taladrado Top Layer - Signal Layer 1.
Notas
- La propiedad Drill Layer Pair solo está definida para los objetos de vía.
-
Los caracteres de comilla simple (') al principio y al final de la cadena
LayerPairson obligatorios. -
Para seleccionar un tipo específico de vía, incluya una comprobación del tipo de objeto adecuada en la consulta:
IsThruVia,IsBlindVia,IsBuriedVia,IsMicroViaoIsSkipVia.
Por ejemplo, la consulta:
InDrillLayerPair('Top Layer - Signal Layer 1') AND IsMicroVia
Devuelve todos los objetos de vía cuya propiedad Drill Pair coincide con el par de capas de taladradoTop Layer - Signal Layer 1Y cuyo tipo de vía esµVia.
InFromTo
Resumen
Devuelve todos los objetos asociados a un objeto de origen-destino cuyas propiedades Net, From Pad y To Pad cumplen la consulta.
Aunque los objetos de origen-destino se devolverán en el panel PCB List, para verlos en el área de trabajo deberá aplicar la consulta de filtro después de poner el panel PCB en modo From-To Editor.
Sintaxis
InFromTo('Net_Name (From_Pad : To_Pad)') : Boolean/Boolean_String
A medida que define la expresión de consulta, se muestra una lista emergente de todos los objetos de origen-destino existentes ordenados por nombre.
Net_Name, From_Pad y To_Pad son cadenas; los únicos caracteres de comilla simple (') utilizados son los que se muestran arriba (justo dentro del par de paréntesis más externo).
Cada una de las cadenas From_Pad y To_Pad especifica el nombre completo con el que debe coincidir un pad. Este consta de una subcadena inicial que especifica la propiedad Name del componente padre del pad (es decir, el designador del componente), seguida de una subcadena que especifica la propiedad Name del propio pad (es decir, el designador del pad). Por tanto, el formato es 'ParentComponentDesignator-PadDesignator'.
Ejemplo 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'
Devuelve todos los objetos asociados a un objeto de origen-destino cuya propiedad Net es VDD_XTAL, cuya propiedad From Pad es C13-2 y cuya propiedad To Pad es U1-8. (Por tanto, el pad de origen tiene una propiedad Name con el valor 2, y su objeto de componente padre tiene una propiedad Name con el valor C13. Del mismo modo, el pad de destino tiene una propiedad Name con el valor 8 y su objeto de componente padre tiene una propiedad Name con el valor U1).
Nota
También se devuelven los objetos de origen-destino padre.
InFromToClass
Resumen
Devuelve todos los objetos de origen-destino que pertenecen a la clase de origen-destino especificada.
Sintaxis
InFromToClass(ClassName : String) : Boolean/Boolean_String
A medida que define la expresión de consulta, se muestra una lista emergente de todas las clases de origen-destino existentes definidas por el usuario, ordenadas por nombre.
Ejemplo de uso
InFromToClass('Bus Terminators')
InFromToClass('Bus Terminators') = True
InFromToClass('Bus Terminators') = 'True'
Devuelve todos los objetos de origen-destino que pertenecen a la clase de origen-destino Bus Terminators.
Not InFromToClass('Bus Terminators')
InFromToClass('Bus Terminators') = False
InFromToClass('Bus Terminators') = 'False'
Devuelve todos los objetos except objetos de origen-destino que pertenecen a la clase de origen-destino Bus Terminators.
Nota
Los caracteres de comilla simple (') al principio y al final de la cadena ClassName son obligatorios.
InLayerClass
Resumen
Devuelve todos los objetos cuya propiedad Layer coincide con una capa que pertenece a la clase de capas especificada.
Sintaxis
InLayerClass(ClassName : String) : Boolean/Boolean_String
A medida que define la expresión de consulta, se muestra una lista emergente de todas las clases de capas existentes definidas por el usuario, ordenadas por nombre.
Ejemplo de uso
InLayerClass('TopSide')
InLayerClass('TopSide') = True
InLayerClass('TopSide') = 'True'
Devuelve todos los objetos cuya propiedad Layer coincide con una capa que pertenece a la clase de capas TopSide.
Not InLayerClass('BottomSide')
InLayerClass('BottomSide') = False
InLayerClass('BottomSide') = 'False'
Devuelve todos los objetos except objetos cuya propiedad Layer coincide con una capa que pertenece a la clase de capas BottomSide.
Nota
Los caracteres de comilla simple (') al principio y al final de la cadena ClassName son obligatorios.
InLayerStackRegion
Resumen
Devuelve todos los objetos cuyo punto de referencia se encuentra dentro de Board Region con el nombre especificado.
Sintaxis
InLayerStackRegion(RegionName1 : String,RegionName2 : String,...,RegionNamen : String) : Boolean/Boolean_String
Ejemplo de uso
InLayerStackRegion('Region1')
InLayerStackRegion('Region1') = True
InLayerStackRegion('Region1') = 'True'
Devuelve todos los objetos cuyo punto de referencia se encuentra dentro de la región de la placa cuya propiedad Name es Region1.
InLayerStackRegion('Region1','Region2')
InLayerStackRegion('Region1','Region2') = True
InLayerStackRegion('Region1','Region2') = 'True'
Devuelve todos los objetos cuyo punto de referencia se encuentra dentro de la región de la placa cuya propiedad Name es Region1, o de la región de la placa cuya propiedad Name es Region2.
Not InLayerStackRegion('Region2')
InLayerStackRegion('Region2') = False
InLayerStackRegion('Region2') = 'False'
Devuelve todos los objetos except objetos cuyo punto de referencia se encuentra dentro de la región de la placa cuya propiedad Name es Region2.
Nota
Los caracteres de comilla simple (') al principio y al final de la cadena RegionName son obligatorios.
InNamedPolygon
Resumen
Devuelve todos los objetos primitivos que son hijos del relleno poligonal especificado.
Sintaxis
InNamedPolygon(PolygonName : String) : Boolean/Boolean_String
A medida que define la expresión de consulta, se muestra una lista emergente de todos los rellenos poligonales existentes ordenados por nombre.
Ejemplo de uso
InNamedPolygon('Power3V3')
InNamedPolygon('Power3V3') = True
InNamedPolygon('Power3V3') = 'True'
Devuelve todos los objetos primitivos que son hijos del relleno poligonal cuya propiedad Name es Power3V3.
Not InNamedPolygon('Power3V3')
InNamedPolygon('Power3V3') = False
InNamedPolygon('Power3V3') = 'False'
Devuelve todos los objetos except objetos primitivos que son hijos del relleno poligonal cuya propiedad Name es Power3V3.
Notas
-
Los caracteres de comilla simple (') al principio y al final de la cadena
PolygonNameson obligatorios. - También se devuelve el objeto de relleno poligonal padre.
InNamedUnion
Resumen
Devuelve todos los objetos (padre e hijos) que forman parte de la unión especificada.
Sintaxis
InNamedUnion(UnionName : String) : Boolean/Boolean_String
Los nombres de las uniones se asignan automáticamente, pero se pueden cambiar mediante el panel PCB en el modo Unions . A medida que se define la expresión de consulta, se muestra una lista emergente de todas las uniones existentes ordenadas por nombre.
Ejemplos de uso
InNamedUnion('Unions')
InNamedUnion('Unions') = True
InNamedUnion('Unions') = 'True'
Devuelve todos los objetos (padre e hijos) que forman parte de la unión cuyo nombre es Unions.
Not InNamedUnion('Unions 1')
InNamedUnion('Unions 1') = False
InNamedUnion('Unions 1') = 'False'
Devuelve todos los objetos except objetos (padre e hijos) que forman parte de la unión cuyo nombre es Unions 1.
Nota
Los caracteres de comilla simple (') al principio y al final de la cadena UnionName son obligatorios.
InNet
Resumen
Devuelve todos los objetos asociados a objetos de red cuya propiedad Name cumple con la consulta.
Sintaxis
InNet(NetName1 : String,NetName2 : String,...,NetNamen : String) : Boolean/Boolean_String
A medida que se define la expresión de consulta, se muestra una lista emergente de todas las redes existentes ordenadas por nombre.
Ejemplos de uso
InNet('Red_LED')
InNet('Red_LED') = True
InNet('Red_LED') = 'True'
Devuelve todos los objetos asociados al objeto de red cuya propiedad Name es Red_LED.
InNet('D0','D1')
InNet('D0','D1') = True
InNet('D0','D1') = 'True'
Devuelve todos los objetos asociados a objetos de red cuya propiedad Name es D0 o D1.
InNet('V*')
InNet('V*') = True
InNet('V*') = 'True'
Devuelve todos los objetos asociados a objetos de red cuya propiedad Name comienza por V.
Notas
-
Los caracteres de comilla simple (') al principio y al final de cada cadena
NetNameson obligatorios. - También se devuelven los objetos de red padre.
InNetClass
Resumen
Devuelve todas las redes (y sus objetos asociados) que pertenecen a la clase de redes especificada.
Sintaxis
InNetClass(ClassName : String) : Boolean/Boolean_String
A medida que se define la expresión de consulta, se muestra una lista emergente de todas las clases de redes existentes definidas por el usuario, ordenadas por nombre.
Ejemplos de uso
InNetClass('Data Bus Nets')
InNetClass('Data Bus Nets') = True
InNetClass('Data Bus Nets') = 'True'
Devuelve todas las redes (y sus objetos asociados) que pertenecen a la clase de redes Data Bus Nets.
Not InNetClass('Address Bus Nets')
InNetClass('Address Bus Nets') = False
InNetClass('Address Bus Nets') = 'False'
Devuelve todos los objetos except redes (y sus objetos asociados) que pertenecen a la clase de redes Address Bus Nets.
Nota
Los caracteres de comilla simple (') al principio y al final de la cadena ClassName son obligatorios.
InPadClass
Resumen
Devuelve todos los objetos de pad que pertenecen a la clase de pads especificada.
Sintaxis
InPadClass(ClassName : String) : Boolean/Boolean_String
A medida que se define la expresión de consulta, se muestra una lista emergente de todas las clases de pads existentes definidas por el usuario, ordenadas por nombre.
Ejemplos de uso
InPadClass('Top Side Probe Pads')
InPadClass('Top Side Probe Pads') = True
InPadClass('Top Side Probe Pads') = 'True'
Devuelve todos los objetos de pad que pertenecen a la clase de pads Top Side Probe Pads.
Not InPadClass('Bottom Side Probe Pads')
InPadClass('Bottom Side Probe Pads') = False
InPadClass('Bottom Side Probe Pads') = 'False'
Devuelve todos los objetos except objetos de pad que pertenecen a la clase de pads Bottom Side Probe Pads.
Nota
Los caracteres de comilla simple (') al principio y al final de la cadena ClassName son obligatorios.
InPolygonClass
Resumen
Devuelve todos los objetos de relleno poligonal que pertenecen a la clase de polígonos especificada.
Sintaxis
InPolygonClass(ClassName : String) : Boolean/Boolean_String
A medida que se define la expresión de consulta, se muestra una lista emergente de todas las clases de polígonos existentes definidas por el usuario, ordenadas por nombre.
Ejemplos de uso
InPolygonClass('Top Side Polys')
InPolygonClass('Top Side Polys') = True
InPolygonClass('Top Side Polys') = 'True'
Devuelve todos los objetos de relleno poligonal que pertenecen a la clase de polígonos Top Side Polys.
Not InPolygonClass('Custom Polys')
InPolygonClass('Custom Polys') = False
InPolygonClass('Custom Polys') = 'False'
Devuelve todos los objetos except objetos de relleno poligonal que pertenecen a la clase de polígonos Custom Polys.
Nota
Los caracteres de comilla simple (') al principio y al final de la cadena ClassName son obligatorios.
InRegion
Resumen
Devuelve todos los objetos que se encuentran dentro del área especificada por la consulta.
Sintaxis
InRegion(X1 : Number ,Y1 : Number ,X2 : Number ,Y2 : Number) : Boolean/Boolean_String
X1,Y1 y X2,Y2 especifican las coordenadas en el archivo de PCB (o de biblioteca de PCB). Los límites izquierdo y derecho de la región se especifican mediante los parámetros X1 y X2, mientras que los límites inferior y superior se especifican mediante los parámetros Y1 y Y2.
Todas las coordenadas están referidas al origen absoluto (y no al origen del usuario ni al punto de inserción del componente) y, actualmente, siempre se expresan en mils (1 mil = 0,001 pulgadas).
Ejemplos de uso
InRegion(12700,4700,13300,5000)
InRegion(12700,4700,13300,5000) = True
InRegion(12700,4700,13300,5000) = 'True'
Devuelve los objetos que se encuentran dentro de la región rectangular delimitada por X1 = 12700 y X2 = 13300, y por Y1 = 4700 e Y2 = 5000; estas coordenadas están referidas al origen absoluto.
Notas
- No se devuelven los objetos padre de componente, coordenada, cota y red.
- Esta palabra clave es un alias de la palabra clave InRegionAbsolute.
InRegionAbsolute
Resumen
Devuelve todos los objetos que se encuentran dentro del área especificada por la consulta.
Sintaxis
InRegionAbsolute(X1 : Number ,Y1 : Number ,X2 : Number ,Y2 : Number) : Boolean/Boolean_String
X1,Y1 y X2,Y2 especifican las coordenadas en el archivo de PCB (o de biblioteca de PCB). Los límites izquierdo y derecho de la región se especifican mediante los parámetros X1 y X2, mientras que los límites inferior y superior se especifican mediante los parámetros Y1 y Y2.
Todas las coordenadas están referidas al origen absoluto (y no al origen del usuario ni al punto de inserción del componente) y, actualmente, siempre se expresan en mils (1 mil = 0,001 pulgadas).
Ejemplos de uso
InRegionAbsolute(12700,4700,13300,5000)
InRegionAbsolute(12700,4700,13300,5000) = True
InRegionAbsolute(12700,4700,13300,5000) = 'True'
Devuelve los objetos que se encuentran dentro de la región rectangular delimitada por X1 = 12700 y X2 = 13300, y por Y1 = 4700 e Y2 = 5000; estas coordenadas están referidas al origen absoluto.
Notas
- No se devuelven los objetos padre de componente, coordenada, cota y red.
- Esta palabra clave es un alias de la palabra clave InRegion.
InRegionRelative
Resumen
Devuelve todos los objetos que se encuentran dentro del área especificada por la consulta.
Sintaxis
InRegionRelative(X1 : Number ,Y1 : Number ,X2 : Number ,Y2 : Number) : Boolean/Boolean_String
X1,Y1 y X2,Y2 especifican las coordenadas en el archivo de PCB (o de biblioteca de PCB). Los límites izquierdo y derecho de la región se especifican mediante los parámetros X1 y X2, mientras que los límites inferior y superior se especifican mediante los parámetros Y1 y Y2.
Todas las coordenadas están referidas al origen del usuario (archivos de PCB) o al punto de inserción del componente (archivos de biblioteca de PCB), en lugar de al origen absoluto y, actualmente, siempre se expresan en mils (1 mil = 0,001 pulgadas).
Ejemplos de uso
InRegionRelative(-700,-400,1300,1600)
InRegionRelative(-700,-400,1300,1600) = True
InRegionRelative(-700,-400,1300,1600) = 'True'
Devuelve los objetos que se encuentran dentro de la región rectangular delimitada por X1 = -700 y X2 = 1300, y por Y1 = -400 e Y2 = 1600; estas coordenadas están referidas al origen del usuario (o al punto de inserción del componente).
Nota
No se devuelven los objetos padre de componente, coordenada, cota y red.
InStructureClass
Resumen
Devuelve todos los objetos padre e hijo de las clases de componentes y de redes que pertenecen a la clase de estructura especificada.
Sintaxis
InStructureClass(ClassName1 : String,ClassName2 : String,...,ClassNamen : String) : Boolean/Boolean_String
Al definir la expresión de consulta, se muestra una lista emergente de todas las clases de estructura definidas por el usuario existentes, ordenadas por nombre.
Ejemplos de uso
InStructureClass('Red_LED')
InStructureClass('Red_LED') = True
InStructureClass('Red_LED') = 'True'
Devuelve todos los objetos padre e hijo de las clases de componentes y de redes que pertenecen a la clase de estructura Red_LED.
InStructureClass('Output channel','Input channel')
InStructureClass('Output channel','Input channel') = True
InStructureClass('Output channel','Input channel') = 'True'
Devuelve todos los objetos padre e hijo de las clases de componentes y de redes que pertenecen a las clases de estructura Output channel o Input channel.
InStructureClass('Input*')
InStructureClass('Input*') = True
InStructureClass('Input*') = 'True'
Devuelve todos los objetos padre e hijo de las clases de componentes y de redes que pertenecen a cualquier clase de estructura cuya propiedad Name comience por Input.
Nota
Las comillas simples (') al principio y al final de cada cadena ClassName son obligatorias.
InUnion
Resumen
Devuelve todos los objetos (padre e hijos) que forman parte de la unión especificada.
Sintaxis
InUnion(Union : Number) : Boolean/Boolean_String
Los números de unión se asignan automáticamente. Al definir la expresión de consulta, se muestra una lista emergente de todas las uniones existentes, ordenadas por número.
Ejemplos de uso
InUnion(1)
InUnion(1) = True
InUnion(1) = 'True'
Devuelve todos los objetos (padre e hijos) que forman parte de la unión cuyo número asignado es 1.
Not InUnion(4)
InUnion(4) = False
InUnion(4) = 'False'
Devuelve todos los objetos except objetos (padre e hijos) que forman parte de la unión cuyo número asignado es 4.
InxSignal
Resumen
Devuelve todos los objetos asociados a la xSignal especificada.
Sintaxis
InxSignal(Name : String) : Boolean/Boolean_String
Al definir la expresión de consulta, se muestra una lista emergente de todas las xSignals existentes, ordenadas por nombre.
Ejemplos de uso
InxSignal('DRAM_A0_PP1')
InxSignal('DRAM_A0_PP1') = True
InxSignal('DRAM_A0_PP1') = 'True'
Devuelve todos los objetos asociados a la xSignal DRAM_A0_PP1.
Not InxSignal('DRAM_A0_PP1')
InxSignal('DRAM_A0_PP1') = False
InxSignal('DRAM_A0_PP1') = 'False'
Devuelve todos los objetos except objetos asociados a la xSignal DRAM_A0_PP1.
Nota
Las comillas simples (') al principio y al final de la cadena Name son obligatorias.
InxSignalClass
Resumen
Devuelve todos los objetos xSignal que pertenecen a la clase de xSignals especificada.
Sintaxis
InxSignalClass(ClassName : String) : Boolean/Boolean_String
Al definir la expresión de consulta, se muestra una lista emergente de todas las clases de xSignals definidas por el usuario existentes, ordenadas por nombre.
Ejemplos de uso
InxSignalClass('PCIE')
InxSignalClass('PCIE') = True
InxSignalClass('PCIE') = 'True'
Devuelve todos los objetos xSignal que pertenecen a la clase de xSignals PCIE.
Not InxSignalClass('PCIE')
InxSignalClass('PCIE') = False
InxSignalClass('PCIE') = 'False'
Devuelve todos los objetos except objetos xSignal que pertenecen a la clase de xSignals PCIE.
Nota
Las comillas simples (') al principio y al final de la cadena ClassName son obligatorias.
IsNamedPolygon
Resumen
Devuelve el relleno poligonal especificado.
Sintaxis
IsNamedPolygon(PolygonName : String) : Boolean/Boolean_String
Al definir la expresión de consulta, se muestra una lista emergente de todos los rellenos poligonales existentes, ordenados por nombre.
Ejemplos de uso
IsNamedPolygon('Power3V3')
IsNamedPolygon('Power3V3') = True
IsNamedPolygon('Power3V3') = 'True'
Devuelve el objeto de relleno poligonal cuya propiedad Name es Power3V3.
Not IsNamedPolygon('Power3V3')
IsNamedPolygon('Power3V3') = False
IsNamedPolygon('Power3V3') = 'False'
Devuelve todos los objetos except el objeto de relleno poligonal cuya propiedad Name es Power3V3.
Notas
-
Las comillas simples (') al principio y al final de la cadena
PolygonNameson obligatorias. -
No se devuelven los objetos primitivos hijos del objeto de relleno poligonal devuelto.
IsxSignal
Resumen
Devuelve el objeto xSignal con el nombre especificado.
Sintaxis
IsxSignal(Name : String) : Boolean/Boolean_String
Al definir la expresión de consulta, se muestra una lista emergente de todas las xSignals existentes, ordenadas por nombre.
Ejemplos de uso
IsxSignal('DRAM_A0_PP1')
IsxSignal('DRAM_A0_PP1') = True
IsxSignal('DRAM_A0_PP1') = 'True'
Devuelve la xSignal DRAM_A0_PP1.
Not IsxSignal('DRAM_A0_PP1')
IsxSignal('DRAM_A0_PP1') = False
IsxSignal('DRAM_A0_PP1') = 'False'
Devuelve todos los objetos except la xSignal DRAM_A0_PP1.
Nota
Las comillas simples (') al principio y al final de la cadena Name son obligatorias.
OnGrid
Resumen
Devuelve todos los objetos cuyas propiedades X1 y Y1 cumplen la consulta.
Sintaxis
OnGrid(X1 : Number,Y1 : Number) : Boolean/Boolean_String
Cada instancia de Distance_String es una cadena numérica que especifica una distancia en el archivo de PCB (biblioteca). Para que se devuelva un objeto, su propiedad X1 debe ser un múltiplo entero de la primera distancia especificada y su propiedad Y1 debe ser un múltiplo entero de la segunda distancia especificada.
X1 y Y1 especifican coordenadas en el archivo de PCB (biblioteca). Para que se devuelva un objeto, su propiedad X1 debe ser un múltiplo entero del primer valor especificado y su propiedad Y1 debe ser un múltiplo entero del segundo valor especificado.
Todas las coordenadas se refieren al origen absoluto (y no al origen del usuario ni al punto de inserción del componente) y, actualmente, siempre utilizan unidades de mils (1 mil = 0,001 pulgadas).
Ejemplos de uso
OnGrid(25,25)
OnGrid(25,25) = True
OnGrid(25,25) = 'True'
Devuelve todos los objetos cuya propiedad X1 es un múltiplo entero de 25mil y cuya propiedad Y1 es un múltiplo entero de 25mil.
OnGrid(5,100)
OnGrid(5,100) = True
OnGrid(5,100) = 'True'
Devuelve todos los objetos cuya propiedad X1 es un múltiplo entero de 5mil y cuya propiedad Y1 es un múltiplo entero de 100mil.
OnLayer
Resumen
Devuelve todos los objetos cuya propiedad Layer cumple la consulta.
Sintaxis
OnLayer(Layer : String) : Boolean/Boolean_String
Layer es el nombre de la capa tal como aparece en la pestaña Layers & Colors del panel Configuración de vista.
Ejemplos de uso
OnLayer('Top Layer')
OnLayer('Top Layer') = True
OnLayer('Top Layer') = 'True'
Devuelve todos los objetos cuya propiedad Layer es Top Layer.
Not OnLayer('Mechanical 3')
OnLayer('Mechanical 3') = False
OnLayer('Mechanical 3') = 'False'
Devuelve todos los objetos except objetos cuya propiedad Layer es la capa Mechanical 3.
Notas
-
Las comillas simples (') al principio y al final de
Layerson obligatorias. -
Tenga en cuenta que la palabra clave de consulta
OnLayersolo devolverá los objetos colocados en la capaMulti-Layercuando se especifique esta capa en particular, es decir, al utilizar la consultaOnLayer('Multi-Layer'). La palabra clave de consultaOnLayerno devolverá los objetos colocados en la capaMulti-Layercuando se especifique otra capa en la que existan formas de estos objetos. Utilice la consultaExistsOnLayer(Layer : String)para seleccionar los objetos (incluidos los de la capaMulti-Layer) que tengan formas en la capa especificada.
TouchesRoom
Resumen
Devuelve los objetos que se encuentran total o parcialmente dentro de la región ocupada por cualquier objeto de tipo room (regla de restricción de confinamiento) cuya propiedad Name cumpla con la consulta.
Sintaxis
TouchesRoom(RoomName1 : String,RoomName2 : String,...,RoomNamen : String) : Boolean/Boolean_String
Al definir la expresión de consulta, se muestra una lista desplegable de todos los rooms existentes ordenados por nombre.
Ejemplos de uso
TouchesRoom('Power')
TouchesRoom('Power') = True
TouchesRoom('Power') = 'True'
Devuelve los objetos que se encuentran total o parcialmente dentro de la región ocupada por cualquier room cuya propiedad Name sea Power.
TouchesRoom('COUT1','COUT2')
TouchesRoom('COUT1','COUT2') = True
TouchesRoom('COUT1','COUT2') = 'True'
Devuelve los objetos que se encuentran total o parcialmente dentro de las regiones ocupadas por cualquier room cuya propiedad Name sea COUT1 o COUT2.
TouchesRoom('Monitor','Auxilary','Effects')
TouchesRoom('Monitor','Auxilary','Effects') = True
TouchesRoom('Monitor','Auxilary','Effects') = 'True'
Devuelve los objetos que se encuentran total o parcialmente dentro de las regiones ocupadas por cualquier room cuya propiedad Name sea Monitor, Auxilary o Effects.
Notas
-
Los caracteres de comilla simple (') al principio y al final de cada cadena
RoomNameson obligatorios. -
No se devuelven los objetos de coordenadas de origen, cotas ni redes.
WithinRoom
Resumen
Devuelve los objetos que se encuentran completamente dentro de la región ocupada por cualquier objeto de tipo room (regla de restricción de confinamiento) cuya propiedad Name cumpla con la consulta.
Para que se devuelvan los pads y las vías, sus puntos centrales deben encontrarse dentro de los rooms especificados.
Sintaxis
WithinRoom(RoomName1 : String,RoomName2 : String,...,RoomNamen : String) : Boolean/Boolean_String
Al definir la expresión de consulta, se muestra una lista desplegable de todos los rooms existentes ordenados por nombre.
Ejemplos de uso
WithinRoom('Power')
WithinRoom('Power') = True
WithinRoom('Power') = 'True'
Devuelve los objetos que se encuentran completamente dentro de la región ocupada por cualquier room cuya propiedad Name sea Power.
WithinRoom('COUT1','COUT2')
WithinRoom('COUT1','COUT2') = True
WithinRoom('COUT1','COUT2') = 'True'
Devuelve los objetos que se encuentran completamente dentro de las regiones ocupadas por cualquier room cuya propiedad Name sea COUT1 o COUT2.
WithinRoom('Monitor','Auxilary','Effects')
WithinRoom('Monitor','Auxilary','Effects') = True
WithinRoom('Monitor','Auxilary','Effects') = 'True'
Devuelve los objetos que se encuentran completamente dentro de las regiones ocupadas por cualquier room cuya propiedad Name sea Monitor, Auxilary o Effects.
Notas
-
Los caracteres de comilla simple (') al principio y al final de cada cadena
RoomNameson obligatorios. - No se devuelven los objetos de coordenadas de origen, cotas ni redes.