BinaryComparison オブジェクト

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

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

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

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

ChangeLength読み取り専用IBinaryComparison

変更の行数。

IDL	`[propget] HRESULT ChangeLength( [in] long nChange, [in] long nSide, [in, optional] VARIANT nFilePair, [out, retval] long* pValue)`
.NET	`Int32 get_ChangeLength( Int32 nChange, Int32 nSide, Object nFilePair)`

nChange
含まれているバイト数を求める変更（0 ベース）を指定します。この値は 0 から NumberOfChanges-1 の範囲になります。
nSide
変更の左側（0）または右側（1）を指定します。
nFilePair オプション
ファイル 0 と 1 の結果を返すか（nFilePair = 0、デフォルトの場合）、ファイル 1 と 2 の結果を返すか（nFilePair = 1 の場合）を指定します。

ChangeStartLine読み取り専用IBinaryComparison

変更の開始バイトオフセット（0 ベース）。

IDL	`[propget] HRESULT ChangeStartLine( [in] long nChange, [in] long nSide, [in, optional] VARIANT nFilePair, [out, retval] long* pValue)`
.NET	`Int32 get_ChangeStartLine( Int32 nChange, Int32 nSide, Object nFilePair)`

nChange
開始バイトオフセットを求める変更（0 ベース）を指定します。この値は 0 から NumberOfChanges-1 の範囲になります。
nSide
変更の左側（0）または右側（1）を指定します。
nFilePair オプション
ファイル 0 と 1 の結果を返すか（nFilePair = 0、デフォルトの場合）、ファイル 1 と 2 の結果を返すか（nFilePair = 1 の場合）を指定します。

ChangeType読み取り専用IBinaryComparison

変更のタイプ。変更は、挿入行、削除行、変更行、未変更行を表します。

IDL	`[propget] HRESULT ChangeType( [in] long nChange, [in, optional] VARIANT nFilePair, [out, retval] ChangeStyle* pValue)`
.NET	`ChangeStyle get_ChangeType( Int32 nChange, Object nFilePair)`

nChange
タイプを求める変更（０ベース）を指定します。この値は 0 から NumberOfChanges-1 の範囲になります。
nFilePair オプション
ファイル 0 と 1 の結果を返すか（nFilePair = 0、デフォルトの場合）、ファイル 1 と 2 の結果を返すか（nFilePair = 1 の場合）を指定します。

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

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

NumberOfBytes読み取り専用IBinaryComparison

比較ファイルのバイト数。

IDL	`[propget] HRESULT NumberOfBytes( [in] short nFile, [out, retval] short* pValue)`
.NET	`Int16 get_NumberOfBytes( Int16 nFile)`

nFile
対象のファイルを指定します（第 1、第 2、第 3 ファイルに対してそれぞれ 0、1、または 2）。

NumberOfChanges読み取り専用IFileComparison

2 つのファイル間の変更数。

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 ファイルとの比較の結果。