TextComparison オブジェクト

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

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

プロパティ (ICommonUI インターフェイスによって実装されます )

Active

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`

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

このプロパティは取得と設定が可能です。

Height

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

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

このプロパティは取得と設定が可能です。

Left

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

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

このプロパティは取得と設定が可能です。

Maximized

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

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`

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

このプロパティは取得と設定が可能です。

Top

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

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

このプロパティは取得と設定が可能です。

Visible

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

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

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

このプロパティは取得と設定が可能です。

プロパティ (IComparison インターフェイスによって実装されます )

ViewType

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

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

このプロパティは取得と設定が可能です。

プロパティ (IFileComparison インターフェイスによって実装されます )

AllUnresolvedConflicts

IDL	`[propget] HRESULT AllUnresolvedConflicts([out, retval] long* pValue)`
.NET	`Int32 AllUnresolvedConflicts[get]`
VB6	`AllUnresolvedConflicts As Long`

すべての比較ファイルの中にある未解決の不一致の数を提供します。

このプロパティは取得のみです。

AutoSaveOnClose

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

Merge が閉じられるときに変更されたファイルが未保存の場合、通常、Merge はユーザーにこれらのファイルを保存するかどうかを尋ねます。これは、PromptForUnsavedFiles プロパティに false が設定されていない場合で、設定されている場合は未保存ファイルが破棄されます。ただし、AutoSaveOnClose に true が設定されている場合、Merge はユーザーに尋ねることなく未保存ファイルを自動的に保存します。この機能は、Merge をほかのアプリケーションと統合する場合に便利です。

このプロパティは取得と設定が可能です。

ComparisonError

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`

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

このプロパティは取得のみです。

引数

nFilePair [optional]
ファイル 0 と 1 の結果を返すか（nFilePair = 0［デフォルト］の場合）、ファイル 1 と 2 の結果を返すか（nFilePair = 1 の場合）を指定します。

ComparisonResult

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`

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

このプロパティは取得のみです。

引数

nFilePair [optional]
ファイル 0 と 1 の結果を返すか（nFilePair = 0［デフォルト］の場合）、ファイル 1 と 2 の結果を返すか（nFilePair = 1 の場合）を指定します。

ErrorInfo

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`

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

このプロパティは取得と設定が可能です。

引数

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

Modified

IDL	`[propget] HRESULT Modified([in] short nFile, [out, retval] VARIANT_BOOL* pValue) [propput] HRESULT Modified([in] short nFile, [in] VARIANT_BOOL newValue)`
.NET	`Boolean get_Modified(Int16 nFile) void set_Modified(Int16 nFile, Boolean newValue)`
VB6	`Modified(nFile As Integer) As Boolean`

ファイルの修正状態の設定または取得を可能にします。

このプロパティは取得と設定が可能です。

引数

nFile
修正状態を取得/設定するファイル（0、1 または 2）。

NumberOfChanges

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`

2 つのファイル間の変更数。このプロパティと ChangeType、ChangeStartLine および ChangeLength プロパティを使用して、比較ファイル間の変更を繰り返し処理します。メモ：変更のセットには、削除/挿入/変更ブロック行のほかに未変更のブロック行も含まれます。

このプロパティは取得のみです。

引数

nFilePair [optional]
ファイル 0 と 1 の結果を返すか（nFilePair = 0［デフォルト］の場合）、ファイル 1 と 2 の結果を返すか（nFilePair = 1 の場合）を指定します。

PromptForUnsavedFiles

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

修正されたファイルを含んでいるファイル比較ウィンドウが閉じられる場合、通常、Merge はそれらのファイルを保存する機会を提供します。このプロパティを false に設定すると、［修正ファイルの保存］ウィンドウは表示されなくなります。

AutoSaveOnClose プロパティも参照してください。

このプロパティは取得と設定が可能です。

ReadOnly

IDL	`[propget] HRESULT ReadOnly([in] short nFile, [out, retval] VARIANT_BOOL* pValue) [propput] HRESULT ReadOnly([in] short nFile, [in] VARIANT_BOOL newValue)`
.NET	`Boolean get_ReadOnly(Int16 nFile) void set_ReadOnly(Int16 nFile, Boolean newValue)`
VB6	`ReadOnly(nFile As Integer) As Boolean`

ファイルの読み取り専用状態の設定または取得を可能にします。

このプロパティは取得と設定が可能です。

引数

nFile
読み取り専用状態を取得/設定するファイル（0、1 または 2）。

SaveFileName

IDL	`[propget] HRESULT SaveFileName([out, retval] BSTR* pValue) [propput] HRESULT SaveFileName([in] BSTR newValue)`
.NET	`String SaveFileName[get, set]`
VB6	`SaveFileName As String`

ファイル比較ウィンドウで変更を保存（Ctrl+S キーまたは［上書き保存］コマンドを使用）するときに使うファイル名。

このプロパティは取得と設定が可能です。

ThreeWayMergeActions

IDL	`[propget] HRESULT ThreeWayMergeActions([out, retval] IThreeWayMergeActions** pValue)`
.NET	`ThreeWayMergeActions ThreeWayMergeActions[get]`
VB6	`ThreeWayMergeActions As ThreeWayMergeActions`

1 番目と 3 番目のファイルの変更を中央の親ファイルへマージするために実行する必要があるアクションのコレクションを取得します。

このプロパティは取得のみです。

UnresolvedConflicts

IDL	`[propget] HRESULT UnresolvedConflicts([in] short nFile, [out, retval] long* pValue)`
.NET	`Int32 get_UnresolvedConflicts(Int16 nFile)`
VB6	`UnresolvedConflicts(nFile As Integer) As Long`

比較ファイルの 1 つの中にある未解決の不一致の数を提供します。

このプロパティは取得のみです。

引数

nFile
未解決の不一致をチェックする必要のあるファイル（0、1 または 2）を指定します。

プロパティ (ITextComparison インターフェイスによって実装されます )

ChangeLength

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 [optional]
ファイル 0 と 1 の結果を返すか（nFilePair = 0［デフォルト］の場合）、ファイル 1 と 2 の結果を返すか（nFilePair = 1 の場合）を指定します。

ChangeStartLine

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`

変更の開始行（0 ベース）。

このプロパティは取得のみです。

引数

nChange
開始行を求める変更（0 ベース）を指定します。この値は [0..NumberOfChanges-1] の範囲になります。
nSide
変更の左側（0）または右側（1）を指定します。
nFilePair [optional]
ファイル 0 と 1 の結果を返すか（nFilePair = 0［デフォルト］の場合）、ファイル 1 と 2 の結果を返すか（nFilePair = 1 の場合）を指定します。

ChangeType

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 [optional]
ファイル 0 と 1 の結果を返すか（nFilePair = 0［デフォルト］の場合）、ファイル 1 と 2 の結果を返すか（nFilePair = 1 の場合）を指定します。

FileContent

IDL	`[propget] HRESULT FileContent([in] short nFile, [out, retval] BSTR* pValue) [propput] HRESULT FileContent([in] short nFile, [in] BSTR newValue)`
.NET	`String get_FileContent(Int16 nFile) void set_FileContent(Int16 nFile, String newValue)`
VB6	`FileContent(nFile As Integer) As String`

ファイルパネルの内容の設定、取得あるいは検索を可能にします。

このプロパティは取得と設定が可能です。

引数

nFile
行を含んでいるファイル（0、1 または 2）を指定します。

FullLineData

IDL	`[propget] HRESULT FullLineData([in] long nLine, [in] short nFile, [out, retval] BSTR* pValue)`
.NET	`String get_FullLineData(Int32 nLine, Int16 nFile)`
VB6	`FullLineData(nLine As Long, nFile As Integer) As String`

ファイルの 1 つにある行の内容。内容には CR や LF の行終端文字が含まれます。

このプロパティは取得のみです。

引数

nLine
データを求める行（0 ベース）を指定します。
nFile
行を含んでいるファイル（0、1 または 2）を指定します。

FullLineLength

IDL	`[propget] HRESULT FullLineLength([in] long nLine, [in] short nFile, [out, retval] long* pValue)`
.NET	`Int32 get_FullLineLength(Int32 nLine, Int16 nFile)`
VB6	`FullLineLength(nLine As Long, nFile As Integer) As Long`

ファイルの 1 つにある行の長さ。長さには CR や LF の行終端文字が含まれます。

このプロパティは取得のみです。

引数

nLine
長さを求める行（0 ベース）を指定します。
nFile
行を含んでいるファイル（0、1 または 2）を指定します。

LineData

IDL	`[propget] HRESULT LineData([in] long nLine, [in] short nFile, [out, retval] BSTR* pValue)`
.NET	`String get_LineData(Int32 nLine, Int16 nFile)`
VB6	`LineData(nLine As Long, nFile As Integer) As String`

ファイルの 1 つにある行の内容。内容には CR や LF の行終端文字は含まれません。

このプロパティは取得のみです。

引数

nLine
データを求める行（0 ベース）を指定します。
nFile
行を含んでいるファイル（0、1 または 2）を指定します。

LineLength

IDL	`[propget] HRESULT LineLength([in] long nLine, [in] short nFile, [out, retval] long* pValue)`
.NET	`Int32 get_LineLength(Int32 nLine, Int16 nFile)`
VB6	`LineLength(nLine As Long, nFile As Integer) As Long`

ファイルの 1 つにある行の長さ。長さには CR や LF の行終端文字は含まれません。

このプロパティは取得のみです。

引数

nLine
長さを求める行（0 ベース）を指定します。
nFile
行を含んでいるファイル（0、1 または 2）を指定します。

NumberOfLines

IDL	`[propget] HRESULT NumberOfLines([in] short nFile, [out, retval] short* pValue)`
.NET	`Int16 get_NumberOfLines(Int16 nFile)`
VB6	`NumberOfLines(nFile As Integer) As Integer`

比較ファイルの行数。

このプロパティは取得のみです。

引数

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

メソッド (ICommonUI インターフェイスによって実装されます )

Close

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

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

GiveUserControl

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

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

Restore

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

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

メソッド (IComparison インターフェイスによって実装されます )

Compare

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])`

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

引数

strFirstFile
第 1 ファイルへの完全修飾パス。
strSecondFile
第 2 ファイルへの完全修飾パス。
strThirdFile [optional]
第 3 ファイルへの完全修飾パス。

Print

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 です。縦置き、横置きのどちらの向きで印刷するかを示します。

Refresh

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

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

Report

IDL	`HRESULT Report([in] BSTR bstrReporter, [in] LineEndingStyle nLineEndingStyle, [in] BSTR strOutputFile)`
.NET	`void Report(String bstrReporter, LineEndingStyle nLineEndingStyle, String strOutputFile)`
VB6	`Report(bstrReporter As String, nLineEndingStyle As LineEndingStyle, strOutputFile As String)`

ファイル比較のレポートを生成します。

引数

bstrReporter
レポートの生成に使用するレポーターのショートネーム。有効なショートネームは "xml"、"html"、"htmlslideshow" および "diff" です。すべてのレポーターで 3 者間比較レポートの生成がサポートされているわけではありません。
nLineEndingStyle
生成するレポートファイルで使用する行終端のタイプ。
strOutputFile
レポート用の出力ファイルの名前。レポーターが 2 つ以上のファイルを生成する場合、それらのファイルにはこの名前を基にした名前が付けられます。

Report2

IDL	`HRESULT Report2([in] BSTR bstrReporter, [in] LineEndingStyle nLineEndingStyle, [in] VARIANT vtEncoding, [in] BSTR strOutputFile)`
.NET	`void Report2(String bstrReporter, LineEndingStyle nLineEndingStyle, Object vtEncoding, String strOutputFile)`
VB6	`Report2(bstrReporter As String, nLineEndingStyle As LineEndingStyle, vtEncoding As Variant, strOutputFile As String)`

ファイル比較のレポートを生成します。

引数

bstrReporter
レポートの生成に使用するレポーターのショートネーム。有効なショートネームは "xml"、"html"、"htmlslideshow" および "diff" です。すべてのレポーターで 3 者間比較レポートの生成がサポートされているわけではありません。
nLineEndingStyle
生成するレポートファイルで使用する行終端のタイプ。
vtEncoding
生成するレポートで使用する文字エンコード。コードページ番号、または 'UCS2' （Unicode UCS2）、'UCS2-BE' （Unicode UCS2 ビッグエンディアン）、'UTF8' （Unicode UTF8 バイト順マーク付き）、'UTF8-NOBOM' （Unicode UTF8 バイト順マークなし）、'UTF7' （Unicode UTF7）のいずれか。
strOutputFile
レポート用の出力ファイルの名前。レポーターが 2 つ以上のファイルを生成する場合、それらのファイルにはこの名前を基にした名前が付けられます。

SaveComparison

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

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

引数

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

SetPanelTitles

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 [optional]
第 3 ファイルパネルのタイトル。

メソッド (IFileComparison インターフェイスによって実装されます )

CompareAsync

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])`

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

引数

strFirstFile
第 1 ファイルへの完全修飾パス。
strSecondFile
第 2 ファイルへの完全修飾パス。
strThirdFile [optional]
第 3 ファイルへの完全修飾パス。

SaveFile

IDL	`HRESULT SaveFile([in] short nFile, [in, optional] VARIANT strSaveTo)`
.NET	`void SaveFile(Int16 nFile, Object strSaveTo)`
VB6	`SaveFile(nFile As Integer [, strSaveTo As Variant])`

nFile パネルのファイルを保存します。strSaveTo 引数を使用すると、Merge は指定ファイルに対して［名前を付けて保存］を実行します。

引数

nFile
保存するファイル（0、1 または 2）。
strSaveTo [optional]
ファイルを保存するときに使用する任意のファイル名。

SaveFileAs

IDL	`HRESULT SaveFileAs([in] short nFile)`
.NET	`void SaveFileAs(Int16 nFile)`
VB6	`SaveFileAs(nFile As Integer)`

nFile パネルのファイルに新しい名前を付けて保存するようユーザーに指示するメッセージを表示します。

引数

nFile
保存するファイル（0、1 または 2）。

ThreeWayMerge

IDL	`HRESULT ThreeWayMerge([out, retval] long* pValue)`
.NET	`Int32 ThreeWayMerge()`
VB6	`ThreeWayMerge As Long`

3 者間比較で 2 つの（左右）外側のファイルを中央にある共通の親ファイルにマージします。マージが返される間に発生したマージの不一致の数。

メソッド (ITextComparison インターフェイスによって実装されます )

メソッド (ITextComparison2 インターフェイスによって実装されます )

CompareAsyncWithEncoding

IDL	`HRESULT CompareAsyncWithEncoding([in] VARIANT strFirstFile, [in] IEncoding* firstEncoding, [in] VARIANT strSecondFile, [in] IEncoding* secondEncoding, [in, optional] VARIANT strThirdFile, [in, optional] IEncoding* thirdEncoding)`
.NET	`void CompareAsyncWithEncoding(Object strFirstFile, Encoding firstEncoding, Object strSecondFile, Encoding secondEncoding, Object strThirdFile, Encoding thirdEncoding)`
VB6	`CompareAsyncWithEncoding(strFirstFile As Variant, firstEncoding As Encoding, strSecondFile As Variant, secondEncoding As Encoding [, strThirdFile As Variant] [, thirdEncoding As Encoding])`

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

引数

strFirstFile
第 1 ファイルへの完全修飾パス。
firstEncoding
第 1 ファイルを読み込む際に使用するエンコード、またはデフォルトのエンコードを使用する場合は 0（null NULL）。
strSecondFile
第 2 ファイルへの完全修飾パス。
secondEncoding
第 2 ファイルを読み込む際に使用するエンコード、またはデフォルトのエンコードを使用する場合は 0（null NULL）。
strThirdFile [optional]
第 3 ファイルへの完全修飾パス。
thirdEncoding [optional]
第 3 ファイルを読み込む際に使用するエンコード、またはデフォルトのエンコードを使用する場合は 0（null NULL）。

CompareWithEncoding

IDL	`HRESULT CompareWithEncoding([in] VARIANT strFirstFile, [in] IEncoding* firstEncoding, [in] VARIANT strSecondFile, [in] IEncoding* secondEncoding, [in, optional] VARIANT strThirdFile, [in, optional] IEncoding* thirdEncoding)`
.NET	`void CompareWithEncoding(Object strFirstFile, Encoding firstEncoding, Object strSecondFile, Encoding secondEncoding, Object strThirdFile, Encoding thirdEncoding)`
VB6	`CompareWithEncoding(strFirstFile As Variant, firstEncoding As Encoding, strSecondFile As Variant, secondEncoding As Encoding [, strThirdFile As Variant] [, thirdEncoding As Encoding])`

ファイルを読み込む際、指定されたエンコードを使用して、2 つまたは 3 つのファイルを比較します。このメソッドは同期メソッドです。比較が完了して、エラーと結果を報告するときに、ComparisonComplete イベントが発生します。

引数

strFirstFile
第 1 ファイルへの完全修飾パス。
firstEncoding
第 1 ファイルを読み込む際に使用するエンコード、またはデフォルトのエンコードを使用する場合は 0（null NULL）。
strSecondFile
第 2 ファイルへの完全修飾パス。
secondEncoding
第 2 ファイルを読み込む際に使用するエンコード、またはデフォルトのエンコードを使用する場合は 0（null NULL）。
strThirdFile [optional]
第 3 ファイルへの完全修飾パス。
thirdEncoding [optional]
第 3 ファイルを読み込む際に使用するエンコード、またはデフォルトのエンコードを使用する場合は 0（null NULL）。

イベント (IFileComparisonEvents インターフェイスによって実装されます )

Close

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

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

ComparisonComplete

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])`

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

引数

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

関連するトピック
オートメーション API