はじめに

• デザイン時の動作は、VLE でアプリケーションを作成する間に発生します。
• 実行時の動作は、VLE を使用して作成したアプリケーションを実行する間に発生します。

• 実行時に要求される動作を定義して実装します。アプリケーションで作成するパッケージ内で、実行時の動作を定義します。
• デザイン時の追加の動作を定義して実装します。デザイン時の動作は、VLE 機能拡張ファイルで定義します。

基本的な機能拡張の作成

（例１）ProgressBar 機能拡張

事前準備

1. 実行時パッケージの作成
   機能拡張ファイルを作成する前に、VLE で使用するオブジェクトを実装するコードを記述する必要があります。VLE パレットに追加するオブジェクトを十分にテストしてから、オブジェクトに対するパレット機能拡張を作成します。ScrollBox など、既に Curl API の一部であるオブジェクトにアクセスするための機能拡張を作成する場合は、この手順を行う必要はありません。
   この例では、この拡張例のコードを使用します。
   d:\automated-build-temp\build\win32-atom\docs\default\examples\layout-editor\ProgressBar.zip
   この例を抽出し、progress bar (進捗状況バー) の実行時コードを含む progressbar-ext/progress/load.scurl ファイルを見つけます。
2. プロジェクトの作成
   IDE プロジェクトを含まないディレクトリで起動した場合、機能拡張エディタで使用するオプションは限られます。既存のプロジェクトも使用できます。作成する VLE 機能拡張ファイルのプロジェクトは、機能拡張の編集中は、IDE 内で開かれている必要があります。
3. プロジェクトに実行時パッケージを追加
   任意の既存プロジェクトで VLE 機能拡張を作成できますが、実行時パッケージを含むプロジェクトを選択することが最善です。

機能拡張エディタの起動

機能拡張の作成

• VLE 機能拡張ファイル名 :
  パレット機能拡張ファイルには、完全なパス名を指定する必要があります。ディレクトリの場所を指定するには、[参照] ボタンを使用します。次に、適切なフィールドにファイル名を入力します。既存のファイルを選択する場合、エディタは選択を確認し、ファイルが上書きされる警告を表示します。
  機能拡張ファイルは、機能拡張を VLE パレットに追加するために VLE にロードする Curl ソース ファイル (.scurl) です。機能拡張ファイルは、パレットにオブジェクトを追加するために必要なデザイン時の情報を VLE に提供します。「VLE 機能拡張ファイルのインストールとアンインストール」を参照してください。
• このファイルを name プロジェクトの一部にします :
  このチェック ボックスは、既定ではオンです。プロジェクトに機能拡張が含まれるように、オンのままにします。
• マニフェストを使用します :
  このラジオ ボタンは、既定ではオンです。現在のプロジェクト マニフェストに機能拡張が含まれるように、オンのままにします。機能拡張ファイルがプロジェクトのトップレベルのディレクトリにない場合、この設定は無効になります。
• VLE 機能拡張パッケージ名 :
  機能拡張パッケージのパッケージ名を入力します。機能拡張パッケージには、機能拡張エディタが生成したコードが含まれます。このパッケージには、VLE におけるオブジェクトのデザイン時の動作を定義するほとんどのコードが含まれます。機能拡張ファイルがプロジェクトのトップレベルのディレクトリに位置していない場合、設定は無効になります。

パッケージのインポートとパレット定義ボタン

• マニフェストを使用するパッケージ :
  このラジオ ボタンは、既定ではオンです。パッケージがマニフェストを使用するために、オンのままにします。
• パッケージ名 :
  実行時パッケージの名前を入力します。これは、パレット機能拡張のための事前準備を行った際にプロジェクトに追加されたパッケージです。このパッケージは、プロジェクトの他のすべてのパッケージと共に、このフィールドのドロップダウン リストに表示されます。このリストから正しい実行時パッケージを選択して、[追加] ボタンをクリックします。

• 実行時タイプ :
  このフィールドのドロップダウン リストは、現在のパッケージで定義されたクラスを表示します。VLE パレットに追加するオブジェクトを定義するクラスを選択します。
• このオブジェクトはテキストを含みます。
  このチェック ボックスをオンにして、プロパティの既定のリスト内に font-size などのテキスト タイプのプロパティを含めます。
• このオブジェクトはコントロールです。
  このチェック ボックスをオンにして、control-appearance-changeable?、control-content-background、および control-color などの、コントロールに特有のプロパティを含めます。この設定は、コントロールに適切なイベントも含み、既定のパレット タブとしてコントロールを設定します。

ボタンの構成

（例２）Scrollbar 機能拡張

プロパティの追加

• 既存の定義を使用するオプション
  これらは、VLE パレットを介して既に使用可能な他のオブジェクトに存在するオプションであり、そのため、その定義は既に VLE に組み込まれています。enabled? などの、これらのオプションの 1 つを選択した場合、プロパティ設定情報は完全に適用されることに注意してください。
• 他のローカル オプション
  これらは、エディタがローカル オプションとして識別可能なオプションですが、その定義は VLE に組み込まれていません。
• 他の非ローカル オプション
  これらは、エディタが非ローカル オプションとして識別可能なオプションです。これらの 1 つ、または他のローカル オプションの 1 つを選択する場合、エディタはオブジェクトから取得される情報を使用してプロパティ設定を適用します。

プロパティの設定

• プロパティ名 :
  プロパティ名を設定します。通常、このフィールドを編集する必要はありません。
• メタデータ カテゴリ :
  このフィールドは、VLE プロパティ シートでこのプロパティを設定するカテゴリを決定します。既存のカテゴリのリストから選択するか、または新しいカテゴリの名前を入力します。新しいカテゴリを入力した場合、そのカテゴリはこのプロパティのプロパティ シートに作成されます。
• プロパティ エディタ :
  プロパティ エディタにより、VLE ユーザーがプロパティ シートでこのプロパティの編集をすることが可能です。VLE では、いくつかのプロパティ エディタが既に定義されています。設定しようとするプロパティに適合するものがある場合、その中の 1 つを選択できます。使用可能な特定のエディタがない場合、機能拡張エディタは、SimpleCodeEditor を選択します。SimpleCodeEditor により、エンド ユーザーはプロパティ シートのソース コードまたは IDE エディタのソース コードとしてプロパティを編集することが可能です。
  現在の例では、directionプロパティは列挙型です。[...] ボタンをクリックして、[列挙体エディタの定義] ダイアログを開きます。このダイアログでは、列挙型に対するオプション値を入力できます。このプロパティの有効な値は 2 つのため、vertical および horizontal を入力します。
  他の特別なプロパティ エディタの作成については、このドキュメントの範囲外です。
• ヘルプ テキスト :
  エンド ユーザーが VLE 内のプロパティを編集する場合、プロパティ ペインの下にヘルプ テキストが表示されます。このフィールドを使用して、ユーザーがこのプロパティを編集するときに表示されるヘルプ テキストを入力します。
• ソース コードの初期値 :
  このテキスト フィールドは、プロパティの初期値を提供する Curl 式を指定します。VLE で最初にオブジェクトが作成される際にプロパティが設定されている必要がある場合、このフィールドを使用します。このフィールドを空白のままにしておくと、ユーザーがパレット ボタンを使用してオブジェクトを作成する場合、プロパティは最初に設定されません。
• このプロパティは、ローカル オプション、非ローカル オプション、またはキーボード コンストラクタ引数です。
  これらの 3 つのラジオ ボタンは、このプロパティの種類を示します。エディタは、この情報を特定しようと試みます。必要に応じて、この情報を訂正します。
• 既定のソース コード
  このプロパティの既定値と等しい値の Curl 式、つまり、設定されていない状態のこのプロパティの値です。このテキスト フィールドを空白にすることは、既定のソース コードとして null を指定することと同じです。
  このフィールドは、キーボード コンストラクタ引数を定義する場合のみ有効であり、プロパティがキーボード コンストラクタ引数でない場合は、無効です。

VLE 機能拡張ファイルのインストールとアンインストール

VLE 機能拡張エディタ ユーザー インターフェース

メニュー バー

ファイル メニュー

新しい機能拡張の作成

• VLE 機能拡張ファイル名 :
  VLE 機能拡張が含まれる新しい curl ソース ファイル (.curl 拡張子) の完全なパス名を指定する必要があります。[参照] ボタンにより、ファイル システムを検索できます。
  一度機能拡張ファイル名を指定すると、VLE 機能拡張エディタは、指定したディレクトリ内でmanifest.mcurl と呼ばれるファイルを検索します。そのようなファイルが検出されると、ダイアログの残りのコントロールを有効にします。
• このファイルを name プロジェクトの一部にする :
  このチェックボックスを使用し、新規ファイルを IDE プロジェクトに含めるかどうかを決定します。この設定は、IDE で開かれている Curl プロジェクトを含むディレクトリに機能拡張ファイルが配置されている場合に有効です。ファイルをプロジェクトの一部にすると、統合開発環境のプロジェクト ファイルリストと、プロジェクトのマニフェスト ファイルに表示されます。既定では、このチェック ボックスはオンです。
• マニフェストを使用する/しない :
  このラジオ ボタンのペアは、このファイルが現在のディレクトリで検出されたマニフェストを使用するかどうかを決定します。既定では、ファイルはマニフェストを使用します。
• VLE 機能拡張パッケージの名前 :
  このフィールドは、作成するコードを含むパッケージの名前を指定します。

  VLE 機能拡張コード。[マニフェストを使用しない] ボタンをクリックすると、このフィールドは無効となります。適切な命名規則を使用して、パッケージに名前を付けます。「パッケージの命名」を参照してください。

表示メニュー

ヘルプ メニュー

機能拡張デザイン ウィンドウ

機能拡張設定ペイン

ボタン設定ペイン

• パレット タブ名
  各パレットボタンは、VLE[パレット] タブ コンテナの特定のタブに配置されます。このコンボ ボックスは、このパレット ボタンが配置されるタブ名を指定します。コンボ ボックス ドロップダウンには、[グラフィックス] および [コントロール] が含まれます。これらは、新しく定義されたオブジェクトに最も適切な 2 つの既存のタブ名です。ドロップダウンには、この VLE 機能拡張で以前に定義されたパレット ボタンで既に使用された他のパレット タブ名も含まれます。ここでは任意のタブ名を入力でき、新しいタブに表示されるパレット ボタンはその名前になります。
• パレット グラフィック
  これは、28x28 ピクセルの画像を含むファイルの URL になります。VLE 機能拡張エディタの実行中、このファイルが存在する場合は、画像の URL を表示するテキスト フィールドの左側に画像が表示されます。このパレット ボタンのアイコンを指定していない場合、既定のアイコンがここに表示されます。
• デザイン時作成演算子
  このテキスト フィールドは、VLE が [レイアウト] ペインで表示するオブジェクトの作成に使用される作成演算子を指定します。
  通常、これは実行時作成演算子と同じですが、実行時オブジェクトとは異なるデザイン時オブジェクトを指定することも可能です。たとえば、実行時オブジェクトが VLE を実行中に使用できない実行環境のいくつかのコンポーネントを要求する場合に便利です。
  注意: 基本モードでは、このフィールドは表示されません。
• 表示目的で使用する名前
  このテキスト フィールドは、VLE ヒント内、VLE レイアウト ツリー内、およびその他の場所内のオブジェクトの参照に使用される名前を指定します。
  通常、この名前は実行時作成演算子と同じですが、異なる場合もあります。たとえば、VLE では、テーブルの行の実行時作成演算子は row-prototype ですが、表示する名前は、単に row です。
  注意: 基本モードでは、このフィールドは表示されません。
• DesignTimeGraphic サブクラス名
  このテキスト フィールドは、このパレット アイテムを表すために定義する DesignTimeGraphic サブクラスの名前を指定します。
  標準規則では、DesignTimexxx のような名前を使用します。ここで、xxx は実行時作成演算子です。実行時作成演算子がクラス名でない場合、異なる名前にすることもできます。
  注意: 基本モードでは、このフィールドは表示されません。

プロパティ設定ペイン