BinaryComparison オブジェクト

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

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

プロパティ

Active読み取り/書き込みICommonUI

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

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

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)
VB6 ChangeLength(
    nChange As Long,
    nSide As Long
    [, nFilePair As Variant]) As Long
  • 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)
VB6 ChangeStartLine(
    nChange As Long,
    nSide As Long
    [, nFilePair As Variant]) As Long
  • 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)
VB6 ChangeType(
    nChange As Long
    [, nFilePair As Variant]) As ChangeStyle
  • 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)
VB6 ComparisonError(
    [nFilePair As Variant]) As FileComparisonError
  • 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)
VB6 ComparisonResult(
    [nFilePair As Variant]) As FileComparisonResult
  • 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)
VB6 ErrorInfo(
    nFile As Integer) As String
  • 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]
VB6 Height As Long

Left読み取り/書き込みICommonUI

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

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

Maximized読み取り/書き込みICommonUI

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

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

Minimized読み取り/書き込みICommonUI

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

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

Modified読み取り/書き込みIFileComparison

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

NumberOfBytes読み取り専用IBinaryComparison

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

IDL [propget] HRESULT NumberOfBytes(
    [in] short nFile,
    [out, retval] short* pValue)
.NET Int16 get_NumberOfBytes(
    Int16 nFile)
VB6 NumberOfBytes(
    nFile As Integer) As Integer
  • 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)
VB6 NumberOfChanges(
    [nFilePair As Variant]) As Long
  • 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]
VB6 Top As Long

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]
VB6 ViewType As FileViewType

Visible読み取り/書き込みICommonUI

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

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

Width読み取り/書き込みICommonUI

比較ウィンドウの幅(ピクセル)。

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

メソッド

CloseICommonUI

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

IDL HRESULT Close()
.NET void Close()
VB6 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)
VB6 Compare(
    strFirstFile As Variant,
    strSecondFile As Variant
    [, strThirdFile As Variant])
  • 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)
VB6 CompareAsync(
    strFirstFile As Variant,
    strSecondFile As Variant
    [, strThirdFile As Variant])
  • strFirstFile
    第 1 ファイルへの完全修飾パス。
  • strSecondFile
    第 2 ファイルへの完全修飾パス。
  • strThirdFile オプション
    第 3 ファイルへの完全修飾パス。

GiveUserControlICommonUI

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

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

PrintIComparison

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

IDL HRESULT Print(
    [in] VARIANT_BOOL bShowPrinterDialog,
    [in] PageOrientation nOrientation)
.NET void Print(
    Boolean bShowPrinterDialog,
    PageOrientation nOrientation)
VB6 Print(
    bShowPrinterDialog As Boolean,
    nOrientation As PageOrientation)
  • bShowPrinterDialog
    デフォルトは FALSE です。印刷を行う前に印刷ダイアログをユーザーに表示するかどうかを示します。
  • nOrientation
    デフォルトは poLandscape です。縦置き、横置きのどちらの向きで印刷するかを示します。

RefreshIComparison

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

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

ReportIComparison

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

Report2IComparison

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

RestoreICommonUI

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

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

SaveComparisonIComparison

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

IDL HRESULT SaveComparison(
    [in] BSTR filename)
.NET void SaveComparison(
    String filename)
VB6 SaveComparison(
    filename As String)
  • 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)
VB6 SetPanelTitles(
    strFirst As Variant,
    strSecond As Variant
    [, strThird As Variant])
  • strFirst
    第 1 ファイル パネルのタイトル。
  • strSecond
    第 2 ファイル パネルのタイトル。
  • strThird オプション
    第 3 ファイル パネルのタイトル。

ThreeWayMergeIFileComparison

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

イベント

CloseIFileComparisonEvents

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

IDL HRESULT Close()
.NET void Close()
VB6 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)
VB6 ComparisonComplete(
    error1 As FileComparisonError,
    result1 As FileComparisonResult
    [, error2 As FileComparisonError]
    [, result2 As FileComparisonResult])
  • error1
    第 1 ファイルと第 2 ファイルの比較中に発生したエラー(ある場合)。
  • result1
    第 1 ファイルと第 2 ファイルとの比較の結果。
  • error2 オプション
    第 2 ファイルと第 3 ファイルの比較中に発生したエラー(ある場合)。
  • result2 オプション
    第 2 ファイルと第 3 ファイルとの比較の結果。