ImageComparison オブジェクト

On this page:

Description

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

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

このオブジェクトによって表される比較が閉じると、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)

ComparisonResult 読み取り専用、IFileComparison

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

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

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)

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)

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]

メソッド

Close ICommonUI

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

IDL HRESULT Close()
.NET void Close()

Compare IComparison

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)

CompareAsync IFileComparison

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)

GiveUserControl ICommonUI

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

IDL HRESULT GiveUserControl()
.NET void GiveUserControl()

Print IComparison

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

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

Refresh IComparison

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

IDL HRESULT Refresh()
.NET void Refresh()

Report IComparison

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

Report2 IComparison

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

Restore ICommonUI

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

IDL HRESULT Restore()
.NET void Restore()

SaveComparison IComparison

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

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

SaveFile IFileComparison

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

SaveFileAs IFileComparison

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

SetPanelTitles IComparison

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

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

ThreeWayMerge IFileComparison

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

イベント

Close IFileComparisonEvents

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

IDL HRESULT Close()
.NET void Close()

ComparisonComplete IFileComparisonEvents

ファイル比較が完了したときに発生します。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)