4.4 - Script Editorを使用する

自動的にコードをフォーマットする

スクリプト・エディタは、あなたのために、自動的にコードをフォーマットします。キーワード、関数、サブルーチン、および変数の大文字でも、入力内容に関係なく、スクリプトエディターによって処理されます。コードをカスタムフォーマットすることはできませんが、それぞれの行に、インデントを設定したり、カスタム改行を配置したりできます。

関数を呼び出すときに戻り値を使用する場合、パラメーターを囲む括弧は必須です（ほとんどの近代的なプログラミング言語と同様）。：

a = fooFunc (b, c)

しかしながら、関数呼び出しから、返された値が、すでに破棄されている場合、あるいは、サブルーチンを呼び出す場合、括弧は省略する必要があります（他のほとんどの言語とは異なります）。：

barFunc d, e
Call fooBarSub (f) 

Coloring syntax automatically

あなたが、Codeウィンドウでコードを開発すると、スクリプト・エディタは、分類に従って、それぞれの単語に色をつけます。

単語の色と分類

単語の色	分類
青	オートメーション・キーワードまたはプログラミング・ステートメント
緑	コメント
黒	他の全てのテキスト

Codeウィンドウでは、次の色付け手法も使用されます。：

Codeウィンドウでの色分け

Codeウィンドウ	分類
赤いテキスト	エラーが含まれているコード行
青色背景の白いテキスト	選択されたテキスト
黄色で強調表示されたテキスト	デバッグのために実行が一時停止される行
赤い背景に白いテキスト、左マージンに赤い点	デバッグのために設定されたブレークポイント（マクロのデバッグを参照）
左マージンの青い点	左マージンの青い点

構文の色付けと強調表示：

あなたが、アプリケーションを終了したとき、ブレークポイントとブックマークが失われます。

スクリプト・エディタは、あなたが、構文を強調表示するために、デフォルトの色を変更できます。[ツールオプション]をクリックし、[エディターの形式]ページで設定を選択します。

Jumping to definitions

スクリプト・エディタは、あなたが、変数、関数、オブジェクトの定義に、直接移動できます。

　　

変数、関数、オブジェクトの定義に移動する

目的の定義	手順	移動先
変数	Codeウィンドウで、変数を右クリックし、[定義]をクリックします。	コードの変数の定義
関数	Codeウィンドウで、関数を右クリックし、[定義]をクリックします。	コードの関数の定義
オブジェクト	Codeウィンドウで、オブジェクトを右クリックし、[定義]をクリックします。	オブジェクト・ブラウザのオブジェクトの定義

あなたが、定義をリクエストした場所に戻るために、Codeウィンドウのどこかを右クリックします。続いて、最後の位置をクリックします。

Using contextual pop-up lists for automatic completion

スクリプト・エディタは、あなたが記述する関数と、すべての組み込みのキーワードと列挙値が含まれているあなたが内部のリストに定義する変数を、追加します。あなたは、入力しながら、スクリプト・エディタは、現在の位置に挿入するための有効な候補の単語のコンテキスト・リストを表示します。この自動補完機能は、コード開発を迅速かつ便利にします。

自動補完のポップアップ・リスト：

あなたが、使用したい単語の最初の数文字を入力すると、ポップアップ・リストは、最も近い候補へ進みます。それは、それらの文字と一致します。目的の単語を選択し、続いて、以下のいずれかを実行します。：

• 単語の後に続く文字を入力します（通常は、空白、改行、括弧、ピリオド、コンマ）。
• Tab、あるいは、Ctrl + Enterを押して単語のみを入力します。

ポップアップ・メニューを強制的に表示するために、Ctrl +スペース・バーを押します。;メニューは、あなたが、これまでに入力した文字に最も近い単語にスクロールします。この技術は、関数やサブルーチンを呼び出すとき、パラメーター・リストの入力に特に役立ちます。完全一致が1つしかない場合、スクリプト・エディタは、リストをポップアップすることなく、単語を挿入します;選択したキーワードのポップアップ・リストを、自動補完なしで、いつでも表示するには、Ctrl + Jを押します。

Using the Class list

すべてのプロジェクトとライブラリは、Classリストで表示される、次のクラスに関連したアイテムを含むオブジェクト・モデルを持っています。

• グローバル値
• クラス
• モジュール
• 型
• 列挙体

グローバル値は、プロジェクトやライブラリ全体に適用されます。そして、それらは、列挙体から、それぞれのメンバーが含まれています。（テキストと段落の配置、シェイプタイプ、インポート/エクスポートフィルターのような）。

クラスには、プロパティ、メソッドとイベントが含まれています。詳細については、「クラスとは、何？」を参照してください。

CorelDRAWやCorel PHOTO-PAINTで利用できるすべてのクラスの文書については、「APIリファレンス|クラス」セクションを参照してください。

モジュールには、マクロ・コードが含まれています。

CorelDRAWで利用できるすべてのモジュールの文書については、「APIリファレンス|モジュール」セクションを参照してください。

型は、オートメーション環境によって、提供される組み込みデータ型を補完するカスタマイズされたデータ型です（「変数の宣言」を参照）。

CorelDRAWで利用できるすべての型の文書については、「APIリファレンス|型」セクションを参照してください。

列挙体は、マクロのためのコーディングの手順と関数で、固定値を表します。詳細については、「列挙体とは、何？」を参照してください。

CorelDRAWやCorel PHOTO-PAINTで利用できるすべての列挙体の文書については、「APIリファレンス|列挙体」セクションを参照してください。

Classリストの型のそれぞれの項目は、それに割り当てられたアイコンを持っています。：

Classリストの型に割り当てられたアイコン

アイコン	項目
グローバル値
	クラス
	モジュール
	型
	列挙体

選択した項目のための「ヘルプ」トピックにアクセスするには、「ヘルプ」ボタンをクリックするか、F1を押します。

Using the Member list

あなたが、項目をClassリストから選択するとき、その項目のメンバーが、メンバーリストに表示されます。クラス・メンバーには、以下のものが含まれています。：

• プロパティ
• メソッド
• イベント
• 定数

プロパティは、（Boolean、integerや文字列のような）単純型やClassリストからのクラスや列挙体になることができます。Classリストのクラスに基づいたプロパティは、そのクラスのすべてのメンバーを継承します。

多くのクラスは、デフォルトのプロパティを持っています。親のオブジェクトの値を取得する、あるいは、設定するとき、プロパティ名が指定されていない場合、デフォルトのプロパティが、暗示されます。たとえば、コレクション型は、インディックスを作成できるデフォルトのプロパティItemを持っています。;このような場合には、それは、Itemプロパティを指定する必要はありません。

ここで、

ActiveSelection.Shapes.Item(1).Selected = False

は、短いものと同じです。

ActiveSelection.Shapes(1).Selected = False

Itemが、shapesコレクションのデフォルト、あるいは、暗示されたプロパティであるため、

CorelDRAWやCorel PHOTO-PAINTで利用できるすべてのプロパティの文書については、「APIリファレンス|プロパティ」セクションを参照してください。

メソッドは、一般に、「メンバ関数」として知られています。－クラスが、それ自体で実行できる関数。良い例は、［x、y］ベクトルを使用することにより、shapeを移動する、CorelDRAWのShapeクラスのMoveメソッドです。次のコードは、選択したシェイプを2測定単位右に移動し、3測定単位を上に移動します。：

ActiveSelection.Move 2, 3

関数の戻り値が使用されていない場合、Callキーワードが使用されない限り、関数呼び出しは、引数リストを括弧で囲みません。

CorelDRAWやCorel PHOTO-PAINTで利用できるすべてのメソッドの文書については、「APIリファレンス|メソッド」セクションを参照してください。

イベントは、いくつかのクラスに関連付けられています。そのイベントが、アプリケーションで発生するとき、あなたは、呼び出されるイベント・ハンドラを設定することができます。;この機能により、あなたは、アプリケーション内で起きていることに自動的に応答する洗練されたアプリケーションを開発できます。一般的に処理されるイベントには、Corel DESIGNERおよびCorelDRAWのDocumentクラスのBeforePrint、BeforeSave、PageActivate、SelectionChange、ShapeMoveイベントが含まれています。

CorelDRAWやCorel PHOTO-PAINTで利用できるすべてのイベントの文書については、「APIリファレンス|イベント」セクションを参照してください。

メンバリストで表示される定数は、列挙体のメンバーであるか、モジュールでパブリックとして定義されています。列挙体は、閉じたリストから関連したアイテムをグループ化します－Corel DESIGNERとCorelDRAW shape型、インポート／エクスポートのフィルタとアライメントのような、－どこかで使用するために、整数値は必須です。

Corel DESIGNER、CorelDRAW、およびCorel PHOTO-PAINTでは、多くの定数がcdr（cdrEPSやcdrLeftAlignmentなど）で始まりますが、他の定数はclr、cui、pdf、pnt、またはprnで始まります。Visual Basicには、キーストローク用のもの（vbKeyEnterなど）やダイアログボックスボタン用のもの（vbOKなど）など、独自の定数もあります。

CorelDRAWやCorel PHOTO-PAINTで利用できるすべての定数の文書については、「APIリファレンス|定数」セクションを参照してください。

メンバリストの型のそれぞれの項目は、それに割り当てられたアイコンを持っています。：

メンバリストの型に割り当てられたアイコン

アイコン	項目
	プロパティ
	デフォルト
	プロパティ
	メソッド
	イベント
	定数

選択した項目のための「ヘルプ」トピックにアクセスするには、「ヘルプ」ボタンをクリックするか、F1を押します。

Using the Information window

情報ウィンドウは、選択されたクラスやクラス・メンバーに関する情報を提供します。この情報は、次のものを含みます：

• 項目のプロトタイプ
• 項目が読取り専用プロパティであるかどうかの表示
• 項目の親
• 項目の短い説明

Corel PHOTO-PAINTのDocument.Applicationプロパティのための情報ウィンドウ：

情報ウィンドウは、すべての参照されている型とクラスへのハイパーリンクを提供します。現在のオブジェクトモデル内で定義されます。たとえば、Corel PHOTO-PAINTのDocument.Applicationプロパティの情報：（前の図を参照）次のハイパーリンクが、含まれています：

• Application－Applicationが、Document.Applicationプロパティの型とPHOTOPAINTライブラリのクラスであるため、Applicationクラスにアクセスします。
• PHOTOPAINT－Corel PHOTO-PAINTオブジェクト・モデル内のすべてのクラスに含まれている、PHOTOPAINTライブラリのクラスにアクセスします。
• Document－Applicationプロパティの親のDocumentクラスにアクセスします。

Informationウィンドウが、完全にコンテンツを表示するほど高さがない場合、スクロール・バーが、提供されます。

Informationウィンドウの高さを増やすために、ウィンドウの上部の境界線を上にドラッグします。

Using the search controls

検索コントロールを使用すると、選択したプロジェクトやライブラリで特定の文字列を検索できます。あなたが、クラスやクラス・メンバーの名前を部分的にしか覚えていない場合、あるいは、あなたが、（"open"という単語を含んでいるような）類似した名前を持っている、クラスとメンバーを見つけたいとき、検索は、役に立ちます。

CorelDRAWオブジェクトモデルの検索

選択したオブジェクト・モデルのクラスとメンバーを検索するために、Searchボックスに文字列を入力します。続いて、Searchボタンをクリックします。検索結果ウィンドウは、すべての一致が、アルファベット順に表示されます。一致をクリックすると、ClassリストとMemberリストがそのアイテムに移動し、そのアイテムの情報ウィンドウが表示されます。

クラス名と一致することは、検索結果ウィンドウで空白のMember列を持っています。

検索結果ウィンドウを非表示にするには、「検索結果を非表示」ボタンをクリックします。