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 ベース)を指定します。この値は 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 メソッドで実行された比較の結果(fcrSamefcrDifferentfcrError)。

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