VisualApplets
ユーザーマニュアル

階層ボックスを右クリックして、モジュールのコンテキストメニューを開きます。

Save to User Libraryを選択します。

Saveダイアログがポップアップ表示されます：

図170：階層ボックスのユーザーライブラリ要素としての保存

新しい要素を保存するユーザーライブラリを選択します（または、New User Libraryをクリックして新しいライブラリを定義します）。

新しいユーザーライブラリ要素の名前を（Element Typeの下に）入力します。

オプション：要素に関する情報（バージョン番号、簡単な説明、個別のGUIアイコン、HTMLヘルプファイル形式のドキュメント）を追加する場合：

ユーザーライブラリ要素を保護する場合は、Protectionオプションを選択します。これにより、ユーザーライブラリ要素が「ブラックボックス」になります（要素の保護の詳細については、「ユーザーライブラリ要素の保護」を参照してください）。

Saveをクリックします。

オプションのPNGファイルとHTMLファイルは、VisualAppletsのインストールディレクトリのサブディレクトリであるLibraryCacheにコピーされます。

Protectionオプションを有効にしている場合、Protect User Library Elementダイアログボックスが表示されます。

すべてのUserライブラリとそのコンテンツは、ライブラリパネルで使用できます（The User Interface of VisualAppletsを参照）。User Libraryタブをクリックして、User Libraryウィンドウを表示します。

選択したアイコンが、ライブラリ要素とともに表示されます。

個々の要素に関する詳細情報は、ツールチップに表示されます。

図 173. User Library要素のツールチップ情報

新しいUser Library要素を選択すると、対応するヘルプ情報がHelpタブの下の情報パネルに表示されます。

デザインウィンドウ内の表示が変更されます。「HierarchicalBox」の代わりに、User Library要素の名前が表示されます。階層ボックスのアイコンは、ライブラリ要素用に選択したアイコンに置き換えられています。デザイン内のインスタンスの名前（アイコンの下）は変更されていません。

図 174. デザイン内でのUser Library要素の表示

メインメニューから、Library → Edit User Library → New User Library Elementを選択します。

これでデザインエディターが閉じます。デザインエディターとともに、作業していたデザインも閉じられます。

User Libraryエディターが開きます。User Libraryエディターは、通常のデザインエディターと同様に動作します。

新しいUser Library要素の名前を定義します。

ターゲットハードウェアプラットフォームを選択します。

(ただし、このプラットフォームは、カメラオペレーターなど、ハードウェアの問題に依存するオペレーターをエレメントに含める場合にのみ関連します。)

OKをクリックします。

OKをクリックすると、ダイアログボックスが開き、エレメントの入力ポートと出力ポートの数を指定する必要があります。これらの数は後から変更できないため、入力リンクと出力リンクの数を正しく指定してください。

	必要な数のリンクを定義する
	後からこれらの数を変更することはできないため、入力リンクと出力リンクの数を正しく指定してください。

OKをクリックしてポートの定義を確認します。

ユーザーライブラリエディターが開き、指定した入力ポートと出力ポートのみを含む空のエレメントデザインが表示されます。

必要に応じて、ユーザーライブラリエレメントのデザインを編集します。

完了したら、メインメニューからFile → Save Asを選択してエレメントを保存します。

図 175: 新しいユーザーライブラリエレメントの保存

新しいエレメントを保存するユーザーライブラリを選択します（または、New User Libraryをクリックして新しいライブラリを定義します）。

オプション：エレメントに関する情報（バージョン番号、簡単な説明、個別のGUIアイコン、HTMLヘルプファイル形式のドキュメント）を追加する場合：

ユーザーライブラリエレメントを保護するには、Protectionオプションを選択します。これにより、ユーザーライブラリエレメントが「ブラックボックス」になります。（エレメントの保護の詳細については、'Protecting User Library Elements'を参照してください。）

	保護されたエレメントはレガシーファイル形式で保存できません
	ユーザーライブラリを *.vl レガシーファイル形式で保存した場合、保護された要素は保存されません。この場合、保護を解除するか、より新しく推奨される *.val ファイル形式でユーザーライブラリを保存してください。 レガシーファイル形式を使用すると、VisualAppletsバージョン3.3.2以前でユーザーライブラリを開くことができます。

Saveをクリックします。

オプションのPNGおよびHTMLファイルは、VisualAppletsのインストールディレクトリのサブディレクトリ LibraryCacheにコピーされます。

Protectionオプションを有効にした場合は、追加のダイアログProtect User Library Elementが表示されます。

すべてのUserライブラリとそのコンテンツは、ライブラリパネルで使用できます（The User Interface of VisualAppletsを参照）。User Libraryタブをクリックして、User Libraryウィンドウを表示します。

選択したアイコンが、ライブラリ要素とともに表示されます。

個々の要素に関する詳細情報は、ツールチップに表示されます。

図178：ユーザーライブラリ要素に関するツールチップ情報

新しいユーザーライブラリ要素を選択すると、対応するヘルプ情報がHelpタブの下の情報パネルに表示されます。

デザインの作業を続行するには、ユーザーライブラリ要素のデザインとユーザーライブラリエディタを閉じます。メインメニューから、File → Closeを選択します。

	File->Closeで要素デザインを閉じる
	デザインのタブを閉じるだけでは、要素デザインを閉じたことにはなりません。ユーザーライブラリエディタも閉じる必要があります。 両方を閉じるには、File → Closeをクリックします。このようにユーザーライブラリ要素のデザイン（およびライブラリエディタ）を閉じて初めて、通常のデザインエディタ、ひいてはアップレットデザイン全体を再び開くことができます。

デザインの作業を続けるには、デザインを開きます。

現在作業中のデザインを保存します。

ライブラリペインで、User Libraryタブに移動します。

編集する要素を右クリックします。

要素のコンテキストメニューから、Editを選択します。

図 182：User Library Editorを開く

変更を加えます。

変更を保存します。

メインメニューから、Library → Element Detailsを選択します。

編集した要素を保存します。

階層ボックスまたはインスタンス化されたUser library要素を、既存のUser library要素の名前で保存します（'Saving a Hierarchical Box as a User Library Element'で説明されているとおりです）。

更新するインスタンスを選択します。

メインメニューから、Library → Quick Update from User Libraryを選択します。

Ctrlキーを押したまま、更新するすべてのインスタンスを選択します。

メインメニューから、Library → Quick Update from User Libraryを選択します。

要素の選択されたすべてのインスタンスが新しいインスタンスに置き換えられます。

置き換えを行うモジュールを選択します（Ctrlキーを押しながら）。

メインメニューから、Library → Update from User Libraryを選択します。

ダイアログウィンドウUpdate User Library Elementsが開きます。左側のパネルには更新用に選択したモジュールが表示され、右側のパネルにはユーザーライブラリが表示されます。

図183. インスタンスの置き換え

右側のパネルで、必要なユーザーライブラリ要素を選択します。左側のパネルでは、希望通りに置き換え可能なすべてのモジュールが緑色でハイライト表示されます（そうならない場合は、入力と出力の数が一致しているか確認してください）。

Replace Modulesをクリックします。

ノード数が一致するリスト内のすべてのモジュールが、新しいユーザーライブラリ要素のインスタンスに即座に置き換えられます。