CorelDRAWとCorel DESIGNERで、カスタム・ツールを作成する

Prerequisites

• Microsoft Visual Studio 2012以降が必要です。Visual Studio Community（無料版）は、Microsoftから、こちらで入手できます。
• この記事では、Visual Studio用の「CorelDRAWおよびCorel DESIGNERツール・アドオン」拡張機能について説明します。拡張機能をインストールするために、Visual Studioを実行します。メニュー項目の[ツール]-> [拡張機能と更新]を選択します。[オンライン]タブを展開し、「CorelDRAW」を検索します。「CorelDRAW and Corel DESIGNER Tool Addon」拡張機能を選択してインストールします。

Creating a New Project

まず、"CorelDRAW and Corel DESIGNER Tool Addon"拡張機能が、Visual Studioにインストールされると、それは、[ファイル]-> [新しいプロジェクト]リストを通して利用できます。[ファイル]-> [新しいプロジェクト]に移動します。そして、[インストール済み]-> [テンプレート]-> [その他の言語]-> [C＃]に移動します。そして、"CorelDRAW and Corel DESIGNER Tool Addon"をリストから選択します。ツールの名前を選択します。（例えば「MyTool」）そして、プロジェクトを作成するために、OKを押します。

次に、スタートアップ・アプリケーションが、選択したアドオン設定ダイアログが、表示されます。この選択は、プロジェクトのプロパティ・ダイアログによって、後から変更できます。（外部プログラムを起動する）。注記：アプリケーションが、コンピュータ上にインストールされたテンプレートを検出した場合、アプリケーションの選択は、有効になっています

Compile and Run

アドオンをコンパイルするために、[ビルド]-> [ソリューションのビルド]を選択します。（あるいは、F7を押します）。F5を押します。そして、それは、以前に選択されたアプリケーション(CorelDRAWやCorel DESIGNER)を起動します。そして、新しいツールは、ツールボックスに追加されます。

このサンプル・ツールを使用すると、ユーザーは、2点を指定した直線を作成でき、カスタムツールの作成が、いかに簡単かを示します。画面プレビューUI、スナップ、制約、プロパティ・バー、およびツールに期待される他のすべてを備えています。

The Code

プロジェクトは、2つの.csファイルを持っています。Addon.csは、エントリ・ポイントが含まれています。このクラスは、ホスト・アプリケーション(CorelDRAWやCorel DESIGNER)で、インスタンス化されています。アプリケーションが起動するとき、これは、他のデータソースや他のタスクは、アプリケーションの起動時に実行する必要がある新しいツールが登録される場所です。

///<summary>
/// Constructor for the Addon.  This is called by CorelDRAW or Corel DESIGNER when it is discovered.
/// アドオンのコンストラクタ。これは、それが発見されるとき、CorelDRAWやCorel DESIGNERが呼び出されます。
///</summary>
public Addon(Application Application)
{
        // Create and register our tool
        ToolState toolState = new CGS.MyTool(Application);
        Application.RegisterToolState("b17f7ca0-0062-4dd8-adf6-1ea2192a3d35", "MyTool", toolState);
}

RegisterToolState関数は、GUID(Globally Unique IDentifier)"b17f7ca0-0062-4dd8-adf6-1ea2192a3d35"が、MyToolアドオンを識別するために、そのアプリケーションに伝えます。このGUIDは、ツールごとに異なる必要があります。そして、Visual Studio拡張機能は、プロジェクトごとに新しい拡張機能を生成します。複数のツールは、プロジェクト内で作成でき、すべてが、この場所で登録できます。それぞれのツールは、一意のGUIDが必要です。これは、Visual Studioの[ツール]-> [GUIDの作成]、あるいは、Webで利用できる同等のGUIDジェネレーターを使用して作成できます。

MyTool.csファイルは、ツールのコードが含まれています。このサンプル・ツールの長さは、200行未満ですが、必要なカスタム・ロジックを実行するように拡張できます。MyToolクラスは、ToolStateインターフェイスを継承します。ツールを使用するとき、ホスト・アプリケーションは、実装されるさまざまな機能を呼び出します。たとえば、ツールを開始するとき、OnStartState()関数が、ツールを使用するように設定できる呼び出されます。あなたが、ビューを横切るようにマウスを移動するとき、OnMouseMove()関数が、呼び出されます。この関数は、UIを更新するために、使用することができます。あるいは、曲線を作成するために、マウスの位置を収集します。

サンプルツールのコードは、うまく文書化されていますが、関数の基本的な理解を得るために、コードとコメントを一読してください。線ツールの擬似コードは、次のとおりです。：

• OnLButtonDownLeaveGrace

  マウスの左ボタンが、押された位置を保存します。

• OnMouseMove

  マウスの左が、押された場合、現在の位置まで保存した場所からの線で、画面UI上で、排他的論理和を更新します。

• OnLButtonUp

  保存した位置から、現在の位置まで線を作成します。

The UI

プロジェクトは、2つのXSLTファイルを持っています。：AppUI.xsltとUserUI.xslt.XSLTは、XML変換ファイルです。その目的は、新しいツールを含めるために、ユーザーのワークスペースを更新することです。このサンプルは、新しいツール・ボタンをツールボックスの最後に追加します。他のXSLT変換を使用すると、ワークスペースをより複雑に変更できます。あなたが、複雑なUIを作成しようとしている場合、よく理解するために、XSLTを読むといいかもしれません。

AppUI.xsltファイルは、新しい項目（例えばボタン）を定義する役割を果たします。そして、新しいドッキング・ウィンドウやダイアログを追加します。カスタマイズできないものは、すべてここで定義できます。サンプルの線ツールでは、それは、1つの新しい項目を追加します。

<!-- C# Test Line Tool 線ツールのC#によるテスト-->
<itemData guid="b17f7ca0-0062-4dd8-adf6-1ea2192a3d35"
          type="groupedRadioButton"
          currentActiveOfGroup="*Bind(DataSource=WAppDataSource;Path=ActiveTool;BindType=TwoWay)"
          enable="*Bind(DataSource=WAppDataSource;Path=ToolboxEnable)"
          identifier="b17f7ca0-0062-4dd8-adf6-1ea2192a3d35"/>

GUIDは、ツール・ボタンを識別するために使用されます。("b17f7ca0-0062-4dd8-adf6-1ea2192a3d35").このGUIDは、項目とグループ化されたradio識別子のために設定されます。これは、MyToolとして、アプリケーションに登録された、同じGUIDでもあります。これは、ボタンが、クリックされるとき、MyToolが、アクティブになるため、重要です。

UserUI.xsltは、カスタマイズ可能なUIを変更するためのものです。たとえば、既存のツールバー、メニューへのボタン、あるいは、ツール、その他の作成する新しいツールバーを追加します。

  <!-- Add tool item to the Toolbox -->
  <xsl:template match="//commandBarData[@guid='7c905e2a-cb64-4ba1-aff0-c306f392680c']/toolbar">
    <xsl:apply-templates mode="insert-item" select=".">
      <xsl:with-param name="content">
        <xsl:if test="not(./item[@guidRef='6b5b83bb-e7b8-4f9d-8dfd-36f59bf545cf'])">
          <!-- Only insert if its not already there -->
          <item guidRef="6b5b83bb-e7b8-4f9d-8dfd-36f59bf545cf"/>
        </xsl:if>
      </xsl:with-param>
    </xsl:apply-templates>
  </xsl:template>
  <xsl:template match="uiConfig/commandBars/commandBarData[@guid='74e03d83-404c-49f5-824a-fe0fd02ab29a']/toolbar">
     <xsl:copy>
       <xsl:apply-templates select="node()|@*"/>
       <modeData guid="fd9a53f7-05cc-4cdc-b2ad-0fd6a7ea3480" captionRef="01965a34-ae38-01a0-4271-cd903b48e518">
         <item guidRef="3148e122-4f73-6e8a-4dfb-b2f6a84090d5"/>
         <item guidRef="a41164ff-c9e9-4b2c-954a-095f4204538e"/>
         <item guidRef="266435b4-6e53-460f-9fa7-f45be187d400"/>
         <item guidRef="325d7c86-da3a-4610-bd25-5cf98cf66a41"/>
         <item guidRef="42bef211-16e5-4b4f-b9ee-52b7b5476232"/>
         <item guidRef="d289f32b-3808-4510-b892-fd2cb0820209"/>
         <item guidRef="266435b4-6e53-460f-9fa7-f45be187d400"/>
         <item guidRef="8723ad52-3e31-473c-8756-7ae85abcc483"/>
         <item guidRef="266435b4-6e53-460f-9fa7-f45be187d400"/>
         <item guidRef="e6644135-9dab-4935-8ab9-fc85527810ca"/>
         <item guidRef="6ae897fd-2eab-4dad-b172-f4fb768c273e"/>
         <item guidRef="266435b4-6e53-460f-9fa7-f45be187d400"/>
         <item guidRef="97e5c8b9-f7e2-453c-92a2-af7fb61e67b2"/>
         <item guidRef="266435b4-6e53-460f-9fa7-f45be187d400"/>
         <item guidRef="76dd9e0c-e9c2-42b6-b8bb-f7717482164e"/>
         <item guidRef="6bd00383-d132-4686-8a21-8d7052b6a81b"/>
         <item guidRef="40cc3adc-498a-4256-a98a-d1210a4019f7"/>
       </modeData>
     </xsl:copy>
   </xsl:template> 

最初のセクションでは、新しいツール・ボタンをツールボックスの最後に追加します。それは、テンプレートを使用して、ヘルパーを挿入します。－項目は、XSLT内でも定義されています。2つ目のセクションは、ツールのための新しいプロパティ・バー・モードを定義します。GUID"fd9a53f7-05cc-4cdc-b2ad-0fd6a7ea3480"もこのツールに固有です。そして、MyTool::StartAtState(),で、あなたは、次の行を見つけるでしょう。：

currentAttribs.PropertyBarGuid = "fd9a53f7-05cc-4cdc-b2ad-0fd6a7ea3480";

これは、ツールが選択されるとき、私たちが、このプロパティ・バーを使用したいホスト・アプリケーションに伝えます。このサンプル・プロパティ・バー・モードの項目は、主に実際の線ツールから、アプリケーションから取得されます。同じように、カスタム項目は作成でき、ここに、含めることができます。

The Resources

3種類のリソースは、アイコン、カーソル、および文字列を定義できます。config.xmlは、アイテムのGUIDを特定のリソースに結び付けます。この場合、私たちは、"b17f7ca0-0062-4dd8-adf6-1ea2192a3d35"を文字列"10223"とアイコン"104に結び付けます。これらのリソースは、resources.rctをダブルクリックしてプロジェクト内で見つけることができます。

注記：組み込みのエディタを使用する代わりに、外部エディタを使用してアイコンを作成する方が簡単な場合があります。続いて、"Add Resource"、"Icon"、インポートを使用します。

The APIs

下記は、CorelDRAWのX7.1とCorel DESIGNER X7オブジェクト・モデルに追加されたすべての新しい関数のリストです。：

Notes:

• VBAツールでは、遅延読込をオフにする必要があります。この理由だけのために、C#やC++を使用することが推奨されます。それが、最も使いやすい言語である場合、あなたは、VB dllとしてツールを記述することもできます。
• UserUI.xsltは、ワークスペースを更新するために、一度だけ読み込まれます。ツールの開発中の場合、このファイルを変更する必要があります。あなたは、F8キーを押して、ワークスペースをリセットする必要があります。この理由から、あなたが、ツールを開発する間、一時的なワークスペースで作業することをお勧めします
• AppUI.xsltファイルは、毎回、読み込まれるため、行われた変更は、すぐに表示されます。
• カスタム・アドオン・ツールを使用するために、CorelDRAW X7.1以上のユーザーが、有効なCorelDRAW StandardやPremiumメンバーシップでサインインする必要があります。CorelDRAW Graphics Suite X7を購入したすべてのお客様は、Standardメンバーシップは、無料です。
• CorelDRAWの32ビットバージョンと64ビットバージョンの両方がインストールされている場合、Visual Studioプロジェクト・テンプレートは、64bitのバージョンを選択します。