ImageComparison オブジェクト

このオブジェクトはイメージ比較ウィンドウを表します。必ずしも画面にウィンドウを表示する必要はありませんが、クライアントにファイル比較サービスを実行したり、ファイル比較画面をユーザーに提示したりする場合に、このウィンドウを利用できます。

このオブジェクトが公開するメソッドとプロパティを使って、イメージファイル比較とイメージファイル比較ウィンドウの外観の変更を行います。

Information このオブジェクトによって表される比較が閉じると、Close イベントのハンドラーによって、メソッドやプロパティにアクセスする最後の機会が提供されます。その後はアクセスしようとすると、エラーになります。

プロパティ

Active読み取り/書き込みICommonUI

比較ウィンドウのアクティブ状態。

IDL	`[propget] HRESULT Active([out, retval] VARIANT_BOOL* pValue) [propput] HRESULT Active([in] VARIANT_BOOL newValue)`
.NET	`Boolean Active[get, set]`

AllUnresolvedConflicts読み取り専用IFileComparison

現在は使用されていません。

AutoSaveOnClose読み取り/書き込みIFileComparison

現在は使用されていません。

ComparisonError読み取り専用IFileComparison

Compare メソッドで発生したエラー（ある場合）。

IDL	`[propget] HRESULT ComparisonError( [in, optional] VARIANT nFilePair, [out, retval] FileComparisonError* pValue)`
.NET	`FileComparisonError get_ComparisonError( Object nFilePair)`

nFilePair オプション
ファイル 0 と 1 の結果を返すか（nFilePair = 0、デフォルトの場合）、ファイル 1 と 2 の結果を返すか（nFilePair = 1 の場合）を指定します。

ComparisonResult読み取り専用IFileComparison

Compare メソッドで実行された比較の結果（fcrSame、fcrDifferent、fcrError）。

IDL	`[propget] HRESULT ComparisonResult( [in, optional] VARIANT nFilePair, [out, retval] FileComparisonResult* pValue)`
.NET	`FileComparisonResult get_ComparisonResult( Object nFilePair)`

nFilePair オプション
ファイル 0 と 1 の結果を返すか（nFilePair = 0、デフォルトの場合）、ファイル 1 と 2 の結果を返すか（nFilePair = 1 の場合）を指定します。

ErrorInfo読み取り/書き込みIFileComparison

ファイルの 1 つを読み込み/比較している間に発生したエラーに関する詳細情報を提供します。nFile が -1 の場合、3 つのファイルすべてに適用されるエラー（メモリ不足エラーなど）が返されます。

IDL	`[propget] HRESULT ErrorInfo( [in] short nFile, [out, retval] BSTR* pValue) [propput] HRESULT ErrorInfo( [in] short nFile, [in] BSTR newValue)`
.NET	`String get_ErrorInfo( Int16 nFile) void set_ErrorInfo( Int16 nFile, String newValue)`

nFile
エラー情報を取得するファイル（0、1、または 2）。値を -1 にすると、すべてのファイルを示すことができます。

Height読み取り/書き込みICommonUI

比較ウィンドウの高さ（ピクセル）。

IDL	`[propget] HRESULT Height([out, retval] long* pValue) [propput] HRESULT Height([in] long newValue)`
.NET	`Int32 Height[get, set]`

Left読み取り/書き込みICommonUI

比較ウィンドウの左端のピクセル座標の位置。

IDL	`[propget] HRESULT Left([out, retval] long* pValue) [propput] HRESULT Left([in] long newValue)`
.NET	`Int32 Left[get, set]`

Maximized読み取り/書き込みICommonUI

比較ウィンドウの最大化状態。

IDL	`[propget] HRESULT Maximized([out, retval] VARIANT_BOOL* pValue) [propput] HRESULT Maximized([in] VARIANT_BOOL newValue)`
.NET	`Boolean Maximized[get, set]`

Minimized読み取り/書き込みICommonUI

比較ウィンドウの最小化状態。

IDL	`[propget] HRESULT Minimized([out, retval] VARIANT_BOOL* pValue) [propput] HRESULT Minimized([in] VARIANT_BOOL newValue)`
.NET	`Boolean Minimized[get, set]`

Modified読み取り/書き込みIFileComparison

現在は使用されていません。

NumberOfChanges読み取り専用IFileComparison

2 つのイメージ間で変更されているピクセル数。両方のイメージの指定された場所で変更されている 1 ピクセルを 1 つの変更としてカウントします。（イメージサイズの違いから生じる）挿入されたピクセルや削除されたピクセルも、それぞれ 1 つの変更としてカウントします。

IDL	`[propget] HRESULT NumberOfChanges( [in, optional] VARIANT nFilePair, [out, retval] long* pValue)`
.NET	`Int32 get_NumberOfChanges( Object nFilePair)`

nFilePair オプション
ファイル 0 と 1 の結果を返すか（nFilePair = 0、デフォルトの場合）、ファイル 1 と 2 の結果を返すか（nFilePair = 1 の場合）を指定します。

PromptForUnsavedFiles読み取り/書き込みIFileComparison

現在は使用されていません。

ReadOnly読み取り/書き込みIFileComparison

現在は使用されていません。

SaveFileName読み取り/書き込みIFileComparison

現在は使用されていません。

ThreeWayMergeActions読み取り専用IFileComparison

現在は使用されていません。

Top読み取り/書き込みICommonUI

比較ウィンドウの上端のピクセル座標の位置。

IDL	`[propget] HRESULT Top([out, retval] long* pValue) [propput] HRESULT Top([in] long newValue)`
.NET	`Int32 Top[get, set]`

UnresolvedConflicts読み取り専用IFileComparison

現在は使用されていません。

ViewType読み取り/書き込みIComparison

比較タイプ（2 者間または 3 者間レイアウト）。

IDL	`[propget] HRESULT ViewType([out, retval] FileViewType* pValue) [propput] HRESULT ViewType([in] FileViewType newValue)`
.NET	`FileViewType ViewType[get, set]`

Visible読み取り/書き込みICommonUI

比較ウィンドウの表示状態。

IDL	`[propget] HRESULT Visible([out, retval] VARIANT_BOOL* pValue) [propput] HRESULT Visible([in] VARIANT_BOOL newValue)`
.NET	`Boolean Visible[get, set]`

Width読み取り/書き込みICommonUI

比較ウィンドウの幅（ピクセル）。

IDL	`[propget] HRESULT Width([out, retval] long* pValue) [propput] HRESULT Width([in] long newValue)`
.NET	`Int32 Width[get, set]`

メソッド

CloseICommonUI

比較ウィンドウを閉じます。

IDL	`HRESULT Close()`
.NET	`void Close()`

CompareIComparison

2 つまたは 3 つのファイルを比較します。このメソッドは同期メソッドです。比較が完了して、エラーと結果を報告するときに ComparisonComplete イベントが発生します。

IDL	`HRESULT Compare( [in] VARIANT strFirstFile, [in] VARIANT strSecondFile, [in, optional] VARIANT strThirdFile)`
.NET	`void Compare( Object strFirstFile, Object strSecondFile, Object strThirdFile)`

strFirstFile
第 1 ファイルへの完全修飾パス。
strSecondFile
第 2 ファイルへの完全修飾パス。
strThirdFile オプション
第 3 ファイルへの完全修飾パス。

CompareAsyncIFileComparison

2 つまたは 3 つのファイルを比較します。このメソッドは非同期メソッドです（比較が完了する前に返されます）。比較が完了して、エラーと結果を報告するときに ComparisonComplete イベントが発生します。

IDL	`HRESULT CompareAsync( [in] VARIANT strFirstFile, [in] VARIANT strSecondFile, [in, optional] VARIANT strThirdFile)`
.NET	`void CompareAsync( Object strFirstFile, Object strSecondFile, Object strThirdFile)`

strFirstFile
第 1 ファイルへの完全修飾パス。
strSecondFile
第 2 ファイルへの完全修飾パス。
strThirdFile オプション
第 3 ファイルへの完全修飾パス。

GiveUserControlICommonUI

比較ウィンドウの起動から終了までをユーザーが制御できるようにします。未処理のオートメーション参照が解放されても、Merge は自動的に比較ウィンドウを閉じません。

IDL	`HRESULT GiveUserControl()`
.NET	`void GiveUserControl()`

PrintIComparison

ファイル比較を印刷します。

IDL	`HRESULT Print( [in] VARIANT_BOOL bShowPrinterDialog, [in] PageOrientation nOrientation)`
.NET	`void Print( Boolean bShowPrinterDialog, PageOrientation nOrientation)`

bShowPrinterDialog
デフォルトは false です。印刷を行う前に印刷ダイアログをユーザーに表示するかどうかを示します。
nOrientation
デフォルトは poLandscape です。縦置き、横置きのどちらの向きで印刷するかを示します。

RefreshIComparison

ウィンドウに表示されているファイルを再度比較します。これにより、未保存の変更は破棄されます。

IDL	`HRESULT Refresh()`
.NET	`void Refresh()`

ReportIComparison

現在は使用されていません。

Report2IComparison

現在は使用されていません。

RestoreICommonUI

比較ウィンドウを、最小化または最大化された状態から通常のサイズ変更可能な状態に戻します。

IDL	`HRESULT Restore()`
.NET	`void Restore()`

SaveComparisonIComparison

比較をファイルに保存します。ファイル名には .cmp7 拡張子を使用することをお勧めします。

IDL	`HRESULT SaveComparison( [in] BSTR filename)`
.NET	`void SaveComparison( String filename)`

filename
比較を保存するファイルの名前。

SaveFileIFileComparison

現在は使用されていません。

SaveFileAsIFileComparison

現在は使用されていません。

SetPanelTitlesIComparison

ファイルペインの上に表示するタイトルを設定します。

IDL	`HRESULT SetPanelTitles( [in] VARIANT strFirst, [in] VARIANT strSecond, [in, optional] VARIANT strThird)`
.NET	`void SetPanelTitles( Object strFirst, Object strSecond, Object strThird)`

strFirst
第 1 ファイルペインのタイトル。
strSecond
第 2 ファイルペインのタイトル。
strThird オプション
第 3 ファイルペインのタイトル。

ThreeWayMergeIFileComparison

現在は使用されていません。

イベント

CloseIFileComparisonEvents

ファイル比較ウィンドウはユーザーによって閉じられました。

IDL	`HRESULT Close()`
.NET	`void Close()`

ComparisonCompleteIFileComparisonEvents

ファイル比較が完了したときに発生します。2 ファイル間での比較では、最初の 2 つの引数のみが定義されます。3 ファイル間での比較では、4 つすべての引数が定義されます。

IDL	`HRESULT ComparisonComplete( [in] FileComparisonError error1, [in] FileComparisonResult result1, [in, optional] FileComparisonError error2, [in, optional] FileComparisonResult result2)`
.NET	`void ComparisonComplete( FileComparisonError error1, FileComparisonResult result1, FileComparisonError error2, FileComparisonResult result2)`

error1
第 1 ファイルと第 2 ファイルの比較中に発生したエラー（ある場合）。
result1
第 1 ファイルと第 2 ファイルとの比較の結果。
error2 オプション
第 2 ファイルと第 3 ファイルの比較中に発生したエラー（ある場合）。
result2 オプション
第 2 ファイルと第 3 ファイルとの比較の結果。