パラメータ

Parent page: 回路図オブジェクト

パラメータは、コンポーネント（図示）、ドキュメント、およびプロジェクトに対して使用され、設計に詳細情報を追加します。

概要

パラメータは汎用のテキスト文字列で、親オブジェクトの子オブジェクトとして存在し、その親オブジェクトに詳細情報を追加できるようにします。たとえば回路図コンポーネントではパラメータが広く使用されます。Designator と Comment を定義するために使用されるほか、コンポーネントを完全に定義するために追加できる汎用パラメータ文字列としても使用されます。汎用コンポーネント・パラメータは、Wattage、Voltage などのコンポーネント詳細、サプライヤ名や型番などのサプライヤ詳細、シンボルのリビジョン番号などのライブラリ・コンポーネント設計詳細、さらにコンポーネントのデータシートへリンクする URL のようなドキュメント詳細など、さまざまな用途に利用できます。

パラメータは、回路図シート（ドキュメント）レベルおよびプロジェクト・レベルで定義できます。ドキュメント・レベルのパラメータは、ドキュメントのタイトルや番号などのフィールド定義に最適で、プロジェクト・レベルのパラメータは、設計者名やプロジェクト名などのフィールド定義に最適です。

利用可能性

パラメータは親オブジェクトのプロパティとして追加されます。Text String のように独立して配置するものではありません。パラメータは次の設計オブジェクトのいずれにも追加できます。

• Component - Parameters 領域でユーザー定義パラメータを追加します。これは Component Properties ダイアログ、または回路図ライブラリ・エディタでコンポーネント定義中に追加する場合は Library Component Properties ダイアログで行います。Designator と Comment のパラメータは Component オブジェクトに常に存在します。ダイアログを開くには、Schematic エディタでコンポーネントをダブルクリックするか、Schematic Library エディタの Sch Library パネルでコンポーネント名をダブルクリックします。
• Pin - Pin Properties ダイアログの Parameters タブ。
• Port - Port Properties ダイアログの Parameters タブ。
• Sheet Symbol - Sheet Symbol ダイアログの Parameters タブ。
• Document - Document Options ダイアログ（Project | Content | ）内。パラメータはダイアログの Parameters タブに一覧表示されます。新規の回路図シートには、既定のパラメータがいくつか自動的に含まれます。
• Project - Options for Project ダイアログ（Project | Content | ）内。パラメータはダイアログの Parameters タブに一覧表示されます。

グラフィカル編集

表示されている文字列は、in-place 編集と呼ばれる方法でグラフィカルに編集できます。文字列をその場で編集するには、1回クリックして選択し、1秒ほど待ってから、もう一度クリックして編集モードに入ります。

 1回クリックして文字列を選択します。

 一旦待ってから、2回目のクリックでインプレース編集モードに入ります。

Designator 文字列の値はインプレースで編集できます。

 ここでは文字列が選択され、置き換え文字列を入力できる状態になっています。

編集が完了したら、Enter を押すか、文字列の外側をクリックしてインプレース編集モードを終了します。

インスペクタ・パネルによる編集

Panel pages: SCH Inspector、SCHLIB Inspector

Inspector パネルを使用すると、アクティブなドキュメント内の1つまたは複数の設計オブジェクトのプロパティを確認し、編集できます。

コンポーネント・パラメータ

コンポーネント・パラメータには、Designator と Comment、およびユーザー定義パラメータが含まれます。

回路図ライブラリ・エディタでのコンポーネント・パラメータ編集

既定では、Designator、Comment、およびユーザー定義パラメータは Schematic Library エディタでは表示されません。これらは Library Component Properties ダイアログで編集します。SCH Library パネルで Component 名をダブルクリックするか、Edit ボタンをクリックしてダイアログを開きます（下図参照）。

コンポーネント名をダブルクリックするか Edit ボタンをクリックしてダイアログを開き、ライブラリ・エディタでコンポーネント・パラメータを編集します。

ユーザー定義パラメータは、Library Component Properties ダイアログで Visible チェックボックスを有効にすると表示できます。これを有効にすると、パラメータ Value. が表示されます。パラメータ名を表示するには、Edit ボタンをクリックして Parameter Properties ダイアログを開き、Name フィールドの Visible チェックボックスを有効にします。

別の方法として、Schematic Library Editor で Designator と Comment の文字列を表示し、それらをダブルクリックしてプロパティを編集することもできます。これらの文字列を表示するには、Tools | Options |

をクリックして Library Editor Workspace ダイアログを開き、下図のように Always Show Comment/Designator オプションを有効にします。この設定は Schematic Library のプロパティです。

Always Show Comment/Designator オプションを有効にすると、Schematic Library Editor でこれらの文字列が表示されます。

Schematic Editor でのコンポーネント・パラメータ編集

コンポーネント・パラメータは、Schematic Editor でコンポーネント配置中、または回路図シート上に配置した後に定義できます。

• コンポーネント配置中に designator/comment/user-parameter を定義するには、コンポーネントがカーソルに追従している状態で Tab キーを押します。Properties for Schematic Component ダイアログが開きます。必要な designator/comment/user-defined parameter 文字列を入力し、OK をクリックしてダイアログを閉じ、コンポーネント配置を完了します。続けてコンポーネントを配置するか、Esc を押して配置を終了します。
• 配置後に designator/comment/user-parameter を定義するには、配置済みコンポーネントをダブルクリックして Properties for Schematic Component ダイアログを開き、designator/comment/user-parameter を編集します。OK をクリックしてダイアログを閉じ、変更を確定します。

コンポーネント・パラメータの表示プロパティ編集

designator/comment/user-parameter 文字列の外観（フォント種類、サイズ、色を含む）は、次のように定義できます。

1. Schematic Library Editor の Parameter Properties ダイアログで designator/comment/user-parameter のプロパティを設定し、シンボルのプロパティとして定義します。これには、前述のとおり designator 文字列を可視化する必要があります。
2. 配置済み回路図コンポーネントの designator/comment/user-parameter 文字列を編集します。コンポーネントをダブルクリックして、各パラメータのプロパティを編集します。

どちらの方法でも、下図の Parameter Properties ダイアログが開きます。このダイアログでは、パラメータのすべてのプロパティを編集できる点に注意してください。

Designator 文字列の値と外観は、Parameter Properties ダイアログで編集できます。

パラメータ文字列の位置を固定する

コンポーネント・パラメータ文字列の既定の動作は、配置中にコンポーネントを回転させると自動的に位置調整（オートポジション）されることです。この動作が不要な場合は、シンボル作成時または回路図シートに配置した後に、Parameter Properties ダイアログ（前の画像参照）で Autoposition オプションをオフにします。これにより、このパラメータは manual parameter（手動配置パラメータ）として分類されます。手動パラメータは、選択ボックスの左下隅にあるドットで識別されます。

特別用途のコンポーネント・パラメータ

特別用途のコンポーネント・パラメータは、コンポーネントから関連ドキュメントへのリンクを定義するために作成されています。これには HelpURL と ComponentLink のパラメータ・ペアが含まれます。

HelpURL パラメータ

HelpURL パラメータを使用すると、コンポーネントから PDF や Web ページなどの外部ドキュメントへのリンクを定義できます。リンクは、回路図シート上でコンポーネントの上にカーソルを置いて F1 を押したとき、または Libraries パネルでそのコンポーネントが選択されているときに有効になります。このパラメータを使用して、PDF、テキストファイル、HTML ページを参照できます。機能を使用するには、必要なコンポーネントに HelpURL パラメータを追加し、パラメータ値に開きたいドキュメントを設定します。

パラメータ値を指定する際、絶対パスを含めることも、ドキュメント名のみを入力することもできます。次の例はいずれもパラメータ値として有効です。

• C:\Design_Projects\Schematics\Modifications.txt
• From Idea to Manufacture - Driving a PCB Design through CircuitStudio.pdf
• www.circuitstudio.com

配置済みオブジェクト上にカーソルを置いた状態で F1 を押すと、ドキュメント検索は次の順序で行われます。

• パスが指定されている場合は、まずその場所を検索します。
• その場所でドキュメントが見つからない、またはパスが指定されていない場合は、CircuitStudio インストールの \Help フォルダを検索します。
• それでもドキュメントが見つからない場合は、オブジェクトの既定のヘルプトピックが表示されます。

ComponentLink パラメータ・ペア

この機能により、任意の数の参照ドキュメントへの「名前付きリンク」を定義して提示できます。複数の ComponentLink パラメータ・ペアを定義可能です。この機能を使用するには、各 ComponentLink ペアについて次のように2つのパラメータを追加して設定します。

第1パラメータ - 対象ドキュメントを定義します:

• Parameter Name = ComponentLinknURL（n は任意の整数値）
• Parameter Value = target document path\name

第2パラメータ - メニューに表示される項目を定義します:

• Name = ComponentLinknDescription （n は第1パラメータで使用した整数値と同じ）
• Value = Entry to appear in the menu

ComponentLink パラメータ・ペアは任意の数だけ定義でき、各ペアは n の値を同一にすることで関連付けられます。

コンポーネント・リンクにアクセスするには、ワークスペース上の配置済み部品を右クリックします。リンクの項目は References サブメニューに表示されます。

文字列の値をパラメータ値で置き換える

コンポーネントのパラメータは、Visible チェックボックスで簡単に表示できます。しかし、ドキュメント／プロジェクトのパラメータは回路図シート上に直接表示できません。これらのパラメータを表示するには、String Indirectionと呼ばれる手法を使用します。String Indirection（文字列の間接参照）とは、回路図シート上に通常のテキスト文字列を配置し、文字列値を入力する代わりに、等号（=）を先頭に付けたドキュメントまたはプロジェクト・パラメータ名を入力する仕組みです。たとえば=Titleのように入力します。ソフトウェアはこのような文字列を自動的に検出し、=Titleのようなテキスト文字列の内容を表示する代わりに、ドキュメント／プロジェクト・パラメータを参照します。そしてTitleというパラメータが見つかれば、Titleパラメータの値が表示されます。

間接参照された文字列はSpecial Stringsと呼ばれます。事前定義された特殊文字列が多数用意されており、以下に一覧を示します。ユーザー定義のドキュメント／プロジェクト・パラメータも特殊文字列とみなすことができ、回路図シート上のテキスト文字列へ間接参照させることができます。

回路図の事前定義特殊文字列

以下は、回路図ドキュメントで使用できる事前定義の特殊文字列です。大半は、 Parameters タブでアクティブなドキュメントに対して定義される既定のパラメータ情報にリンクしています（ Document Options ダイアログ（Project | Content | Document Options））。

• =Address1 – 既定のドキュメントレベル・パラメータ Address1に指定された値を表示します。
• =Address2 – 既定のドキュメントレベル・パラメータ Address2に指定された値を表示します。
• =Address3 – 既定のドキュメントレベル・パラメータ Address3に指定された値を表示します。
• =Address4 – 既定のドキュメントレベル・パラメータ Address4に指定された値を表示します。
• =Application_BuildNumber – 現在のCircuitStudioインストールのバージョンとビルドを表示します。
• =ApprovedBy – 既定のドキュメントレベル・パラメータ ApprovedByに指定された値を表示します。
• =Author – 既定のドキュメントレベル・パラメータ Authorに指定された値を表示します。
• =CheckedBy – 既定のドキュメントレベル・パラメータ CheckedByに指定された値を表示します。
• =CompanyName – 既定のドキュメントレベル・パラメータ CompanyNameに指定された値を表示します。
• =CurrentDate – 現在の日付。ユーザーのシステム設定から自動計算され、形式は dd/mm/yyyyです。回路図の編集時、または更新／再描画時に更新されます。例： 10/12/2012。
• =CurrentTime – 現在の時刻。ユーザーのシステム設定から自動計算され、形式は h:mm:ss AM/PMです。回路図の編集時、または更新／再描画時に更新されます。例： 2:39:47 PM。
• =Date – 固定の日付情報を表示するために使用します。既定のドキュメントレベル・パラメータ Dateに指定された値を表示します。自動計算され所定の形式で表示される =CurrentDate 特殊文字列とは異なり、任意の形式で固定の日付情報を入力できます。
• =DocumentFullPathAndName – 文字列が配置されたドキュメントのフルパスと名前を表示するために使用します。例： C:\MyTestDesign\PSU.SchDoc。
• =DocumentName – 回路図のファイル名のみ（ファイルパスなし）を表示するために使用します。例： PSU.SchDoc。
• =DocumentNumber – 既定のドキュメントレベル・パラメータDocumentNumberに指定された値を表示します。ソース・パラメータは、Tools | Annotation | Number Sheetsコマンド使用時にSheet Numbering For Projectダイアログから更新することもできます。
• =DrawnBy – 既定のドキュメントレベル・パラメータ DrawnByに指定された値を表示します。
• =Engineer – 既定のドキュメントレベル・パラメータ Engineerに指定された値を表示します。
• =ImagePath – 既定のドキュメントレベル・パラメータ ImagePathに指定された値を表示します。
• =ModifiedDate – 回路図の更新日時スタンプ。自動的に入力されます。例： 10/12/2012。
• =Organization – 既定のドキュメントレベル・パラメータ Organization に指定された値を表示します。
• =ProjectName – プロジェクトの実際の名前（拡張子を含む）を表示します。たとえば、ファイル名が MyPCB.PrjPcbのプロジェクトの場合、この特殊文字列は MyPCB.PrjPcbを表示します。
• =Revision – 既定のドキュメントレベル・パラメータ Revisionに指定された値を表示します。
• =Rule – 既定のドキュメントレベル・パラメータ Ruleに指定された値を表示します。このパラメータの値は初期状態では Undefined Rule （回路図上では * として表示）になります。パラメータ値をダブルクリックすると、ルール種別の定義および制約の編集ができます。
• =SheetNumber – 現在の回路図のシート番号。この値はTools | Annotate | Number Sheetsコマンド使用時に計算されます。Sheet Numbering For Projectダイアログで割り当てたシート番号が、既定のドキュメントレベル・パラメータSheetNumberの値に入力されます。この特殊文字列を回路図シートのEditorタブ表示で使用した場合、ここから情報を取得します。
• =SheetTotal – プロジェクトの総シート数。この値はTools | Annotate | Number Sheetsコマンド使用時に計算されます。Sheet Numbering For Projectダイアログの総シート数が、既定のドキュメントレベル・パラメータSheetTotalの値に入力されます。この特殊文字列を回路図シートのEditorタブ表示で使用した場合、ここから情報を取得します。
• =Time – 固定の時刻情報を表示するために使用します。既定のドキュメントレベル・パラメータ Timeに指定された値を表示します。自動計算され所定の形式で表示される =CurrentTime 特殊文字列とは異なり、任意の形式で固定の時刻情報を入力できます。
• =Title – 既定のドキュメントレベル・パラメータ Titleに指定された値を表示します。
• =VariantName - 出力が生成されたバリアントを表示します。これは現在のバリアント（Project | Project Actions | Current Variant）のエントリに従います。ベース設計を使用して出力を生成した場合、値は[No Variations]になります。

コンポーネント・パラメータで使用する特殊文字列

コンポーネント・パラメータを定義する際には、追加の特殊文字列（または既存のものの特殊な解釈）をいくつか使用できます。いずれの場合も、特殊文字列はパラメータのvalueとして入力します。

• =CurrentFootprint – 関連する Component Properties ダイアログの Models 領域で定義された、コンポーネントに現在割り当てられているフットプリント名を表示します。
• =Comment – 関連する Component Properties ダイアログの Properties 領域で定義された、コンポーネントの Comment フィールドに表示される値を表示します。
• =Description – 関連する Component Properties ダイアログの Properties 領域で定義された、コンポーネントの Description フィールドに表示される値を表示します。
• =[ParameterName] – 指定したコンポーネント・パラメータに定義された値を表示します。特殊文字列名として、コンポーネント・パラメータの実際の名前を入力します。たとえば、 PowerRatingという名前のコンポーネント・パラメータの場合、=PowerRatingと入力します。コンポーネントのCommentプロパティを定義する際、関連するドロップダウン・フィールドには既存のすべてのコンポーネント・パラメータに対する特殊文字列が表示されるため、定義済みパラメータの値をCommentとして素早く使用できます。