# プロパティシート

関数リファレンスが構造体関数を返す場合、または関数に複数の入力パラメータがある場合、In-Sight 関数を設定するにはプロパティシートを使用します。

注: 可変数のパラメータを受け入れる関数 (画面表示関数など) にはプロパティシートはありません。代わりに、セル、またはツールバーの数式バーで直接、プロパティを設定します。プロパティシートがあるのは、固定数のパラメータを持つ関数だけです。

すべてのプロパティシートには、関数のデフォルトのパラメータ、値、および式を示す表が表示されます。プロパティシートの各行は、パラメータの名前と値、または展開/折り畳み可能なパラメータと値のグループで構成され、展開と折り畳みは / 記号で示されます。

注:

プロパティシートのパラメータの一部は、わかりやすいように次の [領域] のようにまとめられています。

ヒント:

プロパティシートのパラメータは、設定項目をドラッグ & ドロップして、スプレッドシートに配置することができます。プロパティシートからパラメータを選択してから、それをスプレッドシートにドラッグすることによって、パラメータのラベルとエディットコントロールが自動的に作成され、スプレッドシートで参照できるようになります。

例えば、DetectBlobs関数のプロパティシートが開いている場合、[しきい値] パラメータをスプレッドシートのセル A2 にドラッグ & ドロップすると、セル A2 にテキスト「しきい値」が入力され、A3 に EditInt関数が入力されます。DetectBlobs 関数のプロパティシートの [しきい値] パラメータは、セル $A$3 に対する絶対セル参照として自動的に設定されます。

パラメータの値は、以下の方法で割り当てることができます。

- セル参照:値は、スプレッドシート内のセルへの絶対または相対セル参照によって決まります。

注: パラメータ値をダブルクリックして Esc キーを押すと、そのパラメータのテキストがオペレーティングシステムのクリップボードにコピーされ、以前にコピーされたテキストを上書きします。プロパティシートを編集する場合は、パラメータをダブルクリックするのではなく、プロパティシートのメニューまたはツールバーボタンを使用してパラメータを編集することを推奨します。

- 座標:対話型グラフィックスモードに切り替えるか、座標の数値を手動で入力することで値が指定されます。
- 整数: ボタンをクリックすることによって値を増減したり、目的の数値を手動で入力したりすることができます。
- テキスト:値は英数字によって表されます。
- チェックボックス:チェックボックスがオフのときは値 0 が割り当てられ、チェックボックスがオンのときは 1 が割り当てられます。
- ドロップダウンリスト:値は、リスト内の選択項目から選択されます。値は、リストから選択された項目のインデックス番号 (ゼロから始まります) に設定されます。

注: プロパティシートのパラメータは、操作手順の状況によって異なります。したがって、メニューバーとツールバーは、選択したパラメータが特定の編集または挿入操作をサポートしている場合のみ有効になります。

## プロパティシートを表示するには

[関数の挿入] ダイアログを使用して、スプレッドシートのセルに関数を挿入します。関数にプロパティシートがある場合には、プロパティシートが自動的に開きます。

各プロパティシートは、以下のもので構成されています。

- 関数名、ダイアログ名を示すタイトルバー
- メニューバー
- ツールバー
- パラメータ設定領域
- 状況依存ヘルプ

注: テキストが赤色でハイライトされている場合は、値にエラーがあり、エラーを修正しないと確定できません。別のパラメータまたは [OK] ボタンを選択すると、エラー部分はそれ以前に指定されていた有効な値に戻ります。

## プロパティシートでセルグラフィックスを編集するには

1. セルグラフィックスが関連付けられているパラメータをクリックします。

2. プロパティシートの [編集] メニューの [グラフィックス] をクリックします。または、プロパティシートのツールバーにある [グラフィックスの編集] ボタンをクリックするか、セルグラフィックスが関連付けられているパラメータ名をダブルクリックします。プロパティシートが消え、画像の上に対話型グラフィックスモードが表示されます。

   注: 選択したパラメータにセルグラフィックスが関連付けられていない場合、[グラフィックスの編集] メニューとツールバーボタンは、グレーアウトされます。
3. 変更を確定するには、ツールバーの [OK] ボタンをクリックするか、Enter キーを押すか、セルグラフィックス内をダブルクリックします。変更をキャンセルするには、[ジョブの編集] ツールバーの [キャンセル] ボタンをクリックするか、Esc キーを押します。

## 領域セルグラフィックスを最大化するには

1. 領域セルグラフィックスが関連付けられているパラメータをクリックします。

2. プロパティシートの [編集] メニューの [領域の最大化] をクリックします。または、プロパティシートのツールバーにある [領域の最大化] ボタンをクリックします。領域のセルグラフィックスのサイズが、参照先の データ構造体の画像領域と同じサイズに変更されます。セル A0 は、デフォルトの画像ソースです。

   注: 選択したパラメータに領域セルグラフィックスが関連付けられていない場合、[領域の最大化] メニューとツールバーボタン は、グレーアウトされます。
3. 変更を確定するには、[OK] ボタンをクリックします。変更をキャンセルするには、[キャンセル] ボタンをクリックします。

注:

1. スプレッドシートにパターンマッチ関数関数を挿入します。プロパティシートが自動的に開きます。[画像] パラメータの値は $A$0 であり、デフォルトの画像ソースであるセル A0 を参照しています。

2. [サーチ領域] パラメータをハイライトします。

3. プロパティシートの [編集] メニューの [領域の最大化] をクリックするか、またはツールバーの [領域の最大化] ボタン をクリックします。領域のセルグラフィックスのサイズが、参照先の データ構造体 (セル $A$0) の画像領域と同じサイズに変更されます。

## プロパティシートに関数を挿入するには

プロパティシートのパラメータに関数を挿入することによって、動的引数を作成することができます。例えば、DetectBlobs 関数を使用していて、変動する一連の差異に基づいて画像取り込み時に [しきい値] パラメータを動的に変更する場合は、数学関数関数をパラメータに挿入して、差異に応じて計算することができます。パラメータに関数を追加することによって (スプレッドシート内で個別の関数を作成し、同じ数式を作成して、それらのセルを参照するのではなく)、時間とスプレッドシートの計算スペースを節約することができます。

注: 数式の最大長は 248 文字です。248 文字を超える長さの数式を入力すると、プロパティシートを閉じて変更をキャンセルするまで、In-Sight Explorer が応答しなくなる場合があります。変更はすべて失われ、更新した数式は受け付けられません。

1. 関数を挿入したいパラメータをクリックします。

   注: 折り畳まれているグループに関数を挿入することはできません。プラスボタンを押して、グループを展開しておく必要があります。次に、個々のサブパラメータを選択します。

2. プロパティシートの [挿入] メニューの [関数] をクリックします。または、プロパティシートのツールバーにある [関数の挿入] ボタンをクリックします。

   注: 選択したパラメータが関数をサポートしていない場合、[関数の挿入] メニューとツールバーボタンはグレーアウトされます。

3. パラメータの値が編集可能な式に変わります。

4. 関数の名前、左括弧、パラメータの順に手動で入力します。

   注: 関数の名前を手動で入力して、テキストが赤色でハイライトされた場合は、その数式にエラーがあり、修正しないと確定できません。

5. 関数を作成したら、Tab キーを押して関数を確定し、次のパラメータに移動します。

6. Enter キーを押すと、自動的に関数が確定されて、プロパティシートは閉じます。Esc キーを押すと、確定せずにプロパティシートを閉じます。

## プロパティシートからセル参照を挿入するには

1. セル参照を挿入したいパラメータをクリックします。

2. プロパティシートの右クリックメニューから、[絶対参照を挿入] または [相対参照を挿入] をクリックします。あるいは、プロパティシートのツールバーの ボタンまたは ボタンをクリックします。プロパティシートが消えて、セル選択モードになります。

   ヒント: パラメータの種類によっては、パラメータをダブルクリックしてセル選択モードに切り替えることもできます。

3. プロパティシートのパラメータの値を含むセルを選択します。

   ヒント:
   - 複数セル参照は、複数の値を持つパラメータ (フィクスチャや領域など) を定義する際に有効です。
   - パラメータにセル参照が設定されると、スプレッドシートでハイライトされます。このとき、プロパティシートを閉じずにマウスでセル参照先を移動することができます。
   - パラメータに手動で関数を入力する場合 (可能な場合)、相対セル参照カーソル (Shift キーを押すと、絶対セル参照カーソル に変わります) を使用してスプレッドシートのセルをクリックすると、セル参照を挿入することができます。
4. セル参照を確定するには、ツールバーの [変更を確定する] ボタン をクリックするか、Enter キーを押すか、セルをダブルクリックします。セル参照をキャンセルするには、[ジョブの編集] ツールバーの [変更をキャンセルする] ボタン をクリックするか、Esc キーを押します。
5. プロパティシートの値をすべて変更した後、[OK] をクリックすると変更が確定されます。[キャンセル] を押すと、すべての変更が元に戻されて、スプレッドシートに戻ります。