クエリ言語の活用
Altium Essentials: PCB Global Editing and List Panel
This content is part of the official Altium Professional Training Program. For full courses, materials and certification, visit Altium Training.
概略
- クエリで特定のオブジェクトを絞り込む仕組みと、フィルターの適用範囲によって検索対象のドキュメントやオブジェクトがどのように決まるかを学びます。
- クエリ式を作成して検証し、結果の選択、ズーム、マスキングを制御する方法を紹介します。
- フィルターの適用と解除、お気に入りや最近使用したクエリの再利用、括弧を使って式をわかりやすくする方法を解説します。
クエリとは?
複雑な電子回路設計に取り組む際、おそらく最大の課題となるのは、多数の設計オブジェクトの管理です。回路図シート上のコンポーネント、ネットラベル、テキスト文字列から、PCB上の数百ものコンポーネントや配線を構成するトラックまで、これらのオブジェクトにアクセスし、確認、編集できる必要があります。 ほとんどのWindowsアプリケーションと同様に、オブジェクトをダブルクリックすると、そのプロパティを編集できます。単一のオブジェクトであればこれで問題ありませんが、300個以上のコンポーネントのデジグネータ文字列を編集したり、PCB上のすべてのビアを変更したりする場合には適していません。このような変更を行うには、複数のオブジェクトに同時にアクセスする必要があります。
Altium Designerの回路図エディタとPCBエディタの基盤には、強力なクエリエンジンがあります。このエンジンにクエリを入力すると、必要なオブジェクトだけを正確に絞り込み、検索、編集できます。
Altium Designerの強力なデータフィルタリングおよび編集システムを使用すると、指定したオブジェクト群を返すようにソフトウェアに指示できます。この指示は、クエリという形式で入力します。クエリとは、特定のキーワードと構文を使用して入力する文字列であり、対象のオブジェクトを返します。取得したオブジェクトをどう扱うかは、ユーザー次第です。それらをハイライト表示して、ほかのすべてのオブジェクトを薄暗く表示することも、プロパティを参照または並べ替えて、共通する特定の属性を変更することもできます。
クエリを適用できる場所はいくつかありますが、中心となるのは、以下の画像に示す Filterパネルです。F12を押すと、Filter パネルの表示と非表示を切り替えられます。
クエリが入力されたPCB FilterパネルとSCH Filterパネル

クエリが入力されたPCBLIB FilterパネルとSCHLIB Filterパネル
パネル内のコントロールでは、クエリを適用するオブジェクトと、クエリの条件に一致するオブジェクトおよび一致しないオブジェクトの扱い方を定義します。
SCH Filterパネル

SCH Filterパネルで論理クエリを使用すると、オブジェクトをすばやく見つけてハイライト表示できます。
概要
SCH Filterパネルでは、論理クエリを作成してフィルタを構築できます。定義したフィルタは、アクティブな回路図ドキュメントまたは開いているすべての回路図ドキュメントに適用できるため、複数のオブジェクトをより正確かつ効率的に選択、編集できます。
パネルへのアクセス
パネルには、以下の方法でアクセスできます。
- 回路図エディタがアクティブな状態で、エディタの右下にある Panelsボタンをクリックし、ポップアップメニューからSCH Filterを選択します。
- View » Panels » SCH Filterをクリックします。
- ショートカットキーF12を押します。
フィルタの適用範囲の定義
パネルの最初の領域には、フィルタの適用範囲を定義するためのコントロールがあります。
Limit search to領域には、フィルタの適用範囲をさらに絞り込むためのコントロールがあります。
- All Objects - すべての設計オブジェクトにフィルタを適用します。
- Selected Objects - 現在選択されている設計オブジェクトにのみフィルタを適用します。
- Non Selected Objects - 現在選択されていない設計オブジェクトにのみフィルタを適用します。
Consider objects inドロップダウンフィールドでは、フィルタの適用先を指定できます。以下のオプションから選択します。
- Current Document - アクティブな回路図ドキュメントにのみフィルタを適用します(デフォルト)。
- Open Documents - 開いているすべての回路図ドキュメントにフィルタを適用します。
- Project Documents - 同じ親プロジェクトのソースドキュメントである、開いているすべての回路図ドキュメントにフィルタを適用します。
フィルタクエリの定義
パネルの中央領域では、論理クエリを入力してフィルタを構築できます。フィールドにクエリを直接入力できます。入力中は、入力を支援するキーワード候補のリストが表示されます。
クエリの作成を支援するクエリヘルパーを利用できます。この機能は、クエリの構文や使用できるキーワードがわからない場合に非常に便利です。クエリヘルパーを使用するには、HelperボタンをクリックしてQuery Helperダイアログを開きます。基盤となるクエリエンジンがドキュメントを解析し、利用可能なすべてのオブジェクトと、クエリで使用する汎用キーワードを一覧表示します。
ダイアログの上部で、利用可能なSCH FunctionsとSystem Functionsを使用してクエリ式を作成します。ダイアログの中央部には、式の作成に使用する各種の演算子が用意されています。Check Syntaxボタンを使用して、式の構文が正しいことを確認します。
目的に応じてクエリ式を定義したら、OKをクリックします。クエリがSCH Filterパネルの中央領域に読み込まれ、フィルタを適用できる状態になります。
フィルタのハイライト表示の定義
クエリを適用する前に、フィルタリングの結果を設計ワークスペースにどのように表示するかを定義しておくことをお勧めします。パネルのObjects passing/not passing the filter 領域には、持続的なフィルタリングのハイライト表示を制御する各種オプションが用意されています。
Objects passing the filter領域のオプションでは、フィルタの適用範囲内にあり、指定したクエリ式に一致するすべてのオブジェクトのワークスペース内での表示を制御できます。
- Select - 有効にすると(デフォルト)、フィルタ条件に一致するオブジェクトがワークスペース内で選択されます。
- Zoom - 有効にすると(デフォルト)、フィルタ条件に一致するオブジェクトが設計エディタウィンドウ内でズーム表示され、可能な場合は中央に配置されます。
Objects not passing the filter領域のオプションでは、フィルタの適用範囲外にあるオブジェクト、または指定したクエリ式に一致しないオブジェクトの、ワークスペース内での表示を制御できます。
- Deselect - 有効にすると(デフォルト)、フィルタの適用範囲外にあるすべてのオブジェクトの選択がワークスペース内で解除されます。
- Mask out - 有効にすると(デフォルト)、設計エディタウィンドウ内でフィルタ条件に一致するオブジェクトが通常の明るさで表示され、ほかのすべてのオブジェクトは薄暗く表示されます。マスキングを適用すると、フィルタの適用範囲外にあるすべてのオブジェクトは選択および編集できなくなります。
これらのオプションは自由に組み合わせて有効にできます。たとえば、クエリの適用範囲内にある、フィルタ条件に一致するすべてのオブジェクトを、設計エディタウィンドウ内でズーム表示し、中央に配置して選択すると同時に、マスキングを適用してほかの設計オブジェクトによる表示の煩雑さを抑えることができます。
フィルタの適用と解除
クエリを定義し、パネル内のオプションを必要に応じて設定したら、Applyボタンをクリックするか、Enterを押してフィルタを適用できます。
現在適用されているフィルターをパネル内で解除するには、パネルのクエリ式の入力を消去し、Applyボタンをクリックするか、Enterを押します。設計ワークスペース内のすべてのオブジェクトが完全に表示され、選択や編集が可能になります。
右クリックメニュー
SCH Filterパネル内で右クリックすると、ポップアップメニューから追加のオプションやコマンドにアクセスできます。
このメニューには、次のコマンドがあります。
- Add to Favorites - 現在パネルに表示されているクエリ式を、お気に入りのクエリリストに追加します。クエリは、式マネージャーダイアログのFavoritesタブに新しいエントリとして表示されます。お気に入りのクエリリストに追加したクエリは、右クリックメニューの上部に表示されます。メニューには、お気に入りリストに最近追加した10件のクエリが表示されるため(最新のものが一番上)、お気に入りのクエリ式にすばやくアクセスして再利用できます。
- Organize Favorites - このコマンドを使用すると、式マネージャーダイアログのFavoritesタブにアクセスし、お気に入りのクエリリストのエントリを必要に応じて整理(名前の変更、削除)できます。
- Examples - クリックすると、定義済みのフィルター例のサブメニューにアクセスできます。フィルター例を選択すると、対応するクエリ式がパネル中央の領域に読み込まれます。
- History - クリックすると、パネルのクエリ履歴リストから、最近使用した9件のクエリ式を表示するサブメニューにアクセスできます。Moreエントリをクリックすると、式マネージャーダイアログのHistoryタブにアクセスできます。このタブでは、クエリ履歴の全リストを参照してクエリを適用できるほか、必要に応じて履歴リストを消去できます。
- Show Scope Options - このコマンドを使用すると、パネルのフィルター適用範囲領域の表示を切り替えられます。
- Show Masking Options - このコマンドを使用すると、パネルのフィルターハイライト領域の表示を切り替えられます。
注意事項
全般
- F12キーを押すと、ワークスペース内でのパネルの表示と非表示が切り替わります。
- クエリヘルパーダイアログを使用してクエリを作成する場合、入力済みのキーワード内、または使用可能なリスト内のキーワードをクリックしてF1を押すと、そのキーワードのヘルプが開きます。同様に、SCH Filterパネル中央の領域でキーワード内をクリックし、F1を押しても、キーワード単位のヘルプにアクセスできます。
- パネルの形状とサイズに応じて、内容は横方向または縦方向に動的に配置されます。
クエリ式の作成時
- クエリが正しく解釈されない可能性が少しでもある場合は、括弧を使用することを強くお勧めします。
-
使用可能な各種演算子には優先順位が定義されており、括弧を指定しない場合、ソフトウェアはその優先順位に従ってクエリを解釈します。括弧は、この優先順位の中で最も高い優先度を持ちます。優先順位は次のとおりです。
Brackets
Not
^, *, /, Div, Mod, And
+, -, Or, Xor
=, <>, <, >, <=, >=
&&, ||
この優先順位は、Pascal系言語で使用されるものと似ています。括弧を積極的に使用すると曖昧さがなくなり、他の人にとってもクエリが読みやすくなります。 - 曖昧さがある場合は、左から右に処理して解決されます。
- 括弧は内側から外側へ評価され、同じ階層の括弧は左から右へ処理されます。
- 適用したフィルターに一致するオブジェクトと一致しないオブジェクトでは表示オプションが分かれているため、前回のフィルタリング結果を基に、新しいフィルタークエリを効果的に適用できます。
- SCH Filterパネルのクエリを使用して適用したフィルタリングは、解除するまで維持されます。フィルターに一致しない設計オブジェクトをマスク表示する場合、マスクの強さはパネル下部のスライダーバーで調整します。
- 持続的に適用されるフィルターを解除するには、SCH Filterパネルから空のクエリを適用する必要があります。
SCHLIB Filterパネル
SCHLIB Filterパネルで論理クエリを使用して、回路図ライブラリのオブジェクトをすばやく検索し、ハイライト表示できます。
概要
SCHLIB Filterパネルでは、論理クエリを作成してフィルターを構築できます。定義したフィルターは、アクティブな回路図ライブラリコンポーネント、またはアクティブな回路図ライブラリ内のすべてのコンポーネントに適用できるため、複数のオブジェクトをより正確かつ効率的に選択、編集できます。フィルターの検索条件に一致するオブジェクトと一致しないオブジェクトそれぞれについて、表示方法を指定できます。
パネルへのアクセス
このパネルには、次の方法でアクセスできます。
- ワークスペース右下のPanelsボタンをクリックし、SCHLIB Filterを選択します。
- メインメニューからView » Panels » SCHLIB Filter をクリックします。
- ショートカットキーF12を使用します。
フィルター適用範囲の定義
SCHLIB Filterパネルの左側の領域には、フィルターの適用範囲を定義(制限)するためのコントロールがあります。
適用範囲のオプションは次のとおりです。
- All Objects - すべての設計オブジェクトにフィルターを適用します。
- Selected Objects - 現在選択されている設計オブジェクトにのみフィルターを適用します。
- Non Selected Objects - 現在選択されていない設計オブジェクトにのみフィルターを適用します。
- Whole Library - フィルタリングをアクティブなコンポーネントのみに適用するか(オプション無効)、アクティブな回路図ライブラリドキュメント内のすべてのコンポーネントに適用するか(オプション有効)を制御します。
フィルタークエリの定義
SCHLIB Filterパネル中央の領域では、論理クエリを入力してフィルターを構築できます。
フィールドにクエリを直接入力できます。入力中は、候補となるキーワードのリストが表示され、入力を支援します。
クエリヘルパー
このパネルには、候補リストに加えて、クエリの作成を支援するQuery Helper機能も用意されています。この機能は、クエリの構文や使用できるキーワードがわからない場合に非常に便利です。Query Helperを使用するには、HelperボタンをクリックしてQuery Helperダイアログを開きます。内部のクエリエンジンがドキュメントを解析し、使用可能なすべてのオブジェクトと、クエリで使用できる汎用キーワードを一覧表示します。
ダイアログの上部で、使用可能なSCH FunctionsとSystem Functionsを使用してクエリ式を作成します。ダイアログの中央部には、式の作成に使用できる各種演算子が用意されています。Check Syntaxボタンを使用すると、式の構文が正しいかどうかを検証できます。
目的のクエリ式を定義したら、OKをクリックして、SCHLIB Filterパネルの中央部にクエリを読み込みます。Applyボタンでフィルターを適用します。
ライブラリ全体に適用すると、ほかのすべてのコンポーネントでも、フィルター条件を満たすピンがハイライト表示されます。
フィルターの適用の詳細については、以下のApplying and Clearing a Filterセクションを参照してください。
フィルターのハイライト表示の設定
SCHLIB Filterパネルでクエリを適用する前に、フィルタリングの結果をデザインエディターのワークスペースでどのように表示するかを設定しておくことをお勧めします。パネルの右側には、継続的なフィルタリングのハイライト表示を制御する各種オプションが用意されています。
Objects passing the filterオプションでは、フィルターの対象範囲内にあり、指定したクエリ式に一致するすべてのオブジェクトを、ワークスペースでどのように表示するかを制御できます。
- Select - 有効にすると(デフォルト)、フィルター条件に一致するオブジェクトがワークスペースで選択されます。
- Zoom - 有効にすると(デフォルト)、フィルター条件に一致するオブジェクトがライブラリエディターのウィンドウでズーム表示され、可能な場合は中央に配置されます。ズーム動作は、Preferencesダイアログの回路図 - ライブラリの自動ズームページにあるZoom Library Componentsオプションで設定できます。
一方、Objects not passing the filterオプションでは、フィルターの対象範囲内にdo not、または指定したクエリ式に一致しないすべてのオブジェクトを、ワークスペースでどのように表示するかを制御できます。
- Deselect - 有効にすると(デフォルト)、フィルターの対象範囲外のすべてのオブジェクトがワークスペースで選択解除されます。
- Mask out - 有効にすると(デフォルト)、フィルターの対象範囲外のすべてのオブジェクトがライブラリエディターのウィンドウでマスク表示されます。スライダーでマスクのレベルを設定します。
フィルターの適用と解除
クエリを定義し、パネルのオプションを必要に応じて設定したら、パネルのApplyボタンをクリックするか、Enterを押してフィルターを適用できます。
現在適用されているフィルターをパネル内から解除するには、パネル中央部のクエリ式をクリア(選択して削除)してから、Applyボタンをクリックするか、Enterを押します。デザインワークスペース内のすべてのオブジェクトが通常の表示状態に戻り、選択や編集が可能になります。
パネル中央部にクエリ式を残したままワークスペースのフィルタリングを解除するには、Sch Lib StandardツールバーのClear Current Filter ボタン(
)を使用します(ショートカット:Shift+C)。
右クリックメニュー
SCHLIB Filterパネル内で右クリックすると、ポップアップメニューから追加のオプションやコマンドにアクセスできます。
このメニューには、次のコマンドが用意されています。
- Add to Favorites - パネル中央部に現在表示されているクエリ式を、お気に入りのクエリのリストに追加します。クエリは、式マネージャーダイアログのFavoritesタブに新しい項目として表示されます。お気に入りのクエリのリストに追加すると、そのクエリが右クリックメニューの先頭に表示されます。メニューには、お気に入りリストに最近追加した10件のクエリが表示されます(新しいものが先頭)。これにより、お気に入りのクエリ式にすばやくアクセスして再利用できます。
- Organize Favorites - 式マネージャーダイアログのFavoritesタブを開き、お気に入りのクエリのリストにある項目を整理(名前の変更、削除)できます。
- Examples - クリックすると、定義済みのフィルター例を含むサブメニューが開きます。フィルター例を選択すると、対応するクエリ式がパネル中央部に読み込まれます。
- History - クリックすると、パネルのクエリ履歴リストから最近使用した9件のクエリ式を表示するサブメニューが開きます。More項目をクリックすると、式マネージャーダイアログのHistoryタブが開き、クエリ履歴の全リストからクエリを参照して適用したり、必要に応じて履歴リストをクリアしたりできます。
- Show Scope Options - パネルのフィルター対象範囲領域の表示と非表示を切り替えます。
- Show Masking Options - パネルのフィルターハイライト設定領域の表示と非表示を切り替えます。
注意事項
全般
- F12キーを押すと、ワークスペースでパネルの表示と非表示が切り替わります。
- SCHLIB Filterパネルのクエリによって適用されたフィルタリングは、そのセッション中は維持されます。この継続的なフィルターを解除するには、対応するClear操作(SCHLIB Filterパネルから空のクエリを適用する操作)が必要です。
- SCHLIB Filterパネル自体の形状とサイズに応じて、内容は横方向または縦方向に動的に配置されます。
クエリ式の作成
- クエリが正しく解釈されない可能性が少しでもある場合は、括弧を使用することを強くお勧めします。
-
用意されている各種演算子には優先順位が定義されており、ユーザーが括弧を指定していない場合、ソフトウェアはこの優先順位に従ってクエリを解釈します。括弧は、この中で最も高い優先順位を持ちます。優先順位は次のとおりです。
Brackets
Not
^, *, /, Div, Mod, And
+, -, Or, Xor
=, <>, <, >, <=, >=
&&, ||
この優先順位は、Pascal系言語で使用されるものと似ています。ただし、括弧を十分に使用すれば曖昧さがなくなり、ほかの人にも読みやすいクエリになります。 - 曖昧さがある場合は、左から右へ処理して解決されます。
- 括弧は内側から外側へ評価され、同じ階層では左から右へ評価されます。
PCB Filterパネル

PCB Filterパネル
概要
PCB Filterパネルには、論理クエリを作成してフィルターを構築するためのコントロールが用意されています。定義したフィルターをアクティブなPCBに適用することで、複数のオブジェクトを高い精度で効率よく選択、編集できます。
パネルへのアクセス
PCBエディターから、次のいずれかの方法でパネルにアクセスできます。
- ワークスペース右下のPanels ボタンをクリックし、PCB Filterを選択します。
- メインメニューから View » Panels » PCB Filterをクリックします。
- ショートカットキーF12 を使用します。
パネルの各セクション
PCB Filterパネルは3つの領域で構成されています。最初の2つは項目を選択できるリスト領域で、Object とLayerの組み合わせによってフィルタリングの範囲を定義します。
3つ目の領域である Filterには、現在選択されているオブジェクトとレイヤーに基づいて作成されたクエリが表示されます。
単純なフィルター式の作成
パネルのメイン領域には、任意のオブジェクトの組み合わせを対象とする単純なフィルター式をすばやく作成するためのコントロールが用意されています。オブジェクトの種類は「オブジェクトマトリクス」に配置され、ネットオブジェクト(Net)、コンポーネントオブジェクト(Comp)、フリーオブジェクト(Free)に分類されています。次の基本的なオブジェクトは、これら3つのグループすべてに含まれています。
- トラック
- アーク
- ビア
- パッド
- フィル
- リージョン
Text オブジェクトは、Comp およびFree グループに含まれています。ただし、この種類のオブジェクトはネット情報を持たないため、Net グループには含まれません。また、Free グループには、Component、Component Body、Room、Polygonも含まれています。
たとえば、これらを「Component」と「Top Layer」に設定すると、基板ビューでトップレイヤーのコンポーネントがハイライト表示されます。両方のパネルセクションでの選択には、複数段階のフィルタリングの効果が組み合わされるため、あらゆる種類の設計オブジェクトをすばやくハイライト表示できます。
フィルター式の作成にオブジェクトを使用する、つまりそのオブジェクトでフィルタリングするには、オブジェクトマトリクス内で該当するオブジェクトのチェックボックスをオンにします。この領域の右クリックメニューにあるコマンドを使用すると、マトリクス内のすべての項目をすばやくオンまたはオフにしたり、すべてのチェックボックスの状態を反転したりできます。
パネルのLayer領域を使用すると、フィルターの対象を特定のレイヤー、複数のレイヤー、または特定のレイヤークラスに制限できます。リストには、次の項目が表示されます。
-
基板に定義されているレイヤークラス。デフォルトは次のとおりです。
- <All Layers>
- <Component Layers>
- <Electrical Layers>
- <Signal Layers>
- レイヤースタックに定義されているレイヤー(Layer Stack Editorに表示されるもの)。
- トップおよびボトムのペーストマスクレイヤー。
フィルタリングの条件を選択すると、それに応じたクエリ式が動的に作成され、パネルのFilter 領域に表示されます。フィルターのクエリ式を必要に応じて定義したら、別途適用操作を行う必要があります。適用するには、パネル下部のApply to All ボタンをクリックします。ワークスペースで現在選択されているオブジェクトのみに適用する場合は、Apply to Selectedボタンをクリックします。
オブジェクトによるフィルタリング
パネルのObject リストでの選択により、基板ビューをフィルタリングしてプリミティブ設計オブジェクトを表示します。Object および/またはLayer フィルターリストの設定で変更されない限り、すべてのオブジェクトがハイライト表示されます。

ObjectでComponent BodyとPad (In Any Component) を選択した状態の基板。Layer は<All>に設定されています。

Object をTracks (In Any Net)とPads (In Any Net)に設定した状態の基板。 Layer は<All>に設定されています。
レイヤーによるフィルタリング
パネルのLayer リストでの選択により、基板ビューをフィルタリングして、指定した物理設計レイヤー(信号、マスク、シルクスクリーンレイヤー)上のオブジェクトを表示します。Layer および/またはObjects フィルターリストの設定で変更されない限り、該当するすべてのレイヤーオブジェクトがハイライト表示されます。

Object をComponentsと Pads (In Any Component)に設定した状態の基板。Layers はTop Layerに設定されています。

Object をTracks (In Any Net)に設定した状態の基板。 Layer はBottom Layerに設定されています。
フィルタリングされたオブジェクトの選択
パネルが提供する複合的なフィルタリング機能により、目的の基板設計オブジェクトの表示と選択が容易になります。
選択できるのはハイライト表示された(フィルタリングされた)オブジェクトのみのため、オブジェクトの特定、編集、情報の確認を簡単に行えます。
フィルターの解除
Clear ボタンをクリックすると、現在適用されているフィルターが解除されます。
視覚的なフィルタリングの設定
ワークスペース内のドキュメントに適用したフィルタリングの表示結果は、一連のハイライト表示コントロールによって決まります。エディタービューに適用する効果は、Normal、Mask、またはDimに設定でき、このうちMask が最も明確なハイライト効果をもたらします。
Normal / Mask / Dimドロップダウンリストには、ワークスペース内でフィルター条件に一致するオブジェクトと一致しないオブジェクトを視覚的に区別するためのオプションが用意されています。

マスキングモードのドロップダウンリストで、適用する視覚的なフィルタリングの種類を選択します。
各マスキングモードのハイライト効果は次のとおりです。
- Normal - フィルター条件に一致するオブジェクトがワークスペースに表示され、一致しないオブジェクトの外観は変わりません。
- Mask - フィルター条件に一致するオブジェクトがワークスペース内でハイライト表示され、それ以外のすべてのオブジェクトはモノクロ表示になります。
- Dim - フィルター条件に一致するオブジェクトがワークスペース内でハイライト表示され、 それ以外のすべてのオブジェクトは元の色を保ったまま 暗く表示されます。
フィルタークエリの定義
パネルの中央領域には、 論理クエリを入力してフィルターを作成するためのコントロールが用意されています。
フィールドにクエリを直接入力できます。入力中は、入力を補助するキーワード候補のリストが表示されます。
クエリの作成を支援する機能として、クエリヘルパーとクエリビルダーの2つが用意されています。これらの機能は、クエリの構文や使用できるキーワードがわからない場合に非常に便利です。
クエリヘルパー
クエリヘルパーを使用するには、Helperボタンをクリックしてクエリヘルパーダイアログを開きます。内部のクエリエンジンがドキュメントを解析し、使用可能なすべてのオブジェクトを、 クエリで使用する汎用キーワードとともに一覧表示します。
ダイアログの上部で、使用可能なPCB Functions、PCB Object Lists、System Functionsを使用して クエリ式を作成します。ダイアログの中央領域には、 式の作成に使用する各種演算子が用意されています。Check Syntaxボタンを使用して、式の構文が正しいことを確認します。
必要なクエリ式を定義したら、 OKをクリックしてパネルの中央領域にクエリを読み込み、フィルターを適用できる状態にします。
クエリビルダー
クエリビルダーを使用するには、パネルのBuilderボタンをクリックして基板からのクエリ作成ダイアログを開きます。このダイアログでは、ANDやORで結合した一連の条件を構築することで、 設計ドキュメント内の特定のオブジェクトを対象とするクエリを作成できます。ダイアログの左側で、 必要なオブジェクト群を対象にするための条件を 指定します。初期状態では、Condition Type/Operator列の項目はAdd first conditionになっています。この項目を1回クリックすると、条件タイプのドロップダウンリストが表示されます。
リストには、 基板設計に関連する条件タイプのみが表示されます。
目的の条件を選択し、Condition Value列をクリックすると、その条件タイプで選択可能な値のドロップダウンリストが表示されます。ダイアログの左側で条件を定義すると、右側に作成中のクエリのプレビューが表示されます。
必要に応じて条件を追加し、対象となる設計オブジェクトの集合を絞り込みます。条件はANDまたはORで結合できます。デフォルトの論理演算子はANDで、条件を追加すると自動的に挿入されます。
条件間の論理演算子を変更するには、Condition Type/Operator列のANDまたはORの項目をクリックし、必要な演算子を選択します。それに応じてクエリのプレビューが更新されます。
優先順位の指定
基板からのクエリ作成ダイアログの上部にある
ボタンと
ボタンを使用すると、現在選択している条件を囲む括弧を追加または削除できます(インデントを増減できます)。これにより、論理ANDまたは論理ORで結合された特定の条件に優先順位を設定できます。
たとえば、次のように作成したクエリを考えてみます。
InNet('5V') AND (OnLayer('TopLayer')
最初の条件では、条件タイプをBelongs to Net、 値を16M_INに設定しています。次に、条件タイプをExists on Layer、 値をTopLayerとして、別の条件を追加しています。
この段階で、ダイアログ内の2番目の条件を選択した状態で右矢印ボタンをクリックします。2番目の条件を囲む括弧が自動的に追加され、 その括弧内に条件を追加できるようになります。
続いて、条件タイプがObject Kind is、値がトラックの3番目の条件を括弧内に追加します。
ダイアログの左上にあるShow Levelドロップダウンを使用して、階層化された条件式のレベルの表示を制御します。これは実質的に、括弧の表示を展開または折りたたむ操作です。括弧を追加すると、新しいレベルが作成されます。レベル1~5を表示できますが、それより深いレベルを追加した場合は、Show All Levelsオプションを使用します。
または、括弧で囲まれた条件に対応する展開記号 または折りたたみ記号 をクリックすると、それぞれ下位のレベルを表示するか、現在のレベルとその下のすべてのレベルを非表示にできます。ダイアログ上部の
ボタンと
ボタンを使用して、現在選択している条件を展開または折りたたむこともできます。
ダイアログ上部の
ボタンと
ボタンを使用して、クエリ式内の選択した条件を移動します。サブレベルを持つ条件(括弧で囲まれた条件)の場合、その階層構造内のどの条件でも移動できます。レベルが展開されている場合は、レベル間を上下に条件を移動できます。レベルが折りたたまれている場合は、折りたたまれた階層構造をひとまとまりとして、その前後に条件を移動します。
条件を削除するには、その条件を選択し、ダイアログ上部の
ボタンをクリックするか、 Deleteキーを使用します。
必要なクエリ式を定義したら、 OKをクリックしてPCB Filterパネルの中央領域にクエリを読み込み、フィルターを適用できる状態にします。
デザインルールの作成
PCB Filterパネルには、パネルの中央領域で現在定義されているクエリ式を適用範囲とするデザインルールを作成する機能も用意されています。
新しいデザインルールを追加するには、PCB FilterパネルのCreate Ruleボタンをクリックします。Choose Design Rule Typeダイアログが開きます。
このダイアログには、PCBドキュメントで使用できる各ルールカテゴリとルールタイプが一覧表示されます。作成するルールのタイプを選択し、OKをクリックします(または項目を直接ダブルクリックします)。PCBルールと制約エディターダイアログが開きます。
左側のナビゲーションツリーでは、新しく作成したルール名が選択された状態で表示されます。ルールのクエリ式は、ダイアログの右上のペインに表示されます。
選択したタイプのルールが作成され、ルールのメイン編集ウィンドウが表示されます。ここで、ルールの具体的な制約を定義できます。PCB Filterパネルのクエリ式は、ダイアログの「Full Query」領域に入力されます。必要に応じてルールの設定を調整し、新しいルールを適用してください。
フィルターの適用と解除
クエリを定義し、パネルのオプションを必要に応じて設定したら、パネルのApplyボタンのいずれかをクリックするか、Enterをクリックしてフィルターを適用できます。
パネル内で現在適用されているフィルターを解除するには、パネル中央の領域にあるクエリ式を消去(選択して削除)し、Applyボタンのいずれかをクリックするか、Enterを押します。設計ワークスペース内のすべてのオブジェクトが通常の表示に戻り、選択や編集が可能になります。
右クリックメニュー
PCB Filterパネル内で右クリックすると、ポップアップメニューから追加のオプションやコマンドにアクセスできます。
パネルのObject またはLayer領域で右クリックすると、以下のコンテキストメニューオプションが表示されます。
- Toggle Check - オプションの選択状態を切り替えます。現在選択されているオプションは選択が解除され、選択されていないオプションは選択されます。
- Check All - 使用可能なすべてのオプションを選択します。
- Uncheck All - 使用可能なすべてのオプションの選択を解除します。
注意事項
全般
- F12キーを押すと、ワークスペース内のパネルの表示と非表示が切り替わります。
- Query Builder(基板からクエリを作成ダイアログ)では、状況に応じた条件タイプと値を使用し、関連する「構成要素」だけを組み合わせて、簡単にクエリを作成できます。キーワードの完全な指定や演算子の構文を使用して高度なクエリを作成するには、クエリヘルパーダイアログを使用してください。
- 適用したフィルターの条件を満たすオブジェクトと満たさないオブジェクトでは表示オプションが分かれているため、前回のフィルタリング結果に新しいフィルタークエリを適用して、さらに絞り込むことができます。
クエリ式を作成する際の注意事項
-
クエリが正しく解釈されない可能性が少しでもある場合は、括弧を使用することを強くお勧めします。
-
用意されている各種演算子には優先順位が定義されており、ユーザーが括弧を指定していない場合、ソフトウェアはこの優先順位に従ってクエリを解釈します。括弧は、この中で最も優先順位が高くなります。優先順位は次のとおりです。
Brackets
Not
^, *, /, Div, Mod, And
+, -, Or, Xor
=, <>, <, >, <=, >=
&&, ||
この優先順位は、Pascal系言語で使用されるものと似ています。ただし、括弧を積極的に使用すれば曖昧さがなくなり、ほかの人にとってもクエリが読みやすくなります。 -
曖昧さがある場合は、左から右の順に処理されます。
-
括弧は内側から外側の順に評価され、同じ階層では左から右の順に評価されます。
PCBLIB Filterパネル
概要
PCBLIB Filterパネルには、論理クエリを作成してフィルターを構築するためのコントロールが用意されています。定義したフィルターは、アクティブなPCBコンポーネントのフットプリント、またはアクティブなPCBライブラリ内のすべてのコンポーネントのフットプリントに適用でき、複数のオブジェクトを高い精度で効率よく選択、編集できます。
パネルへのアクセス
PCBライブラリエディターから、以下の方法でパネルにアクセスできます。
- ワークスペース右下のPanels ボタンをクリックし、PCBLIB Filter項目を選択します。
- メインメニューからView » Panels » PCBLIB Filterをクリックします。
- F12ショートカットキーを使用します。
パネルのセクション
PCBLIB Filterパネルは3つの領域で構成されています。最初の2つは、フィルタリングの範囲を組み合わせて定義する選択可能なリスト領域で、Object とLayerです。3つ目の領域であるFilterには、現在選択されているオブジェクトとレイヤーに基づいて作成されたクエリが表示されます。
シンプルなフィルター式の作成
パネルのメイン領域には、任意のオブジェクトの組み合わせを対象とするシンプルなフィルター式をすばやく作成するためのコントロールが用意されています。オブジェクトタイプは「オブジェクトマトリクス」に配置され、ネットオブジェクト(Net)、コンポーネントオブジェクト(Comp)、フリーオブジェクト(Free)に分類されています。以下の基本的なオブジェクトのリストが、これら3つのグループそれぞれに用意されています。
- トラック
- アーク
- ビア
- パッド
- フィル
- リージョン
Text オブジェクトは、Comp およびFree グループに含まれます。ただし、このオブジェクトタイプはネット情報を持たないため、Net グループには含まれません。また、Free グループには、Component、ComponentBody、Room、Polygonも含まれます。
たとえば、これらを「Components」と「Top Layer」に設定すると、基板ビューでトップレイヤーのコンポーネントがハイライト表示されます。両方のパネルセクションでの選択は、複数段階のフィルタリングを組み合わせた結果を表しており、あらゆるタイプの設計オブジェクトをすばやくハイライト表示できます。
フィルター式の作成にオブジェクトを使用する、つまりそのオブジェクトでフィルタリングするには、オブジェクトマトリクス内で、そのオブジェクトに対応するチェックボックスをオンにします。この領域の右クリックコンテキストメニューには、マトリクス内のすべての項目をすばやくオンまたはオフにするコマンドと、すべてのチェックボックスの状態を切り替えるコマンドが用意されています。
Layer領域を使用すると、フィルターの対象を特定のレイヤー、複数のレイヤー、または特定のレイヤークラスに限定できます。一覧には、以下が表示されます。
-
基板に定義されているレイヤークラス。デフォルトは次のとおりです。
- <All Layers>
- <Component Layers>
- <Electrical Layers>
- <Signal Layers>
- レイヤースタックに定義されているレイヤー(レイヤースタックに表示されるもの)。
- トップおよびボトムのペーストマスクレイヤー。
フィルタリング条件を選択すると、クエリ式が動的に構築され、パネルの Filter 領域に表示されます。フィルターのクエリ式を必要に応じて定義したら、別途操作して適用する必要があります。適用するには、パネル下部の Apply to All ボタンをクリックします。ワークスペースで現在選択されているオブジェクトにのみ適用する場合は、Apply to Selected ボタンを使用します。
フィルタリングの適用
PCBライブラリのコンポーネントは、さまざまな基板レイヤーに配置されたプリミティブオブジェクト(アーク、パッド、トラックなど)で構成されています。オブジェクトには、「フリー」のものと、グループオブジェクトに「所有」されているものがあります。Object 領域で Free を選択すると、グループオブジェクトに属していないオブジェクトのみがハイライト表示されることに注意してください。
オブジェクトによるフィルタリング
パネルの Object リストで選択すると、基板ビューがフィルタリングされ、プリミティブ設計オブジェクトが表示されます。Layer フィルターリストの設定で変更しない限り、すべてのオブジェクトがハイライト表示されます。

Object で Track と Arc を選択した基板の例。Layer は Top Overlay に設定されています。
レイヤーによるフィルタリング
パネルの Layers リストで選択すると、基板ビューがフィルタリングされ、指定した物理設計レイヤー(信号、マスク、シルクスクリーンの各レイヤー)上のオブジェクトが表示されます。Object フィルターリストの設定で変更しない限り、該当するレイヤー上のすべてのオブジェクトがハイライト表示されます。

Object を Pad. Layer に設定した基板の例。Top Layer に設定されています。
フィルタリングされたオブジェクトの選択
PCBLIB Filter パネルの一括フィルタリング機能は、目的の基板設計オブジェクトの表示と選択の両方に役立ちます。
ハイライト表示された(フィルタリングされた)オブジェクトのみが選択可能になるため、オブジェクトの特定、編集、情報の確認が容易になります。
フィルターの解除
パネルの Clear ボタンで、現在適用されているフィルターを解除します。
フィルタリングの表示設定
ワークスペース内のドキュメントに適用されたフィルタリングの表示結果は、一連のハイライト表示コントロールによって決まります。エディタービューに適用する効果は、Normal、Mask、または Dim に設定できます。実際には、Mask が最も明確なハイライト効果をもたらします。
Normal / Mask / Dim ドロップダウンリストには、ワークスペース内でフィルタリングされたオブジェクトと、それ以外のオブジェクトを視覚的に区別するためのオプションがあります。

マスクモードのドロップダウンリストで、適用する表示フィルタリングの種類を選択します。
各マスクモードのハイライト表示効果:
- Normal - フィルタリングされたオブジェクトはワークスペースに表示され、それ以外のオブジェクトの表示は変わりません。
- Mask - フィルタリングされたオブジェクトはワークスペースでハイライト表示され、それ以外のすべてのオブジェクトはモノクロ表示になります。
- Dim - フィルタリングされたオブジェクトはワークスペースでハイライト表示され、それ以外のすべてのオブジェクトは色を維持したまま暗く表示されます。
フィルタークエリの定義
パネルの中央領域では、論理クエリを入力してフィルターを構築できます。
フィールドにクエリを直接入力できます。入力中は、候補となるキーワードのリストが入力支援として表示されます。
クエリの作成を支援する機能として、Query HelperとQuery Builderの2つが用意されています。クエリの構文や、使用できるキーワードがわからない場合に、これらの機能が非常に役立ちます。
Query Helper
Query Helperを使用するには、Helper ボタンをクリックして Query Helper ダイアログを開きます。内部のクエリエンジンがドキュメントを解析し、利用可能なすべてのオブジェクトと、クエリで使用する汎用キーワードを一覧表示します。
ダイアログ上部で、使用可能な PCB Functions、PCB Object Lists、System Functions を使ってクエリ式を作成します。ダイアログの中央領域には、式の構築に使用できるさまざまな演算子が用意されています。Check Syntax ボタンを使用すると、式の構文が正しいかどうかを確認できます。
クエリ式を必要に応じて定義したら、OK をクリックします。クエリが PCBLIB Filter パネルの中央領域に読み込まれ、フィルターを適用できる状態になります。
Query Builder
Query Builderを使用するには、PCBLIB Filter パネルの Builder ボタンをクリックして、Building Query from Board ダイアログを開きます。
このダイアログでは、ANDやORで結合した一連の条件を簡単に組み立てることで、設計ドキュメント内の特定のオブジェクトを対象とするクエリを作成できます。
ダイアログの左側で、必要なオブジェクト群を対象とするための条件を指定します。初期状態では、Condition Type/Operator 列の項目は Add first condition になっています。この項目を1回クリックすると、条件の種類のドロップダウンリストが開きます。
表示される条件の種類は、基板設計に関連するもののみです。
条件を選択し、Condition Value 列をクリックすると、その条件の種類で指定可能な値のドロップダウンリストが表示されます。ダイアログの左側で条件を定義すると、右側に現在構築されているクエリのプレビューが表示されます。
必要に応じて条件を追加し、対象となる設計オブジェクト群を絞り込みます。条件はANDまたはORで結合できます。既定の論理演算子はANDで、条件を追加すると自動的に挿入されます。
条件間の論理演算子を変更するには、Condition Type/Operator 列のANDまたはORをクリックし、必要な演算子を選択します。それに応じてクエリのプレビューが更新されます。
優先順位の指定
Building Query from Board ダイアログの上部にある
ボタンと
ボタンを使用すると、現在選択されている条件を囲む括弧を追加または削除できます(インデントの増減)。これにより、論理ANDまたは論理ORで結合された特定の条件に優先順位を設定できます。
最初の条件は、条件タイプを Exists on Layer、値を Top Layer に設定しています。次に、条件タイプを Object Kind is、値を Arc とする別の条件を追加しています。
この段階で、ダイアログ内の2番目の条件を選択した状態で右矢印ボタンをクリックしています。2番目の条件を囲む括弧が自動的に追加され、この括弧のペア内に条件を追加できるようになります。
次に、条件タイプが In Any Polygon の3番目の条件を括弧内に追加します。
ダイアログ左上の Show All Levels ドロップダウンを使用して、構造化された条件文字列の階層表示を制御します。これは実質的に、括弧の表示を展開または折りたたむ操作です。括弧を追加すると、新しい階層が作成されます。レベル1~5を表示できますが、それより深い階層を追加した場合は Show All Levels オプションを使用してください。
または、括弧で囲まれた条件に付いている展開記号または折りたたみ記号をクリックすると、それぞれ次の階層を表示するか、現在の階層とその下のすべての階層を非表示にできます。ダイアログ上部の
ボタンと
ボタンでも、現在選択されている条件を展開または折りたたむことができます。
ダイアログ上部の
ボタンと
ボタンを使用して、作成中のクエリ文字列内で選択した条件を移動します。下位階層を持つ条件(括弧で囲まれた条件)の場合、階層構造内のどの条件でも移動できます。階層が展開されている場合は、条件を階層間で上下に移動できます。階層が折りたたまれている場合は、その階層構造をひとまとまりとして飛び越える形で条件が移動します。
条件を削除するには、条件を選択し、ダイアログ上部の
ボタンをクリックするか、Delete キーを押します。
クエリ式を要件どおりに定義したら、OK をクリックして PCBLIB Filter パネルの中央領域にクエリを読み込み、フィルターを適用できる状態にします。
デザインルールの作成
PCBLIB Filter パネルには、デザインルールを作成する機能もあります。ルールの適用範囲には、パネルの中央領域で現在定義されているクエリ式が使用されます。
新しいデザインルールを追加するには、PCBLIB Filter パネルの Create Rule ボタンをクリックします。Choose Design Rule Type ダイアログが開きます。
このダイアログには、PCBドキュメントで使用できるルールカテゴリとルールタイプがすべて一覧表示されます。作成するルールのタイプを選択して OK をクリックします(または項目を直接ダブルクリックします)。PCBルールと制約エディター ダイアログが開きます。
左側のナビゲーションツリーで、新しく作成されたルール名が選択されています。ルールのクエリ式は、ダイアログの右上のペインに表示されます。
選択したタイプのルールが作成され、ルールのメイン編集ウィンドウが表示されます。ここで、ルールの具体的な制約を定義できます。PCBLIB Filter パネルのクエリ式は、ダイアログの「Full Query」領域に入力されます。必要に応じてルールの設定を調整し、新しいルールを適用してください。
フィルターの適用と解除
クエリを定義し、パネル内のオプションを必要に応じて設定したら、パネルの Apply ボタンをクリックするか、Enter を押すことでフィルターを適用できます。
現在適用されているフィルターをパネル内から解除するには、パネル中央領域のクエリ式を消去(選択して削除)してから、Apply ボタンをクリックするか、Enter を押します。設計ワークスペース内のすべてのオブジェクトが通常の表示に戻り、選択や編集ができるようになります。
右クリックメニュー
PCBLIB Filter パネル内を右クリックすると、ポップアップメニューから追加のオプションやコマンドにアクセスできます。
パネルの Object または Layer 領域を右クリックすると、次のコンテキストメニューオプションが表示されます。
- Toggle Check - オプションの選択状態を切り替えます。現在選択されているオプションは選択解除され、選択されていないオプションは選択されます。
- Check All - 使用可能なすべてのオプションを選択します。
- Uncheck All - 使用可能なすべてのオプションの選択を解除します。
注意事項
全般
- F12 キーを押すと、ワークスペース内のパネルの表示と非表示が切り替わります。
- Query Builder(基板からクエリを作成 ダイアログ)では、状況に応じた条件タイプと値を使用して、簡単にクエリを作成できます。関連する「構成要素」のみを使用して作成できる仕組みになっています。キーワードの完全な指定や演算子構文を使用して高度なクエリを作成する場合は、クエリヘルパー ダイアログを使用してください。
- 適用したフィルターの条件を満たすオブジェクトと満たさないオブジェクトの表示オプションは個別に設定できるため、前回のフィルタリング結果を基に、新しいフィルタークエリを適用してさらに絞り込むことができます。
クエリ式の作成時
- クエリが正しく解釈されない可能性が少しでもある場合は、括弧を使用することを強くお勧めします。
-
用意されている各種演算子には優先順位が定義されており、ユーザーが括弧を指定していない場合、ソフトウェアはこの優先順位に従ってクエリを解釈します。括弧の優先順位は最も高くなっています。優先順位は次のとおりです。
Brackets
Not
^, *, /, Div, Mod, And
+, -, Or, Xor
=, <>, <, >, <=, >=
&&, ||
この優先順位は、Pascal系言語で使用されるものと似ています。ただし、括弧を積極的に使用すると曖昧さがなくなり、他の人にとっても読みやすいクエリになります。 - 曖昧さがある場合は、左から右の順に処理されます。
- 括弧は内側から外側へ評価され、同じ階層では左から右へ評価されます。
クエリ結果はどこにありますか?
Filter パネルでクエリを作成したら、そのクエリで返されたオブジェクトにはどのようにアクセスすればよいでしょうか。Altium Designer環境では、2つの方法でオブジェクトにアクセスして編集できます。
-
グラフィカルに操作する方法 - フィルターを適用すると、デフォルトではクエリの条件を満たさなかったすべてのオブジェクトがマスクされ(薄く表示され、編集不可になります)、条件を満たしたオブジェクトだけが残ります。このモードは、ワークスペース内でオブジェクトを見つけて確認するのに最適です。マスクされたオブジェクトは編集できないため、Ctrl+A(すべて選択)などのコマンドは、クエリで返されたオブジェクトにのみ適用されます。
-
List パネル - List パネル(Shift+F12)は、設計データをスプレッドシート形式で表示するビューです。デフォルトではすべての設計オブジェクトが表示されますが、フィルターを適用すると、クエリによって返されたオブジェクトのみが表示されます。List パネルには、並べ替えや選択など、一般的なスプレッドシートと同様の機能があり、単一または複数のセルを直接編集できます。
PCB ListパネルとSCH List パネルには、前のセクションのPSB/SCHクエリの結果が表示されます。
ハイライト表示オプション
クエリが適用されると(または別の方法でデータフィルタリング機能が使用されると)、対象ドキュメント内の各オブジェクトについて、そのフィルタリング操作の結果に含まれるかどうかが決まります。ただし、結果に含まれるオブジェクトと含まれないオブジェクトがその後どのように表示されるかは、Filter パネルで選択したハイライト表示オプションによって異なります。ハイライト表示オプションは3種類あり、それぞれ完全に独立しているため、1つ、2つ、またはすべてを選択できます。
ズーム
クエリの適用時にZoom オプションが有効になっていると、対象ドキュメントのビューが更新され、結果に含まれるすべてのオブジェクトが収まる領域が表示されます。残りの各オブジェクトが更新後のビューに表示されるかどうかは、その領域に対する位置によって決まるため、全体が表示される場合も、一部のみが表示される場合も、まったく表示されない場合もあります。
このオプションは、他の一方または両方のオプションと組み合わせて選択されることがよくあります。Mask オプションが有効になっていない場合、結果に含まれないオブジェクトも、更新後の表示範囲内にあればグラフィカルビューに引き続き表示されます。一見すると、このオプションだけを選択しても意味がないように思えるかもしれません。しかし、ドキュメント内のどのオブジェクトについても選択状態やマスク状態を変更せずに、特定のオブジェクトが収まるようにグラフィカルビューを更新したい場合に役立ちます。
選択
Select オプションが有効になっていると、結果に含まれるすべてのオブジェクトが選択状態になり、残りのすべてのオブジェクトは非選択状態になります。選択されたオブジェクトは、選択されていないオブジェクトよりも目立つように表示されます。
現在のクエリを適用するときにSelectオプションが選択されていると、結果セットに含まれるすべてのオブジェクトが選択状態になり、残りのすべてのオブジェクト(結果セットに含まれないオブジェクト)は非選択状態になります。このオプションは通常、一括編集操作の直前に選択します。その時点で選択されているオブジェクトのプロパティだけが更新されるためです。また、特定のオブジェクトを移動、コピー、削除する場合などにも、Selectオプションが役立ちます。
マスク
Mask ハイライト表示オプションは、対象ドキュメント内のオブジェクトのマスク属性を更新します。選択すると、結果に含まれるすべてのオブジェクトがマスクされ、残りのすべてのオブジェクトはマスク解除されます。マスクされたオブジェクトの主な特徴は、オブジェクト自体とそのプロパティを編集できないことです。(マスクされたオブジェクトはリストビューでは淡色で表示されますが、List パネルでall objects オプションが選択されていない場合は、リストビューに表示されません。)マスクされたオブジェクトの主な特徴は、オブジェクト自体とそのプロパティを編集できないことです。
クエリビルダー
PCBエディターには、専用のQuery Builderダイアログが用意されています。このダイアログでは、ドロップダウンリストから判定条件を選択して、複雑なクエリを作成できます。Query Builder の利点は、異なる種類のオブジェクトを対象とするクエリを作成できることです。
「Building Query」ダイアログ(「Query Builder」機能の一部)は、クエリの指定に不慣れなユーザーを支援します。設計者が指定した条件に対応する内容のクエリが自動的に生成されます。
このダイアログの左側には、生成されるクエリでドキュメント内の各オブジェクトが返されるために必要なプロパティを、設計者が指定できるようにするコントロールがあります。各条件を指定または編集するたびに、対応するクエリの内容が更新され、ダイアログの右側に表示されます。その後、OK(またはApply)ボタンをクリックしてダイアログを閉じると、対応するクエリが適用されるか、その内容がFilterパネルにコピーされます(どちらの動作になるかは、最初にこのダイアログを開いた方法によって異なります)。
Query Builderダイアログは、次の場所から開くことができます(下図参照)。
- PCB FilterパネルでQuery Builder ボタンをクリックすると、クエリを作成し、その文字列をパネルに読み込むことができます。
- PCB Rules and Constraints EditorダイアログでBuilder ボタンをクリックすると、このルールを適用するオブジェクトを定義するクエリを作成できます。
下図は、Query Builderダイアログを使用して、5Vネット上のパッドとビアの両方を対象とするクエリを作成している例です。

Query Builderダイアログ
Query Builderダイアログのオプションとコントロール
-
Show All Levels - ドロップダウンを使用して、構造化された条件文字列の階層の表示を制御します。基本的には、括弧の表示を展開または折りたたみます。括弧を追加すると新しい階層が作成され、レベル1~5を表示できます。また、展開(
)または折りたたみ(
)記号をクリックして、それぞれ次の階層を表示するか、現在の階層(およびその下のすべての階層)を非表示にすることもできます。
-
- 現在選択されている条件を囲む括弧を削除します(インデントを減らします)。これにより、論理ANDまたは論理ORで結合された特定の条件に優先順位を設定できます。
-
- 現在選択されている条件を括弧で囲みます(インデントを増やします)。これにより、論理ANDまたは論理ORで結合された特定の条件に優先順位を設定できます。
-
- 作成中のクエリ文字列内で、選択した条件を上に移動します。下位階層を持つ条件(括弧で囲まれた条件)の場合、階層構造内のどの条件でも移動できます。階層が展開されている場合は、階層内をたどって条件を上に移動できます。階層が折りたたまれている場合は、その階層構造をひとまとまりとして越える形で条件が移動します。
-
- 作成中のクエリ文字列内で、選択した条件を下に移動します。下位階層を持つ条件(括弧で囲まれた条件)の場合、階層構造内のどの条件でも移動できます。階層が展開されている場合は、階層内をたどって条件を下に移動できます。階層が折りたたまれている場合は、その階層構造をひとまとまりとして越える形で条件が移動します。
-
- 記号を展開して、次の階層を表示します。
-
- シンボルを折りたたみ、現在の階層(およびそれ以下のすべての階層)を非表示にします。
-
- 選択した条件を削除します。
- Condition Type/Operator - この領域では、必要なオブジェクト群を対象とするための条件を指定します。初期状態では、Condition Type/Operator 列の項目は Add first condition になっています。この項目を1回クリックすると、条件タイプのドロップダウンリストが開きます。リストの内容は、ダイアログを開いた場所によって変わります。PCB Rules And Constraints Editor ダイアログで特定のデザインルール用のクエリを作成している場合、条件リストには、そのルールタイプで使用できる条件タイプだけが表示されます。
- Condition Value - 最初の条件を選択し、Condition Value 列をクリックすると、その条件タイプで指定できる値のドロップダウンリストが表示されます。条件を定義すると、現在作成中のクエリのプレビューが Query Preview 領域に表示されます。
クエリヘルパー
クエリ作成のスキルを高める次のステップは、Query Helper ダイアログを使用することです。Query Helper ダイアログには、目的のクエリを入力できる Query ボックスがあります。また、Query フィールドの下にある構文ボタン(And、Or、<、Not、 Like など)や、Categories フィールドに表示されるすべてのクエリキーワードの一覧も使用できます。
「クエリヘルパー」ダイアログは、独自のクエリを指定したい設計者を支援します。一覧の各キーワードには簡単な説明が用意されていますが、キーワードをハイライトした状態で F1 キーを押すと、オンラインヘルプにアクセスできます。これにより Altium Designer ドキュメントライブラリのダイアログが開き、ハイライトしたキーワードによってドキュメント内のどのオブジェクトが返されるか、そのキーワードの使用方法、および1つ以上の使用例を確認できます。
このダイアログには、次の方法でアクセスできます。
- Filter パネルの Helper ボタンをクリックします。
PCB Filter パネルへのアクセス
SCH Filter パネルへのアクセス
-
ファイルベースのライブラリ検索ダイアログ(Components パネルの右上隅にある
をクリックし、ドロップダウンメニューから File-based Libraries Search を選択してアクセス)で、Helper ボタンをクリックします。
File-based Libraries Search ダイアログへのアクセス
ダイアログ上部の Query セクションでは、使用可能な関数を使ってクエリ式を作成します。テキストボックスでは、検索式を確認したり、さらに編集したりできます。検索式を編集するには、テキストボックスに直接入力します。追加する特定のキーワードを検索するには、入力を開始します。入力中は、それまでに入力したテキストに一致する使用可能なキーワードがドロップダウンメニューに表示されます。キーワードをクリックすると、選択したキーワードが自動補完されます。目的のキーワードがハイライトされている場合は、Enter を押しても自動補完できます。
使用可能なキーワードの Categories から、目的のキーワードを探します。正確なキーワードがわからない場合は、Mask フィールドを使用します。たとえば、回路図エディターの Query Helper で、Mask フィールドに *har と入力すると、下の画像のように、ハーネスに特に適用されるキーワードが見つかります。Mask フィールドは、キーワードの Name フィールドと Description フィールドの両方を検索するため、候補となるキーワードを見つける最も手早い方法になる場合があります。
グリッド内のキーワードをダブルクリックすると、クエリの現在のカーソル位置に追加されます。
ダイアログ中央の領域には、式の作成時に使用できるさまざまな演算子の構文ボタンがあります。各構文ボタンの機能の詳細については、後述の 論理クエリ式の演算子 セクションを参照してください。式の構文が正しいことを確認するには、Check Syntax ボタン(ダイアログの左下)を使用します。
クエリ履歴
フィルターパネル(SCH Filter / SCHLIB Filter、PCB Filter / PCBLIB Filter)で新しいクエリを入力して適用すると、クエリ履歴リストに追加されます。このリストにアクセスするには、パネルの History ボタンをクリックします。History タブがアクティブになった状態で Expression Manager ダイアログが開きます。
Expression Manager ダイアログの 履歴 タブには、過去に使用したクエリ式の一覧が表示されます。ここでは、回路図のクエリ履歴の例を示しています。画像にマウスを合わせると、PCB の同様のリスト例が表示されます。
リスト内のクエリ履歴を使用するには、その項目を選択して Apply Expression ボタンをクリックするか、項目を直接ダブルクリックします。ダイアログが閉じ、そのクエリ式が該当するフィルターパネルの中央領域に読み込まれます。
クエリ履歴の項目を選択して Add To Favorites ボタンをクリックすると、お気に入りのクエリのリストに追加できます。履歴リストを消去するには、Clear History ボタンを使用します。
リスト内の最近使用したクエリ式は、最大9件まで、フィルターパネルの右クリックメニューの History サブメニューから使用できます。
お気に入りのクエリ
定義したクエリは、次の2つの方法でお気に入りのクエリリストに追加できます。
- Add To Favorites ボタンをクリックするか、メインの Query Expression 領域内で右クリックし、コンテキストメニューから Add to Favorites コマンドを選択すると、アクティブなフィルターパネルの中央領域に現在定義されているクエリ式が追加されます。
- Expression Manager ダイアログの History タブで履歴内のクエリエントリを選択し、Add To Favorites ボタンをクリックします。
お気に入りのクエリ式は、Expression Manager ダイアログの Favorites タブに保存され、そこで管理できます。このダイアログには、フィルターパネル(SCH Filter / SCHLIB Filter、PCB Filter / PCBLIB Filter)の Favorites ボタンを使用するか、フィルターパネルのメインの Query Expression 領域内で右クリックして、コンテキストメニューから Organize Favorites コマンドを選択することでアクセスできます。設計スペースからは、ショートカットキー Y を使用し、フィルタリングのポップアップメニューから Organize Favorites を選択してアクセスできます。
エディターのフィルターパネルから、または設計スペースのフィルタリングポップアップメニューを使用して、お気に入りのクエリ一覧にアクセスできます。
クエリ式を Favorites リストに追加すると、一意の名前が割り当てられます。デフォルトでは、汎用的な名前 Favorite_n が割り当てられます。ここで、n は次に使用可能な未使用の番号です。エントリの名前は、次のいずれかの方法でいつでも変更できます。
- クエリエントリを選択し、Rename ボタンをクリックします。
- クエリエントリを選択し、右クリックメニューから 編集 コマンドを選択します。
- クエリエントリを選択し、Name フィールド内をもう一度クリックします。
いずれの場合も、必要な新しい名前を入力し、Name フィールドの外側をクリックして変更を確定します。
お気に入りのクエリ式を編集するには、リスト内のエントリを選択し、Edit ボタンをクリックします(または右クリックして、コンテキストメニューから Edit を選択します)。Edit Favorite ダイアログが開きます。このダイアログで、お気に入りの名前や式自体を変更したり、設計オブジェクト(フィルター条件を満たすものと満たさないものの両方)の扱いを指定したりできます。
Edit Favorite ダイアログを使用して、既存のお気に入りのクエリを変更します。左は回路図用、右はPCB用のダイアログです。
Favorites リストからクエリを削除するには、リスト内のエントリを選択し、Remove ボタンをクリックするか、右クリックメニューから Remove コマンドを選択します。削除の確認を求めるダイアログが表示されます。
お気に入りのクエリの使用
お気に入りのクエリは、次の3つの方法で使用できます。
-
Expression Manager ダイアログの Favorites タブから使用する場合は、エントリを選択して Apply Expression ボタンをクリックするか、エントリをダブルクリックします。ダイアログが閉じ、該当するフィルターパネルの中央領域にクエリ式が読み込まれます。
-
フィルターパネルの右クリックメニューの上部から使用できます(Favorites リストに最近追加されたクエリ式が最大10件表示されます)。
-
設計スペースのフィルタリングポップアップメニュー(Y を押す)から使用できます。メニューの上部に、お気に入りのクエリ式が最大10件表示されます。選択したクエリ式が、該当するフィルターパネルの中央領域に読み込まれます。
付属のサンプルの使用
回路図エディターとPCBエディターには、サンプルクエリがあらかじめ用意されています。これらのサンプルは、フィルタリングメニューから利用できます。このメニューには、フィルターパネルの式の領域内で右クリックするか、設計スペースでショートカットキー Y を使用してアクセスします。Examples にマウスポインターを合わせると、サブメニューが表示されます。
サブメニューの項目を選択すると、そのフィルターに対応するクエリが適用されます。サンプルで使用されている実際のクエリを確認するには、適用後に History リストを確認してください。このリストには、フィルタリングポップアップメニューからもアクセスできます。
クエリ作成ツール
クエリを記述する最も簡単な方法は、Altium Designerに作成させることかもしれません。これには、Find Similar Objects ダイアログまたは Query Builder ダイアログを使用できます。
類似オブジェクトの検索ダイアログ
類似オブジェクトの検索ダイアログを使用すると、目的のオブジェクトを検索するクエリが生成されます。Create Expression オプションが有効な場合、そのクエリは Filter パネルに表示されます。これは、さまざまなクエリキーワードを学ぶのに非常に有効な方法です。
設計ドキュメント内のマスクされていないオブジェクトを右クリックし、コンテキストメニューから Find Similar Objects を選択すると、Find Similar Objects ダイアログが開きます。
このダイアログでは、右クリックしたオブジェクトに類似するオブジェクトを検索し、一致条件として、どの属性が同じ(または異なる)でなければならないかを指定できます。たとえば、設計内のすべてのGNDパッドを変更する場合は、いずれかのGNDパッドを右クリックしてFind Similar Objectsを選択し、Net フィールドをAny(デフォルト設定)からSameに変更します。ダイアログでApply をクリックすると、すべてのGNDパッドが選択されます。Create Expression オプションが有効な場合、Filter パネルに次のクエリが表示されます。(ObjectKind = 'Pad') And (Net = 'GND').
回路図での例として、ドキュメント内で特定のTextプロパティ(例:'GND')を持つすべての電源オブジェクトのColor プロパティを同じ値に変更できます。また、PCBでの例として、ドキュメント内で特定のVia Diameterプロパティを持つすべてのビアのHole Sizeプロパティを同じ値に変更できます。
既存の選択をクリアするオプション
検索を適用する前に既存の選択や編集マスクをクリアするには、Clear Existing オプションを有効にします。連続して検索を実行し、その結果を累積したい場合は、このオプションを無効にします。
フィルターツールバー
Filter Toolbar はPCBドキュメント用に用意されており、指定したプロパティを持つオブジェクト、または指定したコンポーネントの一部であるオブジェクトを除き、ドキュメント内のすべてのオブジェクトをマスクできます。ツールバーの一番右のフィールドでクエリの内容を指定します。このフィールドにクエリを入力するか、ドロップダウンから最近使用したクエリ(クエリのHistory リストにあるもの)を選択できます。Filter Toolbarからクエリを適用する場合、使用するオプションは指定できません。どの場合も、以前のクエリはクリアされ、現在のクエリに対してMaskおよびZoomオプションが使用されます。クエリオプションを使用するには、Filter パネル、Query Builderダイアログ、Query Helperダイアログ、またはFind Similar Objects ダイアログを使用してください。
論理クエリ式の演算子
クエリ言語で論理クエリ式を定義する際に使用できる演算子の概要を以下に示します。
算術演算子
| 演算子 | 説明 | 例 |
|---|---|---|
| + | 加算演算子 | NetPinCount + NetViaCount |
| - | 減算演算子 | ArcStopAngle - ArcStartAngle |
| * | 乗算演算子 | PadXSize_BottomLayer * PadYSize_BottomLayer |
| / | 除算演算子 | HoleDiameter / ViaDiameter |
| Div | 整数除算演算子 | Color Div 65536 Colorを65536で割り、結果の小数部を切り捨てます |
| Mod | 剰余演算子 | Color Mod 256 Colorを256で割った余りを求めます。結果の小数部は求めません |
論理演算子
| 演算子 | 説明 | 例 |
|---|---|---|
| And | 論理AND演算子 | IsPad And OnMultiLayer 検索結果に含まれるには、オブジェクトがパッドであり、かつMulti-Layerレイヤー上に存在する必要があります |
| && | 論理AND演算子 (優先順位が低い) |
IsPad && OnMultiLayer 検索結果に含まれるには、オブジェクトがパッドであり、かつMulti-Layerレイヤー上に存在する必要があります |
| Or | 論理OR演算子 | IsPad Or IsVia 検索結果に含まれるには、オブジェクトがパッドまたはビアである必要があります |
| || | 論理OR演算子 (優先順位が低い) |
IsPad || IsVia 検索結果に含まれるには、オブジェクトがパッドまたはビアである必要があります |
| Xor | 論理排他的OR演算子 | OnMultiLayer Xor (HoleDiameter <> 0) 検索結果に含まれるには、オブジェクトがMulti-Layerレイヤー上にあり、 Hole Diameterがゼロであるか、または Multi-Layerレイヤー上になく、Hole Diameterがゼロ以外である必要があります。 |
| Not | 論理NOT演算子 | Not OnMultiLayer 検索結果に含まれるには、オブジェクトがMulti-Layerレイヤー上に存在しない必要があります |
比較演算子
| 演算子 | 説明 | 例 |
|---|---|---|
| < | 未満演算子 | HoleDiameter < 40 検索結果に含まれるには、オブジェクトのHole Diameterが40未満である必要があります |
| <= | 以下演算子 | HoleDiameter <= 40 検索結果に含まれるには、オブジェクトのHole Diameterが40以下である必要があります |
| >= | 以上演算子 | HoleDiameter >= 40 検索結果に含まれるには、オブジェクトのHole Diameterが40以上である必要があります |
| > | より大きい演算子 | HoleDiameter > 40 検索結果に含まれるには、オブジェクトのHole Diameterが40より大きい必要があります |
| <> | 不等価演算子 | HoleDiameter <> 40 検索結果に含まれるには、オブジェクトのHole Diameterが40と等しくない必要があります |
| = | 等価演算子 | HoleDiameter = 40 検索結果に含まれるには、オブジェクトのHole Diameterが40と等しい必要があります |
| Between...And... | 両端を含む範囲演算子 | HoleDiameter Between 30 And 50 検索結果に含まれるには、オブジェクトのHole Diameterが30以上、かつ 50以下である必要があります。 |
| Like | Like演算子 | Name Like 'ADDR?*' Name プロパティに関連付けられた文字列がADDRで始まり、 その後に少なくとも1文字以上が続くオブジェクトを返します |
ワイルドカード文字
ワイルドカード文字を使用すると、完全には指定されていない文字列を指定できます。通常、これらの文字は他の文字と組み合わせて使用し、文字列の一部を指定します。例外的に、完全には指定されていない文字列パラメーターを受け付けるキーワードもいくつかありますが、ほとんどの場合、文字列にワイルドカード文字を含められるのは、Like演算子で比較する場合に限られます。
| 演算子 | 説明 | 例 |
|---|---|---|
| ? | 任意の種類の1文字に置き換えることができます | Footprint Like 'DIP1?' FootprintプロパティがDIP10、DIP12、DIP14などのオブジェクトを返します。 |
| * | 任意の種類の任意の数の文字に置き換えることができます | Footprint Like 'SIP*' Footprint プロパティがSIP1、SIP12、SIP216などのオブジェクトを返します。(「*」はno文字にも置き換えられるため、Footprint プロパティがSIPのオブジェクトも返されます。) |
ブール文字列
| 演算子 | 説明 | 例 |
|---|---|---|
| True | キーワードの意味を肯定します | IsPad = True 返されるオブジェクトはパッドである必要があります |
| False | キーワードの意味を否定します | IsVia = False 返されるオブジェクトはビアでない必要があります |
丸括弧と優先順位
論理クエリ式で使用する演算子の優先順位を確認しておくことは重要です。優先順位を理解していないと、必要なオブジェクトを対象としない式になってしまう可能性があります。
各種演算子には優先順位が定義されており、丸括弧の優先順位が最も高くなっています。この優先順位によって、ユーザーが丸括弧を指定していない場合に、ソフトウェアがクエリをどのように解釈するかが決まります。優先順位の高い順に並べると、次のようになります。
- 丸括弧 ()
- Not
- ^, *, /, Div, Mod, And
- +, -, Or, Xor
- =, <>, <, >, <=, >=
- &&, ||
グローバルシステムクエリ関数

Query Helperダイアログに表示されるグローバルシステムクエリ関数
このセクションでは、Altium Designerの回路図、PCB、およびライブラリドキュメントで使用できるクエリ言語のキーワードについて詳しく説明します。特定のクエリキーワードのヘルプを表示するには、以下の折りたたみ可能なセクションを使用するか、Query Helper、Filterパネル、またはPCBデザインルールのQueryフィールドでキーワードを選択(またはキーワード内をクリック)して、F1を押してください。該当するセクションに直接アクセスできます。
算術関数
ABS
概要
パラメーターの数値の絶対値に等しい数値(実数)を返します。その数値が正の場合は同じ値を返し、それ以外の場合はパラメーターの数値に-1を掛けた値を返します。
構文
ABS(X : Number / Numeric_String) : Number
使用例
ABS(2.3)
2.3を返します。
ABS(-7.2)
7.2を返します。
CEIL
概要
パラメーターの数値に応じた整数値を返します。その数値が整数である場合は、まったく同じ値を返します。それ以外の場合は、パラメーターの数値より大きい最小の整数を返します。
構文
CEIL(X : Number / Numeric_String) : Number
使用例
CEIL(5.0)
5を返します。
CEIL(5.33)
6を返します。
CEIL(-5.0)
-5を返します。
CEIL(-5.33)
-5を返します。
FLOOR
概要
パラメーターの数値に応じた整数値を返します。その数値が整数である場合は、まったく同じ値を返します。それ以外の場合は、パラメーターの数値より小さい最大の整数を返します。
構文
FLOOR(X : Number / Numeric_String) : Number
使用例
FLOOR(5.0)
5を返します。
FLOOR(5.33)
5を返します。
FLOOR(-5.0)
-5を返します。
FLOOR(-5.33)
-6を返します。
FRAC
概要
パラメーターの数値に応じて、次の数値(実数)を返します。
- その数値が正で整数ではない場合は、パラメーターの数値から、その数値より小さい最大の整数を引いた差を返します。
- その数値が負で整数ではない場合は、パラメーターの数値から、その数値より大きい最小の整数を引いた差を返します。
- パラメーターの数値が整数である場合は、0を返します。
構文
FRAC(X : Number / Numeric_String) : Number
使用例
FRAC(5.0)
0を返します。
FRAC(5.33)
0.33を返します。
FRAC(-5.0)
0を返します。
FRAC(-5.33)
-0.33を返します。
IIF
概要
3つのクエリを含む特殊な構文です。最初のクエリ(開き括弧と最初のカンマの間)の値が評価されます。その値がTrueの場合は2番目のクエリ(カンマの間)を返し、それ以外の場合は3番目のクエリ(2番目のカンマと閉じ括弧の間)を返します。
構文
IIF(L : Boolean Query , A : Query , B : Query)
L、A、Bは、いずれもクエリを指定する文字列です。Lはブールクエリ(つまり、TrueまたはFalseのいずれかを結果として返すもの)である必要があります。
使用例
IsArc And IIF(ArcStopAngle - ArcStartAngle >= 0 , ArcStopAngle - ArcStartAngle Between 30 And 60 , ArcStartAngle - ArcStopAngle Between 300 And 330)
弧の長さが30度以上60度以下のすべての円弧を返します。(円弧の弧の長さプロパティは、終了角度(Stop Angle)プロパティから開始角度(Start Angle)プロパティを引いて求められる角度です。円弧の終了角度プロパティが開始角度プロパティより小さい場合もあるため注意が必要ですが、このクエリは、あらゆる円弧オブジェクトの実際の弧の長さプロパティを正しく評価します。)
IsComponent And IIF(Layer = 'Top Layer' , Rotation <> 0 , Rotation <> 180)
PCBの上面にあり、回転角度(Rotation)プロパティが0度ではないすべてのコンポーネントと、PCBの下面にあり、回転角度プロパティが180度ではないすべてのコンポーネントを返します。(コンポーネントオブジェクトはTop信号層またはBottom信号層にのみ配置できるため、Top信号層にないコンポーネントは必ずBottom信号層にあります。)
INT
概要
パラメーターの数値に応じて、次の整数を返します。
- 数値が正で、整数でない場合は、パラメーターの数値より小さい最大の整数を返します。
- 数値が負で、整数でない場合は、パラメーターの数値より大きい最小の整数を返します。
- 数値が整数の場合は、まったく同じ値を返します。
構文
INT(X : Number / Numeric_String) : Number
使用例
INT(5.0)
5を返します。
INT(5.33)
5を返します。
INT(-5.0)
-5を返します。
INT(-5.33)
-5を返します。
ヒント
これは算術関数TRUNCの別名です。
MAX
概要
指定されたすべてのパラメーターの最大値に等しい数値(実数)を返します。各パラメーターは数値または数値文字列である必要があり、任意の数のパラメーターを指定できます。
構文
MAX(N1 : Number / Numeric_String, [N2] : Number / Numeric_String, ...) : Number
使用例
MAX(2)
2を返します。
MAX(7,2,3)
7を返します。
ヒント
少なくとも1つのパラメーターを指定する必要があります。
MIN
概要
指定されたすべてのパラメーターの最小値に等しい数値(実数)を返します。各パラメーターは数値または数値文字列である必要があり、任意の数のパラメーターを指定できます。
構文
MIN(N1 : Number / Numeric_String, [N2] : Number / Numeric_String, ...) : Number
使用例
MIN(2)
2を返します。
MIN(7,2,3)
2を返します。
ヒント
少なくとも1つのパラメーターを指定する必要があります。
POWER
概要
最初のパラメーターの数値を、2番目のパラメーターの数値で累乗した値に等しい数値(実数)を返します。
構文
POWER(X : Number / Numeric_String , Y : Number / Numeric_String) : Number
使用例
POWER(3,2)
9を返します。
POWER(32,0.2)
2を返します。
POWER(16,-0.5)
0.25を返します。
ROUND
概要
パラメーターの数値に応じて、次の整数を返します。
- 数値が整数の場合は、まったく同じ値を返します。
- 数値が整数でない場合は、パラメーターの数値に最も近い整数を返します。隣接する整数のちょうど中間にある正の数はupwardsに丸められ、隣接する整数のちょうど中間にある負の数はdownwardsに丸められます。
構文
ROUND(X : Number / Numeric_String) : Number
使用例
ROUND(5.0)
5を返します。
ROUND(5.33)
5を返します。
ROUND(5.5)
6を返します(大きい方の整数に丸められます)。
ROUND(5.66)
6を返します。
ROUND(-5.0)
-5を返します。
ROUND(-5.33)
-5を返します。
ROUND(-5.5)
-6を返します(小さい方の整数に丸められます)。
ROUND(-5.66)
-6を返します。
SIGN
概要
指定されたパラメーターの符号値を返します。つまり、パラメーターの数値に応じて、次の整数を返します。
- 数値が正の場合は、1を返します。
- 数値が負の場合は、-1を返します。
- 数値がちょうどゼロの場合は、0を返します。
構文
SIGN(X : Number / Numeric_String) : Number
使用例
SIGN(5.33)
1を返します。
SIGN(-5.33)
-1を返します。
SIGN(0)
0を返します。
SQR
概要
パラメーターの数値の2乗に等しい数値(実数)を返します。
構文
SQR(X : Number / Numeric_String) : Number
使用例
SQR(2)
4を返します。
SQR(14.1)
198.81を返します。
SQR(-1.5)
2.25を返します。
SQRT
概要
パラメーターの数値の正の平方根に等しい数値(実数)を返します。
構文
SQRT(X : Number / Numeric_String) : Number
使用例
SQRT(4)
2を返します。
SQRT(10)
3.1623を返します。
TRUNC
概要
パラメーターの数値に応じて、次の整数を返します。
- 数値が正で、整数でない場合は、パラメーターの数値より小さい最大の整数を返します。
- 数値が負で、整数でない場合は、パラメーターの数値より大きい最小の整数を返します。
- 数値が整数の場合は、まったく同じ値を返します。
構文
TRUNC(X : Number / Numeric_String) : Number
使用例
TRUNC(5.0)
5を返します。
TRUNC(5.33)
5を返します。
TRUNC(-5.0)
-5を返します。
TRUNC(-5.33)
-5を返します。
ヒント
これは算術関数INTの別名です。
ZERO
概要
パラメーターの数値に応じて、0または1の整数を返します。数値がゼロの場合は0を返し、それ以外の場合は1を返します。
構文
ZERO(X : Number / Numeric_String) : Number
使用例
ZERO(5.33)
1を返します。
ZERO(-5.33)
1を返します。
ZERO(0)
0を返します。
三角関数
ACOS
概要
パラメーターの数値で指定された数の逆余弦に相当する角度を、実数で返します。角度の単位は度ではなくラジアンです。
構文
ACOS(X : Number / Numeric_String) : Number
使用例
ACOS(0)
1.5708を返します。
ACOS(0.5)
1.0472を返します。
ACOS(1)
0を返します。
ASIN
概要
パラメーターの数値で指定された数の逆正弦に相当する角度を、実数で返します。角度の単位は度ではなくラジアンです。
構文
ASIN(X : Number / Numeric_String) : Number
使用例
ASIN(0)
0を返します。
ASIN(0.5)
0.5236を返します。
ASIN(1)
1.5708を返します。
ATAN
概要
パラメーターの数値で指定された数の逆正接に相当する角度を、実数で返します。角度の単位は度ではなくラジアンです。
構文
ATAN(X : Number / Numeric_String) : Number
使用例
ATAN(0)
0を返します。
ATAN(1)
0.7854を返します。
ATAN(2.5)
1.1903を返します。
COS
概要
パラメーターの数値で指定された角度の余弦を、実数で返します。角度の単位は度ではなくラジアンです。
構文
COS(X : Number / Numeric_String) : Number
使用例
COS(0)
1を返します。
COS(0.8)
0.6967を返します。
COS(1.57)
0.0008を返します。
COSH
概要
パラメーターの数値の双曲線余弦を、実数で返します。
構文
COSH(X : Number / Numeric_String) : Number
使用例
COSH(TextHeight / TextWidth) < 70.5
TextHeightとTextWidthの距離の比(TextHeight / TextWidth)の双曲線余弦が70.5未満のオブジェクトを返します。(これは、TextHeightとTextWidthの距離の比が4.9487未満のオブジェクトを返すことと同等です)。
(TextHeight / TextWidth) >= COSH(2.3)
TextHeightとTextWidthの距離の比(TextHeight / TextWidth)が、2.3の双曲線余弦(5.0372)以上のオブジェクトを返します。
COTAN
概要
パラメーターの数値で指定された角度の余接を、実数で返します。角度の単位は度ではなくラジアンです。
構文
COTAN(X : Number / Numeric_String) : Number
使用例
COTAN(0.1)
9.9666を返します。
COTAN(0.8)
0.9712を返します。
COTAN(1.57)
0.0008を返します。
SIN
概要
パラメーターの数値で指定された角度の正弦を、実数で返します。角度の単位は度ではなくラジアンです。
構文
SIN(X : Number / Numeric_String) : Number
使用例
SIN(0)
0を返します。
SIN(0.8)
0.7174を返します。
SIN(1.57)
1.0を返します。
SINH
概要
パラメーターの数値の双曲線正弦を、実数で返します。
構文
SINH(X : Number / Numeric_String) : Number
使用例
SINH(TextWidth / TextHeight) < 0.17
TextWidthとTextHeightの距離の比(TextWidth / TextHeight)の双曲線正弦が0.17未満のオブジェクトを返します。(これは、TextWidthとTextHeightの距離の比が0.1692未満のオブジェクトを返すことと同等です)。
(TextWidth / TextHeight) >= SINH(0.2)
TextWidthとTextHeightの距離の比(TextWidth / TextHeight)が、0.2の双曲線正弦(0.2013)以上のオブジェクトを返します。
TAN
概要
パラメーターの数値で指定された角度の正接を、実数で返します。角度の単位は度ではなくラジアンです。
構文
TAN(X : Number / Numeric_String) : Number)
使用例
TAN(0)
0を返します。
TAN(0.8)
1.0296を返します。
TAN(1.57)
1255.7656を返します。
TANH
概要
パラメーターの数値の双曲線正接を、実数で返します。
構文
TANH(X : Number / Numeric_String) : Number
使用例
TANH(TextWidth / TextHeight) < 0.17
TextWidthとTextHeightの距離の比(TextWidth / TextHeight)の双曲線正接が0.17未満のオブジェクトを返します。(これは、TextWidthとTextHeightの距離の比が0.1717未満のオブジェクトを返すことと同等です)。
(TextWidth / TextHeight) >= TANH(0.2)
TextWidthとTextHeightの距離の比(TextWidth / TextHeight)が、0.2の双曲線正接(0.1974)以上のオブジェクトを返します。
指数関数と対数関数
EXP
概要
eをパラメーターの数値で累乗した値を、実数で返します。(数値eは自然対数の底であり、およそ2.7183です)。
構文
EXP(X : Number / Numeric_String) : Number
使用例
EXP(0)
1を返します。
EXP(1)
2.7183を返します。
LG
概要
パラメーターの数値の10を底とする対数を、実数で返します。
構文
LG(X : Number / Numeric_String) : Number
使用例
LG(1)
0を返します。
LG(10)
1を返します。
LG(25)
1.3979を返します。
LN
概要
パラメーターの数値の自然対数(eを底とする対数)を、実数で返します。(数値eは2.7183です)。
構文
LN(X : Number / Numeric_String) : Number
使用例
LN(1)
0を返します。
LN(2)
0.6931を返します。
LN(10)
2.3026を返します。
LOG
概要
パラメーターの数値の2を底とする対数を、実数で返します。
構文
LOG(X : Number / Numeric_String) : Number
使用例
LOG(1)
0を返します。
LOG(2)
1を返します。
LOG(8)
3を返します。
LOG(10)
3.3219を返します。
集約関数
AVG
概要
指定されたすべてのパラメーターの平均値を実数で返します。各パラメーターは数値または数値文字列である必要があり、任意の数のパラメーターを指定できます。
構文
AVG(N1 : Number / Numeric_String, [N2] : Number / Numeric_String, ...) : Number
使用例
AVG(2)
2を返します。
AVG(7,2,3)
4を返します。
ヒント
- 少なくとも1つのパラメーターを指定する必要があります。
MAX
概要
指定されたすべてのパラメーターの最大値を実数で返します。各パラメーターは数値または数値文字列である必要があり、任意の数のパラメーターを指定できます。
構文
MAX(N1 : Number / Numeric_String, [N2] : Number / Numeric_String, ...) : Number
使用例
MAX(2)
2を返します。
MAX(7,2,3)
7を返します。
ヒント
少なくとも1つのパラメーターを指定する必要があります。
MIN
概要
指定されたすべてのパラメーターの最小値を実数で返します。各パラメーターは数値または数値文字列である必要があり、任意の数のパラメーターを指定できます。
構文
MIN(N1 : Number / Numeric_String, [N2] : Number / Numeric_String, ...) : Number
使用例
MIN(2)
2を返します。
MIN(7,2,3)
2を返します。
ヒント
少なくとも1つのパラメーターを指定する必要があります。
PROD
概要
指定されたすべてのパラメーターの積を実数で返します。各パラメーターは数値または数値文字列である必要があり、任意の数のパラメーターを指定できます。
構文
PROD(N1 : Number / Numeric_String, [N2] : Number / Numeric_String, ...) : Number
使用例
PROD(2)
2を返します。
PROD(7,2,3)
42を返します。
ヒント
少なくとも1つのパラメーターを指定する必要があります。
SUM
概要
指定されたすべてのパラメーターの合計を実数で返します。各パラメーターは数値または数値文字列である必要があり、任意の数のパラメーターを指定できます。
構文
SUM(N1 : Number / Numeric_String, [N2] : Number / Numeric_String, ...) : Number
使用例
SUM(2)
2を返します。
SUM(7,2,3)
12を返します。
ヒント
少なくとも1つのパラメーターを指定する必要があります。
システム関数
Copy
概要
文字列の部分文字列を返します。返される部分文字列の文字数と、その先頭文字となる元の文字列内の位置を指定できます。
構文
Copy(S : String , Index : Integer , Count : Integer) : String
Sは文字列型の式です。Index とCountは整数型の式です。Copyは、S[Index]から始まるCount文字の部分文字列を返します。
Index がSの長さを超える場合、Copyは空の文字列を返します。
Countで指定した文字数が取得可能な文字数を超える場合、S[Index]からSの末尾までの文字のみが返されます。
使用例
Copy('Cats and dogs',1,1)
'C'を返します。(文字列の1文字目から1文字を返します。)
Copy('Cats and dogs',2,1)
'a'を返します。(文字列の2文字目から1文字を返します。)
Copy('Cats and dogs',13,1)
's'を返します。(文字列の13文字目から1文字を返します。)
Copy('Cats and dogs',14,1)
''(空の文字列)を返します。(文字列の14文字目から1文字を返そうとしますが、文字列には13文字しかないため、空の文字列が返されます。)
Copy('Cats and dogs',1,2)
'Ca'を返します。(文字列の1文字目から2文字を返します。)
Copy('Cats and dogs',2,2)
'at'を返します。(文字列の2文字目から2文字を返します。)
Copy('Cats and dogs',12,2)
'gs'を返します。(文字列の12文字目から2文字を返します。)
Copy('Cats and dogs',13,2)
's'を返します。(文字列の13文字目から2文字を返そうとしますが、文字列には13文字しかないため、1文字のみが返されます。)
Copy('Cats and dogs',15,2)
''(空の文字列)を返します。(文字列の15文字目から2文字を返そうとしますが、文字列には13文字しかないため、空の文字列が返されます。)
Copy('Cats and dogs',1,6)
'Cats a'を返します。(文字列の1文字目から6文字を返します。)
Copy('Cats and dogs',5,9)
' and dogs'を返します。(文字列の5文字目から9文字を返します。)
Copy('Cats and dogs',8,5)
'd dog'を返します。(文字列の8文字目から5文字を返します。)
Copy('Cats and dogs',8,6)
'd dogs'を返します。(文字列の8文字目から6文字を返します。)
Copy('Cats and dogs',8,7)
'd dogs'を返します。(文字列の8文字目から7文字を返そうとしますが、文字列には13文字しかないため、6文字のみが返されます。)
Length
概要
文字列に含まれる文字数を返します。
構文
Length(S : String) : Integer
Sは、文字数を取得する対象の文字列です。
使用例
Length(Name) Between 4 And 7
Nameプロパティの文字数が4~7文字のオブジェクトを返します。
Length('Cat')
3を返します。
Length('Darryll')
7を返します。
Length('Cats and dogs')
13を返します。
Length('')
0を返します。
Pos
概要
指定された文字列内で、指定された部分文字列が最初に出現する位置のインデックス値を返します。
構文
Pos(Substr : String , S : String) : Integer
Posは、文字列S内で部分文字列Substrを検索します。SubstrとSは文字列型の式です。Substrの先頭文字のインデックスを示す整数値が返されます。
使用例
Pos('T',Name) = 1
Name プロパティの文字列内で、'T'が最初に出現する位置が1文字目であるすべてのオブジェクトを返します。このような文字列の例として、'T1'や'Time Table'があります。(文字列'Time Table'には'T'が2回出現しますが、最初に出現するのは1文字目です。)
Pos('A',Name) = 2
Name プロパティの文字列内で、'A'が最初に出現する位置が2文字目であるすべてのオブジェクトを返します。このような文字列の例として、'RA1'や'CABLE CHART'があります。
Pos('B',Name) = 0
Name プロパティに関連付けられた文字列のどの位置にも 'B' が含まれていないオブジェクトをすべて返します。'D1' や 'Time Table' がこのような文字列の例です。('Time Table' という文字列には8文字目に 'b' が含まれていますが、Pos は大文字と小文字を区別します。)
Pos('D',Name) > 0
Name プロパティに関連付けられた文字列の任意の位置に 'D' が1つ以上含まれているオブジェクトをすべて返します。'Data Chart'、'U1D'、'Install either D1 and D2 or D3 and D4, but never install all of these.' がこのような文字列の例です。
Pos('Con',Name) = 1
Name プロパティに関連付けられた文字列で、'Con' が最初に出現する位置が1~3文字目であるオブジェクトをすべて返します。'Concatenate' がこのような文字列の例です。('Concatenate' 内で 'Con' が最初に出現するのは先頭の3文字です。'Con' の最初の文字は 'C' で、その位置は 'Concatenate' の1文字目です。)
Pos('ate',Name) = 5
Name プロパティに関連付けられた文字列で、'ate' が最初に出現する位置が5~7文字目であるオブジェクトをすべて返します。'Concatenate' がこのような文字列の例です。('Concatenate' 内で 'ate' が最初に出現するのは5~7文字目です。'ate' の最初の文字は 'a' で、その位置は 'Concatenate' の5文字目です。)
Pos('ate',Name) = 0
Name プロパティに関連付けられた文字列のどこにも 'ate' が含まれていないオブジェクトをすべて返します。'C1' や 'TIME:' がこのような文字列の例です。
Pred
概要
パラメーターの数値から 1.0 を引いた値を実数で返します。
構文
Pred(X : Number / Numeric_String) : Number
使用例
Pred(4.1)
3.1 を返します。
Pred(41.313)
40.313 を返します。
Random
概要
0 から X-1 までの乱数を返します。
構文
Random(X) : Number
使用例
Random(10)
0 から 9 までの値を返します。
Random(100)
0 から 99 までの値を返します。
Succ
概要
パラメーターの数値に 1.0 を加えた値を実数で返します。
構文
Succ(X : Number / Numeric_String) : Number
使用例
Succ(2.1)
3.1 を返します。
Succ(41.313)
42.313 を返します。






















