メンバーシップチェック
概略
- Altium Designerで使用できるMembership Checksクエリキーワードの種類と、それぞれの用途を学べます。
- 単位、レイヤー、フットプリント、パッド、マスク拡張、ビアのフィーチャーを条件にオブジェクトを選択するための正しい構文とクエリ例を確認できます。
- 必須のシングルクォートや、クエリ結果に影響するソフトウェア固有の動作など、使用上の重要な注意点を把握できます。

Query Helper ダイアログに表示される Membership Checks PCBクエリ関数
このリファレンスページでは、Altium DesignerのPCBドキュメントおよびPCBライブラリドキュメントで使用できる Membership Checks カテゴリのクエリ言語キーワードについて詳しく説明します。特定のクエリキーワードのヘルプを参照するには、以下の折りたたみセクションを使用するか、Query Helper または Filter パネルでキーワードを選択(またはキーワード内をクリック)してから、F1 を押すと、該当するセクションに直接アクセスできます。
AsMils
概要
オブジェクトの数値プロパティ(高さ、幅、半径など)に対して、このキーワードは、デフォルトのワークスペース単位で測定された現在の値をヤード・ポンド法の単位であるmil(1 mil = 0.001インチ)に変換し、その結果を式に入力された値と比較します。
構文
AsMils(Keyword : Number) : Number
使用例
AsMils(ArcRadius) = 250
Radius プロパティが 250mil であるすべての円弧オブジェクトを返します。
AsMils(Height) Between 300 And 500
Height プロパティが 300mil 以上、かつ 500mil 以下であるすべてのコンポーネントオブジェクトを返します。
AsMils(PolygonGridSize) >= 10
Grid Size プロパティが 10mil 以上であるすべてのポリゴンポアオブジェクトを返します。
AsMils(Width) < 50
Width プロパティが 50mil 未満であるすべての円弧およびトラックオブジェクトを返します。
AsMils(TraceLength) = 10
Length が 10mil と等しいすべての円弧およびトラックオブジェクトを返します。
Note - ソフトウェアの問題により、AsMils キーワードを使用して TraceLength を正しく検出するには、クエリを実行する前に基板の単位をmilに設定する必要があります。
AsMM
概要
オブジェクトの数値プロパティ(高さ、幅、半径など)に対して、このキーワードは、デフォルトのワークスペース単位で測定された現在の値をメートル法の単位であるmm(1 mm = 0.001メートル)に変換し、その結果を式に入力された値と比較します。
構文
AsMM(Keyword : Number) : Number
使用例
AsMM(ArcRadius) = 6.35
Radius プロパティが 6.35mm であるすべての円弧オブジェクトを返します。
AsMM(Height) Between 7.62 And 12.7
Height プロパティが 7.62mm 以上、かつ 12.7mm 以下であるすべてのコンポーネントオブジェクトを返します。
AsMM(PolygonGridSize) >= 0.254
Grid Size プロパティが 0.254mm 以上であるすべてのポリゴンポアオブジェクトを返します。
AsMM(Width) < 1.27
Width プロパティが 1.27mm 未満であるすべての円弧およびトラックオブジェクトを返します。
AsMM(TraceLength) = 1
Length が 1mm と等しいすべての円弧およびトラックオブジェクトを返します。
Note - ソフトウェアの問題により、AsMM キーワードを使用して TraceLength を正しく検出するには、クエリを実行する前に基板の単位をmilに設定する必要があります。
ComponentInLayerClass
概要
Layer プロパティが、指定したレイヤークラスに属するレイヤーと一致するすべてのコンポーネントオブジェクトを返します。
構文
ComponentInLayerClass(ClassName : String) : Boolean/Boolean_String
クエリ式を定義すると、既存のすべてのユーザー定義レイヤークラスが、名前順に並べられたポップアップリストに表示されます。
使用例
ComponentInLayerClass('TopSide')
ComponentInLayerClass('TopSide') = True
ComponentInLayerClass('TopSide') = 'True'
Layer プロパティが、TopSide レイヤークラスに属するレイヤーと一致するすべてのコンポーネントオブジェクトを返します。
Not ComponentInLayerClass('BottomSide')
ComponentInLayerClass('BottomSide') = False
ComponentInLayerClass('BottomSide') = 'False'
Layer プロパティが BottomSide レイヤークラスに属するレイヤーと一致するコンポーネントオブジェクトexcept すべてのオブジェクトを返します。
注記
ClassName 文字列の先頭と末尾には、一重引用符(')が必要です。
ExistsOnLayer
概要
指定したレイヤー上に存在するすべてのオブジェクトを返します。
構文
ExistsOnLayer(Layer : String) : Boolean/Boolean_String
Layer は、View Configurationパネルの Layers & Colors タブに表示されるレイヤー名です。
使用例
ExistsOnLayer('Top Layer')
ExistsOnLayer('Top Layer') = True
ExistsOnLayer('Top Layer') = 'True'
Top Layer.
Not ExistsOnLayer('Mechanical 3')
ExistsOnLayer('Mechanical 3') = False
ExistsOnLayer('Mechanical 3') = 'False'
上に存在するすべてのオブジェクトを返します。
Mechanical 3 レイヤー上に存在するオブジェクトexceptすべてのオブジェクトを返します。
注記
Layer の先頭と末尾には、一重引用符(')が必要です。
HasFootprint
概要
Footprint プロパティがクエリの条件を満たすすべてのコンポーネントオブジェクトを返します。
構文
HasFootprint(Footprint : String) : Boolean/Boolean_String
使用例
HasFootprint('SIP?0')
HasFootprint('SIP?0') = True
HasFootprint('SIP?0') = 'True'
Footprint プロパティが SIP で始まり、0 で終わり、その間に任意の1文字を含むすべてのコンポーネントオブジェクトを返します。条件を満たすフットプリントの例として、SIP10、SIP20、SIPQ0 があります。
HasFootprint('DIP*')
HasFootprint('DIP*') = True
HasFootprint('DIP*') = 'True'
Footprint プロパティが DIP で始まるすべてのコンポーネントオブジェクトを返します。条件を満たすフットプリントの例として、DIP8、DIP14、DIP24N があります。
Not HasFootprint('IDC16')
HasFootprint('IDC16') = False
HasFootprint('IDC16') = 'False'
Footprint プロパティが IDC16 であるコンポーネントオブジェクトexcept すべてのオブジェクトを返します。
HasFootprint('*2*')
HasFootprint('*2*') = True
HasFootprint('*2*') = 'True'
Footprint プロパティに文字 2 を含むすべてのコンポーネントオブジェクトを返します。条件を満たすフットプリントの例として、2012、2N5001、IDC20、HDR1X2 があります。
注記
-
Footprint文字列の先頭と末尾には、一重引用符(')が必要です。 - 返される各コンポーネントオブジェクトに関連付けられた子オブジェクトも返されます。
HasFootprintPad
概要
指定したフットプリントを持つコンポーネントオブジェクトの子オブジェクトであり、パッドの Name プロパティがクエリの条件を満たすすべてのパッドオブジェクトを返します。
構文
HasFootprintPad(Footprint : String,Name : String) : Boolean/Boolean_String
使用例
Not HasFootprintPad('0805','1')
HasFootprintPad('0805','1') = False
HasFootprintPad('0805','1') = 'False'
Name プロパティが 1 であり、Footprint プロパティが 0805 であるコンポーネントオブジェクトの子オブジェクトであるパッドオブジェクトexcept すべてのオブジェクトを返します。
HasFootprintPad('SIP?0','1')
HasFootprintPad('SIP?0','1') = True
HasFootprintPad('SIP?0','1') = 'True'
Name プロパティが 1 であり、Footprint プロパティが SIP で始まり、0 で終わり、その間に任意の1文字を含むコンポーネントオブジェクトの子オブジェクトであるすべてのパッドオブジェクトを返します。条件を満たすフットプリントの例として、SIP10、SIP20、SIPQ0 があります。
HasFootprintPad('DB*','MNT')
HasFootprintPad('DB*','MNT') = True
HasFootprintPad('DB*','MNT') = 'True'
Name プロパティが MNT であり、Footprint プロパティがDBで始まるコンポーネントオブジェクトの子オブジェクトであるすべてのパッドオブジェクトを返します。条件を満たすフットプリントの例として、DB9S、DB15HD、DB25P があります。
HasFootprintPad('','MN*')
HasFootprintPad('','MN*') = True
HasFootprintPad('','MN*') = 'True'
Name プロパティが MN で始まり、any コンポーネントオブジェクトの子オブジェクトであるすべてのパッドオブジェクトを返します。
注記
-
FootprintおよびName文字列の先頭と末尾には、一重引用符(')が必要です。 - 親コンポーネントオブジェクトは返されません。
HasMaskExpansionOnLayer
概要
指定したレイヤーにペーストマスク拡張値(ビアを除く)またはソルダーマスク拡張値が定義されている、すべてのアーク、フィル、パッド、リージョン、トラック、およびビアオブジェクトを返します。値は手動で定義することも、適用される定義済みのデザインルールから取得することもできます。
構文
HasMaskExpansionOnLayer(Layer : String) : Boolean/Boolean_String
Layerは、View ConfigurationパネルのLayers & Colorsタブにある該当するLayersセクションに表示されるレイヤー名です。
使用例
HasMaskExpansionOnLayer('Top Layer')
HasMaskExpansionOnLayer('Top Layer') = True
HasMaskExpansionOnLayer('Top Layer') = 'True'
Top Layer.
Not HasMaskExpansionOnLayer('Bottom Layer')
HasMaskExpansionOnLayer('Bottom Layer') = False
HasMaskExpansionOnLayer('Bottom Layer') = 'False'
にペーストマスク拡張値(ビアを除く)またはソルダーマスク拡張値が定義されている、すべてのアーク、フィル、パッド、リージョン、トラック、およびビアオブジェクトを返します。
Bottom Layerにペーストマスク拡張値(ビアを除く)またはソルダーマスク拡張値が定義されているアーク、フィル、パッド、リージョン、トラック、およびビアオブジェクトexceptすべてのオブジェクトを返します。
注記
Layerの先頭と末尾には、一重引用符(')が必須です。
HasPad
概要
完全名プロパティがクエリに一致するすべてのパッドオブジェクトを返します。
構文
HasPad(PadName : String) : Boolean/Boolean_String
PadName文字列は、パッドが一致する必要のある完全名を指定します。これは、パッドの親コンポーネントのName プロパティ(コンポーネントのデジグネーター)を指定する部分文字列と、それに続くパッド自体のName プロパティ(パッドのデジグネーター)を指定する部分文字列で構成されます。したがって、形式は'ParentComponentDesignator-PadDesignator'となります。
使用例
Not HasPad('C14-1')
HasPad('C14-1') = False
HasPad('C14-1') = 'False'
Name プロパティが1であり、Name プロパティがC14のコンポーネントオブジェクトの子オブジェクトであるパッドオブジェクトexcept すべてのオブジェクトを返します。
HasPad('U5-11')
HasPad('U5-11') = True
HasPad('U5-11') = 'True'
Name プロパティが11であり、Name プロパティがU5のコンポーネントオブジェクトの子オブジェクトであるパッドオブジェクトを返します。
HasPad('U*-11')
HasPad('U*-11') = True
HasPad('U*-11') = 'True'
Name プロパティが11であり、Name プロパティがUで始まるコンポーネントオブジェクトの子オブジェクトである、すべてのパッドオブジェクトを返します。
HasPad('*-1*')
HasPad('*-1*') = True
HasPad('*-1*') = 'True'
Name プロパティが1で始まり、any コンポーネントオブジェクトの子オブジェクトである、すべてのパッドオブジェクトを返します。
注記
PadName文字列の先頭と末尾には、一重引用符(')が必須です。
HasViaFeature
概要
ビアフィーチャープロパティがクエリに一致するすべてのビアオブジェクトを返します。
構文
HasViaFeature(ViaFeature : String) : Boolean/Boolean_String
ViaFeature文字列は、ビアが一致する必要のあるビアフィーチャーを指定します。次のいずれかを指定できます。
-
Capping -
Covering -
Filling -
Plugging -
Tenting
使用例
Not HasViaFeature('Capping')
HasViaFeature('Capping') = False
HasViaFeature('Capping') = 'False'
ビアフィーチャープロパティがCappingのビアオブジェクトexceptすべてのオブジェクトを返します。
HasViaFeature('Covering')
HasViaFeature('Covering') = True
HasViaFeature('Covering') = 'True'
ビアフィーチャープロパティがCoveringのビアオブジェクトを返します。
注記
ViaFeature文字列の先頭と末尾には、一重引用符(')が必須です。
HasViaType
概要
ビアタイププロパティがクエリに一致するすべてのビアオブジェクトを返します。
構文
HasViaType(ViaType : String) : Boolean/Boolean_String
ViaType文字列は、ビアが一致する必要のあるIPC 4761 Via Typeプロパティを指定します。次のいずれかを指定できます。
-
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
使用例
Not HasViaFeature('Capping')
HasViaFeature('Capping') = False
HasViaFeature('Capping') = 'False'
ビアフィーチャープロパティがCappingのビアオブジェクトexceptすべてのオブジェクトを返します。
HasViaFeature('Covering')
HasViaFeature('Covering') = True
HasViaFeature('Covering') = 'True'
ビアフィーチャープロパティがCoveringのビアオブジェクトを返します。
注記
ViaFeature文字列の先頭と末尾には、一重引用符(')が必須です。
InChannelClass
概要
指定したデザインチャネルクラスのメンバーであるコンポーネントオブジェクトに関連付けられた、すべてのオブジェクトを返します。
構文
InChannelClass(ClassName1 : String,ClassName2 : String,...,ClassNamen : String) : Boolean/Boolean_String
クエリ式を定義すると、既存のすべてのユーザー定義デザインチャネルクラスが名前順に並んだポップアップリストが表示されます。
使用例
InChannelClass('Red_LED')
InChannelClass('Red_LED') = True
InChannelClass('Red_LED') = 'True'
Red_LEDデザインチャネルクラスのメンバーであるコンポーネントオブジェクトに関連付けられた、すべてのオブジェクトを返します。
InChannelClass('Output channel','Input channel')
InChannelClass('Output channel','Input channel') = True
InChannelClass('Output channel','Input channel') = 'True'
Output channel または Input channelデザインチャネルクラスのいずれかのメンバーであるコンポーネントオブジェクトに関連付けられた、すべてのオブジェクトを返します。
InChannelClass('Input*')
InChannelClass('Input*') = True
InChannelClass('Input*') = 'True'
Name プロパティがInputで始まるいずれかのデザインチャネルクラスのメンバーであるコンポーネントオブジェクトに関連付けられた、すべてのオブジェクトを返します。
注記
-
各
ClassName文字列の先頭と末尾には、一重引用符(')が必須です。 - 親コンポーネントオブジェクトも返されます。
InComponent
概要
Name プロパティがクエリに一致するすべてのコンポーネントオブジェクトを返します。
構文
InComponent(Name : String) : Boolean/Boolean_String
クエリ式を定義すると、既存のすべてのコンポーネントが名前順に並んだポップアップリストが表示されます。
使用例
InComponent('U1')
InComponent('U1') = True
InComponent('U1') = 'True'
Name プロパティがU1のすべてのコンポーネントオブジェクトを返します。
InComponent('U1', 'U2', 'J1')
InComponent('U1', 'U2', 'J1') = True
InComponent('U1', 'U2', 'J1') = 'True'
Name プロパティがU1、U2、またはJ1のすべてのコンポーネントオブジェクトを返します。
Not InComponent('IDC16')
InComponent('IDC16') = False
InComponent('IDC16') = 'False'
Name プロパティがIDC16のコンポーネントオブジェクトexcept すべてのオブジェクトを返します。
InComponent('U*')
InComponent('U*') = True
InComponent('U*') = 'True'
Name プロパティがUで始まるすべてのコンポーネントオブジェクトを返します。
注記
-
Name文字列の先頭と末尾には、一重引用符(')が必須です。 - 返される各コンポーネントオブジェクトについて、関連付けられた子オブジェクトも返されます。
InComponentClass
概要
指定したコンポーネントクラスのメンバーであるすべてのコンポーネントオブジェクトを返します。
構文
InComponentClass(ClassName : String) : Boolean/Boolean_String
クエリ式を定義すると、既存のすべてのユーザー定義コンポーネントクラスが名前順に並んだポップアップリストが表示されます。
使用例
InComponentClass('TopSideSMD')
InComponentClass('TopSideSMD') = True
InComponentClass('TopSideSMD') = 'True'
TopSideSMDコンポーネントクラスのメンバーであるすべてのコンポーネントオブジェクトを返します。
Not InComponentClass('BottomSideSMD')
InComponentClass('BottomSideSMD') = False
InComponentClass('BottomSideSMD') = 'False'
BottomSideSMDコンポーネントクラスのメンバーであるコンポーネントオブジェクトexcept すべてのオブジェクトを返します。
注記
ClassName文字列の先頭と末尾には、一重引用符(')が必須です。
InDifferentialPair
概要
Name プロパティがクエリに一致する差動ペアオブジェクトに関連付けられた、すべてのオブジェクトを返します。
構文
InDifferentialPair(DifferentialPairName1 : String,DifferentialPair2 : String,...,DifferentialPairn : String) : Boolean/Boolean_String
クエリ式を定義すると、既存のすべての差動ペアが名前順に並んだポップアップリストが表示されます。
使用例
InDifferentialPair('Red_LED')
InDifferentialPair('Red_LED') = True
InDifferentialPair('Red_LED') = 'True'
Name プロパティがRed_LEDの差動ペアオブジェクトに関連付けられた、すべてのオブジェクトを返します。
InDifferentialPair('D0','D1')
InDifferentialPair('D0','D1') = True
InDifferentialPair('D0','D1') = 'True'
Name プロパティがD0または D1のいずれかである差動ペアオブジェクトに関連付けられた、すべてのオブジェクトを返します。
InDifferentialPair('Input*')
InDifferentialPair('Input*') = True
InDifferentialPair('Input*') = 'True'
Name プロパティがInputで始まる差動ペアオブジェクトに関連付けられた、すべてのオブジェクトを返します。
注記
- 各
DifferentialPairName文字列の先頭と末尾には、シングルクォート(')が必要です。 - 親の差動ペアオブジェクトも返されます。
InDifferentialPairClass
概要
指定した差動ペアクラスに属するすべての差動ペアオブジェクトを返します。
構文
InDifferentialPairClass(ClassName : String) : Boolean/Boolean_String
クエリ式を定義すると、既存のすべての差動ペアが名前順に並んだポップアップリストが表示されます。
使用例
InDifferentialPairClass('TopSide')
InDifferentialPairClass('TopSide') = True
InDifferentialPairClass('TopSide') = 'True'
TopSide差動ペアクラスに属するすべての差動ペアオブジェクトを返します。
Not InDifferentialPairClass('BottomSide')
InDifferentialPairClass('BottomSide') = False
InDifferentialPairClass('BottomSide') = 'False'
BottomSide差動ペアクラスに属する差動ペアオブジェクトexcept すべてのオブジェクトを返します。
注意
ClassName文字列の先頭と末尾には、シングルクォート(')が必要です。
InDrillLayerPair
概要
Drill Pair プロパティが指定したドリルレイヤペアと一致するすべてのビアオブジェクトを返します。
構文
InDrillLayerPair(LayerPair : String) : Boolean/Boolean_String
使用例
InDrillLayerPair('Top Layer - Bottom Layer')
InDrillLayerPair('Top Layer - Bottom Layer') = True
InDrillLayerPair('Top Layer - Bottom Layer') = 'True'
Drill Pair プロパティが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'
Drill Pair プロパティがTop Layer - Signal Layer 1ドリルレイヤペアと一致するビアオブジェクトexcept すべてのオブジェクトを返します。
注意事項
- Drill Layer Pairプロパティは、ビアオブジェクトに対してのみ定義されています。
-
LayerPair文字列の先頭と末尾には、シングルクォート(')が必要です。 -
特定の種類のビアを対象とするには、クエリに適切なオブジェクトタイプのチェックを含めます:
IsThruVia、IsBlindVia、IsBuriedVia、IsMicroVia、またはIsSkipVia。
たとえば、次のクエリは:
InDrillLayerPair('Top Layer - Signal Layer 1') AND IsMicroVia
Drill Pair プロパティがTop Layer - Signal Layer 1ドリルレイヤペアと一致し、かつビアタイプがµViaであるすべてのビアオブジェクトを返します。
InFromTo
概要
Net、From Pad、To Padプロパティがクエリの条件を満たすFrom-Toオブジェクトに関連付けられたすべてのオブジェクトを返します。
From-ToオブジェクトはPCB Listパネルに返されますが、ワークスペースに表示するには、PCB パネルをFrom-To Editorモードにしてからフィルタクエリを適用する必要があります。
構文
InFromTo('Net_Name (From_Pad : To_Pad)') : Boolean/Boolean_String
クエリ式を定義すると、既存のすべてのFrom-Toが名前順に並んだポップアップリストが表示されます。
Net_Name、From_Pad、To_Padはいずれも文字列です。使用するシングルクォート(')は、上記に示したもの(最も外側の括弧のすぐ内側)のみです。
From_PadおよびTo_Padの各文字列は、パッドが一致する必要のある完全な名前を指定します。これは、パッドの親コンポーネントのName プロパティ(コンポーネントのデジグネータ)を指定する先頭の部分文字列と、それに続くパッド自体のName プロパティ(パッドのデジグネータ)を指定する部分文字列で構成されます。したがって、形式は'ParentComponentDesignator-PadDesignator'となります。
使用例
InFromTo('VDD_XTAL (C13-2 : U1-8)')
InFromTo('VDD_XTAL (C13-2 : U1-8)') = True
InFromTo('VDD_XTAL (C13-2 : U1-8)') = 'True'
Net プロパティがVDD_XTAL、From PadプロパティがC13-2、To PadプロパティがU1-8であるFrom-Toオブジェクトに関連付けられたすべてのオブジェクトを返します。(この場合、始点パッドのName プロパティは2で、その親コンポーネントオブジェクトのNameプロパティはC13です。同様に、終点パッドのName プロパティは8で、その親コンポーネントオブジェクトのName プロパティはU1です)。
注意
親のFrom-Toオブジェクトも返されます。
InFromToClass
概要
指定したFrom-Toクラスに属するすべてのFrom-Toオブジェクトを返します。
構文
InFromToClass(ClassName : String) : Boolean/Boolean_String
クエリ式を定義すると、既存のすべてのユーザー定義From-Toクラスが名前別にポップアップリストに表示されます。
使用例
InFromToClass('Bus Terminators')
InFromToClass('Bus Terminators') = True
InFromToClass('Bus Terminators') = 'True'
Bus TerminatorsFrom-Toクラスに属するすべてのFrom-Toオブジェクトを返します。
Not InFromToClass('Bus Terminators')
InFromToClass('Bus Terminators') = False
InFromToClass('Bus Terminators') = 'False'
Bus TerminatorsFrom-Toクラスに属するFrom-Toオブジェクトexcept すべてのオブジェクトを返します。
注意
ClassName文字列の先頭と末尾には、シングルクォート(')が必要です。
InLayerClass
概要
Layer プロパティが、指定したレイヤクラスに属するレイヤと一致するすべてのオブジェクトを返します。
構文
InLayerClass(ClassName : String) : Boolean/Boolean_String
クエリ式を定義すると、既存のすべてのユーザー定義レイヤクラスが名前順に並んだポップアップリストが表示されます。
使用例
InLayerClass('TopSide')
InLayerClass('TopSide') = True
InLayerClass('TopSide') = 'True'
Layer プロパティが、TopSideレイヤクラスに属するレイヤと一致するすべてのオブジェクトを返します。
Not InLayerClass('BottomSide')
InLayerClass('BottomSide') = False
InLayerClass('BottomSide') = 'False'
Layer プロパティが、BottomSideレイヤクラスに属するレイヤと一致するオブジェクトexcept すべてのオブジェクトを返します。
注意
ClassName文字列の先頭と末尾には、シングルクォート(')が必要です。
InLayerStackRegion
概要
指定した名前のBoard Region内に基準点があるすべてのオブジェクトを返します。
構文
InLayerStackRegion(RegionName1 : String,RegionName2 : String,...,RegionNamen : String) : Boolean/Boolean_String
使用例
InLayerStackRegion('Region1')
InLayerStackRegion('Region1') = True
InLayerStackRegion('Region1') = 'True'
Name プロパティがRegion1である基板領域内に基準点があるすべてのオブジェクトを返します。
InLayerStackRegion('Region1','Region2')
InLayerStackRegion('Region1','Region2') = True
InLayerStackRegion('Region1','Region2') = 'True'
Name プロパティが Region1である基板領域、またはNameプロパティがRegion2である基板領域内に基準点があるすべてのオブジェクトを返します。
Not InLayerStackRegion('Region2')
InLayerStackRegion('Region2') = False
InLayerStackRegion('Region2') = 'False'
Name プロパティがRegion2である基板領域内に基準点があるオブジェクトexcept すべてのオブジェクトを返します。
注意
RegionName文字列の先頭と末尾には、シングルクォート(')が必要です。
InNamedPolygon
概要
指定したポリゴンポアの子であるすべてのプリミティブオブジェクトを返します。
構文
InNamedPolygon(PolygonName : String) : Boolean/Boolean_String
クエリ式を定義すると、既存のすべてのポリゴンポアが名前順に並んだポップアップリストが表示されます。
使用例
InNamedPolygon('Power3V3')
InNamedPolygon('Power3V3') = True
InNamedPolygon('Power3V3') = 'True'
Name プロパティがPower3V3であるポリゴンポアの子であるすべてのプリミティブオブジェクトを返します。
Not InNamedPolygon('Power3V3')
InNamedPolygon('Power3V3') = False
InNamedPolygon('Power3V3') = 'False'
Name プロパティがPower3V3であるポリゴンポアの子であるプリミティブオブジェクトexcept すべてのオブジェクトを返します。
注意事項
-
PolygonName文字列の先頭と末尾には、シングルクォート(')が必要です。 - 親のポリゴンポアオブジェクトも返されます。
InNamedUnion
概要
指定したユニオンを構成するすべてのオブジェクト(親と子)を返します。
構文
InNamedUnion(UnionName : String) : Boolean/Boolean_String
ユニオン名は自動的に割り当てられますが、PCB パネルをUnions モードにして名前を変更できます。クエリ式を定義すると、既存のすべてのユニオンが名前順に並んだポップアップリストが表示されます。
使用例
InNamedUnion('Unions')
InNamedUnion('Unions') = True
InNamedUnion('Unions') = 'True'
名前がUnionsであるユニオンに属するすべてのオブジェクト(親と子)を返します。
Not InNamedUnion('Unions 1')
InNamedUnion('Unions 1') = False
InNamedUnion('Unions 1') = 'False'
名前がUnions 1であるユニオンに属するオブジェクト(親と子)except すべてのオブジェクトを返します。
注記
UnionName文字列の先頭と末尾の一重引用符(')は必須です。
InNet
概要
Name プロパティがクエリの条件に一致するネットオブジェクトに関連付けられたすべてのオブジェクトを返します。
構文
InNet(NetName1 : String,NetName2 : String,...,NetNamen : String) : Boolean/Boolean_String
クエリ式を定義すると、既存のすべてのネットが名前順に並んだポップアップリストが表示されます。
使用例
InNet('Red_LED')
InNet('Red_LED') = True
InNet('Red_LED') = 'True'
Name プロパティがRed_LEDであるネットオブジェクトに関連付けられたすべてのオブジェクトを返します。
InNet('D0','D1')
InNet('D0','D1') = True
InNet('D0','D1') = 'True'
Name プロパティがD0または D1であるネットオブジェクトに関連付けられたすべてのオブジェクトを返します。
InNet('V*')
InNet('V*') = True
InNet('V*') = 'True'
Name プロパティがVで始まるネットオブジェクトに関連付けられたすべてのオブジェクトを返します。
注記
-
各
NetName文字列の先頭と末尾の一重引用符(')は必須です。 - 親のネットオブジェクトも返されます。
InNetClass
概要
指定したネットクラスに属するすべてのネット(および関連付けられたオブジェクト)を返します。
構文
InNetClass(ClassName : String) : Boolean/Boolean_String
クエリ式を定義すると、既存のすべてのユーザー定義ネットクラスが名前順に並んだポップアップリストが表示されます。
使用例
InNetClass('Data Bus Nets')
InNetClass('Data Bus Nets') = True
InNetClass('Data Bus Nets') = 'True'
Data Bus Netsネットクラスに属するすべてのネット(および関連付けられたオブジェクト)を返します。
Not InNetClass('Address Bus Nets')
InNetClass('Address Bus Nets') = False
InNetClass('Address Bus Nets') = 'False'
Address Bus Netsネットクラスに属するネット(および関連付けられたオブジェクト)except すべてのオブジェクトを返します。
注記
ClassName文字列の先頭と末尾の一重引用符(')は必須です。
InPadClass
概要
指定したパッドクラスに属するすべてのパッドオブジェクトを返します。
構文
InPadClass(ClassName : String) : Boolean/Boolean_String
クエリ式を定義すると、既存のすべてのユーザー定義パッドクラスが名前順に並んだポップアップリストが表示されます。
使用例
InPadClass('Top Side Probe Pads')
InPadClass('Top Side Probe Pads') = True
InPadClass('Top Side Probe Pads') = 'True'
Top Side Probe Padsパッドクラスに属するすべてのパッドオブジェクトを返します。
Not InPadClass('Bottom Side Probe Pads')
InPadClass('Bottom Side Probe Pads') = False
InPadClass('Bottom Side Probe Pads') = 'False'
Bottom Side Probe Padsパッドクラスに属するパッドオブジェクトexcept すべてのオブジェクトを返します。
注記
ClassName文字列の先頭と末尾の一重引用符(')は必須です。
InPolygonClass
概要
指定したポリゴンクラスに属するすべてのポリゴンポアオブジェクトを返します。
構文
InPolygonClass(ClassName : String) : Boolean/Boolean_String
クエリ式を定義すると、既存のすべてのユーザー定義ポリゴンクラスが名前順に並んだポップアップリストが表示されます。
使用例
InPolygonClass('Top Side Polys')
InPolygonClass('Top Side Polys') = True
InPolygonClass('Top Side Polys') = 'True'
Top Side Polysポリゴンクラスに属するすべてのポリゴンポアオブジェクトを返します。
Not InPolygonClass('Custom Polys')
InPolygonClass('Custom Polys') = False
InPolygonClass('Custom Polys') = 'False'
Custom Polysポリゴンクラスに属するポリゴンポアオブジェクトexcept すべてのオブジェクトを返します。
注記
ClassName文字列の先頭と末尾の一重引用符(')は必須です。
InRegion
概要
クエリで指定した領域内にあるすべてのオブジェクトを返します。
構文
InRegion(X1 : Number ,Y1 : Number ,X2 : Number ,Y2 : Number) : Boolean/Boolean_String
X1,Y1とX2,Y2は、PCB(ライブラリ)ファイル内の座標を指定します。領域の左端と右端はX1パラメーターとX2パラメーターで指定し、下端と上端はY1パラメーターとY2パラメーターで指定します。
すべての座標は絶対原点を基準とし(ユーザー原点やコンポーネントの挿入点ではありません)、現時点では常にmil単位を使用します(1 mil = 0.001インチ)。
使用例
InRegion(12700,4700,13300,5000)
InRegion(12700,4700,13300,5000) = True
InRegion(12700,4700,13300,5000) = 'True'
X1 = 12700とX2 = 13300、およびY1 = 4700とY2 = 5000で囲まれた矩形領域内にあるオブジェクトを返します。これらの座標は絶対原点を基準とします。
注記
- 親のコンポーネント、座標、寸法、およびネットオブジェクトは返されません。
- このキーワードはInRegionAbsoluteキーワードの別名です。
InRegionAbsolute
概要
クエリで指定した領域内にあるすべてのオブジェクトを返します。
構文
InRegionAbsolute(X1 : Number ,Y1 : Number ,X2 : Number ,Y2 : Number) : Boolean/Boolean_String
X1,Y1とX2,Y2は、PCB(ライブラリ)ファイル内の座標を指定します。領域の左端と右端はX1パラメーターとX2パラメーターで指定し、下端と上端はY1パラメーターとY2パラメーターで指定します。
すべての座標は絶対原点を基準とし(ユーザー原点やコンポーネントの挿入点ではありません)、現時点では常にmil単位を使用します(1 mil = 0.001インチ)。
使用例
InRegionAbsolute(12700,4700,13300,5000)
InRegionAbsolute(12700,4700,13300,5000) = True
InRegionAbsolute(12700,4700,13300,5000) = 'True'
X1 = 12700とX2 = 13300、およびY1 = 4700とY2 = 5000で囲まれた矩形領域内にあるオブジェクトを返します。これらの座標は絶対原点を基準とします。
注記
- 親のコンポーネント、座標、寸法、およびネットオブジェクトは返されません。
- このキーワードはInRegionキーワードの別名です。
InRegionRelative
概要
クエリで指定した領域内にあるすべてのオブジェクトを返します。
構文
InRegionRelative(X1 : Number ,Y1 : Number ,X2 : Number ,Y2 : Number) : Boolean/Boolean_String
X1,Y1とX2,Y2は、PCB(ライブラリ)ファイル内の座標を指定します。領域の左端と右端はX1パラメーターとX2パラメーターで指定し、下端と上端はY1パラメーターとY2パラメーターで指定します。
すべての座標は絶対原点ではなく、ユーザー原点(PCBファイル)またはコンポーネントの挿入点(PCBライブラリファイル)を基準とし、現時点では常にmil単位を使用します(1 mil = 0.001インチ)。
使用例
InRegionRelative(-700,-400,1300,1600)
InRegionRelative(-700,-400,1300,1600) = True
InRegionRelative(-700,-400,1300,1600) = 'True'
X1 = -700とX2 = 1300、およびY1 = -400とY2 = 1600で囲まれた矩形領域内にあるオブジェクトを返します。これらの座標はユーザー原点(またはコンポーネントの挿入点)を基準とします。
注記
親のコンポーネント、座標、寸法、およびネットオブジェクトは返されません。
InStructureClass
概要
指定したストラクチャクラスのメンバーであるコンポーネントクラスおよびネットクラスの、すべての親オブジェクトと子オブジェクトを返します。
構文
InStructureClass(ClassName1 : String,ClassName2 : String,...,ClassNamen : String) : Boolean/Boolean_String
クエリ式を定義すると、既存のすべてのユーザー定義ストラクチャクラスが名前順に並んだポップアップリストが表示されます。
使用例
InStructureClass('Red_LED')
InStructureClass('Red_LED') = True
InStructureClass('Red_LED') = 'True'
Red_LED ストラクチャクラスのメンバーであるコンポーネントクラスおよびネットクラスの、すべての親オブジェクトと子オブジェクトを返します。
InStructureClass('Output channel','Input channel')
InStructureClass('Output channel','Input channel') = True
InStructureClass('Output channel','Input channel') = 'True'
Output channel または Input channel ストラクチャクラスのいずれかのメンバーであるコンポーネントクラスおよびネットクラスの、すべての親オブジェクトと子オブジェクトを返します。
InStructureClass('Input*')
InStructureClass('Input*') = True
InStructureClass('Input*') = 'True'
Name プロパティが Input で始まる任意のストラクチャクラスのメンバーであるコンポーネントクラスおよびネットクラスの、すべての親オブジェクトと子オブジェクトを返します。
注意
各 ClassName 文字列の先頭と末尾には、単一引用符(')が必要です。
InUnion
概要
指定したユニオンに属するすべてのオブジェクト(親と子)を返します。
構文
InUnion(Union : Number) : Boolean/Boolean_String
ユニオン番号は自動的に割り当てられます。クエリ式を定義すると、既存のすべてのユニオンが番号順に並んだポップアップリストが表示されます。
使用例
InUnion(1)
InUnion(1) = True
InUnion(1) = 'True'
割り当てられた番号が 1 のユニオンに属するすべてのオブジェクト(親と子)を返します。
Not InUnion(4)
InUnion(4) = False
InUnion(4) = 'False'
割り当てられた番号が 4 のユニオンに属するオブジェクト(親と子)except のすべてのオブジェクトを返します。
InxSignal
概要
指定した xSignal に関連するすべてのオブジェクトを返します。
構文
InxSignal(Name : String) : Boolean/Boolean_String
クエリ式を定義すると、既存のすべての xSignal が名前順に並んだポップアップリストが表示されます。
使用例
InxSignal('DRAM_A0_PP1')
InxSignal('DRAM_A0_PP1') = True
InxSignal('DRAM_A0_PP1') = 'True'
xSignal DRAM_A0_PP1 に関連するすべてのオブジェクトを返します。
Not InxSignal('DRAM_A0_PP1')
InxSignal('DRAM_A0_PP1') = False
InxSignal('DRAM_A0_PP1') = 'False'
xSignal DRAM_A0_PP1 に関連するオブジェクトexcept のすべてのオブジェクトを返します。
注意
Name 文字列の先頭と末尾には、単一引用符(')が必要です。
InxSignalClass
概要
指定した xSignal クラスのメンバーであるすべての xSignal オブジェクトを返します。
構文
InxSignalClass(ClassName : String) : Boolean/Boolean_String
クエリ式を定義すると、既存のすべてのユーザー定義 xSignal クラスが名前順に並んだポップアップリストが表示されます。
使用例
InxSignalClass('PCIE')
InxSignalClass('PCIE') = True
InxSignalClass('PCIE') = 'True'
PCIE xSignal クラスのメンバーであるすべての xSignal オブジェクトを返します。
Not InxSignalClass('PCIE')
InxSignalClass('PCIE') = False
InxSignalClass('PCIE') = 'False'
PCIE xSignal クラスのメンバーである xSignal オブジェクトexcept のすべてのオブジェクトを返します。
注意
ClassName 文字列の先頭と末尾には、単一引用符(')が必要です。
IsNamedPolygon
概要
指定したポリゴンポアを返します。
構文
IsNamedPolygon(PolygonName : String) : Boolean/Boolean_String
クエリ式を定義すると、既存のすべてのポリゴンポアが名前順に並んだポップアップリストが表示されます。
使用例
IsNamedPolygon('Power3V3')
IsNamedPolygon('Power3V3') = True
IsNamedPolygon('Power3V3') = 'True'
Name プロパティが Power3V3 であるポリゴンポアオブジェクトを返します。
Not IsNamedPolygon('Power3V3')
IsNamedPolygon('Power3V3') = False
IsNamedPolygon('Power3V3') = 'False'
Name プロパティが Power3V3 であるポリゴンポアオブジェクトexcept のすべてのオブジェクトを返します。
注意事項
-
PolygonName文字列の先頭と末尾には、単一引用符(')が必要です。 -
返されるポリゴンポアオブジェクトの子プリミティブオブジェクトは返されません。
IsxSignal
概要
指定した名前の xSignal オブジェクトを返します。
構文
IsxSignal(Name : String) : Boolean/Boolean_String
クエリ式を定義すると、既存のすべての xSignal が名前順に並んだポップアップリストが表示されます。
使用例
IsxSignal('DRAM_A0_PP1')
IsxSignal('DRAM_A0_PP1') = True
IsxSignal('DRAM_A0_PP1') = 'True'
xSignal DRAM_A0_PP1 を返します。
Not IsxSignal('DRAM_A0_PP1')
IsxSignal('DRAM_A0_PP1') = False
IsxSignal('DRAM_A0_PP1') = 'False'
xSignal DRAM_A0_PP1 exceptのすべてのオブジェクトを返します。
注意
Name 文字列の先頭と末尾には、単一引用符(')が必要です。
OnGrid
概要
X1 および Y1 プロパティがクエリの条件を満たすすべてのオブジェクトを返します。
構文
OnGrid(X1 : Number,Y1 : Number) : Boolean/Boolean_String
各 Distance_String は、PCB(ライブラリ)ファイル内の距離を指定する数値文字列です。オブジェクトが返されるには、その X1 プロパティが最初に指定した距離の整数倍であり、Y1 プロパティが2番目に指定した距離の整数倍である必要があります。
X1 および Y1 は、PCB(ライブラリ)ファイル内の座標を指定します。オブジェクトが返されるには、その X1 プロパティが最初に指定した値の整数倍であり、Y1 プロパティが2番目に指定した値の整数倍である必要があります。
すべての座標は、ユーザー原点やコンポーネントの挿入点ではなく、絶対原点を基準とします。また、現時点では常に mil 単位(1 mil = 0.001 インチ)を使用します。
使用例
OnGrid(25,25)
OnGrid(25,25) = True
OnGrid(25,25) = 'True'
X1 プロパティが 25mil の整数倍であり、Y1 プロパティが 25mil の整数倍であるすべてのオブジェクトを返します。
OnGrid(5,100)
OnGrid(5,100) = True
OnGrid(5,100) = 'True'
X1 プロパティが 5mil の整数倍であり、Y1 プロパティが 100mil の整数倍であるすべてのオブジェクトを返します。
OnLayer
概要
Layer プロパティがクエリの条件を満たすすべてのオブジェクトを返します。
構文
OnLayer(Layer : String) : Boolean/Boolean_String
Layer は、View Configuration パネルの Layers & Colors タブに表示されるレイヤー名です。
使用例
OnLayer('Top Layer')
OnLayer('Top Layer') = True
OnLayer('Top Layer') = 'True'
Layer プロパティが Top Layer.
Not OnLayer('Mechanical 3')
OnLayer('Mechanical 3') = False
OnLayer('Mechanical 3') = 'False'
であるすべてのオブジェクトを返します。
Layer プロパティが Mechanical 3 レイヤーであるオブジェクトexceptのすべてのオブジェクトを返します。
注意事項
-
Layerの先頭と末尾には、単一引用符(')が必要です。 -
Multi-Layerレイヤーに配置されたオブジェクトは、このレイヤーを明示的に指定した場合、つまりOnLayer('Multi-Layer')クエリを使用した場合にのみ、OnLayerクエリキーワードによって返されます。Multi-Layerレイヤーに配置されたオブジェクトは、その形状が存在する別のレイヤーを指定しても、OnLayerクエリキーワードでは返されません。指定したレイヤー上に形状を持つオブジェクト(Multi-Layerレイヤー上のオブジェクトを含む)を対象にするには、ExistsOnLayer(Layer : String)クエリを使用してください。
TouchesRoom
概要
Name プロパティがクエリの条件を満たすルームオブジェクト(配置制約ルール)の領域内に、全体または一部が存在するオブジェクトを返します。
構文
TouchesRoom(RoomName1 : String,RoomName2 : String,...,RoomNamen : String) : Boolean/Boolean_String
クエリ式を定義すると、既存のすべてのルームが名前順に並んだポップアップリストが表示されます。
使用例
TouchesRoom('Power')
TouchesRoom('Power') = True
TouchesRoom('Power') = 'True'
Name プロパティがPowerであるルームの領域内に、全体または一部が存在するオブジェクトを返します。
TouchesRoom('COUT1','COUT2')
TouchesRoom('COUT1','COUT2') = True
TouchesRoom('COUT1','COUT2') = 'True'
Name プロパティがCOUT1またはCOUT2であるルームの領域内に、全体または一部が存在するオブジェクトを返します。
TouchesRoom('Monitor','Auxilary','Effects')
TouchesRoom('Monitor','Auxilary','Effects') = True
TouchesRoom('Monitor','Auxilary','Effects') = 'True'
Name プロパティがMonitor、Auxilary、またはEffectsであるルームの領域内に、全体または一部が存在するオブジェクトを返します。
注記
-
各
RoomName文字列の先頭と末尾には、単一引用符(')が必要です。 -
親の座標、寸法、およびネットオブジェクトは返されません。
WithinRoom
概要
Name プロパティがクエリの条件を満たすルームオブジェクト(配置制約ルール)の領域内に、全体が存在するオブジェクトを返します。
パッドおよびビアが返されるには、その中心点が指定されたルーム内に存在する必要があります。
構文
WithinRoom(RoomName1 : String,RoomName2 : String,...,RoomNamen : String) : Boolean/Boolean_String
クエリ式を定義すると、既存のすべてのルームが名前順に並んだポップアップリストが表示されます。
使用例
WithinRoom('Power')
WithinRoom('Power') = True
WithinRoom('Power') = 'True'
Name プロパティがPowerであるルームの領域内に、全体が存在するオブジェクトを返します。
WithinRoom('COUT1','COUT2')
WithinRoom('COUT1','COUT2') = True
WithinRoom('COUT1','COUT2') = 'True'
Name プロパティがCOUT1またはCOUT2であるルームの領域内に、全体が存在するオブジェクトを返します。
WithinRoom('Monitor','Auxilary','Effects')
WithinRoom('Monitor','Auxilary','Effects') = True
WithinRoom('Monitor','Auxilary','Effects') = 'True'
Name プロパティがMonitor、Auxilary、またはEffectsであるルームの領域内に、全体が存在するオブジェクトを返します。
注記
-
各
RoomName文字列の先頭と末尾には、単一引用符(')が必要です。 - 親の座標、寸法、およびネットオブジェクトは返されません。