テキスト文字列

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

配置されたテキスト文字列。

概要

テキスト文字列（注釈とも呼ばれます）は、非電気的な描画プリミティブです。回路図シート上に配置できる、1行のフリーテキストです。用途としては、セクション見出し、改訂履歴、タイミング情報、その他の説明文や指示文などが挙げられます。

利用可能性

テキスト文字列は、回路図エディタおよび回路図ライブラリエディタの両方で配置できます。

• Schematic Editor - メインメニューから Home | Graphical Elements |  をクリックします。
• Schematic Library Editor - メインメニューから Home | Place |  をクリックします。

配置

コマンドを起動すると、カーソルが十字カーソルに変わり、テキスト文字列の配置モードに入ります。テキスト文字列がカーソルに「追従」して表示されます。

1. オブジェクトを配置したい位置に移動し、クリックするか Enter を押して配置します。
2. 続けて別のテキスト文字列を配置するか、右クリックするか Esc を押して配置モードを終了します。

配置中に実行できる追加操作は次のとおりです。

• Tab キーを押すと、関連するプロパティ ダイアログにアクセスでき、テキスト文字列のプロパティをその場で変更できます。
• Alt キーを押すと、移動方向を（移動開始時の方向に応じて）水平または垂直軸に制限できます。
• Spacebar を押すとテキスト文字列を反時計回りに回転し、Shift+Spacebar を押すと時計回りに回転します。回転は90°刻みです。
• X または Y キーを押すと、テキスト文字列をそれぞれX軸またはY軸に沿ってミラーできます。

グラフィカル編集

この編集方法では、ワークスペース上で配置済みのテキスト文字列オブジェクトを直接選択し、位置をグラフィカルに変更できます。テキスト文字列は、使用するフォントサイズ（Annotation ダイアログからアクセス）を変更することでのみサイズ調整できます。そのため、テキスト文字列オブジェクトを選択しても編集ハンドルは表示されません。

選択されたテキスト文字列

• 破線のボックス内をクリックしてドラッグし、必要に応じてテキスト文字列を再配置します。ドラッグ中に、テキスト文字列を回転（Spacebar/Shift+Spacebar）またはミラー（X または Y キーで、それぞれX軸またはY軸に沿ってミラー）できます。
• テキスト文字列オブジェクトのテキストは、in-place により次の手順で編集できます。
  1. テキスト文字列をシングルクリックして選択します。
  2. もう一度シングルクリック（または Enter キーを押す）して、その場編集モードに入ります。ソフトウェアが2回のシングルクリックを1回のダブルクリック（テキスト文字列のプロパティダイアログが開く）として解釈しないよう、各クリックの間に十分な時間を空けてください。
  3. その場編集を終了するには、Enter キーを押すか、マウスでテキスト文字列以外の場所をクリックします。

非グラフィカル編集

次の非グラフィカル編集方法が利用できます。

関連プロパティダイアログから

Dialog page: 注釈

この編集方法では、Annotation ダイアログを使用してテキスト文字列オブジェクトのプロパティを変更します。

注釈 ダイアログ

配置中は Tab キーを押すことでこのダイアログにアクセスできます。

配置後は、次のいずれかの方法でダイアログにアクセスできます。

• 配置済みのテキスト文字列オブジェクトをダブルクリックします。
• テキスト文字列オブジェクト上にカーソルを置き、右クリックしてコンテキストメニューから Properties を選択します。

インスペクタパネルから

Panel pages: SCH Inspector、SCHLIB Inspector

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

特殊文字列

テキスト文字列オブジェクトは、回路図シート上にユーザー定義のテキストを配置するために使用できますが、配置できるのはjustユーザー定義テキストだけではありません。ドキュメント作成を支援するために、「特殊文字列（special strings）」という概念が用意されています。これらは、出力生成時に回路図上へ表示される設計情報またはシステム情報のプレースホルダーとして機能します。

新規の回路図ドキュメントでは、既定の定義済み特殊文字列セットが提供されます。また、ドキュメントレベル（現在の回路図のみで使用）またはプロジェクトレベル（プロジェクト内のすべての回路図シートおよびPCBドキュメントで使用可能）で追加パラメータを定義することで、独自のカスタム特殊文字列を追加することもできます。

特殊文字列の配置

回路図で特殊文字列を使用するには、テキスト文字列オブジェクトを配置し、そのテキストを特殊文字列名のいずれかに設定します。

回路図シート上では、特殊文字列は接頭辞「=」で識別されます（例：=CurrentTime、=CurrentDate など）。利用可能な特殊文字列（定義済みおよびカスタム）の一覧は、Annotation ダイアログの Text フィールドに関連付けられたドロップダウン矢印をクリックすると表示されます。

配置済みテキスト文字列オブジェクトの特殊文字列にアクセスする。

回路図の定義済み特殊文字列

以下は、回路図ドキュメントで使用できる定義済み特殊文字列です。これらの大半は、Document Options ダイアログの Parameters タブでアクティブドキュメントに対して定義される既定パラメータ情報（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] になります。

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

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

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