Merge はオートメーション API を備えており、JScript、Visual Basic(VBScript と VBA を含む)、Visual C#、Visual C++、その他多くの言語および環境から制御することができます。オートメーションを使って、Merge を他のアプリケーションと統合したり、ワークフローに組み込むことができます。
オートメーション API 入門
-
Merge インストール ディレクトリ内の AutomationSamples ディレクトリには、オートメーション API の完全なサンプル プログラムが豊富に収められています。これらはさまざまな言語にわたっています(主に JScript と CSharp ですが、VBScript、VB.NET、VB6、および C++ もあります)。
-
オートメーション API 入門を参照してください。
オートメーション API オブジェクト
オートメーション API は、さまざまなオブジェクトを公開しています。下の表でこれらの機能について説明します。
| オブジェクト | 説明 |
|---|---|
| Merge.Application | メイン アプリケーション オブジェクト。ほかのオブジェクトには、このオブジェクトからアクセスします。 |
| TextComparison | テキスト ファイル比較ウィンドウを表します。 |
| BinaryComparison | バイナリ ファイル比較ウィンドウを表します。 |
| ImageComparison | イメージ ファイル比較ウィンドウを表します。 |
| FolderComparison | フォルダー比較ウィンドウを表します。 |
| Preferences | 3 つの Merge 基本設定オプジェクト、LongPreferences、DoublePreferences および StringPreferences へのアクセスを提供します。 |
| LongPreferences | 長整数で表される Merge 基本設定へのアクセスを提供します。 |
| DoublePreferences | 倍精度浮動小数点数で表される Merge 基本設定へのアクセスを提供します。 |
| StringPreferences | 文字列で表される Merge 基本設定へのアクセスを提供します。 |
| ThreeWayMergeActions | 共通の親ファイルに手作業で 3 者間マージを実行するために必要なアクションのコレクションを表します。 |
| ThreeWayMergeAction | 3 者間マージ アクションを表します。 |
| Filters | ファイル/フォルダー フィルターのコレクションを表します。 |
| Filter | ファイル/フォルダー フィルターを表します。 |
| FilterPattern | ファイル/フォルダー フィルターで使用するパターンを表します。 |
| Encodings | エンコードのコレクションを表します。 |
| Encoding | ファイルを開いたり保存する際に使用する文字エンコードを表します。 |
オートメーション API 列挙
| 列挙 | 説明 |
|---|---|
| ChangeStyle | 2 つのファイル間で発生するさまざまな変更のタイプを定義します。 |
| ConfigDouble | DoublePreferences オブジェクトから使用できるさまざまな基本設定の定数を定義します。 |
| ConfigLong | LongPreferences オブジェクトから使用できるさまざまな基本設定の定数を定義します。 |
| ConfigString | StringPreferences オブジェクトから使用できるさまざまな基本設定の定数を定義します。 |
| FileComparisonError | ファイル比較時のエラーの原因を定義します。 |
| FileComparisonResult | ファイル比較の結果を定義します。 |
| FileType | ファイル システム項目のタイプの定数を定義します。 |
| FileViewType | ファイル比較ウィンドウのさまざまなレイアウトの定数を定義します。 |
| FolderComparisonResult | フォルダー比較で発生し得るさまざまな結果の定数を定義します。 |
| FolderComparisonThoroughness | フォルダー比較におけるファイル比較の完全性に関する定数を定義します。 |
| FolderFileType | フォルダー比較の結果で考えられるさまざまなファイルのタイプに関する定数を定義します。 |
| LineEndingStyle | 行終端のスタイルの定数を定義します。 |
| PageOrientation | プリンターの印刷の向きの定数を定義します。 |
| Whitespace | ファイル比較における空白の相違の処理に関する定数を定義します。 |
| ThreeWayMergeActionType | 3 者間マージ アクションの定数を定義します。 |
| FolderSortOrder | フォルダー比較ウィンドウの並べ替え順序をカスタマイズするための定数を定義します。 |
| PatternFilter | ファイル/フォルダーのフィルター パターンのタイプ(包含/除外)の定数を定義します。 |
| PatternMatch | フィルター パターンで一致させる項目(ファイルおよび/またはフォルダー)のタイプの定数を定義します。 |
仮想ファイル システム インターフェイス
オートメーション API にはプラグイン コンポーネントによって実装できる多数のインターフェイスがあり、ファイル システムのサポートを Merge に追加することができます。プラグイン ファイル システムの例を挙げると、Win32 ファイル システム、SCM リポジトリ ファイル システム、および HTTP や FTP ファイル システムなどがあります。詳細については、 IFileSystem インターフェイスページを参照してください。
| インターフェイス | 説明 |
|---|---|
| IContinueOperation | Merge によって実装され、時間のかかる操作をユーザーがキャンセルできるようにします。 |
| IFile | コンポーネントによって実装され、ファイル システム内のファイルを表します。 |
| IFileStream | コンポーネントによって実装され、ファイル システム内のデータのストリームを表します。 |
| IFileSystem | コンポーネントによって実装され、ファイル システムを Merge に提供します。 |
| IFileSystemInit | コンポーネントによって実装され、ファイル システムを Merge に提供します。 |
| IFileSystemItem | コンポーネントによって実装され、ファイル システム内のファイルまたはフォルダーを表します。 |
| IFileSystemItemIcon | コンポーネントによって実装され、ファイル システム内のファイルまたはフォルダーを表します。 |
| IFileSystemItemVersionInformation | コンポーネントによって実装され、ファイル システム内のファイルまたはフォルダーを表します。 |
| IFileSystemItemComparableUrl | コンポーネントによって実装され、ファイル システム内のファイルまたはフォルダーを表します。 |
| IFolder | コンポーネントによって実装され、ファイル システム内のフォルダーを表します。 |
| IFolderContents | コンポーネントによって実装され、ファイル システム内のフォルダーの内容を表します。 |
| IHost | Merge によって実装され、サービスをプラグイン コンポーネントに提供します。 |
| IHostConfig | Merge によって実装され、構成保管サービスをプラグイン コンポーネントに提供します。 |
| IHostUI | Merge によって実装され、ユーザー インターフェイス サービスをプラグイン コンポーネントに提供します。 |
| IUrlCollection | コンポーネントによって実装され、URL のコレクションを表します。 |
仮想ファイル システム 列挙
| 列挙 | 説明 |
|---|---|
| Capability | ファイル システム機能の定数を定義します。 |
| CapabilityLevel | ファイル システム機能の実装の品質レベルの定数を定義します。 |
